準備工作

以下安裝方式任選其一即可：

使用 maa-cli

maa-cli 是一個使用 Rust 編寫的簡單 MAA 命令列工具。相關安裝與使用教程請閱讀CLI 使用指南。

使用 Python

1. 安裝 MAA 動態庫

1. 在 MAA 官網 下載 Linux 動態庫並解壓，或從軟體源安裝：

   • AUR：maa-assistant-arknights，按照安裝後的提示編輯檔案
   • Nixpkgs: maa-assistant-arknights

2. 進入 ./MAA-v{版本號}-linux-{架構}/Python/ 目錄下打開 sample.py 文件

提示

預編譯的版本包含在相對較新的 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/集成文件.md 一欄進行修改

模擬器支援

AVD

必選配置： 16:9 的螢幕解析度，且解析度需大於 720p

推薦配置： x86_64 的框架 (R - 30 - x86_64 - Android 11.0) 配合 MAA 的 Linux x64 動態庫

Genymotion

高版本安卓內建 x86_64 框架，輕量但是執行明日方舟時易閃退

暫未嚴格測試， adb 功能和路徑獲取沒有問題

容器化安卓的支援

提示

以下方案通常對核心模組有一定要求，請根據具體方案和發行版安裝合適的核心模組

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 一欄。

redroid

安卓 11 版本的鏡像可正常執行遊戲，需要暴露 5555 adb 通訊埠.