Linux 에뮬레이터 및 컨테이너
약 373 단어약 1 분
준비 작업
다음중 하나의 설치 방법을 선택하세요.
maa-cli 사용
maa-cli는 Rust로 작성된 간단한 MAA 커맨드 라인 도구입니다. 관련 설치 및 사용 방법은 CLI 가이드를 참조하세요.
Wine 사용
MAA WPF GUI는 현재 Wine을 통해 실행할 수 있습니다. MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포).
설치 단계
Visual C++ Redistributable 설치
Visual C++ 재배포 가능 패키지를 다운로드하고 설치합니다:
wine vc_redist.x64.exe팁
DependencySetup_依赖库安装.bat는 winget에 의존하므로 Wine에서 정상적으로 작동하지 않습니다. 따라서 런타임 라이브러리를 수동으로 설치해야 합니다.MAA 다운로드
Windows용 MAA를 다운로드하고 압축을 푼 후
wine MAA.exe를 실행합니다.
주의
연결 설정에서 ADB 경로를 Windows용 adb.exe로 설정해야 합니다.
ADB를 통해 USB 장치에 연결해야 하는 경우, 먼저 Wine 외부에서 adb start-server를 실행하여 네이티브 ADB 서버에 Wine을 통해 연결하세요.
Linux 네이티브 MaaCore 사용 (실험적 기능)
MAA Wine Bridge 소스 코드를 다운로드하고 빌드하여, 생성된 MaaCore.dll(ELF 파일)로 Windows 버전을 교체하고, Linux 네이티브 동적 라이브러리(libMaaCore.so 및 종속성)를 같은 디렉토리에 넣습니다.
이때 Wine을 통해 MAA.exe를 실행하면 Linux 네이티브 동적 라이브러리가 로드됩니다.
주의
Linux 네이티브 MaaCore를 사용할 때는 연결 설정에서 ADB 경로를 Linux 네이티브 ADB로 설정해야 합니다.
Linux 데스크톱 통합 (실험적 기능)
데스크톱 통합은 네이티브 데스크톱 알림 지원과 fontconfig 글꼴 구성을 WPF에 매핑하는 기능을 제공합니다.
MAA Wine Bridge에서 생성된 MaaDesktopIntegration.so를 MAA.exe와 같은 디렉토리에 넣으면 활성화됩니다.
알려진 문제
- Wine DirectWrite는 강제로 힌팅을 활성화하고 DPI를 FreeType에 전달하지 않아 글꼴 표시 효과가 좋지 않습니다.
- 네이티브 데스크톱 알림을 사용하지 않을 때, 팝업 알림이 전체 시스템의 마우스 포커스를 빼앗아 다른 창을 조작할 수 없게 됩니다.
winecfg를 통해 가상 데스크톱 모드를 활성화하거나 데스크톱 알림을 비활성화하여 완화할 수 있습니다. - Wine-staging 사용자는 MAA가 Wine 환경을 올바르게 감지할 수 있도록
winecfg의Wine 버전 숨기기옵션을 비활성화해야 합니다. - Wine의 Light 테마는 WPF에서 일부 텍스트 색상 이상을 일으키므로,
winecfg에서 테마 없음(Windows 클래식 테마)으로 전환하는 것을 권장합니다. - Wine은 구식 XEmbed 트레이 아이콘을 사용하므로 GNOME에서 정상적으로 작동하지 않을 수 있습니다.
- Linux 네이티브 MaaCore를 사용할 때는 자동 업데이트가 지원되지 않습니다 (
업데이트 프로그램: 내가 Windows 버전을 다운로드해야 한다고?)
Python 사용
MAA 동적 라이브러리 설치
다음 방법 중 하나를 선택하세요:
- MAA 공식 웹사이트에서 사전 컴파일된 Linux 동적 라이브러리 압축 파일을 다운로드하고 압축을 푼 후
Python/sample.py파일을 편집합니다. - AUR: maa-assistant-arknights, 설치 후 안내되는 "Alternative usage" 설명에 따라 파일을 편집합니다.
- Nixpkgs: maa-assistant-arknights
팁
사전 컴파일된 동적 라이브러리는 MaaLinuxToolchain 툴체인을 기반으로 크로스 컴파일되었으며, glibc 2.31(Ubuntu 20.04)만 필요합니다. 여전히 ABI 호환성 문제(예: glibc를 사용하지 않는 배포판)가 발생하는 경우 컨테이너에서 실행하거나 Linux 컴파일 가이드를 참고하여 다시 컴파일할 수 있습니다.
- MAA 공식 웹사이트에서 사전 컴파일된 Linux 동적 라이브러리 압축 파일을 다운로드하고 압축을 푼 후
ADB 구성
이전 단계에서 연
sample.py파일에서if asst.connect("adb.exe", "127.0.0.1:5555"):줄을 찾습니다.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"):- ADB 도구를 직접 사용할 수 있습니다:
이제 테스트할 수 있습니다:
$ python3 sample.py를 실행하고连接成功이 반환되면 대부분 성공한 것입니다.
작업 구성
통합 문서 - 작업 유형 목록을 참고하여 필요에 따라
sample.py의asst.append_task(…)함수 호출을 수정합니다.
에뮬레이터 지원
✅ 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 720adb의 IP 주소 설정: 설정 - 정보 - IP 주소를 열고 첫 번째 IP를 기록하여 ${기록된IP}:5555를 sample.py의 adb IP에 입력하세요.
게임은 ARM 아키텍처만 지원하므로 x64 아키텍처에서는 libhoudini 또는 libndk 같은 arm64 변환 레이어를 설치해야 합니다. waydroid_script 및 Waydroid Helper를 참고하세요.
Waydroid에는 Minitouch에 필수적인 /dev/input/eventN이 없으므로 Minitouch를 사용할 수 없습니다. 다른 터치 모드로 전환하세요.
✅ redroid
안드로이드 11 버전 이미지는 게임을 정상적으로 실행합니다. 5555 adb 포트를 공개해야 합니다.