mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-20 02:55:38 +08:00
14194d1118
格式化工具部分： 1. pre-commit 引入 python 的格式化工具，包括 black（代码格式化）和 isort（对“包导入顺序”的规范） 2. 允许 prettier 对文档站的 markdown 文件格式化 3. 不允许 prettier 对 markdown 文件中的代码块的代码本身进行格式化 4. 升级了 pre-commit 的各个 hook 的版本 5. 优化了 pre-commit 的日志文本显示 容器总览部分： 1. 由原来的单一轻量环境转为区分空环境、轻量环境和全量环境 2. 空环境是裸 Linux 镜像（Ubuntu），为默认环境 3. 轻量环境适合开发文档站前端 4. 全量环境适合开发 MaaCore 5. 目前，全量环境完整包含了轻量环境，轻量环境完整包含了空环境 6. 在仓库 README.md 中更新了三个环境的描述，并将链接分别设置为对应环境的创建链接 **注意：没有修改文档站中的对应文件** 7. 在各个语言的开发指南的最后，移除了 Codespace 部分的“安装额外依赖”相关描述，且将链接设置为全量环境的创建链接 **注意：没有添加“开发文档站”的指南和对应 codespace 的使用方式** 容器的轻量环境和全量环境共有部分： 1. 安装 black 和 isort 包 2. 调整 VS Code 设置，取消先前（对 markdown 文件单独指定 markdownlint 扩展作为格式化工具）的错误设置，现在 markdown 文件仍然使用默认的 prettier 扩展作为格式化工具 3. 引入 markdown-all-in-one 扩展作为语法提示工具 4. 将 node_modules 和 3rdparty 排除在 VS Code 的文本的搜索路径之外 容器的全量环境部分： 1. 为 tools 下的所有 python 脚本安装依赖 2. 使用 tools/maadeps-download.py 下载 maadeps，且将必要二进制文件软链接到 /usr/local/bin/ 3. 使用 apt 安装 cmake 和 clangd-20，将后者通过 update-alternatives 设置为系统 clangd 的默认版本 4. 使用 cmake tools 扩展，并按照 Linux 编译方法进行配置 5. 使用 clang-format 作为 c/cpp 的格式化工具，clang-format 程序主体来自 maadeps（已经软链接到 /usr/local/bin/） 6. 使用 clangd 作为 c/cpp 的语法提示工具 7. 将 MaaDeps、install 和 build 排除在 VS Code 的文本搜索路径之外 其它手动调整： 1. 更新文档站的 package.json，指定 pnpm 包管理器的版本 2. 手动保证 markdown 文件中的列表前后有空行（注意到 MarkdownLint 官方规则不一定能精准定位所有“列表前后空行”的问题，详见：https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md032---lists-should-be-surrounded-by-blank-lines ） 3. 修改了部分 markdown 文件中的 json 代码块的语法问题 **注意：相同的问题并未全部发现，仅修改了两处** 4. 在 tools 目录中，一处 python 脚本的包名误用（本地包名和某个 pip 包重名），这里修改了相应代码 5. 在 tools 目录中，一处 python 脚本使用了弃用的包 cchardet 的问题，这里更换了推荐使用的功能相近的包并修改了相应代码 自动化脚本提交的修改： 1. 自动格式化了大量 tools 中的 python 脚本 2. 自动格式化了大量 docs 中的 markdown 文件 Commits: * chore: pre-commit引入black和isort规范py文件 * chore: Auto update by pre-commit hooks [skip changelog] * chore: devcontainer添加isort扩展，排序python导入 * chore: pre-commit任务命名及更名 * style: isort fix * chore: Auto update by pre-commit hooks [skip changelog] * chore: 更新pre-commit的hook版本 * fix: 模块名与第三方库重名，大忌 * chore: 容器构建时额外安装isort * docs: md -> markdown * chore: 容器安装python包和maadeps * fix: 修复过时python包 * chore: 指定pnpm版本 * chore: container支持选择轻量环境 * chore: 去掉rust * chore: add plain env * chore: 使用clangd语言服务器 * chore: 无需单独设置markdown的格式化工具 * chore: 更新安装的clangd版本 * docs: 简易文档适配 * docs: 在仓库README中重新编排codespaces相关指引 * chore: Auto update by pre-commit hooks [skip changelog] * style: 调整缩进 * chore: 格式化工具不用特意排除被gitignore忽略的文件 * chore: sh文件在gitattributes中单列一类 * chore: 格式化docs下的markdown文件 * chore: 暂时不修改md文件中的代码块 * style: 人为明确markdown中的部分列表相关格式 * docs: 补上部分markdown的json代码块中缺失的逗号 * chore: Auto update by pre-commit hooks [skip changelog] * chore: Auto update by pre-commit hooks [skip changelog] * fix: 补上tools的服务器排序相关代码中缺失的逗号 Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * chore: 使用maadeps的clangd * build: 更新maadeps工具链版本 * style: prettier fix * revert: 还原maadeps版本 * revert: 取消使用maadeps的clangd依赖，改用系统apt安装 --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
182 lines
9.6 KiB
Markdown
182 lines
9.6 KiB
Markdown
---
|
|
order: 4
|
|
icon: mingcute:android-fill
|
|
---
|
|
|
|
# Android 디바이스 지원
|
|
|
|
::: warning
|
|
이 방법은 ADB 디버깅이 포함되며 여전히 컴퓨터와 연결해야 하므로, **초보자에게는 권장하지 않습니다**.
|
|
:::
|
|
|
|
::: info 주의사항
|
|
|
|
0. [연결 설정](../connection.md)을 동시에 참조해야 합니다.
|
|
1. Android 10부터 `Minitouch`는 `SELinux`가 `Enforcing` 모드인 경우 더 이상 사용할 수 없습니다. 다른 터치 모드로 전환하거나 `SELinux`를 일시적으로 `Permissive` 모드로 전환하세요.
|
|
2. Android 생태계가 매우 복잡하기 때문에 `MAA 설정` - `연결 설정`에서 `연결 구성`을 `일반 모드` 또는 `호환 모드` 또는 `두 번째 해상도` 또는 `일반 모드(이상 출력 차단)`로 변경하여 작동하는 모드를 찾을 수 있습니다.
|
|
3. MAA는 오직 `16:9` 비율의 해상도만 지원하므로, `16:9` 또는 `9:16` 화면 비율이 아닌 장치는 해상도를 강제로 변경해야 합니다. 이는 대부분의 현대적인 장치에 해당됩니다. 연결된 장치의 화면 비율이 원래 `16:9` 또는 `9:16`인 경우에는 해상도 변경 부분을 건너뛸 수 있습니다.
|
|
4. 잘못된 조작을 피하기 위해 기기 내비게이션 방식을 `기본 네비게이션 키` 등으로 변경하세요.
|
|
5. 게임 내 설정의 UI 위치 조절을 0으로 조정하여 작업 오류를 피하세요.
|
|
|
|
:::
|
|
|
|
::: tip
|
|
기본적인 `16:9` 비율 해상도에는 `3840*2160` (4K)、`2560*1440` (2K)、`1920*1080` (1080P)、`1280*720` (720P)등이 있습니다.
|
|
:::
|
|
|
|
## adb 디버깅 도구 다운로드 및 장치 연결
|
|
|
|
1. [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)를 다운로드하고 압축을 해제합니다.
|
|
2. 압축 해제한 폴더를 열고 주소 표시줄을 지우고 `cmd`를 입력한 후 Enter 키를 누릅니다.
|
|
3. 나타나는 명령 프롬프트 창에 `adb`를 입력하고 많은 영어 도움말 텍스트가 표시되면 실행이 성공한 것입니다.
|
|
4. 핸드폰에서 `USB 디버깅`을 활성화합니다. 각 브랜드의 핸드폰은 다른 방식으로 진입할 수 있으며 검색 엔진을 적극 활용하세요. 제조사는 MIUI에서처럼 추가적인 USB 디버깅 옵션을 제공할 수 있습니다. 이 경우 `USB 설치` 및 `USB 디버깅(보안 설정)`과 같은 옵션을 동시에 활성화하세요.
|
|
5. 핸드폰을 컴퓨터에 데이터 케이블로 연결한 후 방금 열었던 명령 프롬프트 창에 다음 명령을 입력합니다.
|
|
|
|
```bash
|
|
adb devices
|
|
```
|
|
|
|
- 성공적으로 실행되면 연결된 `USB 디버깅` 장치 정보가 표시됩니다.
|
|
- 예시:
|
|
|
|
```bash
|
|
List of devices attached
|
|
VFNDU1682100xxxx device
|
|
```
|
|
|
|
- **`device` 앞의 영숫자 조합은 장치 시리얼 번호이자 MAA의 `연결 주소`입니다.**
|
|
|
|
- 현재, 안드로이드 장치에서 `USB 디버깅`을 하려면 디버깅을 허용하는 팝업을 터치해야 합니다. 허가되지 않은 경우 다음과 같이 표시됩니다:
|
|
|
|
```bash
|
|
List of devices attached
|
|
VFNDU1682100xxxx unauthorized
|
|
```
|
|
|
|
- 디바이스가 계속 허가되지 않거나 장치 시리얼 번호 뒤에 `offline`이 표시되면 장치와 컴퓨터를 재부팅한 후 다시 시도해야 합니다. 여전히 문제가 해결되지 않으면 사용자의 현재 사용자 폴더 아래의 `.android` 폴더를 삭제하고 다시 시작한 후 다시 시도하세요. 구체적인 위치는 스스로 검색하세요.
|
|
|
|
## 해상도 변경
|
|
|
|
::: tip
|
|
스마트폰 화면 해상도는 `가로*세로`로 표시되며, 이는 컴퓨터 모니터의 `가로*세로`와는 다릅니다. 목표 장치에 따라 구체적인 값은 직접 확인하세요.
|
|
:::
|
|
|
|
- 위의 장치 목록에 하나의 장치만 표시된 경우 아래 명령을 실행하여 해상도를 변경하거나 복원할 수 있습니다.
|
|
|
|
```bash
|
|
:: 현재 해상도 확인
|
|
adb shell wm size
|
|
:: 기본 해상도로 복원
|
|
adb shell wm size reset
|
|
|
|
:: 해상도를 720p로 변경
|
|
adb shell wm size 720x1280
|
|
:: 해상도를 1080p로 변경
|
|
adb shell wm size 1080x1920
|
|
```
|
|
|
|
- 여러 장치가 있는 경우 `adb`와 `shell` 사이에 `-s <대상 장치 시리얼 번호>` `매개변수`를 추가해야 합니다. 아래는 예시입니다.
|
|
|
|
```bash
|
|
:: 현재 해상도 확인
|
|
adb -s VFNDU1682100xxxx shell wm size
|
|
:: 기본 해상도로 복원
|
|
adb -s VFNDU1682100xxxx shell wm size reset
|
|
|
|
:: 해상도를 720p로 변경
|
|
adb -s VFNDU1682100xxxx shell wm size 720x1280
|
|
:: 해상도를 1080p로 변경
|
|
adb -s VFNDU1682100xxxx shell wm size 1080x1920
|
|
```
|
|
|
|
- 일부 설계가 부적절한 앱은 해상도를 복원해도 내용 레이아웃이 여전히 잘못 표시될 수 있습니다. 일반적으로 해당 앱이나 장치를 다시 시작하면 문제가 해결됩니다.
|
|
|
|
::: danger 주의
|
|
장치 재부팅 전에 해상도를 **반드시 복구하는 것**이 좋습니다. 그렇지 않으면 장치에 따라 예기치 않은 결과가 발생할 수 있습니다.
|
|
레이아웃 위치 오류, 터치 위치 오류, 앱 충돌, 잠금 해제 불가 등의 오류가 발생할 수 있습니다!
|
|
:::
|
|
|
|
## 해상도 자동 변경
|
|
|
|
1. MAA 폴더 아래에 두 개의 텍스트 파일을 생성하고 다음 내용을 입력합니다.
|
|
|
|
```bash
|
|
:: 해상도를 1080p로 조정
|
|
adb -s <대상 장치 시리얼 번호> shell wm size 1080x1920
|
|
:: 화면 밝기 낮추기 (선택 사항)
|
|
adb -s <대상 장치 시리얼 번호> shell settings put system screen_brightness 1
|
|
```
|
|
|
|
```bash
|
|
:: 해상도 복원
|
|
adb -s <대상 장치 시리얼 번호> shell wm size reset
|
|
:: 화면 밝기 높이기 (선택 사항)
|
|
adb -s <대상 장치 시리얼 번호> shell settings put system screen_brightness 20
|
|
:: 홈 화면으로 이동 (선택 사항)
|
|
adb -s <대상 장치 시리얼 번호> shell input keyevent 3
|
|
:: 잠금 화면 (선택 사항)
|
|
adb -s <대상 장치 시리얼 번호> shell input keyevent 26
|
|
```
|
|
|
|
2. 첫 번째 파일을 `startup.bat`으로 이름을 바꾸고, 두 번째 파일을 `finish.bat`으로 이름을 바꿉니다.
|
|
- 이름을 바꾼 후 파일 아이콘이 변경되지 않고 확장명을 변경하는 이중 확인 대화 상자가 표시되지 않는 경우 "Windows에서 파일 확장명 표시하는 방법"을 검색하세요.
|
|
|
|
3. MAA의 `설정` - `연결 설정` - `시작 전 스크립트` 및 `종료 후 스크립트`에 각각 `startup.bat`과 `finish.bat`을 입력합니다.
|
|
|
|
## MAA에 연결하기
|
|
|
|
### 유선 연결
|
|
|
|
::: tip
|
|
유선 연결을 사용하면 IP 주소나 포트가 필요하지 않습니다. 단지 `adb devices` 명령으로 얻은 장치 시리얼 번호만 필요합니다.
|
|
:::
|
|
|
|
1. 방금 얻은 대상 장치의 시리얼 번호를 MAA `설정` - `연결 설정` - `연결 주소`에 입력합니다.
|
|
2. Link Start!
|
|
|
|
### 무선 연결
|
|
|
|
- 장치가 컴퓨터와 동일한 LAN 환경에 있고 서로 통신할 수 있는지 확인하세요. `AP 격리`, `게스트 네트워크` 등의 설정은 장치 간 통신을 차단할 수 있습니다. 관련 라우터 문서를 참조하세요.
|
|
- 장치를 다시 시작하면 무선 디버깅이 비활성화되므로 다시 설정해야 합니다.
|
|
|
|
#### `adb tcpip`를 사용하여 무선 포트를 엽니다
|
|
|
|
1. 방금 열린 명령 프롬프트 창에 다음 명령을 입력하여 무선 디버깅을 활성화합니다.
|
|
|
|
```bash
|
|
adb tcpip 5555
|
|
:: 여러 장치가 있는 경우 -s 매개변수를 추가하여 시리얼 번호를 지정합니다.
|
|
```
|
|
|
|
2. 장치 IP 주소를 확인합니다.
|
|
- 장치의 `설정` - `WLAN`으로 이동하여 현재 연결된 무선 네트워크를 클릭하여 IP 주소를 확인합니다.
|
|
- 각 브랜드의 장치는 설정 위치가 다를 수 있으므로 검색하여 찾으세요.
|
|
|
|
3. MAA `설정` - `연결 설정` - `연결 주소에` `<IP>:5555`와 같이 현재 장치의 IP 주소를 입력합니다. (예: `192.168.1.2:5555`)
|
|
4. Link Start!
|
|
|
|
#### `adb pair`를 사용하여 무선 포트를 엽니다
|
|
|
|
::: tip
|
|
`adb pair`는 안드로이드 11 이상에서 개발자 옵션의 `무선 디버깅`을 사용하여 페어링한 후 연결하는 것으로, 유선 연결을 안할 수 있습니다.
|
|
:::
|
|
|
|
1. 휴대폰의 개발자 옵션으로 이동하여 `무선 디버깅`을 클릭하여 활성화하고 확인을 클릭한 후 `페어링 코드로 디바이스 페어링`을 클릭하고 페어링이 완료될 때까지 나타나는 팝업을 닫지 마세요.
|
|
|
|
2. 페어링을 시작합니다.
|
|
1. 명령 프롬프트에서 `adb pair <장치에 표시된 IP 주소와 포트>`를 입력하고 엔터를 누릅니다.。
|
|
2. `<장치에 표시된 6자리 페어링 코드>`를 입력하고 엔터를 누릅니다.
|
|
3. 창에 `Successfully paired to <IP:포트>`와 같은 내용이 나타나면서 장치에서 팝업이 자동으로 닫히고 페어링된 장치 아래에 컴퓨터 이름이 표시됩니다.
|
|
|
|
3. 현재 장치 화면에 나타나는 `<IP 주소 및 포트>`를 MAA `설정` - `연결 설정` - `연결 주소`에 입력합니다. (예: `192.168.1.2:11451`), **이전에 입력한 것과 반드시 다르게 입력하세요.**
|
|
4. Link Start!
|
|
|
|
#### 루트 권한을 사용하여 무선 포트를 엽니다
|
|
|
|
~~root를 했으면 이 문서를 더이상 보지 않아도 됩니다~~
|
|
|
|
1. [WADB](https://github.com/RikkaApps/WADB/releases)를 다운로드하고 루트 권한을 부여하여 설치합니다.
|
|
2. WADB를 열고 무선 adb를 시작합니다.
|
|
3. WADB에서 제공하는 IP 주소 및 포트를 MAA `설정` - `연결 설정` - `연결 주소`에 입력합니다. (예: `192.168.1.2:5555`)
|
|
4. Link Start!
|