macOS

Prerequisites

1. Make sure cargo and Xcode are installed. Run cargo -V in the terminal to check. If not installed, click here to follow the installation steps.
2. Download the source code from GitHub:
   • Using git, run git clone https://github.com/TeamFlos/phira.git in the terminal to clone the repository.
   • Alternatively, on the Phira repository page, click the Code button, select Download ZIP, and extract to any local directory.
   • If you cannot connect to GitHub, you may use a Git mirror/accelerator to clone or download.
   • To build a specific version of Phira, go to the release page, download Source code (tar.gz) from Assets, and extract to any path.
   • Warning: To avoid unexpected issues, we recommend the path not contain any characters outside ASCII.
3. For the static library files, download from ESA or EdgeOne. After downloading, extract directly to the project root directory. If prompted to overwrite files, click overwrite.

Building

1. Open the terminal and navigate to the project root directory.
2. Run cargo build -r --bin phira-main and wait for compilation to finish.
3. Copy all files from the ./assets/ directory to ./target/release/assets/. The build process is now complete. You can run phira-main to verify that the resource files are intact.

• Note: At the time this document was written, the resource files in the code directory are incomplete. If the main program crashes on startup, go to the release page and download any version's Windows or Linux archive to get the missing resource files.

Troubleshooting

Q. Build output: failed to connect to GitHub

A. Check your network environment, or download prpr-miniquad, prpr-macroquad, sasa and phira-mp locally, then specify their paths in Cargo.toml (e.g., prpr-miniquad = { path = "../../prpr-miniquad" }) and rebuild.

Other issues, please supplement.