# 打包生成 APK
在完成多端应用的模拟器调试或者真机后,开发者可构建 APK 并安装至手机进一步测试,测试完成后亦可构建正式版的 APK 用于提交应用市场进行审核,审核通过后即可上架。
- 前往工具栏,点击「构建 - 打包生成 APK」,进入云构建面板中完成相关配置即可生成 APK
# 一、构建次数
云构建安装包需消耗较多资源,平台已提供基础发布与更新所需的免费次数,具体如下:
- 每位开发者在每个自然周可免费构建的 APK 次数为 50 次
- 如构建的版本仅涉及小程序代码变更,则不消耗次数
- 如构建的版本涉及原生内容,构建失败亦会消耗次数
- 升级到专业版可以获得更多的构建次数,详情可查看升级至专业版
当剩余的可构建次数为 0 时,开发者将无法使用「打包生成 APK」,但可使用「打包生成 APK(仅小程序)」,此构建方法基于本地基座 APK,仅更新小程序代码
# 二、基本信息
- 基本信息来源于
project.miniapp.json
,如开发者需修改可前往project.miniapp.json
修改
# 三、包名信息
- 包名信息来源于多端应用控制台的配置,如开发者所创建的多端应用尚未绑定移动应用账号,则默认以平台分配的测试版 Package Name 作为本次构建的 APK 包名信息
- 如开发者所创建的多端应用已绑定移动应用账号,则以移动应用配置的 Package Name 作为本次构建的 APK 包名信息
- 开发者如需修改,点击「去修改」即可跳转至多端应用控制台进行修改
# 四、证书配置
生成 Android 的安装包需开发者提交相关证书信息,相关的配置以及说明如下.
- 证书别名:即证书的
key-Alias
,该配置项为必填 - 证书密码:即证书的
key-Password
,该配置项为必填 - 证书文件密码:即证书的
storePassword
,该配置项为必填 - 签名文件:即选取签名文件的对应文件位置 如不清楚证书信息如何获取,可以查看 Android 签名相关
# 五、资源包配置
Not found: <<<< Updated upstream
- 资源包的类型分别有:正式版、开发版、开发版(支持远程调试)以及开发版(支持热更新),关于这几个版本的区别以及应用场景可查看版本介绍 =======
- 资源包的类型分别有:正式版、开发版、开发版(支持远程调试)以及开发版(支持热更新),关于这几个版本的区别以及应用场景可查看版本介绍
Stashed changes
# 六、应用版本配置
- 应用版本信息来源于
project.miniapp.json
,如开发者需修改可前往project.miniapp.json
修改
# 七、构建 AAB
- 如需上架 Google Play 可选择发布格式为 AAB
# 八、命令行构建
开发者可以使用命令行构建的方式构建 APK。开发者需要先按照开发者工具的命令行文档准备执行命令的环境,以及查看基础的用法。
按照如下步骤操作:
- 首先仔细阅读命令行的使用文档
- 根据文档执行 cli open --project打开对应的项目
- 如果没有登录需要cli login登录
- 成功进入项目后,执行 cli build-apk。参数包括:
- --project 项目路径
- --keyPass 证书密码
- --storePass 证书文件密码
- --keyAlias 证书别名
- --useAab 发布格式为 AAB 需要为 true(否则为APK)
- --keyStore 证书文件绝对路径
- --desc 版本描述(非必填)
- --output 构建产物的保存路径,需要为系统绝对路径
- --isUploadResourceBundle 是否上传资源包(非必填)
- --resourceBundleVersion 资源包版本号(非必填)
- --resourceBundleDesc 资源包项目备注(非必填)
- 应用版本名称,应用版本号在project.miniapp.json中配置 version,versionCodeCode
样例:/Applications/wechatwebdevtools.app/Contents/MacOS/cli build-apk --project /Users/zhangchen/WeChatProjects/miniprogram-18 --keyPass 123456 --storePass 123456 --keyAlias 123456 --useAab true --keyStore /Users/zhangchen/WeChatProjects/miniprogram-18/miniapp/android/android.keystore --output "/Users/zhangchen/Desktop/"
# 九、其他
- Android 应用上架至不同的应用市场时,对于上传的 APK 包有不同的要求:32 位安装包、64位安装包、32/64 位兼容安装包
- 开发者可在
project.miniapp.json
通过勾选下方配置进行构建对应的安装包
说明:
- 勾选 armeabi-v7a 将构建 32 位 安装包
- 勾选 arm64-v8a 将构建 64 位 安装包
- 同时勾选,则构建的是 32/64 位兼容安装包
- 均未勾选,则默认构建 64 位 安装包