@vnxjs/plugin-mini-ci v3.5.66

@vnxjs/plugin-mini-ci

After the Vnmf applet is built, it supports CI (continuous integration) plug-ins. It supports to automatically open the applet to develop this tool after the build is completed, upload it as a trial version, and generate a preview QR code. Currently, only WeChat, Byte, Alipay, Baidu applet

use

Install

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

Using plugins

/config/index.js

// For example, if you use `vs code` as a development tool, you can also use the comment syntax to import the declaration file included in the plugin to get friendly prompts similar to typescript
/**
 * @typedef { import("@vnxjs/plugin-mini-ci").CIOptions } CIOptions
 * @type {CIOptions}
 */
const CIPluginOpt = {
    weapp: {
        appid: "WeChat applet appid",
        privateKeyPath: "The relative path of the key file relative to the project root directory, such as key/private.appid.key"
    },
    tt: {
        email: "Byte applet mailbox",
        password: "Byte applet password"
    },
    alipay: {
      appId: "Alipay applet appId",
      toolId: "tool id",
      privateKeyPath: "The relative path of the key file relative to the project root directory, such as key/pkcs8-private-pem"
    },
    swan: {
      token: "The token token required for authentication"
    },
    // version number
    version: "1.0.0",
    // release description
    desc: "version description"
}
const config = {
  plugins: [
    [ "@vnxjs/plugin-mini-ci", CIPluginOpt ]
  ]
}

Configuration Commands

The scripts field of package.json uses command parameters

{
    "scripts": {
            // Automatically "open developer tools" after build
           "build:weapp": "vnmf build --type weapp --open",
            // Automatically "upload code as trial version" after building
           "build:weapp:upload": "vnmf build --type weapp --upload",
            // Automatically "upload code as development version and generate preview QR code" after building
           "build:weapp:preview": "vnmf build --type weapp --preview"
    },
    "vnmfConfig": {
        "version": "1.0.0",
        "desc": "Upload description"
    }
}

As can be seen from the above example, the plugin extends the vnmf cli command with 3 options:

• --open Open developer tools, similar to automatically opening Google Chrome in web development
• --upload Upload the code as a trial version
• --preview Upload the code as a development version and generate a preview QR code

These three options cannot be used at the same time in one command

##API

Plugin configuration

WeChat Mini Program CI Configuration

Official CI documentation click here

Toutiao applet CI configuration

Official CI documentation click here

Alipay applet CI configuration

Terminal type values ​​and their meanings:

alipay: Alipay

ampe: AMPE

amap: Gaode

genie: Tmall Genie

alios: ALIOS

uc: UC

quark: quark

taobao: Taobao

koubei: word of mouth

alipayiot: IoT

cainiao: rookie

alihealth: Ali Health

Official CI documentation click here

Baidu Mini Program CI Configuration

Official CI documentation click here

ts interface description

export interface IOptions {
  version?: string;
  desc?: string;
  weapp?: WeappConfig;
  tt?: TTConfig;
  alipay?: AlipayConfig;
  swan?: SwanConfig;
}

/** WeChat applet configuration */
export interface WeappConfig {
  /** The appid of the applet/minigame item */
  appid: string;
  /** Private key, used for authentication when obtaining project properties and uploading (required) */
  privateKeyPath: string;
  /** WeChat developer tools installation path */
  devToolsInstallPath?: string;
  /** The path of the uploaded applet (default outputPath ) */
  projectPath?: string;
  /** Type, default miniProgram applet */
  type?: ProjectType;
  /** Upload directories to be excluded */
  ignores?: Array<string>;
}

/** Toutiao applet configuration */
export interface TTConfig {
  email: string;
  password: string;
}

/** terminal type */
export type ClientType =
/** Alipay */'alipay' |
/** AMPE */'ampe' |
/** Gaode */'amap' |
/** Tmall Genie */'genie'|
/** ALIOS */ 'alios'|
/** UC */'uc'|
/** quark */ 'quark'|
/** Taobao */ 'taobao'|
/** Word of mouth */'koubei' |
/** loT */'alipayiot'|
/** Rookie */'cainiao' |
/** Ali Health */ 'alihealth'

/** Alipay series applet configuration */
export interface AlipayConfig {
  /** applet appId */
  appId: string;
  /** tool id */
  toolId: string;
  /** Tool private key */
  privateKey: string;
  /** Service proxy address (optional) */
  proxy?: string;
  /** Upload terminal, default alipay */
  clientType?: ClientType;
}

/** Baidu applet configuration */
export interface SwanConfig {
  /** The login key that has the permission to publish the applet */
  token: string;
  /** Minimum base library version, default is 3.350.6 if not passed */
  minSwanVersion?: string;
}