mp ci

WeChat アプレット (ゲーム) パブリッシング アシスタント (mp-ci)

WeChat アプレット (ゲーム) 公開アシスタント、プレビューとアップロードをサポートします。 JenkinsおよびGitHub Actionsと組み合わせて使用​​して、自動リリースを実現できます。

公式のminiprogram-ciパッケージに基づいています。

特徴

• ログインするために QR コードをスキャンする必要はありません
• appidとsetting自動で読み込みます
• 提出情報のインテリジェントな生成
• 実行結果表示を美しくする

インストール

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

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

使用する前に、ミニ プログラム管理者として「WeChat パブリック プラットフォーム - 開発 - 開発設定」にアクセスし、コード アップロード キーをダウンロードし、アップロードしてプレビューする前に IP ホワイトリストを構成する必要があります。

注意事項

• コード アップロード キーには、コードをプレビューおよびアップロードする権限があります。
• コード アップロード キーは WeChat パブリック プラットフォームに平文で保存されません。紛失した場合は、安全に保管してください。
• IP ホワイトリストが設定されていない場合、 mp-ci使用してプレビューおよびアップロードすることはできません。
• IP を制限しないことも選択できますが、リスクを必ず理解してください。

使用法

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

Commandsのworkspaceは、デフォルトでは、コマンド実行ディレクトリが使用され、 project.config.jsonファイルが存在するかどうかが確認され、 appidとsettingが読み込まれます。

コマンドによって返される結果の値は次のとおりです。

• 0: 成功
• 1: 失敗しました

アップロード

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

プレビュー

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

例証します:

versionとdesc

• versionバージョン番号の規則
  • ディレクトリ内のpackage.jsonファイルのversionを読み取ってみます。
  • 例: 1.0.0
• descのルール
  • コマンドラインで渡された環境パラメータを読み取ります: --env
  • コマンドラインで渡されたコメントパラメータを読み取ります: --desc
  • プロジェクトの最新のcommitのmessageを取得します ( git )
  • 組み合わせenv: ${env} ${desc || message(hash)}
  • 例: env: dev 补充信息(e0c015a)

pkp

秘密キーファイルの場所。

ミニ プログラム管理者として「WeChat パブリック プラットフォーム - 開発 - 開発設定」にアクセスし、キーをダウンロードします。

qr

オプションの値には、 terminal 、 base64 、 imageが含まれます。

qrDest

qrがbase64またはimageに設定されている場合、 qrDest設定して出力場所 (プロジェクト ディレクトリを基準とした相対位置) を指定する必要があります。

searchQuery

プレビューページの起動パラメータ。

ここの&文字は、コマンド ラインではエスケープ文字&として記述する必要があります。

関連リソース

• mp-ci-demo: TaroとGitHub Actions継続的統合の例