Aide et documentation

Questions
fréquentes

Tout ce que vous devez savoir sur la soumission et la découverte de playgrounds.

Général
Swiftgrounds est une plateforme communautaire où les développeurs et les étudiants peuvent partager et découvrir des projets Swift Playground.

En janvier 2025, Apple a supprimé la possibilité de s’abonner aux flux de playgrounds directement depuis l’application Swift Playground.

Swiftgrounds a été créé pour combler ce vide : un espace où les développeurs, les enseignants et les étudiants peuvent continuer à partager et découvrir des Swift Playground en utilisant le même format de flux par abonnement conçu à l’origine par Apple.
1Créez un compte et vérifiez votre domaine.
2Hébergez un flux JSON sur votre domaine décrivant vos playgrounds, avec des champs comme le titre, la description, le niveau de difficulté et l’URL de téléchargement.
3Rendez-vous sur votre page Flux et soumettez l’URL de votre flux.
4Swiftgrounds récupère, analyse et affiche vos playgrounds automatiquement.
Documentation Apple Developer : Publishing a Subscription
Non. Swiftgrounds est un répertoire, pas un service d’hébergement. L’objectif est de reproduire l’expérience qu’Apple avait intégrée à l’origine dans l’application Swift Playground, où les éditeurs hébergeaient leur contenu sur leur propre domaine et l’application s’abonnait à leurs flux. Ce modèle donne aux créateurs la pleine propriété et le contrôle de leur travail.

Vous hébergez vos fichiers playground où vous le souhaitez (GitHub Pages, votre site personnel, un CDN) et les décrivez dans un flux JSON. Swiftgrounds lit ce flux et rend vos playgrounds découvrables. Il n’y a pas d’étape de téléversement, pas de limite de stockage et pas de dépendance. Votre contenu reste sur votre domaine.
Format du flux
Swiftgrounds utilise le même format de flux JSON défini à l’origine par Apple pour les abonnements Swift Playground.

Champs obligatoires au niveau du flux :
formatVersion, title, publisherName, feedIdentifier, contactURL, documents

Champs obligatoires au niveau du document :
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": [ ... ]
}
Documentation Apple Developer : Creating a Subscription
Les champs optionnels du document incluent detailSubtitle, difficultyLevel (beginner, intermediate, advanced, expert), publishedDate, lastUpdatedDate (ISO 8601), thumbnailURL (902×678px), bannerImageURL (1080×400px), previewImageURLs (800×600px) et additionalInformation.

Le tableau additionalInformation stocke des métadonnées supplémentaires sous forme de paires nom/valeur, chacune avec un champ name, value et un champ optionnel type ("string" ou "date").
Oui. Pour prendre en charge plusieurs langues, l’URL principale de votre flux pointe vers un objet JSON qui associe des identifiants de langue à des fichiers de flux localisés :
JSON 
{
  "en": "en-feed.json",
  "fr": "fr-feed.json",
  "es": "es-feed.json"
}
Chaque flux localisé suit le format standard.
Documentation Apple Developer : Localizing a Subscription Feed
Oui. Apple a présenté une session complète sur la création et la publication d’abonnements Swift Playground lors de la WWDC 2018. Elle couvre en détail le format du flux, y compris la structuration des chapitres, l’ajout de ressources et l’hébergement du flux.

La page sur le site Apple Developer n’est plus référencée, mais la vidéo et les diapositives restent accessibles.
WWDC18 · Session 413 · 35:23
Create Your Own Swift Playgrounds Subscription
Holly Borla & Grace Kendall
HD SD Slides
Vérification de domaine
La vérification de domaine prouve que vous êtes propriétaire du domaine où votre flux est hébergé. Cela empêche quiconque de soumettre un flux depuis un domaine qu’il ne contrôle pas. L’URL de votre flux doit être hébergée sur votre domaine vérifié.
Après avoir ajouté votre domaine dans les paramètres du compte, vous recevrez un code de vérification. Vous pouvez vérifier en utilisant l’une des méthodes suivantes :

Méthode 1 : Balise meta.
Ajoutez ceci dans le <head> de votre page d’accueil :
HTML 
<meta name="swiftgrounds-verification" content="your-code">
Méthode 2 : Fichier texte.
Créez un fichier à l’adresse /.well-known/swiftgrounds-verification.txt contenant votre code de vérification.
GitHub Pages utilise Jekyll par défaut, qui ignore les fichiers et dossiers commençant par un point (comme .well-known). Corrigez cela en ajoutant un fichier .nojekyll vide à la racine de votre dépôt :

Shell 
touch .nojekyll
git add .nojekyll
git commit -m "Disable Jekyll processing"
git push
Vous pouvez aussi utiliser la méthode de la balise meta. Elle ne nécessite pas du tout le dossier .well-known.
Compte
Oui, mais pour prévenir les abus, les changements de nom d’utilisateur sont limités. Après avoir changé votre nom d’utilisateur, vous devrez attendre avant de pouvoir le modifier à nouveau. La date exacte à laquelle vous pourrez le changer est indiquée sur votre page Compte.
Les photos de profil sont fournies par Gravatar.

Pour mettre à jour votre photo, créez ou mettez à jour votre compte Gravatar en utilisant la même adresse e-mail que celle utilisée lors de votre inscription sur Swiftgrounds.
La suppression de votre compte entraîne la suppression définitive de toutes vos données, y compris votre profil, votre flux, vos playgrounds et la vérification de votre domaine. Cette action est irréversible.