50000b988a
Co-authored-by: Rbqwow <55343783+Rbqwow@users.noreply.github.com> Co-authored-by: MistEO <mistereo@hotmail.com>
8.3 KiB
order, icon
| order | icon |
|---|---|
| 3 | teenyicons:linux-alt-solid |
Linux 지원
준비 작업
다음중 하나의 설치 방법을 선택하세요.
maa-cli 사용
maa-cli는 Rust로 작성된 간단한 MAA 커맨드 라인 도구입니다. 관련 설치 및 사용 방법은 CLI 가이드를 참조하세요.
Wine 사용
MAA WPF GUI는 현재 Wine을 통해 실행할 수 있습니다. MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포).
설치 단계
-
Visual C++ Redistributable 설치:
Visual C++ 재배포 가능 패키지를 다운로드하고 설치합니다:
wine vc_redist.x64.exe::: tip
DependencySetup_依赖库安装.bat는 winget 및 Windows 권한 상승 메커니즘에 의존하므로 Wine에서 정상적으로 작동하지 않습니다. 따라서 런타임 라이브러리를 수동으로 설치해야 합니다. ::: -
Windows용 MAA를 다운로드하고 압축을 푼 후
wine MAA.exe를 실행합니다.
::: info 주의
연결 설정에서 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 네이티브 동적 라이브러리가 로드됩니다.
::: info 주의 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 사용
:::: steps
-
MAA 동적 라이브러리 설치
- MAA 공식 웹사이트에서 Linux 동적 라이브러리를 다운로드하고 압축을 풀거나 소프트웨어 저장소에서 설치합니다:
- AUR：maa-assistant-arknights을 설치한 후에 설치 지침에 따라 파일을 편집합니다.
- Nixpkgs: maa-assistant-arknights
./MAA-v{버전}-linux-{아키텍처}/Python/디렉토리로 이동하여sample.py파일을 엽니다.
::: tip 사전 컴파일된 버전은 상대적으로 최신 버전의 Linux 배포판 (Ubuntu 22.04)에서 컴파일된 동적 라이브러리를 포함하고 있습니다. 시스템의 libstdc++ 버전이 오래되면 ABI 호환성 문제가 발생할 수 있습니다. Linux 컴파일 가이드를 참조하여 다시 컴파일하거나 컨테이너를 사용할 수 있습니다. :::
- MAA 공식 웹사이트에서 Linux 동적 라이브러리를 다운로드하고 압축을 풀거나 소프트웨어 저장소에서 설치합니다:
-
ADB 구성
-
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의 # 작업 및 매개변수는 docs/integration.md 참조 부분을 수정합니다.
::::
모바일 에뮬레이터 지원
✅ 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 기능 및 경로 검색에 문제가 없습니다.
안드로이드 컨테이너 지원
::: tip 다음 솔루션은 일반적으로 커널 모듈을 필요로 합니다. 해당 솔루션 및 배포판에 맞는 내부 모듈을 설치하세요. :::
✅ 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 포트를 공개해야 합니다.