Linux 지원

1분 미만

Linux 지원

준비 작업

다음중 하나의 설치 방법을 선택하세요.

maa-cli 사용

maa-cli는 Rust로 작성된 간단한 MAA 커맨드 라인 도구입니다. 관련 설치 및 사용 방법은 CLI 가이드를 참조하세요.

Python 사용

1. MAA 동적 라이브러리 설치

MAA 공식 웹사이트에서 리눅스 라이브러리를 다운로드하고 압축을 풉니다. 혹은 소프트웨어 저장소에서 설치합니다:
- AUR：maa-assistant-arknights을 설치한 후에 설치 지침에 따라 파일을 편집합니다.
- Nixpkgs: maa-assistant-arknights
./MAA-v{버전}-linux-{아키텍처}/Python/ 폴더로 이동하여 sample.py 파일을 엽니다.

팁

사전 컴파일된 버전은 상대적으로 최신 버전의 리눅스 배포판 (Ubuntu 22.04)에서 컴파일된 동적 라이브러리를 포함하고 있습니다. 시스템의 libstdc++ 버전이 오래되어 ABI 호환성 문제가 발생할 수 있습니다. Linux 컴파일 가이드를 참조하여 다시 컴파일하거나 컨테이너를 실행할 수 있습니다.

2. `adb` 구성

if asst.connect('adb.exe', '127.0.0.1:5554'): 줄을 찾습니다.
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를 입력합니다.
에뮬레이터의 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"):
```
이제 테스트를 진행해볼 수 있습니다: $ python3 sample.py를 실행한 후 연결 성공이 표시되면 대부분의 작업이 완료된 것입니다.

3. 작업 설정

사용자 정의 작업: 통합 문서를 참조하고, sample.py의 # 작업 및 매개 변수는 예제를 참조해 줄을 수정하세요.

모바일 시뮬레이터 지원

✅ AVD

필수 구성: 16:9 비율의 화면 해상도이며 해상도는 720p보다 커야 합니다.

권장 구성: MAA의 리눅스 x64 동적 라이브러리와 함께 x86_64 프레임워크 (R - 30 - x86_64 - Android 11.0) 사용

참고: Android 10 이상에서는 SELinux가 Enforcing 모드인 경우 Minitouch를 사용할 수 없습니다. 다른 터치 모드로 전환하거나 SELinux를 임시로 Permissive 모드로 전환하세요.

⚠️ Genymotion

상위 안드로이드 버전에는 x86_64 프레임워크가 기본으로 포함되어 있습니다. 가볍지만 Arknights를 실행하는 동안 종종 비정상 종료됩니다.

엄격한 테스트가 아직 진행되지 않았으며 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에 입력하세요.

amdgpu를 사용하는 경우 screencap 명령이 stderr에 정보를 출력하여 이미지 디코딩이 실패할 수 있습니다. adb exec-out screencap | xxd | head를 실행하여 출력에 /vendor/etc/hwdata/amdgpu.ids: No such file...와 같은 텍스트가 있는지 확인하세요. resource/config.json 파일에서 스크린샷 명령을 adb exec-out 'screencap 2>/dev/null'로 변경해보세요.

✅ redroid

안드로이드 11 버전 이미지는 게임을 정상적으로 실행합니다. 5555 adb 포트를 공개해야 합니다.