Linux Compilation Tutorial

This tutorial requires readers to have some Linux environment configuration ability and programming foundation! If you only want to directly install MAA instead of compiling it yourself, please read User Manual - Linux Emulators and Containers.

::: info Note MAA's build method is still under discussion. The content of this tutorial may be outdated. Please refer to the scripts in GitHub workflow file.
You can also refer to AUR PKGBUILD or nixpkgs. :::

::: info Mac can use the tools/build_macos_universal.zsh script for compilation. It's recommended to refer to the README.md of the MaaAssistantArknights/MaaMacGui project. :::

Compilation Process

Download compilation dependencies
- Ubuntu/Debian
bash
```
sudo apt install cmake
```
- Arch Linux
bash
```
sudo pacman -S --needed cmake
```
Build third-party libraries

You can choose to download pre-built dependency libraries or compile from scratch
- Download pre-built third-party libraries (recommended)
  
  Note ~~Contains dynamic libraries compiled on relatively new Linux distributions (Ubuntu 22.04). If your system's libstdc++ version is older, you may encounter ABI incompatibility issues.~~ After introducing cross compiling to lower the runtime requirement, only glibc 2.31 (aka. ubuntu 20.04) is required now.
  bash
```
python tools/maadeps-download.py
```
If you find the libraries downloaded above cannot run on your system due to ABI version issues and you don't want to use container solutions, you can also try compiling from scratch
- Build third-party libraries from scratch (will take considerable time)
  bash
```
git clone https://github.com/MaaAssistantArknights/MaaDeps
cd MaaDeps
# If the system is too old to use our prebuilt llvm 20, please consider using local build enviroment instead of cross compiling.
# The toolchain config under src/MaaUtils/MaaDeps/cmake needs to be modified.
python linux-toolchain-download.py
python build.py
```
Compile MAA
bash
```
cmake -B build \
    -DINSTALL_RESOURCE=ON \
    -DINSTALL_PYTHON=ON \
    -DCMAKE_TOOLCHAIN_FILE=src/MaaUtils/MaaDeps/cmake/maa-x64-linux-toolchain.cmake
cmake --build build
```
To install MAA to target location, note that MAA is recommended to run by specifying LD_LIBRARY_PATH, don't use administrator privileges to install MAA into /usr

Now it shall be able to run without specifying LD_LIBRARY_PATH
bash
```
cmake --install build --prefix <target_directory>
```
To debug MaaFwAdbController (MaaFramework touch mode) features, you need to compile the Debug version of MaaFramework yourself and put libMaaAdbControlUnit.so in the installation directory.

Integration Documentation

~~Perhaps not really documentation~~

Python

You can refer to the implementation of __main__ in Python demo

C++

You can refer to the implementation in CppSample

C#

You can refer to the implementation in MaaWpfGui