mirror of
https://github.com/ACreTeam/ac-decomp
synced 2026-07-07 03:55:01 -04:00
Fix building Docker container on ARM (#428)
* Fix building Docker container on ARM * Add info about ARM needing cmake to readme * Make language more consistent in readme * Fix typo
This commit is contained in:
@@ -4,6 +4,7 @@ FROM ubuntu:24.04 as build
|
||||
RUN apt-get update && \
|
||||
apt-get upgrade -y && \
|
||||
apt-get install -y \
|
||||
cmake \
|
||||
git \
|
||||
ninja-build \
|
||||
python3 \
|
||||
|
||||
@@ -15,7 +15,7 @@ Use `--recursive` when cloning to have ppcdis in the repository.
|
||||
## Building
|
||||
|
||||
> [!NOTE]
|
||||
> On Windows, the build is known to run disproportionately slow when ran natively, so we recommend using WSL.
|
||||
> On Windows, the build is known to run disproportionately slow when ran natively, so WSL is recommended.
|
||||
|
||||
### Docker
|
||||
|
||||
@@ -29,23 +29,24 @@ Use `--recursive` when cloning to have ppcdis in the repository.
|
||||
### Build manually
|
||||
|
||||
> [!TIP]
|
||||
> When building manually from a work directory previously used for Docker, you will need to run `sudo ninja -t clean` for the build to execute properly.
|
||||
> When building manually from a work directory previously used for Docker, `sudo ninja -t clean` will need to be ran for the build to execute properly.
|
||||
|
||||
1. [Dump a copy of the game](./docs/extract_game.md) and extract all files.
|
||||
2. Place **main.dol**, **foresta.rel.szs**, **forest_1st.arc**, and **forest_2nd.arc** in *dump/*.
|
||||
3. Download the [CodeWarrior 1.3.2, 1.3.2r, and 1.2.5n compilers](https://files.decomp.dev/compilers_latest.zip) and extract them to *tools/1.3.2/*, *tools/1.3.2r/*, and *tools/1.2.5n/*, respectively.
|
||||
4. Install Python, pip, and [ninja](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages#package-managers) using your package manager of choice.
|
||||
4. Install Python, pip, and [ninja](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages#package-managers) using a package manager of choice.
|
||||
- If using an ARM-based device, cmake will also need to be installed.
|
||||
5. Install Python modules from requirements.txt (`pip install -r requirements.txt`).
|
||||
6. Install [wibo](https://github.com/decompals/wibo)
|
||||
- Wibo is a lightweight Wine replacement that's tailor-made for use with decomp projects. Regular Wine can be used if preferred, but for the purposes of this guide, these instructions will use wibo.
|
||||
- Download the [the latest GitHub release](https://github.com/decompals/wibo/releases/latest) and run `install ./wibo /usr/bin` to install it to your system.
|
||||
- Download [the latest GitHub release](https://github.com/decompals/wibo/releases/latest) and run `install ./wibo /usr/bin` to install it to the system.
|
||||
7. Install devkitPPC.
|
||||
- To get devkitPPC, you'll need [devkitPro Pacman](https://devkitpro.org/wiki/devkitPro_pacman#Installing_devkitPro_Pacman).
|
||||
- [devkitPro Pacman](https://devkitpro.org/wiki/devkitPro_pacman#Installing_devkitPro_Pacman) is needed to get devkitPPC.
|
||||
- Run `dkp-pacman -S devkitPPC` once dkp-pacman is installed to install devkitPPC.
|
||||
- Set the `DEVKITPPC` environment variable to */opt/devkitpro/devkitPPC*.
|
||||
8. Set the `N64_SDK` environment variable to the path of your libultra or equivalent headers. If you need headers, you can use the ones from [ultralib](https://github.com/decompals/ultralib).
|
||||
8. Set the `N64_SDK` environment variable to the path of libultra or equivalent headers. Headers from [ultralib](https://github.com/decompals/ultralib) can be used.
|
||||
- Headers should be located at `$N64_SDK/ultra/usr/include`.
|
||||
- You must modify `Gpopmtx`'s `param` member to be `unsigned int` in **gbi.h**.
|
||||
- `Gpopmtx`'s `param` member must be modified to be `unsigned int` in **gbi.h**.
|
||||
9. Run `python3 configure.py`.
|
||||
10. Run `python3 build.py`.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user