63e87aaabf
* docs: readme * docs: develop_ci-tutorial, development * docs: develop_documentation-guidelines * docs: develop_issue-bot-usage * docs: develop_linux-tutorial, overseas-client-adaptation * docs: develop_README, pr-tutorial * docs: develop_vsc-ext-tutorial * docs: manual_README, newbie * docs: manual_faq * docs: manual_connection * docs: manual_cli_config * docs: manual_cli_faq, install * docs: manual_cli_README, usage * docs: develop_development * docs: manual_device_README, macos * docs: manual_device_linux * docs: manual_device_windows * docs: manual_device_android * docs: manual_introduction README, reclamation-algorithm, recruit, rewards, startup, tools * docs: manual_introduction_others * docs: manual_introduction_credit * docs: manual_introduction_infrastructure * docs: manual_introduction_combat * docs: manual_introduction_copilot * docs: manual_introduction_integrated-strategy * docs: protocol_base-scheduling-schema, README, sss-schema * docs: protocol_remote-control-schema * docs: protocol_callback-schema * docs: protocol_copilot-schema * docs: protocol_task-schema * chore: update xmal * chore: 調整部分內容 * chore: 再次調整 README 跟 develop 資料夾下的所有文件內容 * chore: 調整 protocol 資料夾內的文件內容 * chore: 調整 manual 資料夾內的零散文件內容 * chore: 調整 cil 與 device 資料夾內的文件內容 * chore: 調整 introduction 資料夾內的文件內容 * chore: update xaml * chore: 再......再改一點什麼...... * chore: 補圖 * chore: 更改連結 * chore: 再改一點奇怪的東西
3.6 KiB
order, icon
| order | icon |
|---|---|
| 2 | teenyicons:linux-alt-solid |
Linux 編譯教學
本教學需要讀者具備一定的 Linux 環境配置能力與程式設計基礎！ 若您僅希望直接安裝 MAA 而非自行編譯，請參閱用戶手冊 - Linux 模擬器與容器。
::: info 注意
MAA 的建置方法仍在討論中，本教學內容可能過時，請以 GitHub workflow file 中的腳本為準。
您也可以參考 AUR PKGBUILD 或 nixpkgs。
:::
::: info
Mac 使用者可以使用 tools/build_macos_universal.zsh 腳本進行編譯。
建議參考 MaaAssistantArknights/MaaMacGui 專案的 README.md。
:::
編譯過程
:::: steps
-
下載編譯所需的依賴項目 ::: code-tabs @tab:active Ubuntu/Debian
sudo apt install cmake@tab Arch
sudo pacman -S --needed cmake:::
-
建置第三方函式庫
可以選擇下載預編譯的函式庫，或從原始碼編譯。
-
下載預編譯的第三方函式庫（推薦）
Note
先前提供的動態連結庫是在較新的 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> -
結束，您現在應該能在目錄下看到建置完成的檔案了。
::::
整合文件
Python
可參考 Python demo 中 __main__ 中的實作方式。
C++
可參考 CppSample 中的實作方式。
C Sharp
可參考 MaaWpfGui 中的實作方式。