1. 环境准备与工具配置
第一次接触uni-app安卓打包的开发者,往往会卡在环境配置这一步。我见过太多人因为漏装某个依赖项,导致后续步骤频频报错。这里分享我总结的"三件套"配置方案,帮你避开90%的坑。
必备工具清单:
- HBuilderX 3.6+:这是uni-app的官方IDE,建议直接安装最新稳定版。有个冷知识:安装路径不要带中文和空格,否则可能导致adb连接异常
- Android Studio:主要用来获取SDK工具链。实测发现只需安装Command-line Tools即可,不用完整安装(能省10GB空间)
- 真机设备:推荐安卓8.0以上机型,开发者选项里要开启USB调试。遇到过华为手机连接问题?试试在"USB连接方式"里选择"传输文件"模式
配置环境变量时,重点关注这两个路径:
bash复制ANDROID_HOME = C:\Users\你的用户名\AppData\Local\Android\Sdk
PATH追加 %ANDROID_HOME%\platform-tools
注意:Windows系统下如果遇到adb命令不可用,可能需要重启终端。我习惯用VS Code的终端操作,比系统cmd更稳定
第一次运行adb devices时,手机会弹出RSA密钥确认框。遇到过授权不成功的情况?试试先adb kill-server再重新连接。这些细节问题往往最耗时,提前处理好能提升后续效率。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. manifest.json深度配置
这个看似简单的配置文件,藏着不少影响上架的关键参数。最近帮一个团队排查安装包解析失败的问题,最后发现是targetSdkVersion设置过低导致的。
必改的核心参数:
json复制{
"appid": "你的应用标识",
"versionName": "1.0.0",
"versionCode": 100,
"targetSdkVersion": 33, // 低于30可能被应用商店拒绝
"permission": {
"android.permission.INTERNET": {
"request": "once",
"prompt": "需要网络权限以加载数据"
