中文使用文档 利用 GitHub Actions 实现小程序的持续集成
A GitHub Action to automate deploying WeChat MiniProgram by using miniprogram-ci.
It will enable workflows to easily preview and upload your MiniProgram to the WeChat.
The implementation of preview or upload is the same as VSCode extension miniprogram-vscode-extension.
Here's an example workflow which publishes an extension when you push to the master branch.
name: Preview MiniProgramon:
push:
branches:
- masterjobs:
preview:
runs-on: ubuntu-lateststeps:
- name: Checkoutuses: actions/checkout@v3
- id: previewname: Compileuses: crazyurus/miniprogram-action@2.0.0with:
action_type: previewenv:
PRIVATE_KEY: ${{ secrets.PRIVATE_KEY }}
- name: QR Codeuses: peter-evans/commit-comment@v2with:
body: | Copy the following content to the address bar of the browser to open the preview QR code ``` ${{ steps.preview.outputs.preview_qrcode }} ```name: Upload MiniProgramon:
push:
tags:
- "*.*.*"jobs:
upload:
runs-on: ubuntu-lateststeps:
- name: Checkoutuses: actions/checkout@v3
- name: Uploaduses: crazyurus/miniprogram-action@2.0.0with:
action_type: uploadversion: ${{ github.ref_name }}env:
PRIVATE_KEY: ${{ secrets.PRIVATE_KEY }}| Name | Required | Description | Default Value |
|---|---|---|---|
| action_type | false | Action type, preview or upload | upload |
| project_path | false | Project path, which contains project.config.json | . |
| page_path | false | Page path, one of the pages in app.json | |
| page_query | false | Page query | |
| scene | false | Scene code | 1011 |
| version | false | Publish version | 1.0.0 |
| description | false | Release notes | |
| ci | false | Number of CI | 24 |
| Name | Always | Description | Default Value |
|---|---|---|---|
| preview_qrcode | false | The base64 content of the MiniProgram to preview the QR code | |
| preview_qrcode_path | false | The file path of the MiniProgram to preview the QR code |
The PRIVATE_KEY secret is used to authenticate with WeChat when running the miniprogram-ci CLI. You can find out how to create this token here on the WeChat Developers: CI
There are mainly the following primary steps:
- Login to https://mp.weixin.qq.com
- Find "开发" - "开发设置" - "小程序代码上传"
- Generate private key and download key file, and close IP whitelist
- Copy the contents of the key file and add in GitHub repository settings. Find "Settings" - "Secrets" - "Actions", and click "New repository secret" button. Enter the "Name" as
PRIVATE_KEY, and "Secret" as the contents of the key file
- Preview MiniProgram if the
masterbranch has changed since the last build. - Upload MiniProgram when the tag is created on GitHub.
Here is a example project recruit-miniprogram