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

workspace в Commands представляет каталог проекта. По умолчанию используется каталог выполнения команд. В то же время он проверяет, существует ли файл 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
  • Попробуйте прочитать version в файле package.json в каталоге.
  • Например: 1.0.0
• правила примечаний desc
  • Прочитайте параметры среды, переданные в командной строке: --env
  • Прочитайте параметры комментария, переданные в командной строке: --desc
  • Получить message о последнем commit проекта ( git ).
  • Комбинация env: ${env} ${desc || message(hash)}
  • Например: env: dev 补充信息(e0c015a)

pkp

Местоположение файла закрытого ключа.

Откройте «Настройки общедоступной платформы WeChat-Разработка-Разработка» от имени администратора мини-программы и загрузите ключ.

qr

Необязательные значения включают terminal , base64 , image .

qrDest

Если для qr установлено значение base64 или image , вам необходимо установить qrDest , чтобы указать местоположение вывода (относительно каталога проекта).

searchQuery

Предварительный просмотр параметров запуска страницы.

Символ & здесь должен быть записан как escape-символ & в командной строке.

Связанные ресурсы

• mp-ci-demo: пример непрерывной интеграции Taro и GitHub Actions