Taro CI 持续集成框架的配置与使用

痛点

使用 Taro 跨端框架开发小程序时，需要切换三个界面，进行三次操作，才能上传成功，上传代码步骤过于繁琐。

且多人开发时，如果想让自己代码生效，需要切换体验版代码为自己上传的版本。

vscode 打包 -> 微信开发者工具上传 -> 设置为体验版

方案

使用微信官方的 CI 插件包，即可实现命令行上传代码。

因为我使用的 Taro 本身就有 Taro CI，和 Taro 一样兼容了各个小程序平台，所以直接使用 Taro 提供的即可。

配置上传信息 -> vscode 命令行打包上传

Taro CI 完美解决我的痛点，而且因为是机器人上传，所以大家代码都可以上传到同一个体验版内，也不用切换界面，vscode 终端一行命令就可以完成打包上传操作。

环境

node: 14.17.3

Taro: 3.0.21

Taro CI: 3.5.3

实现

安装 `tarojs/plugin-mini-ci`

yarn add @tarojs/plugin-mini-ci -D

或

npm i @tarojs/plugin-mini-ci -D

配置参数

按照官方文档配置本地参数就可以了

Taro CI 官方文档

常见问题

打包报错

UnhandledPromiseRejectionWarning: TypeError: Cannot read property 'platform' of undefined Taro CI 持续集成框架的配置与使用此报错的原因是插件本身取值对象有问题，所以我们需要修改它的取值对象。

文件路径：node_modules\@tarojs\plugin-mini-ci\dist\index.js 51行

const platform = ctx.runOpts.options.platform;

修改为

const platform = ctx.runOpts.platform;

申请插件权限

插件安装以后是不能直接使用的（有时候也可以。。。），需要申请插件权限，需要用到 PostMan 等可以模拟请求的工具。

向插件开发者发起使用插件的申请

1. 获取 `access_token`

const config = {
  // 请求方式
  method: 'GET',
  // 请求地址
  url: 'https://api.weixin.qq.com/cgi-bin/token',
  // 请求参数
  param: {
    grant_type: 'client_credential', // 固定值
    appid: '', // 小程序 id
    secret: '', // 小程序密钥
  },
  // 示例
  example: 'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=123&secret=123'
}

2. 申请插件权限

const config = {
  // 请求方式
  method: 'POST',
  // 请求地址
  url: 'https://api.weixin.qq.com/wxa/plugin',
  // 请求参数
  param: {
    access_token: 'client_credential', // token
    action: 'apply', // 固定值
    plugin_appid: '', // 小程序 id
  },
}