跳至主要內容

Linux 模擬器支援

大约 3 分鐘

Linux 模擬器支援

準備工作

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

使用 maa-cli

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

使用 Python

1. 安裝 MAA 動態庫

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

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

提示

預編譯的版本包含在相對較新的 Linux 發行版 (Ubuntu 22.04) 中編譯的動態庫，如果您系統中的 libstdc++ 版本較老，可能遇到 ABI 不兼容的問題
可以參考 2.1-Linux編譯教學 重新編譯或使用容器執行

2. adb 配置

  1. 找到 if asst.connect('adb.exe', '127.0.0.1:5554'):open in new window 一欄

  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. 任務配置

自定義任務： 根據需要參考 3.x 集成文件open in new window 對 sample.py 的 # 任務及參數請參考 docs/集成文件.mdopen in new window 一欄進行修改

模擬器支援

✅ AVDopen in new window

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

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

⚠️ Genymotionopen in new window

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

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

容器化安卓的支援

提示

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

✅ Waydroidopen in new window

安裝後需要重新設定解析度（或者大於 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 一欄。

✅ redroidopen in new window

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