小程序
取消
开发
中文
EN
取消
  • 平台能力

    • # 打包生成 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 签名相关

    # 五、资源包配置

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

    # 六、应用版本配置

    • 应用版本信息来源于 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 位 安装包