# 通过命令行打包(CLI)

  • 若需在不依赖开发者工具场景如自身业务工程流水线上构建 APK 和 IPA,则推荐使用 miniprogram-ci
  • 在命令行构建的方式构建 APK 和 IPA 前,开发者需要先按照开发者工具的命令行文档准备执行命令的环境,以及查看基础的用法。

步骤概览

  1. 根据文档执行 cli open --project 打开对应的项目
  2. 使用cli login 登录
  3. 成功进入项目后,执行 cli build-apk 或者 cli build-ipa 进行打包

# build-ipa

cli build-ipa 支持的参数如下:

参数名 功能说明 是否必填 参数类型
project 项目路径,需要为系统绝对路径 string
output 构建产物的保存路径,需要为系统绝对路径 string
isDistribute 是否使用分发证书 boolean
isRemoteBuild 是否启用远程构建(必须使用分发证书的情况下才能使用) boolean
profilePath profile 文件地址,文件格式为 mobileprovision,相对项目根路径的相对路径 否(使用分发证书时必填) string
certificateName 签名证书名 否(使用分发证书时必填) string
p12Path p12 文件路径,文件格式为 p12,相对项目根路径的相对路径 否(使用远程构建时必填) string
p12Password p12 密码 否(使用远程构建时必填) string
tpnsProfilePath tpnsProfile 文件路径,相对项目根路径的相对路径 string
isUploadBeta 是否上传内测版(不使用分发证书时才可使用) boolean
isUploadResourceBundle 是否上传资源包 boolean
resourceBundleVersion 资源包版本号 string
resourceBundleDesc 资源包项目备注 string
versionName 应用版本名称 string
versionCode 应用版本号 number
versionDesc 应用描述 string

证书签名示例:


/Applications/wechatwebdevtools.app/Contents/MacOS/cli build-ipa --project /Users/test/project/miniprogram/mini-1 --output /Users/test/Downloads --isDistribute true --isRemoteBuild false --profilePath distribute/distribute_com_tencentdonutminiapp_db.mobileprovision --certificateName 'XIAO TU (AN99464A2B)' --p12Path distribute/distribute.p12 --p12Password 123456 --tpnsProfilePath '' --isUploadBeta false --isUploadResourceBundle false --resourceBundleVersion '' --resourceBundleDesc '' --versionName 0.0.66 --versionCode 103 --versionDesc 一个简单的备注

云构建示例:


/Applications/wechatwebdevtools.app/Contents/MacOS/cli build-ipa --project /Users/test/project/miniprogram/mini-1 --output /Users/test/Downloads --isDistribute true --isRemoteBuild true --profilePath distribute/distribute_com_tencentdonutminiapp_db.mobileprovision --certificateName 'XIAO TU (AN99464A2B)' --p12Path distribute/distribute.p12 --p12Password 123456 --tpnsProfilePath '' --isUploadBeta false --isUploadResourceBundle false --resourceBundleVersion '' --resourceBundleDesc '' --versionName 0.0.66 --versionCode 103 --versionDesc 一个简单的备注

# build-apk

cli build-apk 支持的参数如下:

参数名 功能说明 是否必填 参数类型
project 项目路径,需要为系统绝对路径 string
keyPass 证书密码 string
storePass 证书别名 string
keyAlias 证书别名 boolean
useAab 是否发布为AAB 发布格式为 AAB 需要为 true(否则为APK) boolean
keyStore 证书文件绝对路径 string
desc 版本描述 string
output 构建产物的保存路径,需要为系统绝对路径 string
isUploadResourceBundle 是否上传资源包 否,默认不上传 boolean
resourceBundleVersion 资源包版本号 否,如果选择上传资源包就必填 string
resourceBundleDesc 资源包项目备注 否,如果选择上传资源包就必填 string

示例:


/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/