Guide de l’éditeur

Comment
publier

Référencez vos livres et apps Swift Playground sur Swiftgrounds en quatre étapes.

Swiftgrounds fonctionne en lisant un flux JSON que vous hébergez sur votre propre domaine. Vous gardez le contrôle de votre contenu, et Swiftgrounds le rend simplement découvrable. Voici comment vous lancer.

1
Créer un compte
Inscrivez-vous avec un nom d’utilisateur et une adresse e-mail. Votre nom d’utilisateur devient l’URL de votre profil public à l’adresse swiftgrounds.dev/u/username. Vous pouvez changer votre nom d’utilisateur une fois tous les 30 jours, alors choisissez-en un qui vous convient.
2
Ajouter et vérifier votre domaine
Dans les paramètres du compte, ajoutez le domaine où vous hébergerez votre flux (par ex. votresite.com). Swiftgrounds vous fournira un code de vérification unique. Prouvez que vous êtes propriétaire en ajoutant une balise meta à votre page d’accueil ou un fichier texte à l’adresse /.well-known/swiftgrounds-verification.txt. Une fois vérifié, le domaine est lié à votre compte de manière permanente, ou jusqu’à ce que vous le supprimiez. Votre flux doit être hébergé sur ce domaine vérifié.
3
Rédiger votre flux JSON
Créez un fichier .json sur votre domaine décrivant vos livres playground. Le format suit le schéma de flux par abonnement défini à l’origine par Apple. Chaque entrée nécessite un titre, un sous-titre, une description, un identifiant de contenu, une version et une URL de téléchargement. Vous pouvez également inclure des images miniatures, des images d’aperçu, un niveau de difficulté et des dates de publication.

Consultez le schéma complet et un exemple détaillé dans la FAQ → Format du flux.
4
Soumettre l’URL de votre flux
Rendez-vous sur la page Flux de votre compte et collez l’URL de votre fichier JSON. Swiftgrounds le récupérera immédiatement, analysera les entrées et les affichera dans le répertoire. Lorsque vous mettez à jour votre flux, cliquez sur Actualiser pour synchroniser la dernière version. C’est tout, vos playgrounds sont en ligne.

Conseils

  • Utilisez des images thumbnailURL de 902×678px pour un rendu optimal des cartes dans Swiftgrounds et Swift Playgrounds.
  • Définissez difficultyLevel sur beginner, intermediate, advanced ou expert. Cela alimente les filtres du répertoire.
  • Si vous utilisez GitHub Pages, ajoutez un fichier .nojekyll vide à la racine du dépôt pour que le dossier .well-known soit servi correctement.
  • L’URL du flux doit rester accessible et renvoyer un JSON valide en permanence. Les flux défaillants sont signalés et peuvent être retirés du répertoire.

Des questions ?

La FAQ couvre le format complet du flux, la localisation, la vérification de domaine et bien plus encore.

Prêt à vous lancer ?
Créez votre compte et soumettez votre flux en quelques minutes.
Créer un compte