Leitfaden für Herausgeber

So
veröffentlichen

Lassen Sie Ihre Swift Playground Bücher und Apps in vier Schritten auf Swiftgrounds listen.

Swiftgrounds funktioniert, indem es einen JSON-Feed liest, den Sie auf Ihrer eigenen Domain hosten. Sie behalten die Kontrolle über Ihre Inhalte, und Swiftgrounds macht sie lediglich auffindbar. So richten Sie alles ein.

1
Konto erstellen
Registrieren Sie sich mit einem Benutzernamen und einer E-Mail-Adresse. Ihr Benutzername wird zu Ihrer öffentlichen Profil-URL unter swiftgrounds.dev/u/benutzername. Sie können Ihren Benutzernamen alle 30 Tage ändern – wählen Sie also einen Namen, mit dem Sie zufrieden sind.
2
Domain hinzufügen und verifizieren
Fügen Sie in den Kontoeinstellungen die Domain hinzu, auf der Sie Ihren Feed hosten möchten (z. B. ihreseite.de). Swiftgrounds gibt Ihnen einen eindeutigen Verifizierungscode. Weisen Sie die Inhaberschaft nach, indem Sie einen Meta-Tag auf Ihrer Startseite oder eine Textdatei unter /.well-known/swiftgrounds-verification.txt hinzufügen. Nach der Verifizierung ist die Domain dauerhaft mit Ihrem Konto verknüpft, bis Sie sie entfernen. Ihr Feed muss auf dieser verifizierten Domain gehostet werden.
3
Feed-JSON erstellen
Erstellen Sie eine .json-Datei auf Ihrer Domain, die Ihre Playground-Bücher beschreibt. Das Format folgt Apples ursprünglichem Abonnement-Feed-Schema. Jeder Eintrag benötigt einen Titel, Untertitel, eine Beschreibung, einen Inhaltsbezeichner, eine Version und eine Download-URL. Optional können Sie Vorschaubilder, Schwierigkeitsgrade und Veröffentlichungsdaten hinzufügen.

Das vollständige Schema und ein komplettes Beispiel finden Sie in den FAQ → Feed-Format.
4
Feed-URL einreichen
Gehen Sie zur Feed-Seite in Ihrem Konto und fügen Sie die URL zu Ihrer JSON-Datei ein. Swiftgrounds ruft sie sofort ab, analysiert die Einträge und listet sie im Verzeichnis. Wenn Sie Ihren Feed aktualisieren, klicken Sie auf Aktualisieren, um die neueste Version zu synchronisieren. Das war’s – Ihre Playgrounds sind online.

Tipps

  • Verwenden Sie thumbnailURL-Bilder mit 902×678px für die beste Kartendarstellung in Swiftgrounds und Swift Playgrounds.
  • Setzen Sie difficultyLevel auf beginner, intermediate, advanced oder expert. Dies steuert die Filterchips im Verzeichnis.
  • Wenn Sie GitHub Pages verwenden, fügen Sie eine leere .nojekyll-Datei im Stammverzeichnis des Repos hinzu, damit der .well-known-Ordner korrekt ausgeliefert wird.
  • Die Feed-URL muss jederzeit erreichbar sein und gültiges JSON zurückgeben. Fehlerhafte Feeds werden markiert und können aus dem Verzeichnis entfernt werden.

Fragen?

Die FAQ behandeln das vollständige Feed-Format, Lokalisierung, Domain-Verifizierung und mehr.

Bereit loszulegen?
Erstellen Sie Ihr Konto und reichen Sie Ihren Feed in wenigen Minuten ein.
Konto erstellen