mp ci

Veröffentlichungsassistent für WeChat-Applets (Spiele) (mp-ci)

WeChat-Applet-(Spiel-)Veröffentlichungsassistent, unterstützt Vorschau und Hochladen. Kann in Verbindung mit Jenkins und GitHub Actions verwendet werden, um eine automatisierte Veröffentlichung zu erreichen.

Basierend auf dem offiziellen miniprogram-ci -Paket.

Merkmale

• Zum Anmelden muss kein QR-Code gescannt werden
• appid und setting automatisch lesen
• Intelligente Generierung von Einreichungsinformationen
• Verschönern Sie die Anzeige der Ausführungsergebnisse

Installation

// 全局安装
npm install -g mp-ci

// 本地安装
npm install --save-dev mp-ci

Vor der Verwendung müssen Sie als Mini-Programmadministrator auf „WeChat Public Platform-Development-Development Settings“ zugreifen, den Code-Upload-Schlüssel herunterladen und die IP-Whitelist konfigurieren, bevor Sie hochladen und eine Vorschau anzeigen können.

Dinge zu beachten

• Der Code-Upload-Schlüssel hat die Berechtigung, Codes in der Vorschau anzuzeigen und hochzuladen.
• Der Code-Upload-Schlüssel wird nicht im Klartext auf der öffentlichen WeChat-Plattform gespeichert. Sobald er verloren geht, muss er zurückgesetzt werden.
• Wenn die IP-Whitelist nicht konfiguriert ist, können Sie mp-ci nicht zur Vorschau und zum Hochladen verwenden.
• Sie können sich dafür entscheiden, IP nicht einzuschränken, aber stellen Sie sicher, dass Sie die Risiken verstehen

Verwendung

Usage: mp-ci [--options ...]

Options:
  -V, --version                  output the version number
  -h, --help                     display help for command

Commands:
  upload [options] [workspace]   上传代码
  preview [options] [workspace]  预览代码
  help [command]                 display help for command

workspace in Commands stellt das Projektverzeichnis dar. Standardmäßig wird das Befehlsausführungsverzeichnis verwendet. Gleichzeitig wird überprüft, ob die Datei project.config.json vorhanden ist, und appid und setting gelesen.

Der vom Befehl zurückgegebene Ergebniswert lautet wie folgt:

• 0: Erfolg
• 1: fehlgeschlagen

hochladen

Usage: mp-ci upload [options] [workspace]

上传代码

Options:
  --env [value]     环境 (default: " dev " )
  --type [value]    项目类型 (default: " miniProgram " )
  --ver [value]     发布版本号
  --desc [value]    发布简介
  --pkp [value]     私钥文件所在路径
  --proxy [value]   代理url
  --robot [value]   指定CI机器人，1 ~ 30 (default: " 1 " )
  -h, --help        display help for command

Vorschau

Usage: mp-ci preview [options] [workspace]

预览代码

Options:
  --env [value]          环境 (default: " dev " )
  --type [value]         项目类型 (default: " miniProgram " )
  --ver [value]          发布版本号
  --desc [value]         发布简介
  --pkp [value]          私钥文件所在路径
  --qr [value]           二维码文件的格式: terminal | base64 | image (default: " image " )
  --qrDest [value]       二维码文件保存路径  (default: " preview.png " )
  --pagePath [value]     预览页面路径
  --searchQuery [value]  预览页面路径启动参数，这里的&字符在命令行中应写成转义字符&
  --proxy [value]        代理url
  --robot [value]        指定CI机器人，1 ~ 30 (default: " 1 " )
  -h, --help             display help for command

veranschaulichen:

version & desc

• Regeln für die Versionsnummer der version
  • Versuchen Sie, version in der Datei package.json im Verzeichnis zu lesen
  • Zum Beispiel: 1.0.0
• desc Bemerkungsregeln
  • Lesen Sie die in der Befehlszeile übergebenen Umgebungsparameter: --env
  • Lesen Sie die in der Befehlszeile übergebenen Kommentarparameter: --desc
  • Erhalten Sie message des neuesten commit des Projekts ( git ).
  • Kombination: env: ${env} ${desc || message(hash)}
  • Zum Beispiel: env: dev 补充信息(e0c015a)

pkp

Speicherort der privaten Schlüsseldatei.

Greifen Sie als Miniprogramm-Administrator auf „WeChat Public Platform-Development-Development Settings“ zu und laden Sie den Schlüssel herunter.

qr

Zu den optionalen Werten gehören terminal , base64 und image .

qrDest

Wenn qr auf base64 oder image eingestellt ist, müssen Sie qrDest festlegen, um den Ausgabespeicherort (relativ zum Projektverzeichnis) anzugeben.

searchQuery

Vorschau der Seitenstartparameter.

Das & -Zeichen hier sollte als Escape-Zeichen & in der Befehlszeile geschrieben werden

Verwandte Ressourcen

• mp-ci-demo: Beispiel für die kontinuierliche Integration Taro und GitHub Actions