Ayuda & documentación

Preguntas
frecuentes

Todo lo que necesitas saber sobre publicar y descubrir playgrounds.

General
Swiftgrounds es una plataforma impulsada por la comunidad donde desarrolladores y estudiantes pueden compartir y descubrir proyectos de Swift Playground.

En enero de 2025, Apple eliminó la posibilidad de suscribirse a feeds de playground directamente desde la app Swift Playground.

Swiftgrounds se creó para llenar ese vacío: un lugar donde desarrolladores, educadores y estudiantes pueden seguir compartiendo y descubriendo Swift Playground usando el mismo formato de feed de suscripción que Apple diseñó originalmente.
1Crea una cuenta y verifica tu dominio.
2Aloja un feed JSON en tu dominio que describa tus playgrounds, con campos como título, descripción, nivel de dificultad y URL de descarga.
3Ve a tu página de Feed y envía la URL de tu feed.
4Swiftgrounds obtiene, analiza y muestra tus playgrounds automáticamente.
Documentación de Apple Developer: Publishing a Subscription
No. Swiftgrounds es un directorio, no un servicio de alojamiento. El objetivo es replicar la experiencia que Apple integró originalmente en la app Swift Playground, donde los publicadores alojaban el contenido en su propio dominio y la app se suscribía a sus feeds. Ese modelo otorga a los creadores la propiedad y el control total sobre su trabajo.

Tú alojas tus archivos de playground donde prefieras (GitHub Pages, tu sitio personal, un CDN) y los describes en un feed JSON. Swiftgrounds lee ese feed y hace que tus playgrounds sean descubribles. No hay paso de carga, ni límites de almacenamiento, ni dependencia. Tu contenido permanece en tu dominio.
Formato del feed
Swiftgrounds utiliza el mismo formato de feed JSON definido originalmente por Apple para las suscripciones de Swift Playground.

Campos obligatorios a nivel de feed:
formatVersion, title, publisherName, feedIdentifier, contactURL, documents

Campos obligatorios de documento:
title, overviewSubtitle, description, contentIdentifier, contentVersion, url
JSON 
{
  "title": "My Playgrounds",
  "publisherName": "Your Name",
  "feedIdentifier": "com.example.feed",
  "contactURL": "https://example.com",
  "formatVersion": "1.0",
  "documents": [ ... ]
}
Documentación de Apple Developer: Creating a Subscription
Los campos opcionales de documento incluyen detailSubtitle, difficultyLevel (beginner, intermediate, advanced, expert), publishedDate, lastUpdatedDate (ISO 8601), thumbnailURL (902×678px), bannerImageURL (1080×400px), previewImageURLs (800×600px) y additionalInformation.

El array additionalInformation almacena metadatos adicionales como pares de nombre/valor, cada uno con un campo name, value y un campo opcional type ("string" o "date").
Sí. Para soportar varios idiomas, la URL principal de tu feed apunta a un objeto JSON que mapea identificadores de idioma a archivos de feed localizados:
JSON 
{
  "en": "en-feed.json",
  "fr": "fr-feed.json",
  "es": "es-feed.json"
}
Cada feed localizado sigue el formato estándar.
Documentación de Apple Developer: Localizing a Subscription Feed
Sí. Apple presentó una sesión completa sobre la creación y publicación de suscripciones de Swift Playground en la WWDC 2018. Cubre el formato del feed en profundidad, incluyendo la estructura de capítulos, la adición de recursos y el alojamiento de tu feed.

La página en el sitio web de Apple Developer ya no está listada, pero el vídeo y las diapositivas siguen siendo accesibles.
WWDC18 · Session 413 · 35:23
Create Your Own Swift Playgrounds Subscription
Holly Borla & Grace Kendall
HD SD Slides
Verificación de dominio
La verificación de dominio demuestra que eres propietario del dominio donde se aloja tu feed. Esto evita que alguien envíe un feed desde un dominio que no controla. La URL de tu feed debe estar alojada en tu dominio verificado.
Después de añadir tu dominio en la configuración de tu cuenta, recibirás un código de verificación. Puedes verificar usando cualquiera de estos métodos:

Método 1: Etiqueta meta.
Añade esto al <head> de tu página de inicio:
HTML 
<meta name="swiftgrounds-verification" content="your-code">
Método 2: Archivo de texto.
Crea un archivo en /.well-known/swiftgrounds-verification.txt que contenga tu código de verificación.
GitHub Pages usa Jekyll por defecto, que ignora archivos y carpetas que comienzan con un punto (como .well-known). Soluciónalo añadiendo un archivo vacío .nojekyll en la raíz de tu repositorio:

Shell 
touch .nojekyll
git add .nojekyll
git commit -m "Disable Jekyll processing"
git push
Como alternativa, usa el método de la etiqueta meta. No requiere la carpeta .well-known en absoluto.
Cuenta
Sí, pero para prevenir abusos, los cambios de nombre de usuario están limitados. Después de cambiar tu nombre de usuario, deberás esperar antes de poder cambiarlo de nuevo. La fecha exacta en la que puedes volver a cambiarlo se muestra en tu página de Cuenta.
Las fotos de perfil son proporcionadas por Gravatar.

Para actualizar tu foto, crea o actualiza tu cuenta de Gravatar usando la misma dirección de correo electrónico con la que te registraste en Swiftgrounds.
Eliminar tu cuenta borra permanentemente todos tus datos, incluyendo tu perfil, feed, playgrounds y verificación de dominio. Esta acción no se puede deshacer.