打包生成 APK

WARNING

请注意,当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护,请前往微信文档中心open in new window 找到对应的新文档继续使用

在完成多端应用的模拟器调试或者真机后,开发者可构建 APK 并安装至手机进一步测试,测试完成后亦可构建正式版的 APK 用于提交应用市场进行审核,审核通过后即可上架。

  • 前往工具栏,点击「构建 - 打包生成 APK」,进入云构建面板中完成相关配置即可生成 APK

一、构建次数

  • 云构建安装包需消耗较多资源,平台已提供基础发布与更新所需的免费次数,具体如下:

    • 每位开发者在每个自然周可免费构建的 APK 次数为 50 次
    • 如构建的版本仅涉及小程序代码变更,则不消耗次数
    • 如构建的版本涉及原生内容,构建失败亦会消耗次数
    • 升级到专业版可以获得更多的构建次数,详情可查看升级至专业版open in new window
  • 当剩余的可构建次数为 0 时,开发者将无法使用「打包生成 APK」,但可使用「打包生成 APK(仅小程序)」,此构建方法基于本地基座 APK,仅更新小程序代码

二、基本信息

  • 基本信息来源于 project.miniapp.json,如开发者需修改可前往 project.miniapp.json 修改

三、包名信息

  • 包名信息来源于多端应用控制台的配置,如开发者所创建的多端应用尚未绑定移动应用账号,则默认以平台分配的测试版 Package Name 作为本次构建的 APK 包名信息
  • 如开发者所创建的多端应用已绑定移动应用账号,则以移动应用配置的 Package Name 作为本次构建的 APK 包名信息
  • 开发者如需修改,点击「去修改」即可跳转至 Donut 开发平台进行修改

四、证书配置

生成 Android 的安装包需开发者提交相关证书信息,相关的配置以及说明如下.

  • 证书别名:即证书的 key-Alias,该配置项为必填
  • 证书密码:即证书的 key-Password,该配置项为必填
  • 证书文件密码:即证书的 storePassword,该配置项为必填
  • 签名文件:即选取签名文件的对应文件位置 如不清楚证书信息如何获取,可以查看 Android 签名相关

五、资源包配置

  • 资源包的类型分别有:正式版、开发版、开发版(支持远程调试)以及开发版(支持热更新),关于这几个版本的区别以及应用场景可查看版本介绍

六、应用版本配置

  • 应用版本信息来源于 project.miniapp.json,如开发者需修改可前往 project.miniapp.json 修改

七、构建 AAB

  • 如需上架 Google Play 可选择发布格式为 AAB

八、命令行构建

开发者可以使用命令行构建的方式构建 APK。开发者需要先按照开发者工具的命令行文档open in new window准备执行命令的环境,以及查看基础的用法。

按照如下步骤操作:

  • 首先仔细阅读命令行的使用文档
  • 根据文档执行 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 位 安装包