MAA跨平台支持：Windows/Linux/macOS全平台部署指南

MAA（MaaAssistantArknights）作为一款功能强大的明日方舟游戏小助手，提供了全面的跨平台支持，覆盖Windows、Linux和macOS三大主流操作系统。本文将详细介绍各平台的安装部署流程、兼容性配置及常见问题解决方案，帮助用户在不同系统环境下高效使用MAA。

跨平台架构概览

MAA采用模块化设计实现跨平台兼容，核心功能通过C++编写并封装为动态链接库，上层提供多语言绑定和图形界面适配。项目架构如图所示：

graph TD
    A[MAA Core] --> B[Windows DLL]
    A --> C[Linux SO]
    A --> D[macOS DYLIB]
    B --> E[WPF GUI]
    C --> F[CLI Interface]
    D --> G[macOS App Bundle]
    E & F & G --> H[统一功能接口]

核心组件路径：

• 跨平台核心库：src/MaaCore/
• 平台适配层：src/MaaWpfGui/（Windows）、src/MaaMacGui/（macOS）

Windows平台部署

系统要求

• 操作系统：Windows 10/11（64位）
• 依赖组件：.NET Framework 4.8、DirectX 11

安装流程

1. 从官方仓库下载最新Windows安装包
2. 运行安装程序，勾选"添加到系统PATH"选项
3. 安装完成后自动创建桌面快捷方式

图形界面启动

# 通过开始菜单或桌面快捷方式启动MaaWpfGui
# 或使用命令行启动
cd "C:\Program Files\MaaAssistantArknights"
MaaWpfGui.exe

GPU加速配置

MAA在Windows平台支持DirectML加速，相关配置文件路径：

• src/MaaCore/Config/Resource.json
• 默认已启用GPU加速，如需禁用可删除安装目录下的DirectML.dll

Linux平台部署

系统要求

• 发行版：Ubuntu 20.04+/Debian 11+/Arch Linux
• 依赖库：libopencv-dev、libssl-dev、cmake

编译安装

# 1. 安装依赖
sudo apt install cmake python3 # Ubuntu/Debian
# 或
sudo pacman -S --needed cmake python3 # Arch Linux

# 2. 下载依赖库
python tools/maadeps-download.py

# 3. 编译MAA
cmake -B build \
    -DINSTALL_RESOURCE=ON \
    -DINSTALL_PYTHON=ON \
    -DCMAKE_TOOLCHAIN_FILE=MaaDeps/cmake/maa-x64-linux-toolchain.cmake
cmake --build build

# 4. 安装到指定目录
cmake --install build --prefix ~/maa-install

命令行运行

# 基本使用
cd ~/maa-install
./maa-cli --config tasks.json

# 后台运行模式
nohup ./maa-cli --config arknights-tasks.json > maa.log 2>&1 &

容器化部署

对于服务器环境，推荐使用Docker容器运行：

# 构建镜像
docker build -t maa-linux -f tools/AppImage/Dockerfile .

# 运行容器
docker run -d --name maa-instance maa-linux

macOS平台部署

系统要求

• 操作系统：macOS 12+（Monterey及以上）
• Xcode Command Line Tools

编译流程

MAA提供专用编译脚本tools/build_macos_universal.zsh，支持生成Universal二进制：

# 1. 安装Xcode命令行工具
xcode-select --install

# 2. 运行编译脚本
chmod +x tools/build_macos_universal.zsh
./tools/build_macos_universal.zsh

# 3. 生成XCFramework
cd build
xcodebuild -create-xcframework -library libMaaCore.dylib -headers ../include -output MaaCore.xcframework

应用打包

编译完成后可生成macOS应用 bundle：

# 创建应用目录结构
mkdir -p MaaAssistantArknights.app/Contents/MacOS
cp build/libMaaCore.dylib MaaAssistantArknights.app/Contents/MacOS
cp src/MaaMacGui/Info.plist MaaAssistantArknights.app/Contents/

签名与公证

对于分发需求，需进行代码签名：

codesign --deep --force --sign "Developer ID Application" MaaAssistantArknights.app
xcrun altool --notarize-app --primary-bundle-id "com.maa.assistant" --username "your-apple-id" --password "@keychain:Developer-altool" --file MaaAssistantArknights.app.zip

跨平台兼容性对比

功能特性	Windows	Linux	macOS
图形界面	✅ WPF	✅ CLI/第三方GUI	✅ Cocoa
GPU加速	✅ DirectML	✅ OpenCL	✅ Metal
自动更新	✅ 内置	❌ 需手动	✅ 内置
多开支持	✅ 完全支持	✅ 完全支持	✅ 有限支持
模拟器集成	✅ 全支持	✅ 部分支持	⚠️ 实验性

跨平台开发指南

代码规范

跨平台代码需遵循以下规范：

1. 文件路径统一使用/分隔符
2. 系统调用通过src/MaaCore/Utils/Platform.hpp封装
3. 配置文件使用JSON格式，存放于src/MaaCore/Config/

编译系统

项目采用CMake管理跨平台构建，关键配置文件：

• CMakeLists.txt：主构建脚本
• cmake/macos.cmake：macOS特定配置
• cmake/utils.cmake：跨平台工具函数

第三方依赖管理

使用tools/maadeps-download.py统一管理依赖：

# 下载特定平台依赖
python tools/maadeps-download.py x64-linux # Linux
python tools/maadeps-download.py x64-osx   # macOS

常见问题解决

跨平台数据同步

可通过以下方式同步配置和任务数据：

# 使用符号链接同步配置文件（Linux/macOS）
ln -s ~/Dropbox/MAA/config ~/.config/maa/config

性能优化建议

1. Linux平台启用hugepages：

sudo sysctl -w vm.nr_hugepages=1024

2. macOS平台调整能量设置：

pmset -a standby 0

总结与展望

MAA通过精心设计的跨平台架构，实现了在Windows、Linux和macOS系统上的一致功能体验。未来版本将进一步优化：

1. Linux图形界面完善
2. macOS模拟器兼容性提升
3. WebAssembly版本开发（实验性）

项目开发文档：docs/zh-cn/develop/ 问题反馈：GitHub Issues

---

文档版本：v5.2.0
最后更新：2025-09-24
贡献者：MAA开发团队

本文档遵循CC BY-SA 4.0协议，欢迎转载但需保留署名