linux 编译教程

本教程需要读者有一定的 linux 环境配置能力及编程基础！，若您仅希望直接安装MAA而非自行编译，请阅读用户手册 - linux 模拟器与容器。

注意

MAA 的构建方法仍在讨论中, 本教程的内容可能过时, 请以 GitHub workflow file 中的脚本为准。也可参考 AUR PKGBUILD、nixpkgs。

相关信息

Mac 可以使用 tools/build_macos_universal.zsh 脚本进行编译。建议参考 MaaAssistantArknights/MaaMacGui 项目的 README.md。

编译过程

1. 下载编译所需的依赖

   • Ubuntu/Debian

   sudo apt install gcc-12 g++-12 cmake zlib1g-dev

2. 构建第三方库

   可以选择下载预构建的依赖库或从头进行编译

   • 下载预构建的第三方库 (推荐的)

     Note
     包含在相对较新的 linux 发行版 (Ubuntu 22.04) 中编译的动态库, 如果您系统中的 libstdc++ 版本较老, 可能遇到 ABI 不兼容的问题.

     python maadeps-download.py

   如果您发现上面的方法下载的库由于 ABI 版本等原因无法在您的系统上运行且不希望使用容器等方案, 也可以尝试从头编译

   • 自行构建第三方库 (将花费较长时间)

     git submodule update --init --recursive
     cd MaaDeps
     python build.py

3. 编译 MAA

   CC=gcc-12 CXX=g++-12 cmake -B build \
       -DINSTALL_THIRD_LIBS=ON \
       -DINSTALL_RESOURCE=ON \
       -DINSTALL_PYTHON=ON
   cmake --build build

   来将 MAA 安装到目标位置, 注意 MAA 推荐通过指定 LD_LIBRARY_PATH 来运行, 不要使用管理员权限将 MAA 装入 /usr

   cmake --install build --prefix <target_directory>

集成文档

或许算不上文档

Python

可参考 Python demo 中 __main__ 的实现

C++

可参考 CppSample 中的实现

C Sharp

可参考 MaaWpfGui 中的实现