* Add lz4 dependency to the build instructions At build-time of exosphere, the `split_program.py` script is called. It requires python module `lz4` -> https://github.com/Atmosphere-NX/Atmosphere/blob/master/exosphere/program/split_program.py Adding lz4 to the building.md documentation. * Remove "(Python Library)" from deps-entries
2.0 KiB
Building Atmosphère
Building Atmosphère is a very straightforward process that relies almost exclusively on tools provided by the devkitPro organization.
Dependencies
- devkitA64
- devkitARM
- Python 2 (Python 3 may work as well, but this is not guaranteed)
- LZ4
- PyCryptodome (optional)
Instructions
-
Follow the guide located here to install and configure all the tools necessary for the build process.
-
Install the following packages via (dkp-)pacman:
switch-dev
switch-glm
switch-libjpeg-turbo
devkitARM
devkitarm-rules
-
Install the following library via python's package manager
pip
, required by exosphere:lz4
-
(Optional) In order to build sept the pycryptodome PyPi package is required, which can be installed by running
pip install pycryptodome
under the installed Python environment of your choice or by installing the complete zip package to support themake dist
recipe. This is an optional step included for advanced users who have the ability to provide the necessary encryption/signing keys themselves. -
It is, instead, possible to build sept by providing previously encrypted/signed binaries distributed by official Atmosphère release packages. In order to do so, export the following variables in your current environment:
SEPT_00_ENC_PATH
(must point to thesept-secondary_00.enc
file)SEPT_01_ENC_PATH
(must point to thesept-secondary_01.enc
file)SEPT_DEV_00_ENC_PATH
(must point to thesept-secondary_dev_00.enc
file)SEPT_DEV_01_ENC_PATH
(must point to thesept-secondary_dev_01.enc
file)
-
Finally, clone the Atmosphère repository and run
make
under its root directory.