Build#
RetroArcher binaries are built using pyinstaller. Cross compilation is not supported. That means the binaries must be built on the target operating system and architecture.
Use Python 3.7+
Clone#
- Ensure git is installed and run the following:
git clone https://github.com/lizardbyte/retroarcher.git cd ./retroarcher
Setup venv#
It is recommended to setup and activate a venv within the retroarcher directory.
Install Python Requirements#
- Standard Requirements
python -m pip install -r requirements.txt
- Advanced Requirements
- Required for:
python -m pip install -r requirements-dev.txt
Tip
Advanced requirements include all of the standard dependencies contained in the requirements.txt
Compile Locales#
python ./scripts/_locale.py --compile
Install NPM Requirements#
npm install
mv -f ./node_modules/ ./web/
Compile Docs#
Docs are visible by the webapp and therefore must be compiled.
cd docs
make html
cd ..
Compile Binary#
python ./scripts/build.py
Remote Build#
It may be beneficial to build remotely in some cases. This will enable easier building on different operating systems.
Fork the project
Activate workflows
Trigger the CI workflow manually
Download the artifacts/binaries from the workflow run summary