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:
MisterSheeple
2024-09-06 16:30:07 -04:00
committed by GitHub
parent 76f5191bc5
commit 02351e6257
2 changed files with 9 additions and 7 deletions
+1
View File
@@ -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 \
+8 -7
View File
@@ -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`.