dionmoustos/PokemonEmeraldSafariFrontier
1
0
Fork 0
Code Issues 21 Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #696 from SatoMew/master

Browse Source 
Make installation documentation more straightforward
This commit is contained in:
PikalaxALT
2019-08-04 21:16:41 -04:00
committed by GitHub
parent fa5bfc1627 667f0837e2
commit 483e5173c9
3 changed files with 75 additions and 103 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitattributes
+1 -1
View File
@@ -1,5 +1,5 @@
*.pal text eol=crlf *.pal text eol=crlf
*.sh text eol=lf
*.s text eol=lf *.s text eol=lf
*.txt text eol=lf *.txt text eol=lf
Makefile text eol=lf Makefile text eol=lf
INSTALL.md
+45 -71
View File
@@ -1,116 +1,90 @@
Follow the OS-specific instructions below. # Prerequisites
# Linux | Linux | macOS | Windows 10 (build 18917+) | Windows 10 (1709+) | Windows Vista, 7, 8, 8.1, and 10 (1507, 1511, 1607, and 1703)
| ----- | ----- | ------------------------- | ------------------ | ---------------------------------------------------------
| none | [Xcode Command Line Tools package][xcode] | [Windows Subsystem for Linux 2][wsl2] | [Windows Subsystem for Linux][wsl] | MSYS2 (see below)
Install [**devkitARM**](http://devkitpro.org/wiki/Getting_Started/devkitARM). [xcode]: https://developer.apple.com/library/archive/technotes/tn2339/_index.html#//apple_ref/doc/uid/DTS40014588-CH1-DOWNLOADING_COMMAND_LINE_TOOLS_IS_NOT_AVAILABLE_IN_XCODE_FOR_MACOS_10_9__HOW_CAN_I_INSTALL_THEM_ON_MY_MACHINE_
[wsl2]: https://docs.microsoft.com/windows/wsl/wsl2-install
[wsl]: https://docs.microsoft.com/windows/wsl/install-win10
Make sure that there is an environment variable called DEVKITARM with the path of the directory before the "bin" directory containing "arm-none-eabi-as", "arm-none-eabi-cpp", "arm-none-eabi-ld" and "arm-none-eabi-objcopy". The [prerelease version of the Linux subsystem](https://docs.microsoft.com/windows/wsl/install-legacy) available in the 1607 and 1703 releases of Windows 10 is obsolete so consider uninstalling it.
Then get the compiler from https://github.com/pret/agbcc and run the following commands. Make sure that the `build-essential`, `git`, and `libpng-dev` packages are installed. The `build-essential` package includes the `make`, `gcc-core`, and `g++` packages so they do not have to be obtained separately. MSYS2 does not include `libpng-dev` so it must be built from source.
``` Install the **devkitARM** toolchain of [devkitPro](https://devkitpro.org/wiki/Getting_Started) and add its environment variables. For Windows versions without the Linux subsystem, the devkitPro [graphical installer](https://github.com/devkitPro/installer/releases) includes a preconfigured MSYS2 environment, thus the steps below are not required.
./build.sh
./install.sh PATH_OF_POKEEMERALD_DIRECTORY
```
Finally, build the rom.
```
make
```
# Windows
Install [**devkitARM**](http://devkitpro.org/wiki/Getting_Started/devkitARM).
Then get the compiled tools from https://github.com/pret/pokeruby-tools. Copy the `tools/` folder over the `tools/` folder in your pokeemerald directory.
You can then build pokeemerald using `make` in the MSYS environment provided with devkitARM.
# Mac
Installing pokeemerald on a Mac requires macOS >= 10.12 (Sierra or higher).
Download a [devkitPRO pacman](https://github.com/devkitPro/pacman/releases/tag/v1.0.0)
Run the following commands in Terminal:
```
xcode-select --install
sudo dkp-pacman -S devkitARM
export DEVKITPRO=/opt/devkitpro export DEVKITPRO=/opt/devkitpro
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
export DEVKITARM=$DEVKITPRO/devkitARM export DEVKITARM=$DEVKITPRO/devkitARM
echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
echo "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" >> ~/.bash_profile
# Installation
To set up the repository:
git clone https://github.com/pret/pokeemerald git clone https://github.com/pret/pokeemerald
git clone https://github.com/pret/agbcc git clone https://github.com/pret/agbcc
cd agbcc/ cd ./agbcc
./build.sh ./build.sh
./install.sh ../pokeemerald ./install.sh ../pokeemerald
cd ../pokeemerald cd ../pokeemerald
./build_tools.sh
```
And build the ROM with `make`. To build **pokeemerald.gba** and confirm it matches the official ROM image:
If the step `./build.sh` in the above list of commands fails with the error `Makefile:1: /opt/devkitpro/devkitARM/base_tools: No such file or directory`, then try installing the pacman package `devkitarm-rules` by executing the command make compare
``` ## Notes
sudo dkp-pacman -S devkitarm-rules
```
Executing `./build.sh` again should now succeed. * If the base tools are not found on macOS in new Terminal sessions after the first successful build, run `echo "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" >> ~/.bash_profile` once to prevent the issue from occurring again. Verify that the `devkitarm-rules` package is installed as well; if not, install it by running `sudo dkp-pacman -S devkitarm-rules`.
# Faster builds * If the repository was previously set up using Cygwin, delete the `.exe` files in the subfolders of the `tools` folder except for `agbcc` and try building again. [Learn the differences between MSYS2 and Cygwin.](https://github.com/msys2/msys2/wiki/How-does-MSYS2-differ-from-Cygwin)
After the first build, subsequent builds are faster. You can further speed up the build: # Guidance
## Parallel build To build **pokeemerald.gba** with your changes:
This significantly speeds up the build on modern machines. make
By default `make` only runs a single thread. You can tell `make` to run on multiple threads with `make -j`. See the manfile for usage (`man make`). ## Parallel builds
The optimal value for `-j` is the number of logical cores on your machine. You can run `nproc` to see the exact number. See [the GNU docs](https://www.gnu.org/software/make/manual/html_node/Parallel.html) and [this Stack Exchange thread](https://unix.stackexchange.com/questions/208568) for more information.
``` To speed up building, run:
$ nproc
8
```
If you have 8 cores, run: `make -j8` make -j$(nproc)
`-j` on its own will spawn a new thread for each job. A clean build will have thousands of jobs, which will be slower than not using -j at all. `nproc` is not available on macOS. The alternative is `sysctl -n hw.ncpu` ([relevant Stack Overflow thread](https://stackoverflow.com/questions/1715580)).
## Disable the dependency scanning ## Building without dependency scanning
If you've only changed `.c` or `.s` files, you can turn off the dependency scanning temporarily. Changes to any other files will be ignored, and the build will either fail or not reflect those changes. If only `.c` or `.s` files were changed, turn off the dependency scanning temporarily. Changes to any other files will be ignored and the build will either fail or not reflect those changes.
`make NODEP=1` make NODEP=1
# Building with devkitARM's C compiler ## Building with devkitARM's C compiler
This project supports the `arm-none-eabi-gcc` compiler which ships with devkitARM r52. To build this target, simply run: This project supports the `arm-none-eabi-gcc` compiler included with devkitARM r52. To build this target, simply run:
make modern make modern
# Building with your own toolchain ## Building with other toolchains
To build Pokemon Emerald with a toolchain other than devkitARM, override the `TOOLCHAIN` environment variable with the path to your toolchain. Example: To build using a toolchain other than devkitARM, override the `TOOLCHAIN` environment variable with the path to your toolchain, which must contain the subdirectory `bin`.
make compare TOOLCHAIN=/usr/local/arm-none-eabi make TOOLCHAIN="/path/to/toolchain/here"
The path you pass to the `TOOLCHAIN` variable must contain the subdirectory `bin`. If you compile the `modern` target with this toolchain, the subdirectories `lib`, `include`, and `arm-none-eabi` must also be present. The following is an example:
# Building with debug info make TOOLCHAIN="/usr/local/arm-none-eabi"
To build the ELF file with enhanced debug info, use the `DINFO` variable: To compile the `modern` target with this toolchain, the subdirectories `lib`, `include`, and `arm-none-eabi` must also be present.
make compare DINFO=1 ## Building with debug info
To build **pokeemerald.elf** with enhanced debug info, use the `DINFO` variable.
make DINFO=1
README.md
+23 -25
View File
@@ -2,37 +2,35 @@
[![Build Status][travis-badge]][travis] [![Build Status][travis-badge]][travis]
This is a disassembly of Pokémon Emerald. [travis]: https://travis-ci.org/pret/pokeemerald
[travis-badge]: https://travis-ci.org/pret/pokeemerald.svg?branch=master
It builds the following rom: This is a decompilation of Pokémon Emerald.
* pokeemerald.gba `sha1: f3ae088181bf583e55daf962a92bb46f4f1d07b7` It builds the following ROM:
* [**pokeemerald.gba**](https://datomatic.no-intro.org/index.php?page=show_record&s=23&n=1961) `sha1: f3ae088181bf583e55daf962a92bb46f4f1d07b7`
To set up the repository, see [INSTALL.md](INSTALL.md). To set up the repository, see [INSTALL.md](INSTALL.md).
## See also ## See also
* Disassembly of [**Pokémon Red/Blue**][pokered] Other disassembly and/or decompilation projects:
* Disassembly of [**Pokémon Yellow**][pokeyellow] * [**Pokémon Red and Blue**](https://github.com/pret/pokered)
* Disassembly of [**Pokémon Gold**][pokegold] * [**Pokémon Gold and Silver (Space World '97 demo)**](https://github.com/pret/pokegold-spaceworld)
* Disassembly of [**Pokémon Crystal**][pokecrystal] * [**Pokémon Yellow**](https://github.com/pret/pokeyellow)
* Disassembly of [**Pokémon Pinball**][pokepinball] * [**Pokémon Trading Card Game**](https://github.com/pret/poketcg)
* Disassembly of [**Pokémon TCG**][poketcg] * [**Pokémon Pinball**](https://github.com/pret/pokepinball)
* Disassembly of [**Pokémon Ruby**][pokeruby] * [**Pokémon Stadium**](https://github.com/pret/pokestadium)
* Disassembly of [**Pokémon Fire Red**][pokefirered] * [**Pokémon Gold and Silver**](https://github.com/pret/pokegold)
* Discord: [**pret**][Discord] * [**Pokémon Crystal**](https://github.com/pret/pokecrystal)
* irc: **irc.freenode.net** [**#pret**][irc] * [**Pokémon Ruby and Sapphire**](https://github.com/pret/pokeruby)
* [**Pokémon Pinball: Ruby & Sapphire**](https://github.com/pret/pokepinballrs)
* [**Pokémon FireRed and LeafGreen**](https://github.com/pret/pokefirered)
* [**Pokémon Mystery Dungeon: Red Rescue Team**](https://github.com/pret/pmd-red)
[pokered]: https://github.com/pret/pokered
[pokeyellow]: https://github.com/pret/pokeyellow ## Contacts
[pokegold]: https://github.com/pret/pokegold
[pokecrystal]: https://github.com/pret/pokecrystal You can find us on [Discord](https://discord.gg/6EuWgX9) and [IRC](https://kiwiirc.com/client/irc.freenode.net/?#pret).
[pokepinball]: https://github.com/pret/pokepinball
[poketcg]: https://github.com/pret/poketcg
[pokeruby]: https://github.com/pret/pokeruby
[pokefirered]: https://github.com/pret/pokefirered
[Discord]: https://discord.gg/6EuWgX9
[irc]: https://kiwiirc.com/client/irc.freenode.net/?#pret
[travis]: https://travis-ci.org/pret/pokeemerald
[travis-badge]: https://travis-ci.org/pret/pokeemerald.svg?branch=master