Pakete veröffentlichen
Ein Paket in der AI Game Dev Community-Registry veröffentlichen: Publisher, Upload, Release Notes, Beta-Kanäle, Deprecation, Yanking.
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.

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:
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.
Eine Version veröffentlichen
Setze "publisher": "acme" in aigd-package.json, erhöhe version, baue, dann:
gamedev pkg publish level-toolsDie 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.

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:
gamedev pkg publish level-tools --notes RELEASE_NOTES.mdOhne --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:
# 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:
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:latestist 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,latesteingeschlossen. - 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 namensalpha,beta,rc,next,preview,canary,nightly,devoderexperimentalverschiebt 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@betaschreibt den Channel inpackages.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:
- 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, werden dort beschrieben.
- Ein Publisher-Token:
gamedev pkg publisher token create acme --label ci --days 90, als CI-Secret gespeichert und alsAI_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, 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.
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:
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.tgzendet (hängen Sie die Datei an, diegamedev pkg packgeschrieben hat); andernfalls das Repository an diesem Commit, daher mussaigd-package.jsonim Wurzelverzeichnis liegen unddist/eingecheckt sein. - npm: Führen Sie
npm publishfür den Paketordner aus. Das npm-Archiv mussaigd-package.jsonunddist/enthalten; fügen Sie außerdem"engines": { "aigd": "<range>" }zupackage.jsonhinzu, 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.jsoneingecheckt wird und jedes Teammitglied dieselbe Version erhält, festgeschrieben durch die Lock-Datei des Projekts.
Verwandte Seiten
- Trusted Publishing für CI ohne gespeichertes Secret.
- Regeln und Prüfungen der Registry dafür, was die Prüfungen ablehnen.
- CLI-Referenz für Pakete für alle
publish-Optionen.