# Pakete veröffentlichen — AI Game Dev App & CLI · AI Game Developer Wiki

Ein Paket in der AI Game Dev Community-Registry veröffentlichen: Publisher, Upload, Release Notes, Beta-Kanäle, Deprecation, Yanking.

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/app/publishing-packages).

Die Community-Registry ist der Ort, an dem Nutzer Pakete per id finden und installieren: `gamedev pkg add acme.level-tools`, oder **Browse** im Packages-Fenster, mit automatischen Updates und Bewertungen von 1 bis 5 Sternen. Jedes registrierte Konto auf ai-game.dev kann veröffentlichen, Pakete sind kostenlos, und jede Version durchläuft automatische Prüfungen statt einer manuellen Review. Diese Seite deckt den gesamten Weg ab: deinen Publisher, den ersten Upload, Release Notes, Pre-Release-Kanäle, Deprecation, Yanking und die anderen Wege, ein Paket zu teilen.

![Der Paketkatalog auf ai-game.dev: ein hervorgehobenes Engine-Paket, Kategoriefilter und Reihen offizieller und Community-Pakete](https://ai-game.dev/images/wiki/app/catalog-packages.webp)

Der Paketkatalog: offizielle Pakete und Community-Pakete, jeweils mit ihrem Installationsbefehl.

## Einen Publisher beanspruchen

Deine Publisher-id ist die erste Hälfte jeder Paket-id, die du veröffentlichst (`acme` in `acme.level-tools`). Sie wird einmal beansprucht, und es gilt: wer zuerst kommt, mahlt zuerst:

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

Eine Publisher-id besteht aus 2 bis 40 Kleinbuchstaben, Ziffern und einzelnen Bindestrichen. Die eigene id von AI Game Dev (`aigd`), Engine-Namen (`unity`, `godot`, `unreal`, `brutal`, `bevy`, `threejs`), Marken und Verwechslungsnamen wie `un1ty` oder `unity-tools` sind reserviert. Ein Konto braucht eine verifizierte E-Mail und darf bis zu 3 Publisher halten.

Das Konto, das einen Publisher beansprucht, ist sein **Owner**. Ein Owner kann **Maintainer** per E-Mail hinzufügen; Maintainer dürfen hochladen, yanken, deprecaten, Release Notes bearbeiten, Kanäle verschieben und Tokens erzeugen. Nur ein Owner verwaltet Mitglieder und [vertrauenswürdige Publisher](https://ai-game.dev/de/docs/wiki/app/trusted-publishing).

## Eine Version veröffentlichen

Setze `"publisher": "acme"` in `aigd-package.json`, erhöhe `version`, baue, dann:

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

Die CLI packt den Ordner (dieselben Prüfungen und Bytes wie `gamedev pkg pack`), lädt ihn hoch und wartet auf die Prüfungen. Eine Version durchläuft diese Zustände:

| Zustand | Bedeutung |
| --- | --- |
| `uploaded`, `checking` | Wartet auf die automatischen Prüfungen oder führt sie aus |
| `published` | Hat alle Prüfungen bestanden; innerhalb von etwa einer Minute im signierten Index |
| `rejected` | Eine Prüfung ist fehlgeschlagen; der Bericht nennt jeden Fehler. Behebe ihn und lade dieselbe Version erneut hoch |
| `yanked` | Vom Publisher zurückgezogen: Versionsbereiche überspringen sie, bestehende Installationen behalten sie |
| `revoked` | Von AI Game Dev entfernt (Malware, ein gestohlenes Konto): jede App schaltet sie ab |

**Versionen sind unveränderlich.** Eine veröffentlichte, gezogene (yanked) oder widerrufene (revoked) Versionsnummer kann nie wieder hochgeladen werden; nur eine abgelehnte kann es. Liefere einen Fix als neue Version.

![Die Seite eines Pakets im Katalog: Name, Publisher, Version, Installationsbutton und -befehl, Starter-Vorschauen, ein About-Panel und das neueste Release](https://ai-game.dev/images/wiki/app/catalog-package-page.webp)

Die Seite eines Community-Pakets im Katalog. Nutzer installieren es mit einem Klick oder einem Befehl.

## Release Notes

Jede Version kann Release Notes in Markdown enthalten. Nutzer sehen sie pro Version im Packages-Fenster (**Versions**) und im Publisher-Panel. Gib sie beim Upload mit:

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

Ohne `--notes` nimmt die Registry den Abschnitt deiner `CHANGELOG.md` (im Paketordner, im Archiv ausgeliefert) ab der Überschrift der Version (`## 1.2.0`, `## [1.2.0]` oder `## v1.2.0`) bis zur nächsten Überschrift gleicher oder höherer Ebene, begrenzt auf 20 KB:

```text
# Changelog

## [1.2.0]

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

Notizen umfassen höchstens 20 KB Markdown, werden wie eine README bereinigt und wie jeder andere Text in einem Paket auf Prompt-Injection geprüft. Ein Mitglied kann sie später im Publisher-Panel bearbeiten. Der signierte Index enthält die ersten 4 KB mit einem Link zum Rest.

## Kanäle: latest, beta und andere

Ein Kanal (ein dist-tag) benennt die Version, die Nutzer erhalten, wenn sie ihn per Namen anfragen:

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

- Ein Pre-Release (`1.3.0-beta.1`) wird nie standardmäßig installiert: `latest` ist die höchste veröffentlichte stabile Version, sofern du sie nicht selbst setzt, und kann nie auf ein Pre-Release zeigen.
- Andere Kanäle benennst du selbst (`beta`, `next`, `nightly`): Kleinbuchstaben, beginnend mit einem Buchstaben, bis zu 16 Zeichen. Ein Paket hat höchstens 5 Kanäle, `latest` eingeschlossen.
- Eine gezogene oder widerrufene Version kann nicht getaggt werden; ein Kanal, der auf eine Version zeigt, die gezogen wird, wird entfernt.
- Veröffentliche ein Pre-Release als Semver-Pre-Release (`1.3.0-beta.2`). Ein Pre-Release namens `alpha`, `beta`, `rc`, `next`, `preview`, `canary`, `nightly`, `dev` oder `experimental` verschiebt diesen Kanal automatisch auf sich selbst, es sei denn, ein Mitglied hat den Kanal von Hand gesetzt; jeder Kanal kann auch im Publisher-Panel (**Channels**) verschoben werden.
- `gamedev pkg add acme.level-tools@beta` schreibt den Channel in `packages.json`, `{ "source": "^1.3.0-beta.1", "channel": "beta" }`. Tester erhalten die Version des Channels, solange sie neuer ist als die neueste stabile, und wechseln bei ihrem nächsten Update auf das stabile Release, sobald es erschienen ist.

## Ein Paket oder eine Version als veraltet markieren

Eine Deprecation sagt Nutzern, dass sie weiterziehen sollen, ohne dass etwas Installiertes kaputtgeht:

- **Ein Paket:** eine Nachricht (bis zu 300 Zeichen) und optional die ID eines Ersatzpakets. Die App und die CLI zeigen die Nachricht und das Ersatzpaket an; installierte Kopien funktionieren weiter, und das Paket kann weiterhin hinzugefügt werden.
- **Eine Version:** eine Nachricht wie "Datenverlust beim Exportieren verschachtelter Szenen, bitte auf 1.2.1 aktualisieren".

Bei der Auswahl einer Version bevorzugt die App eine, die nicht als veraltet markiert ist. Beide Arten sind umkehrbar und werden im Audit-Log der Registry protokolliert. Legen Sie sie im Publisher-Panel fest.

## Zurückziehen und widerrufen

Ziehen Sie eine Version zurück, die Sie versehentlich veröffentlicht haben: Versionsbereiche überspringen sie ab dann, und Installationen, die sie bereits haben, behalten sie. Das Zurückziehen ist umkehrbar, und ein Publisher-Token darf zurückziehen. Der Widerruf ist der Kill Switch von AI Game Dev für eine bösartige oder gestohlene Version: Sie verschwindet aus dem Index, und jede App, die sie hat, schaltet sie beim nächsten Lesen des Index ab.

## Aus der CI veröffentlichen

Zwei Wege, beide beschrieben in [Trusted Publishing](https://ai-game.dev/de/docs/wiki/app/trusted-publishing):

- **Trusted Publishing (empfohlen):** GitHub Actions oder GitLab CI weisen nach, welches Repository und welcher Workflow veröffentlicht; nirgends wird ein Secret gespeichert, und jede Version zeichnet ihre Herkunft auf. Eine fertige GitHub Action und eine GitLab-CI-Vorlage, [IvanMurzak/gamedev-publish-action](https://github.com/IvanMurzak/gamedev-publish-action), werden dort beschrieben.
- **Ein Publisher-Token:** `gamedev pkg publisher token create acme --label ci --days 90`, als CI-Secret gespeichert und als `AI_GAME_DEV_PUBLISHER_TOKEN` übergeben.

## Das Publisher-Panel

Alles, was ein Publisher nach dem ersten Upload verwaltet, findet sich im Publisher-Panel unter [ai-game.dev/publisher](https://ai-game.dev/publisher), für angemeldete Owner und Maintainer: Ihre Publisher und Pakete, jede Version mit ihrem Status und Prüfbericht, Release Notes, Channels, Deprecation und Yanking, Mitglieder und Rollen, Publisher-Tokens sowie Trusted Publisher mit kopierbaren Workflow-Snippets. Siehe [Regeln und Prüfungen der Registry](https://ai-game.dev/de/docs/wiki/app/package-registry#panel).

## Andere Quellen: GitHub, npm und Ordner

Die Registry ist nicht der einzige Weg, ein Paket zu teilen. Diese Quellen installieren ohne die Prüfungen der Registry, führen Sie also `gamedev pkg validate` selbst aus, und sie sind der Weg, ein Paket zu teilen, das Proposed API verwendet:

```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:** Mit einem Tag lädt die App ein Release-Asset herunter, dessen Name auf `.aigd.tgz` endet (hängen Sie die Datei an, die `gamedev pkg pack` geschrieben hat); andernfalls das Repository an diesem Commit, daher muss `aigd-package.json` im Wurzelverzeichnis liegen und `dist/` eingecheckt sein.
- **npm:** Führen Sie `npm publish` für den Paketordner aus. Das npm-Archiv muss `aigd-package.json` und `dist/` enthalten; fügen Sie außerdem `"engines": { "aigd": "<range>" }` zu `package.json` hinzu, damit die App Versionen überspringt, die sie nicht ausführen kann, ohne sie herunterzuladen.
- **Teams:** Fügen Sie das Paket auf Projektebene hinzu, damit es in `.ai-game-dev/packages.json` eingecheckt wird und jedes Teammitglied dieselbe Version erhält, festgeschrieben durch die Lock-Datei des Projekts.

## Verwandte Seiten

- [Trusted Publishing](https://ai-game.dev/de/docs/wiki/app/trusted-publishing) für CI ohne gespeichertes Secret.
- [Regeln und Prüfungen der Registry](https://ai-game.dev/de/docs/wiki/app/package-registry) dafür, was die Prüfungen ablehnen.
- [CLI-Referenz für Pakete](https://ai-game.dev/de/docs/wiki/app/package-cli#publish) für alle `publish`-Optionen.

---

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

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