Atmosphere/docs/building.md

28 lines
1.8 KiB
Markdown
Raw Normal View History

# Building Atmosphère
Building Atmosphère is a very straightforward process that relies almost exclusively on tools provided by the [devkitPro](https://devkitpro.org) organization.
## Dependencies
+ [devkitA64](https://devkitpro.org)
+ [devkitARM](https://devkitpro.org)
2020-10-10 02:37:51 +02:00
+ [Python 2](https://www.python.org) (Python 3 may work as well, but this is not guaranteed)
2020-04-27 19:40:22 +02:00
+ [PyCryptodome](https://pypi.org/project/pycryptodome) (optional)
## Instructions
2020-04-27 19:40:22 +02:00
1. Follow the guide located [here](https://devkitpro.org/wiki/Getting_Started) to install and configure all the tools necessary for the build process.
2020-04-27 19:40:22 +02:00
2. Install the following packages via (dkp-)pacman:
2020-04-27 19:52:53 +02:00
+ `switch-dev`
+ `switch-libjpeg-turbo`
+ `devkitARM`
+ `devkitarm-rules`
2020-04-27 19:40:22 +02:00
3. (Optional) In order to build [sept](components/sept.md) 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 the `make dist` recipe. This is an optional step included for advanced users who have the ability to provide the necessary encryption/signing keys themselves.
2020-04-27 19:40:22 +02:00
4. It is, instead, possible to build [sept](components/sept.md) 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:
2020-04-27 19:52:53 +02:00
+ `SEPT_00_ENC_PATH` (must point to the `sept-secondary_00.enc` file)
+ `SEPT_01_ENC_PATH` (must point to the `sept-secondary_01.enc` file)
+ `SEPT_DEV_00_ENC_PATH` (must point to the `sept-secondary_dev_00.enc` file)
+ `SEPT_DEV_01_ENC_PATH` (must point to the `sept-secondary_dev_01.enc` file)
2020-04-27 19:40:22 +02:00
5. Finally, clone the Atmosphère repository and run `make` under its root directory.