MaaAssistantArknights/docs/zh-cn/manual/device/linux.md

order, icon

order	icon
3	teenyicons:linux-alt-solid

Linux 模拟器与容器

准备工作

以下安装方式任选其一即可：

使用 maa-cli

maa-cli 是一个使用 Rust 编写的简单 MAA 命令行工具。相关安装与使用教程请阅读 CLI 使用指南。

使用 Wine

MAA WPF GUI 当前可以通过 Wine 运行。

安装步骤

1. 前往 .NET 发布页下载并安装 Windows 版 .NET 桌面运行时。

2. 下载 Windows 版 MAA，解压后运行 wine MAA.exe。

::: info 注意 需要在连接设置中将 ADB 路径设置为 Windows 版 adb.exe。

如果您需要通过 ADB 连接 USB 设备，请先在 Wine 外运行 adb start-server，即通过 Wine 连接原生 ADB server。 :::

使用 Linux 原生 MaaCore（实验性功能）

下载 MAA Wine Bridge 源码并构建，用生成的 MaaCore.dll（ELF 文件）替换 Windows 版本，并将 Linux 原生动态库（libMaaCore.so 以及依赖）放在同一目录下。

此时通过 Wine 运行 MAA.exe，将会加载 Linux 原生动态库。

::: info 注意 使用 Linux 原生 MaaCore 时，需要在连接设置中将 ADB 路径设置为 Linux 原生 ADB。 :::

Linux 桌面整合（实验性功能）

桌面整合提供原生桌面通知支持，以及将 fontconfig 字体配置映射到 WPF 的功能。

将 MAA Wine Bridge 生成的 MaaDesktopIntegration.so 放到 MAA.exe 同目录下即可启用。

已知问题

• Wine DirectWrite 强制启用 hinting，并且不将 DPI 传递给 FreeType，导致字体显示效果不佳。
• 不使用原生桌面通知时，弹出通知会抢占全系统鼠标焦点，导致无法操作其他窗口。可以通过 winecfg 启用虚拟桌面模式缓解，或禁用桌面通知。
• Wine-staging 用户需要关闭 winecfg 中的 隐藏 Wine 版本 选项，以便 MAA 正确检测 Wine 环境。
• Wine 的 Light 主题会导致 WPF 中部分文字颜色异常，建议在 winecfg 中切换到无主题（Windows 经典主题）。
• Wine 使用旧式 XEmbed 托盘图标，在 GNOME 下可能无法正常工作。
• 使用 Linux 原生 MaaCore 时暂不支持自动更新（更新程序：我寻思我应该下载个 Windows 版）

使用 Python

1. 安装 MAA 动态库

1. 在 MAA 官网 下载 Linux 动态库并解压，或从软件源安装：

   • AUR：maa-assistant-arknights，按照安装后的提示编辑文件
   • Nixpkgs: maa-assistant-arknights

2. 进入 ./MAA-v{版本号}-linux-{架构}/Python/ 目录下打开 sample.py 文件

::: tip 预编译的版本包含在相对较新的 Linux 发行版 (Ubuntu 22.04) 中编译的动态库，如果您系统中的 libstdc++ 版本较老，可能遇到 ABI 不兼容的问题 可以参考 Linux 编译教程 重新编译或使用容器运行 :::

2. ADB 配置

1. 找到 if asst.connect('adb.exe', '127.0.0.1:5554'): 一栏

2. ADB 工具调用

   • 如果模拟器使用 Android Studio 的 avd ，其自带 ADB 。可以直接在 adb.exe 一栏填写 ADB 路径，一般在 $HOME/Android/Sdk/platform-tools/ 里面可以找到，例如：

   if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "模拟器的 ADB 地址"):
   

   • 如果使用其他模拟器须先下载 ADB ： $ sudo apt install adb 后填写路径或利用 PATH 环境变量直接填写 adb 即可。

3. 模拟器 ADB 路径获取

   • 可以直接使用 ADB 工具： $ adb路径 devices ，例如：

   $ /home/foo/Android/Sdk/platform-tools/adb devices
   List of devices attached
   emulator-5554 device
   

   • 返回的 emulator-5554 就是模拟器的 ADB 地址，覆盖掉 127.0.0.1:5555 ，例如：

   if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):
   

4. 这时候可以测试下： $ python3 sample.py ，如果返回 连接成功 则基本成功了。

3. 任务配置

自定义任务： 根据需要参考 集成文档 对 sample.py 的 # 任务及参数请参考 docs/integration.md 一栏进行修改

模拟器支持

✅ AVD

必选配置： 16:9 的屏幕分辨率，且分辨率需大于 720p

推荐配置： x86_64 的框架 (R - 30 - x86_64 - Android 11.0) 配合 MAA 的 Linux x64 动态库

注意：从 Android 10 开始，Minitouch 在 SELinux 为 Enforcing 模式时不再可用，请切换至其他触控模式，或将 SELinux 临时切换为 Permissive 模式。

⚠️ Genymotion

高版本安卓自带 x86_64 框架，轻量但是运行明日方舟时易闪退

暂未严格测试， ADB 功能和路径获取没有问题

容器化安卓的支持

::: tip 以下方案通常对内核模块有一定要求, 请根据具体方案和发行版安装合适的内核模块 :::

✅ Waydroid

安装后需要重新设置分辨率（或者大于 720P 且为 16:9 的分辨率，然后重新启动）：

waydroid prop set persist.waydroid.width 1280
waydroid prop set persist.waydroid.height 720

设置 ADB 的 IP 地址：打开 设置 - 关于 - IP地址 ，记录第一个 IP ，将 ${记录的IP}:5555 填入sample.py 的 adb IP 一栏。

如果使用 amdgpu, screencap 命令可能向 stderr 输出信息导致图片解码失败. 可以运行 adb exec-out screencap | xxd | head 并检查输出中是否有类似 /vendor/etc/hwdata/amdgpu.ids: No such file... 的文本来确认这一点. 尝试将 resource/config.json 中的截图命令由 adb exec-out screencap 改为 adb exec-out 'screencap 2>/dev/null'.

✅ redroid

安卓 11 版本的镜像可正常运行游戏, 需要暴露 5555 ADB 端口.