MAA-Meow Windows 本地编译记录（Android）

这篇文章把一次可复现的 MAA-Meow 本地构建记录整理成可直接执行的正文版本，适合在 Windows 环境下快速完成首包构建。

记录时间：2026-09-06 ~ 2026-09-07
工作目录：D:\self\maa\MAA-Meow

和官方构建文档的关系#

官方文档位置：docs/zh-cn/develop/BUILDING.md

官方主流程本身没有问题，核心是三步：

安装 JDK 25 与 Android Studio
执行 python scripts/setup_maa_core.py
Android Studio Sync 后执行 Assemble

但在国内网络环境下，实测有三个高频坑位需要补齐。

实测补充点（关键）#

需要先安装 Python 依赖
setup_maa_core.py 会调用 scripts/convert_ocr_ncnn.py，而该脚本依赖 pnnx（来自 scripts/requirements.txt）。
仅使用代理不够稳定
Python 包下载建议配合 pip 镜像（例如清华镜像），成功率和速度都更稳。
资源目录未补齐会在 Gradle 阶段报错
典型失败点是 app:generateAssetManifest，缺少目录：app/src/main/assets/MaaSync/MaaResource。

结论：官方流程正确，但建议把“pip 依赖 + 镜像站 + 代理”作为环境准备的显式步骤。

可复现命令（已验证）#

1) 安装 Python 依赖（优先镜像）#

1
Set-Location "D:\self\maa\MAA-Meow"
2
python -m pip install -r "scripts/requirements.txt" -i https://pypi.tuna.tsinghua.edu.cn/simple

2) 使用代理部署 MAA Core 资源（arm64）#

1
Set-Location "D:\self\maa\MAA-Meow"
2
$env:HTTP_PROXY="http://127.0.0.1:7890"
3
$env:HTTPS_PROXY="http://127.0.0.1:7890"
4
python -u "scripts/setup_maa_core.py" --abi arm64-v8a

3) 编译 Debug APK#

1
Set-Location "D:\self\maa\MAA-Meow"
2
$env:HTTP_PROXY="http://127.0.0.1:7890"
3
$env:HTTPS_PROXY="http://127.0.0.1:7890"
4
.\gradlew.bat :app:assembleDebug --no-daemon --console=plain

本次构建结果（实测记录）#

以下内容来自本次构建日志，可作为你本地比对项：

pip 依赖确认
- pnnx==20260526
- torch==2.14.0
资源部署确认
- 目录存在：app/src/main/assets/MaaSync/MaaResource
- 版本文件：.maaversion 内容为 v6.17.2
Gradle 关键输出
- Generated asset manifest: 9329 files
- BUILD SUCCESSFUL in 3m 6s
- :app:assembleDebug 完成
构建产物
- app/build/outputs/apk/debug/app-debug.apk
- 大小：285040447 bytes
- 时间：2026/9/6 22:50:39

建议补充到团队构建文档（最小增量）#

如果要把经验同步到团队文档，可在 docs/zh-cn/develop/BUILDING.md 的“环境准备”后增加这四条：

安装 Python 依赖：python -m pip install -r scripts/requirements.txt
国内网络建议使用 pip 镜像（如清华镜像）
如需代理，设置 HTTP_PROXY / HTTPS_PROXY
先执行 setup_maa_core.py，再进行 Gradle/Android Studio Assemble

这四条基本可以覆盖首次构建最常见的三类问题：

pnnx not found
资源未部署导致 generateAssetManifest 失败
下载慢或下载失败