mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-18 18:20:39 +08:00
f2ab4946ce
* ci: use lychee to check dead links * ci: comment on PR when dead links are found * docs: fix broken links
101 lines
3.9 KiB
Markdown
101 lines
3.9 KiB
Markdown
---
|
||
order: 3
|
||
icon: teenyicons:linux-alt-solid
|
||
---
|
||
# Linux 模擬器與容器
|
||
|
||
## 準備工作
|
||
|
||
以下安裝方式任選其一即可：
|
||
|
||
### 使用 maa-cli
|
||
|
||
[maa-cli](https://github.com/MaaAssistantArknights/maa-cli) 是一個使用 Rust 編寫的簡單 MAA 命令列工具。相關安裝與使用教程請閱讀[CLI 使用指南](../cli)。
|
||
|
||
### 使用 Python
|
||
|
||
#### 1. 安裝 MAA 動態庫
|
||
|
||
1. 在 [MAA 官網](https://maa.plus/) 下載 Linux 動態庫並解壓，或從軟體源安裝：
|
||
|
||
- AUR：[maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)，按照安裝後的提示編輯檔案
|
||
- Nixpkgs: [maa-assistant-arknights](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix)
|
||
|
||
2. 進入 `./MAA-v{版本號}-linux-{架構}/Python/` 目錄下打開 `sample.py` 文件
|
||
|
||
::: tip
|
||
預編譯的版本包含在相對較新的 Linux 發行版 (Ubuntu 22.04) 中編譯的動態庫，如果您系統中的 libstdc++ 版本較老，可能遇到 ABI 不兼容的問題
|
||
可以參考 [Linux編譯教學](../../develop/linux-tutorial.md) 重新編譯或使用容器執行
|
||
:::
|
||
|
||
#### 2. `adb` 配置
|
||
|
||
1. 找到 [`if asst.connect('adb.exe', '127.0.0.1:5554'):`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L48) 一欄
|
||
|
||
2. `adb` 工具調用
|
||
|
||
- 如果模擬器使用 `Android Studio` 的 `avd` ，其內建 `adb` 。可以直接在 `adb.exe` 一欄填寫 `adb` 路徑，一般在 `$HOME/Android/Sdk/platform-tools/` 裡面可以找到，例如：
|
||
|
||
```python
|
||
if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "模擬器的 adb 地址"):
|
||
```
|
||
|
||
- 如果使用其他模擬器須先下載 `adb` ： `$ sudo apt install adb` 後填寫路徑或利用 `PATH` 環境變量直接填寫 `adb` 即可
|
||
|
||
3. 模擬器 `adb` 路徑獲取
|
||
|
||
- 可以直接使用 adb 工具： `$ adb路徑 devices` ，例如：
|
||
|
||
```shell
|
||
$ /home/foo/Android/Sdk/platform-tools/adb devices
|
||
List of devices attached
|
||
emulator-5554 device
|
||
```
|
||
|
||
- 返回的 `emulator-5554` 就是模擬器的 adb 地址，覆蓋掉 `127.0.0.1:5555` ，例如：
|
||
|
||
```python
|
||
if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):
|
||
```
|
||
|
||
4. 這時候可以測試下： `$ python3 sample.py` ，如果返回 `連接成功` 則基本成功了
|
||
|
||
#### 3. 任務配置
|
||
|
||
自定義任務： 根據需要參考 [集成文件](../../protocol/integration.md) 對 `sample.py` 的 [`# 任務及參數請參考 docs/集成文件.md`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 一欄進行修改
|
||
|
||
## 模擬器支援
|
||
|
||
### ✅ [AVD](https://developer.android.com/studio/run/managing-avds)
|
||
|
||
必選配置： 16:9 的螢幕解析度，且解析度需大於 720p
|
||
|
||
推薦配置： x86\_64 的框架 (R - 30 - x86\_64 - Android 11.0) 配合 MAA 的 Linux x64 動態庫
|
||
|
||
### ⚠️ [Genymotion](https://www.genymotion.com/)
|
||
|
||
高版本安卓內建 x86\_64 框架，輕量但是執行明日方舟時易閃退
|
||
|
||
暫未嚴格測試， adb 功能和路徑獲取沒有問題
|
||
|
||
## 容器化安卓的支援
|
||
|
||
::: tip
|
||
以下方案通常對核心模組有一定要求，請根據具體方案和發行版安裝合適的核心模組
|
||
:::
|
||
|
||
### ✅ [Waydroid](https://waydro.id/)
|
||
|
||
安裝後需要重新設定解析度（或者大於 720P 且為 16:9 的解析度，然後重新啟動）：
|
||
|
||
```shell
|
||
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](https://github.com/remote-android/redroid-doc)
|
||
|
||
安卓 11 版本的鏡像可正常執行遊戲，需要暴露 5555 adb 通訊埠.
|