miniprogram-ci 使用说明

miniprogram-ci 使用说明

miniprogram-ci 是从微信开发者工具中抽离的关于小程序/小游戏项目代码的编译模块。

使用miniprogram-ci可以使得开发者不需要通过微信开发者工具进行小程序的上传与预览。

miniprogram-ci 提供了以下的能力

• 1. 上传代码，对应小程序开发者工具的上传
• 2. 预览代码，对应小程序开发者工具的预览
• 3. 构建 npm，对应小程序开发者工具的: 菜单 - 工具 - 构建npm
• 4. 上传云开发云函数代码，对应小程序开发者工具的上传云函数能力
• 5. 上传云托管代码，对应小程序开发者工具的上传云托管能力
• 6. 上传云存储/静态托管文件，对应小程序 开发者工具 - 云开发 - 云存储 和静态托管文件管理
• 7. 代理，配置 miniprogram-ci 的网络请求代理方式
• 8. 支持获取最近上传版本的 sourceMap
• 9. 支持 node 脚本调用方式和 命令行 调用方式

安装

先安装miniprogram-ci:

npm i miniprogram-ci -D
1

创建项目对象

创建项目对象是miniprogram-ci模块实现各种功能的基础。

const ci = require("miniprogram-ci");
const project = new ci.Project({
  appid: "wxsomeappid",
  type: "miniProgram",
  projectPath: "the/project/path",
  privateKeyPath: "the/privatekey/path",
  ignores: ["node_modules/**/*"],
});
1
2
3
4
5
6
7
8

注意： new ci.Project调用时，需要确保项目代码已经是完整的，避免编译过程出现找不到文件的报错。

接受参数如下：

上传

在配置好对象后，就可以进行项目代码的上传了。

const ci = require("miniprogram-ci");
const path = require("path");
const project = new ci.Project({
  appid: "wxsomeappid",
  type: "miniProgram",
  projectPath: process.cwd(),
  privateKeyPath: process.cwd() + "/privateKey.key",
  ignores: ["node_modules/**/*"],
});

ci.upload({
  project,
  version: "1.0.3",
  desc: "desc",
  setting: {
    es6: true,
    minify: true,
  },
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

upload方法中可配置的参数：

robot这个字段主要用于设置开发者，当同一份代码，指定不同的robot，在微信公众平台上的开发版本中都会生成对应的记录，而不是覆盖掉之前的版本。

setting字段可配置字段

• es6: 对应小程序开发者工具的 “es6 转 es5”
• es7: 对应小程序开发者工具的 “增强编译”
• minifyJS: 压缩 JS 代码
• minifyWXML: 压缩 WXML 代码
• minifyWXSS: 压缩 WXSS 代码
• minify: 压缩所有代码，对应小程序开发者工具的 “压缩代码”
• codeProtect: 对应小程序开发者工具的 “代码保护”
• autoPrefixWXSS: 对应小程序开发者工具的 “样式自动补全”

预览

ci.preview({
  project,
  setting: {
    es6: true,
  },
  desc: "desc",
  qrcodeFormat: "image",
  qrcodeOutputDest: path.join(__dirname, "qrcode.jpg"),
});
1
2
3
4
5
6
7
8
9

upload方法中可配置的参数：

使用预览功能，并不会将项目上传至微信公众平台的开发版本中。

获取本地编译后的代码

ci.getCompiledResult(
  {
    project,
    desc: "desc",
    version,
    setting: {
      es6: true,
      minify: true,
    },
  },
  path.join(__dirname, "compiledResult.zip")
);
1
2
3
4
5
6
7
8
9
10
11
12

接受两个参数，第一个参数跟预览的一样，第二个则是代码的保存路径。

构建 npm

当小程序中引入了npm下载的包，需要先进行构建才能使用。

ci.packNpm(project, {
  ignores: [],
  reporter: console.log,
});
1
2
3
4

接受两个参数，第一个参数是项目对象，第二个参数是一个对象，包含ignores（指定构建 npm 需要排除的规则）、reporter（构建回调信息）。

小程序中创建使用 npm

1. npm init生成package.json。
2. 安装依赖，比如说vant-weapp组件库。npm i vant-weapp -S
3. 调用packNpm方法，或者在开发者工具中的 工具 - 构建 npm
4. 使用。在 js 中使用require引入，组件的话需要在app.json中的usingComponents字段中引入。

拉取最近上传版本的sourceMap

ci.getDevSourceMap({
  project,
  robot: 1,
  sourceMapSavePath: "./sm.zip",
});
1
2
3
4
5

getDevSourceMap方法接受的参数:

上传开发云函数

ci.cloud.uploadFunction({
  project,
  env: "云开发 id",
  name: "add",
  path: path.join(__dirname, "cloudfunctions/index"),
  remoteNpmInstall: false,
});
1
2
3
4
5
6
7

uploadFunction方法接受的参数:

在上传云函数时，需要在project.config.json文件中先定义cloudfunctionRoot字段。