メインコンテンツまでスキップ

パッケージの公開

AIDKはprivateパッケージ（@aquaringlab/aidk）としてGitHub Packagesに公開されます。完全なプロセスを以下に説明します。

前提条件​

  1. aquaringlab GitHub組織で write:packages 権限が必要です。
  2. write:packages スコープを持つGitHub Personal Access Token（PAT）が必要です。
  3. .npmrc ファイルが正しく設定されている必要があります。

ステップ1：GitHub PATを作成​

github.com/settings/tokens → Generate new token (Classic) にアクセスします。

以下のスコープを選択します：

  • write:packages
  • read:packages
  • repo

ステップ2：.npmrc の設定​

ローカルの ~/.npmrc に以下を追加します：

@aquaringlab:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=YOUR_GITHUB_PAT
注意

実際のトークンを .npmrc にコミットしないでください。~/.npmrc または環境変数を使用してください。

ステップ3：公開前のビルド​

npm run build

dist/ ディレクトリのビルド出力を確認します。

ステップ4：バージョンの更新​

セマンティックバージョニング に従って npm version で package.json を更新します：

# パッチ（0.2.0 -> 0.2.1）
npm version patch

# マイナー（0.2.0 -> 0.3.0）
npm version minor

# メジャー（0.2.0 -> 1.0.0）
npm version major

ステップ5：公開​

npm publish

package.json の prepublishOnly スクリプトが公開前に自動的に npm run build を実行します。

GitHub Actionsによる自動公開​

上記の手動プロセスは緊急時のみです。通常、aquaringlab/lab-tool-ai-kit リポジトリに v* タグをプッシュするとGitHub Actionsが自動的に公開を行います。

git tag -a v0.16.0 -m "chore: release v0.16.0"
git push aql main --follow-tags

公開後の確認​

公開後、パッケージが以下の場所に表示されることを確認します：

  • GitHub Packages：https://github.com/aquaringlab/lab-tool-ai-kit/packages
  • またはインストールを試みる：npm install -g @aquaringlab/aidk@<version>

CHANGELOGの更新​

新しいバージョンの変更を記録するために、公開前に常に CHANGELOG.md を更新してください。