# Publicar paquetes — App y CLI de AI Game Dev · AI Game Developer Wiki

Publica un paquete en el registro comunitario de AI Game Developer: publisher, subida, notas, canales beta, deprecación, yanking y otras fuentes.

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/app/publishing-packages).

El registro comunitario es donde los usuarios encuentran e instalan paquetes por id: `gamedev pkg add acme.level-tools`, o **Browse** en la ventana Packages, con actualizaciones automáticas y valoraciones de 1 a 5 estrellas. Cualquier cuenta registrada en ai-game.dev puede publicar, los paquetes son gratuitos y cada versión pasa comprobaciones automáticas en lugar de una revisión manual. Esta página cubre todo el recorrido: tu publisher, la primera subida, las notas de versión, los canales de versiones preliminares, la deprecación, el yanking y las demás formas de compartir un paquete.

![El catálogo de paquetes en ai-game.dev: un paquete de motor destacado, filtros de categoría y filas de paquetes oficiales y de la comunidad](https://ai-game.dev/images/wiki/app/catalog-packages.webp)

El catálogo de paquetes: paquetes oficiales y paquetes de la comunidad, cada uno con su comando de instalación.

## Reclama un publisher

Tu id de publisher es la primera mitad de cada id de paquete que publicas (`acme` en `acme.level-tools`). Reclámalo una vez; es por orden de llegada:

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

Un id de publisher tiene de 2 a 40 letras minúsculas, dígitos y guiones simples. El id propio de AI Game Dev (`aigd`), los nombres de motores (`unity`, `godot`, `unreal`, `brutal`, `bevy`, `threejs`), las marcas registradas y los nombres parecidos como `un1ty` o `unity-tools` están reservados. Una cuenta necesita un correo verificado y puede tener hasta 3 publishers.

La cuenta que reclama un publisher es su **propietario**. Un propietario puede añadir **mantenedores** por correo electrónico; los mantenedores pueden subir, retirar (yank), deprecar, editar notas de versión, mover canales y emitir tokens. Solo un propietario gestiona miembros y [publishers de confianza](https://ai-game.dev/es/docs/wiki/app/trusted-publishing).

## Publica una versión

Pon `"publisher": "acme"` en `aigd-package.json`, incrementa `version`, compila y después:

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

La CLI empaqueta la carpeta (las mismas comprobaciones y los mismos bytes que `gamedev pkg pack`), la sube y espera a las comprobaciones. Una versión pasa por estos estados:

| Estado | Significado |
| --- | --- |
| `uploaded`, `checking` | Esperando o ejecutando las comprobaciones automáticas |
| `published` | Ha pasado todas las comprobaciones; está en el índice firmado en aproximadamente un minuto |
| `rejected` | Ha fallado una comprobación; el informe indica cada fallo. Corrígelo y vuelve a subir la misma versión |
| `yanked` | Retirada por su publisher: los rangos la omiten, las instalaciones existentes la conservan |
| `revoked` | Eliminada por AI Game Dev (malware, una cuenta robada): todas las aplicaciones la desactivan |

**Las versiones son inmutables.** Un número de versión publicado, retirado (yanked) o revocado nunca se puede volver a subir; solo uno rechazado. Publica la corrección como una versión nueva.

![La página de un paquete en el catálogo: nombre, publisher, versión, botón y comando de instalación, previsualizaciones de starters, un panel About y la última versión publicada](https://ai-game.dev/images/wiki/app/catalog-package-page.webp)

La página de un paquete de la comunidad en el catálogo. Los usuarios lo instalan con un clic o un comando.

## Notas de versión

Cada versión puede incluir notas de versión en Markdown. Los usuarios las ven por versión en la ventana Packages (**Versions**) y en el panel del publisher. Indícalas al subir:

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

Sin `--notes`, el registro toma la sección de tu `CHANGELOG.md` (en la carpeta del paquete, incluida en el archivo) desde el encabezado de la versión (`## 1.2.0`, `## [1.2.0]` o `## v1.2.0`) hasta el siguiente encabezado del mismo nivel o uno superior, recortada a 20 KB:

```text
# Changelog

## [1.2.0]

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

Las notas son como máximo 20 KB de Markdown, se sanean como un README y se comprueban en busca de inyección de prompts como cualquier otro texto de un paquete. Un miembro puede editarlas después en el panel del publisher. El índice firmado incluye los primeros 4 KB, con un enlace al resto.

## Canales: latest, beta y otros

Un canal (una dist-tag) nombra la versión que reciben los usuarios cuando la piden por nombre:

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

- Una versión preliminar (`1.3.0-beta.1`) nunca se instala por defecto: `latest` es la versión estable publicada más alta a menos que la establezcas tú, y nunca puede apuntar a una versión preliminar.
- Los demás canales los nombras tú (`beta`, `next`, `nightly`): en minúsculas, empezando por una letra y con un máximo de 16 caracteres. Un paquete tiene como máximo 5 canales, `latest` incluido.
- Una versión retirada (yanked) o revocada no se puede etiquetar; un canal que apunta a una versión que se retira se elimina.
- Publica una versión preliminar como versión preliminar de semver (`1.3.0-beta.2`). Una versión preliminar llamada `alpha`, `beta`, `rc`, `next`, `preview`, `canary`, `nightly`, `dev` o `experimental` mueve ese canal a sí misma automáticamente, a menos que un miembro haya establecido el canal a mano; cualquier canal también se puede mover en el panel del publisher (**Channels**).
- `gamedev pkg add acme.level-tools@beta` escribe el canal en `packages.json`, `{ "source": "^1.3.0-beta.1", "channel": "beta" }`. Quien prueba obtiene la versión del canal mientras sea más nueva que la última estable, y pasa a la versión estable en cuanto se publica, en su siguiente actualización.

## Deprecar un paquete o una versión

La deprecación avisa a los usuarios de que deben migrar sin romper nada de lo que ya está instalado:

- **Un paquete:** un mensaje (de hasta 300 caracteres) y, opcionalmente, el id de un paquete de reemplazo. La app y la CLI muestran el mensaje y el reemplazo; las copias instaladas siguen funcionando y el paquete todavía se puede añadir.
- **Una versión:** un mensaje como «pérdida de datos al exportar escenas anidadas, actualiza a 1.2.1».

Al elegir una versión, la app prefiere una que no esté deprecada. Ambos tipos son reversibles y quedan registrados en el log de auditoría del registro. Se configuran en el panel del publicador.

## Retirar y revocar

Retira una versión que publicaste por error: a partir de entonces los rangos de versiones la omiten, y las instalaciones que ya la tienen la conservan. La retirada es reversible y un token de publicador puede retirar versiones. La revocación es el interruptor de emergencia de AI Game Dev para una versión maliciosa o robada: sale del índice y todas las apps que la tienen la desactivan en su siguiente lectura del índice.

## Publicar desde CI

Dos formas, ambas mostradas en [Trusted Publishing](https://ai-game.dev/es/docs/wiki/app/trusted-publishing):

- **Trusted Publishing (recomendado):** GitHub Actions o GitLab CI demuestran qué repositorio y qué workflow están publicando; no se guarda ningún secreto en ningún sitio y cada versión registra su procedencia. Allí se describen una GitHub Action y una plantilla de GitLab CI listas para usar, [IvanMurzak/gamedev-publish-action](https://github.com/IvanMurzak/gamedev-publish-action).
- **Un token de publicador:** `gamedev pkg publisher token create acme --label ci --days 90`, guardado como secreto de CI y pasado como `AI_GAME_DEV_PUBLISHER_TOKEN`.

## El panel del publicador

Todo lo que un publicador gestiona después de la primera subida está en el panel del publicador en [ai-game.dev/publisher](https://ai-game.dev/publisher), para propietarios y mantenedores con la sesión iniciada: tus publicadores y paquetes, cada versión con su estado y su informe de comprobaciones, notas de la versión, canales, deprecación y retirada, miembros y roles, tokens de publicador, y publicadores de confianza con fragmentos de workflow que puedes copiar. Consulta [Reglas y comprobaciones del registro](https://ai-game.dev/es/docs/wiki/app/package-registry#panel).

## Otras fuentes: GitHub, npm y carpetas

El registro no es la única forma de compartir un paquete. Estas fuentes se instalan sin las comprobaciones del registro, así que ejecuta `gamedev pkg validate` tú mismo, y son la forma de compartir un paquete que usa API propuesta:

```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:** con un tag, la app descarga un asset de la release cuyo nombre acaba en `.aigd.tgz` (adjunta el archivo que escribió `gamedev pkg pack`); si no, el repositorio en ese commit, así que `aigd-package.json` debe estar en la raíz y `dist/` debe estar commiteado.
- **npm:** publica la carpeta del paquete con `npm publish`. El archivo de npm debe contener `aigd-package.json` y `dist/`; añade también `"engines": { "aigd": "<range>" }` a `package.json`, para que la app se salte las versiones que no puede ejecutar sin descargarlas.
- **Equipos:** añade el paquete a nivel de Project para que quede commiteado en `.ai-game-dev/packages.json` y cada compañero de equipo obtenga la misma versión, fijada por el archivo de lock del proyecto.

## Páginas relacionadas

- [Trusted Publishing](https://ai-game.dev/es/docs/wiki/app/trusted-publishing) para hacer CI sin guardar ningún secreto.
- [Reglas y comprobaciones del registro](https://ai-game.dev/es/docs/wiki/app/package-registry) para saber qué rechazan las comprobaciones.
- [Referencia de la CLI de paquetes](https://ai-game.dev/es/docs/wiki/app/package-cli#publish) para todas las opciones de `publish`.

---

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

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