JSPM

applets-helper 支持市场上主流的小程序，在脱离IDE工具的情况下，通过命令行工具可以快速发布预览和体验版本，同时集成了邮件和企业微信等通知方式，方便持续构建和快速部署（Jenkins/Gilab CI）和通知测试人员跟进测试。

一、前置依赖&要求

1.1 安装applets

npm install applets-helper -g

1.2 通知模块配置

创建applets.global.json文件，下面是相关配置说明，注入到全局配置，配置信息如下：

{
    "wecom"   : {
        "key" : "xxxxx"
    },
    "email"   : {
        "service":"163", 
        "secureConnection": true,
        "auth": {
            "user": "user",
            "pass": "password"
        },
        "recipient": ["xxx@gmail.com"],
        "cc": ["xxx@qq.com"]
    }
}

1.3 企业微信

在群聊右击，添加群机器人，随后给hook的url地址，把key值记录下来，具体示例：

"wecom": {
    // 是否启用企业微信通知，默认启用
    "enable": true,
    "key": "xxxxx"
}

1.4 配置邮件

邮件模块支持基于nodemailer，配置信息请参考文档的nodemailer.createTransport配置（https://nodemailer.com/smtp/） ，示例如下：

nodemailer.createTransport({
  host: "smtp.example.com",
  port: 587,
  secure: false,
  auth: {
    user: "username",
    pass: "password"
  }
});

除此之前还额外增加recipient（收件人）和cc（抄送）两个参数配置，具体示例：

"email": {
    // 是否启用邮件，默认启动
    "enable": true,
    "service": "163",
    "secureConnection": true,
    "auth": {
        "user": "user",
        "pass": "password"
    },
    "recipient": [
        "xxx@gmail.com"
    ],
    "cc": []
}

1.5 初始化&重置全局配置

然后通过提供的命令行注入：

applets --config applets.global.json

二、发布支付宝小程序

官方cli工具文档地址：https://opendocs.alipay.com/mini/tool/sdk

2.1 获取toolId和私钥方式

https://opendocs.alipay.com/mini/alipaydev

2.1.1、alipay-dev生成公钥和私钥

alipaydev key create -w

# 根据打开的路径输出以下文件
公钥已保存到: path\pkcs8-public-pem
私钥已保存到: path\pkcs8-private-pem

2.1.2、获取toolId

填写上面生成的公钥信息(pkcs8-public-pem)，生成toolId https://openhome.alipay.com/dev/workspace/key-manage/tool

2.2、项目配置

在小程序项目文件夹下，创建applets.local.json文件，具体如下：

{
    "name": "applets test",
    // 版本号，提交小程序体验版时，要求版本号必须递增
    "version": "1.0.0",
    "toolId": "工具id",
    "appId" : "应用id",
    "privateKey": "pkcs8-private-pem的内容"	
}

2.3、命令参数

# 打开项目目录（根目录）
cd /path/project

# 提交预览版本
applets --alipay preview

# 提交体验版本
applets --alipay upload

三、发布微信小程序

官方cli工具文档地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/ci.html

3.1、获取密钥信息

获取小程序上传密钥，访问"微信公众平台（https://mp.weixin.qq.com/）-开发-开发设置"后下载代码上传密钥 分别得到"AppID"和"代码上传密钥"。

秘钥文件格式一般为: private.wx4546464564.key

建议将文件保存到项目根下，或者统一目录存放，后面配置privateKeyPath注意填写，固定路径写绝对路径，建议是相对路径

3.2、IP白名单配置

这个视个人情况而定，开发机器公网IP地址固定，可以配置白名单IP地址，安全性更高些，如果IP地址变化，建议不开启，直接跳过该配置。

3.3、项目配置

在小程序项目文件夹下，创建applets.local.json文件，具体如下：

{
    "name": "applets test",
    "version": "1.0.9",
    "appId" : "xxx",
    "privateKeyPath": "./private.wx820251fbda61f637.key"
}

3.4、如何获取体验版二维码

3.4.1 API 方式获取

操作过程步骤多，相对繁琐。 https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/Mini_Programs/code/get_qrcode.html

3.4.2 管理后台下载

小程序后台-管理-版本管理-开发版本-找到体验版二维码-下载 保存到小程序项目根目录下的"temp/"，并命名"upload-wechat.jpg"

3.5、命令参数

# 打开项目目录（根目录）
cd /path/project

# 提交预览版本
applets --wechat preview
 
# 提交体验版本
applets --wechat upload