Linux 編譯教學

約 624 字大約 2 分鐘

本教學需要讀者具備一定的 Linux 環境配置能力與程式設計基礎！ 若您僅希望直接安裝 MAA 而非自行編譯，請參閱用戶手冊 - Linux 模擬器與容器。

注意

MAA 的建置方法仍在討論中，本教學內容可能過時，請以 GitHub workflow file 中的腳本為準。
您也可以參考 AUR PKGBUILD 或 nixpkgs。

相關信息

Mac 使用者可以使用 tools/build_macos_universal.zsh 腳本進行編譯。
建議參考 MaaAssistantArknights/MaaMacGui 專案的 README.md。

編譯過程

下載編譯所需的依賴項目
Ubuntu/Debian
```
sudo apt install cmake
```
Arch
```
sudo pacman -S --needed cmake
```
建置第三方函式庫
可以選擇下載預編譯的函式庫，或從原始碼編譯。
- 下載預編譯的第三方函式庫（推薦）
  注
  ~~先前提供的動態連結庫是在較新的 Linux 發行版 (Ubuntu 22.04) 中編譯的，若您的系統 libstdc++ 版本較舊，可能會遇到 ABI 不相容的問題。~~
  目前已透過交叉編譯降低了執行環境要求，僅需相依於 glibc 2.31 (Ubuntu 20.04)。
```
python tools/maadeps-download.py
```
如果您發現上述預編譯庫因 ABI 版本等原因無法在您的系統執行，且不打算使用容器等方案，也可以嘗試自行編譯。
- 自行建置第三方函式庫（耗時較長）
```
git clone https://github.com/MaaAssistantArknights/MaaDeps
cd MaaDeps
# 若系統環境版本過低無法使用我們預設提供的 LLVM 20，請考慮不使用交叉編譯，直接使用在地編譯環境。
# 需調整 src/MaaUtils/MaaDeps/cmake 中的 toolchain 設定。
python linux-toolchain-download.py
python build.py
```

編譯 MAA

cmake -B build \
    -DINSTALL_RESOURCE=ON \
    -DINSTALL_PYTHON=ON \
    -DCMAKE_TOOLCHAIN_FILE=src/MaaUtils/MaaDeps/cmake/maa-x64-linux-toolchain.cmake
cmake --build build

將 MAA 安裝到目標路徑。請注意，MAA 建議透過指定 LD_LIBRARY_PATH 來執行，請勿使用管理員權限將 MAA 安裝至 /usr 目錄。

目前應該不需指定 LD_LIBRARY_PATH 即可正常執行。

cmake --install build --prefix <target_directory>

若需針對 MaaFwAdbController（MaaFramework 觸控模式）相關功能進行除錯，需要自行編譯 MaaFramework 的 Debug 版本，將 libMaaAdbControlUnit.so 放到安裝目錄下。

整合文件

~~或許算不上文件~~

Python

可參考 Python demo 中 __main__ 中的實作方式。

C++

可參考 CppSample 中的實作方式。

C#

可參考 MaaWpfGui 中的實作方式。