跳至主要內容
版本:6.x

搭配 pnpm 使用 Changesets

注意事項

在撰寫本文件時,最新的 pnpm 版本為 v6.14。 最新的 Changesets 版本為 2.16.0 版。

安装

要在 pnpm workspace 上設置 changesets ,請將 changesets 作為開發依賴項 安裝在 workspace 的根目錄中:

pnpm add -DW @changesets/cli

然後是 changesets 的初始化指令:

pnpm changeset init

添加新的 changesets

要生成新的 changesets,請在 workspace 的根目錄下運行 pnpm changesets 。 在 .changeset 目錄中生成的 markdown 文件應被 提交到 repository。

發布變更

  1. 執行 pnpm changeset version. 這將提高先前使用 pnpm changeset 的套件(以及它們的任何依賴項)的版本,並更新變更日誌(changelog) 文件。
  2. 執行 pnpm install。 這將會更新 lockfile 及重新打包套件。
  3. 提交更改
  4. 執行 pnpm publish -r。 此命令將發布所有包含被更新版本且尚未出現在註冊源中的套件。

使用 GitHub Actions

若要自動化這個流程,您可以將 changeset version 與 GitHub Actions 搭配使用。

提升版本號

The action will detect when changeset files arrive in the main branch, and then open a new PR listing all the packages with bumped versions. Once merged, the packages will be updated and you can decide whether to publish or not by adding the publish property.

發佈

通過新增 publish: pnpm ci:publish 這個執行 changeset publish 的腳本,一旦 PR 是由 changeset version 觸發,就會自動發布到註冊源。

name: Changesets
on:
push:
branches:
- main
env:
CI: true
PNPM_CACHE_FOLDER: .pnpm-store
jobs:
version:
timeout-minutes: 15
runs-on: ubuntu-latest
steps:
- name: checkout code repository
uses: actions/checkout@v3
with:
fetch-depth: 0
- name: setup node.js
uses: actions/setup-node@v3
with:
node-version: 14
- name: install pnpm
run: npm i pnpm@latest -g
- name: Setup npmrc
run: echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
- name: setup pnpm config
run: pnpm config set store-dir $PNPM_CACHE_FOLDER
- name: install dependencies
run: pnpm install
- name: create and publish versions
uses: changesets/action@master
with:
version: pnpm ci:version
commit: "chore: update versions"
title: "chore: update versions"
publish: pnpm ci:publish
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

有關此操作的更多資訊和文檔可以在這裡找到。