Publicar y actualizar un deck con la CLI

ankiprotect-publish es la herramienta de línea de comandos con la que publicas. Hace dos cosas separadas: publicar convierte tu .apkg en un paquete protegido en tu ordenador, y upload lo sube a la plataforma.

Antes de empezar

• Un deck exportado de Anki como .apkg.
• Una empresa donde publicar, con tu rol de propietario o colaborador.
• Un token de autor en la variable de entorno ANKIPROTECT_AUTHOR_TOKEN. El token nunca es un flag.

Paso 1: generar el paquete

ankiprotect-publish mi-deck.apkg --deck-id deck-ejemplo --deck-version 1.0.0 --title "Deck de ejemplo" --author "Academia Ejemplo" --out ./salida

Obtienes tres ficheros en ./salida, con el nombre <deck-id>-<deck-version>:

• .apkgm: el paquete maestro cifrado. Es lo que subes.
• .manifest.json: el manifiesto, con los recuentos y los avisos.
• .key: la clave de contenido. Es secreta: no la compartas.

Si alguno de los tres ya existe, la herramienta se detiene; usa --force para sobrescribir.

Paso 2: ver el informe sin subir

ankiprotect-publish upload ./salida/deck-ejemplo-1.0.0.apkgm --server https://plataforma.example.com --company academia-ejemplo --dry-run

Con --dry-run calcula el informe de cambios y avisos sin crear la versión.

Paso 3: subir

Quita --dry-run para crear la versión. Con --strict, la herramienta no sube nada si el informe trae avisos.

Si algo falla

La herramienta sale con un código: 0 si todo fue bien, 1 si no se pudo completar y 2 si el uso es incorrecto, por ejemplo si falta el token. El mensaje de error dice qué ha pasado. Los códigos están en la referencia.

Actualizar un deck

Repite el mismo --deck-id con otro --deck-version. Lee Publicar una versión nueva para cuidar el progreso de tus alumnos.

Antes de publicar contenido nuevo

Mira lo que la app no ejecuta y, si quieres que los alumnos prioricen, marca la rentabilidad.