# パッケージの公開 — AI Game DevアプリとCLI · AI Game Developer Wiki

AI Game Devコミュニティレジストリへのパッケージ公開：パブリッシャーの取得、アップロード、リリースノート、ベータチャネル、非推奨化、撤回、その他の共有方法について説明します。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/app/publishing-packages)。

コミュニティレジストリは、ユーザーが id でパッケージを見つけてインストールする場所です。`gamedev pkg add acme.level-tools` を実行するか、Packages ウィンドウの **Browse** から利用でき、自動更新と1〜5つ星の評価に対応しています。登録済みの ai-game.dev アカウントであれば誰でも公開でき、パッケージは無料で、すべてのバージョンは手動レビューの代わりに自動チェックを通過します。このページでは、パブリッシャー、最初のアップロード、リリースノート、プレリリースチャネル、非推奨化、撤回、そしてパッケージを共有するその他の方法まで、全体の流れを説明します。

![ai-game.dev のパッケージカタログ：注目のエンジンパッケージ、カテゴリフィルター、公式パッケージとコミュニティパッケージの行](https://ai-game.dev/images/wiki/app/catalog-packages.webp)

パッケージカタログ：公式パッケージとコミュニティパッケージ。それぞれにインストールコマンドが付いています。

## パブリッシャーを取得する

パブリッシャー id は、公開するすべてのパッケージ id の前半部分です（`acme.level-tools` の `acme`）。取得は一度だけで、先着順です。

```bash
gamedev login
gamedev pkg publisher claim acme --name "Acme Tools"
```

パブリッシャー id は2〜40文字の小文字、数字、単一のハイフンで構成されます。AI Game Dev 自身の id（`aigd`）、エンジン名（`unity`、`godot`、`unreal`、`brutal`、`bevy`、`threejs`）、商標、および `un1ty` や `unity-tools` のような類似名は予約されています。アカウントには確認済みのメールアドレスが必要で、最大3つのパブリッシャーを保持できます。

パブリッシャーを取得したアカウントがその **オーナー** です。オーナーはメールアドレスで **メンテナー** を追加できます。メンテナーはアップロード、撤回、非推奨化、リリースノートの編集、チャネルの移動、トークンの発行ができます。メンバーの管理と[信頼されたパブリッシャー](https://ai-game.dev/ja/docs/wiki/app/trusted-publishing)の管理はオーナーのみが行えます。

## バージョンを公開する

`aigd-package.json` に `"publisher": "acme"` を記述し、`version` を上げてビルドしたら、次を実行します。

```bash
gamedev pkg publish level-tools
```

CLI はフォルダをパックし（`gamedev pkg pack` と同じチェックとバイト列）、アップロードしてチェックを待ちます。バージョンは次の状態を遷移します。

| 状態 | 意味 |
| --- | --- |
| `uploaded`、`checking` | 自動チェックの待機中または実行中 |
| `published` | すべてのチェックに合格。約1分以内に署名済みインデックスに反映 |
| `rejected` | チェックに失敗。レポートに各失敗が示される。修正して同じバージョンを再度アップロードする |
| `yanked` | パブリッシャーによる取り下げ。バージョン範囲はこれをスキップし、既存のインストールは保持される |
| `revoked` | AI Game Dev による削除（マルウェア、アカウント乗っ取り）。すべてのアプリで無効化される |

**バージョンは不変です。** 公開済み、yanked、revoked のいずれかになったバージョン番号を再アップロードすることはできません。再アップロードできるのは rejected のものだけです。修正は新しいバージョンとして出してください。

![カタログ内のパッケージページ：名前、パブリッシャー、バージョン、インストールボタンとコマンド、スタータープレビュー、About パネル、最新リリース](https://ai-game.dev/images/wiki/app/catalog-package-page.webp)

カタログ内のコミュニティパッケージのページ。ユーザーはワンクリックまたは1つのコマンドでインストールできます。

## リリースノート

すべてのバージョンに Markdown のリリースノートを付けられます。ユーザーは Packages ウィンドウの **Versions** と、パブリッシャーパネルでバージョンごとに確認できます。アップロード時に指定します。

```bash
gamedev pkg publish level-tools --notes RELEASE_NOTES.md
```

`--notes` を指定しない場合、レジストリは `CHANGELOG.md`（パッケージフォルダ内にあり、アーカイブに含まれる）から、そのバージョンの見出し（`## 1.2.0`、`## [1.2.0]`、`## v1.2.0`）から次に現れる同じかより上位レベルの見出しまでのセクションを、20 KB に切り詰めて使用します。

```text
# Changelog

## [1.2.0]

- Export levels as glTF.
- Fix the collectible count in nested scenes.
```

ノートは最大 20 KB の Markdown で、README と同様にサニタイズされ、パッケージ内の他のすべてのテキストと同様にプロンプトインジェクションのチェックを受けます。メンバーは後からパブリッシャーパネルで編集できます。署名済みインデックスには最初の 4 KB が含まれ、残りへのリンクが付きます。

## チャネル：latest、beta、その他

チャネル（dist-tag）は、名前で要求されたときにユーザーが取得するバージョンを指定します。

```bash
gamedev pkg add acme.level-tools          # the latest channel
gamedev pkg add acme.level-tools@beta     # whatever beta points to
```

- プレリリース（`1.3.0-beta.1`）はデフォルトでは決してインストールされません。`latest` は、手動で設定しない限り公開済みの安定版のうち最も高いバージョンで、プレリリースを指すことはできません。
- その他のチャネルは自由に命名できます（`beta`、`next`、`nightly`）。小文字で、英字で始まり、最大16文字です。パッケージが持てるチャネルは `latest` を含めて最大5つです。
- yanked または revoked のバージョンにはタグを付けられません。yanked になったバージョンを指すチャネルは削除されます。
- プレリリースは semver のプレリリース（`1.3.0-beta.2`）として公開します。`alpha`、`beta`、`rc`、`next`、`preview`、`canary`、`nightly`、`dev`、`experimental` という名前のプレリリースは、メンバーが手動でチャネルを設定していない限り、そのチャネルを自動的に自身へ移動させます。また、任意のチャネルはパブリッシャーパネル（**Channels**）で移動させることもできます。
- `gamedev pkg add acme.level-tools@beta` はチャネルを `packages.json` に書き込みます: `{ "source": "^1.3.0-beta.1", "channel": "beta" }`。テスターは、チャネルのバージョンが最新の安定版より新しい間はそのバージョンを取得し、安定版がリリースされた後は次の更新時に安定版へ移行します。

## パッケージまたはバージョンを非推奨にする

非推奨化は、インストール済みのものを壊すことなくユーザーに移行を促す仕組みです:

- **パッケージ:** メッセージ(最大300文字)と、任意で代替パッケージの id。アプリと CLI はメッセージと代替パッケージを表示します。インストール済みのコピーは引き続き動作し、そのパッケージを追加することもできます。
- **バージョン:** 「ネストしたシーンのエクスポートでデータ損失が発生します。1.2.1 に更新してください」といったメッセージ。

バージョンを選択する際、アプリは非推奨でないものを優先します。どちらの種類も取り消し可能で、レジストリの監査ログに記録されます。設定はパブリッシャーパネルで行います。

## Yank と失効

誤って公開してしまったバージョンは Yank できます。以後、バージョン範囲の解決ではそのバージョンがスキップされ、すでにインストール済みの環境ではそのまま残ります。Yank は取り消し可能で、パブリッシャートークンでも実行できます。失効(Revocation)は、悪意のあるバージョンや盗まれたバージョンに対する AI Game Developer のキルスイッチです。失効したバージョンはインデックスから削除され、それを持っているすべてのアプリが次回のインデックス読み込み時に無効化します。

## CI からの公開

方法は 2 つあり、どちらも [Trusted Publishing](https://ai-game.dev/ja/docs/wiki/app/trusted-publishing) で説明しています:

- **Trusted Publishing(推奨):** GitHub Actions または GitLab CI が、どのリポジトリとワークフローが公開しているかを証明します。シークレットはどこにも保存されず、すべてのバージョンに出所が記録されます。すぐに使える GitHub Action と GitLab CI テンプレート [IvanMurzak/gamedev-publish-action](https://github.com/IvanMurzak/gamedev-publish-action) についてもそこで説明しています。
- **パブリッシャートークン:** `gamedev pkg publisher token create acme --label ci --days 90` を実行し、CI シークレットとして保存して `AI_GAME_DEV_PUBLISHER_TOKEN` として渡します。

## パブリッシャーパネル

最初のアップロード後にパブリッシャーが管理するものはすべて、[ai-game.dev/publisher](https://ai-game.dev/publisher) のパブリッシャーパネルにまとまっています(サインイン済みのオーナーとメンテナー向け): パブリッシャーとパッケージ、状態とチェックレポート付きのすべてのバージョン、リリースノート、チャネル、非推奨化と Yank、メンバーとロール、パブリッシャートークン、コピー可能なワークフロースニペット付きのトラステッドパブリッシャー。詳しくは [レジストリのルールとチェック](https://ai-game.dev/ja/docs/wiki/app/package-registry#panel) を参照してください。

## その他のソース: GitHub、npm、フォルダー

レジストリはパッケージを共有する唯一の方法ではありません。これらのソースはレジストリのチェックなしでインストールされるため、`gamedev pkg validate` を自分で実行してください。また、提案中の API を使うパッケージを共有するにはこの方法を使います:

```bash
gamedev pkg add github:acme/level-tools           # the default branch: moves with each push
gamedev pkg add github:acme/level-tools@v1.2.0    # a tag: pinned, never auto-updated
gamedev pkg add npm:acme-level-tools@^1.2.0       # an npm package and range
gamedev pkg add file:../level-tools               # a folder
```

- **GitHub:** タグを付けた場合、アプリは名前が `.aigd.tgz` で終わるリリースアセットをダウンロードします(`gamedev pkg pack` が書き出したファイルを添付してください)。それ以外の場合はそのコミット時点のリポジトリを取得するため、`aigd-package.json` がルートにあり、`dist/` がコミットされている必要があります。
- **npm:** パッケージフォルダーで `npm publish` を実行します。npm アーカイブには `aigd-package.json` と `dist/` が含まれている必要があります。さらに `package.json` に `"engines": { "aigd": "<range>" }` を追加すると、アプリは実行できないバージョンをダウンロードせずにスキップします。
- **チーム:** パッケージをプロジェクトレベルで追加すると `.ai-game-dev/packages.json` にコミットされ、プロジェクトのロックファイルで固定された同じバージョンをチームメイト全員が使えます。

## 関連ページ

- シークレットを保存せずに CI を使うための [Trusted Publishing](https://ai-game.dev/ja/docs/wiki/app/trusted-publishing)。
- チェックが何を拒否するかについては [レジストリのルールとチェック](https://ai-game.dev/ja/docs/wiki/app/package-registry) を参照してください。
- すべての `publish` オプションについては [パッケージ CLI リファレンス](https://ai-game.dev/ja/docs/wiki/app/package-cli#publish) を参照してください。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/app/publishing-packages

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/app/publishing-packages
