Guía de publicación

Cómo
publicar

Publica tus libros y apps de Swift Playground en Swiftgrounds en cuatro pasos.

Swiftgrounds funciona leyendo un feed JSON que alojas en tu propio dominio. Tú mantienes el control de tu contenido, y Swiftgrounds simplemente lo hace descubrible. Así es como se configura.

1
Crea una cuenta
Regístrate con un nombre de usuario y un correo electrónico. Tu nombre de usuario se convierte en la URL de tu perfil público en swiftgrounds.dev/u/usuario. Puedes cambiar tu nombre de usuario una vez cada 30 días, así que elige uno con el que estés a gusto.
2
Añade y verifica tu dominio
En la configuración de tu cuenta, añade el dominio donde alojarás tu feed (por ejemplo, tusitio.com). Swiftgrounds te dará un código de verificación único. Demuestra la propiedad añadiendo una etiqueta meta a tu página de inicio o un archivo de texto en /.well-known/swiftgrounds-verification.txt. Una vez verificado, el dominio queda vinculado a tu cuenta de forma permanente, o hasta que lo elimines. Tu feed debe estar alojado en este dominio verificado.
3
Escribe tu feed JSON
Crea un archivo .json en tu dominio que describa tus libros de playground. El formato sigue el esquema original de feeds de suscripción de Apple. Cada entrada necesita un título, subtítulo, descripción, identificador de contenido, versión y URL de descarga. También puedes incluir imágenes en miniatura, imágenes de vista previa, nivel de dificultad y fechas de publicación.

Consulta el esquema completo y un ejemplo detallado en las Preguntas frecuentes → Formato del feed.
4
Envía la URL de tu feed
Ve a la página de Feed en tu cuenta y pega la URL de tu archivo JSON. Swiftgrounds lo obtendrá de inmediato, analizará las entradas y las listará en el índice. Cuando actualices tu feed, pulsa Actualizar para sincronizar la última versión. Eso es todo, tus playgrounds están publicados.

Consejos

  • Usa imágenes thumbnailURL de 902×678px para la mejor apariencia de las tarjetas en Swiftgrounds y Swift Playgrounds.
  • Configura difficultyLevel como beginner, intermediate, advanced o expert. Esto activa los filtros en el índice.
  • Si usas GitHub Pages, añade un archivo vacío .nojekyll en la raíz del repositorio para que la carpeta .well-known se sirva correctamente.
  • La URL del feed debe permanecer accesible y devolver JSON válido en todo momento. Los feeds con errores se marcan y pueden ocultarse del índice.

¿Preguntas?

Las Preguntas frecuentes cubren el formato completo del feed, la localización, la verificación de dominio y más.

¿Listo para empezar?
Crea tu cuenta y envía tu feed en minutos.
Crear cuenta