Hilfe & Dokumentation

Häufig gestellte
Fragen

Alles, was Sie über das Einreichen und Entdecken von Playgrounds wissen müssen.

Allgemein
Swiftgrounds ist eine von der Community betriebene Plattform, auf der Entwickler und Schüler Swift Playground-Projekte teilen und entdecken können.

Im Januar 2025 hat Apple die Möglichkeit entfernt, Playground-Feeds direkt in der Swift Playground-App zu abonnieren.

Swiftgrounds wurde entwickelt, um diese Lücke zu füllen: ein Ort, an dem Entwickler, Pädagogen und Schüler weiterhin Swift Playgrounds teilen und entdecken können – mit demselben Abonnement-Feed-Format, das Apple ursprünglich entworfen hat.
1Erstellen Sie ein Konto und verifizieren Sie Ihre Domain.
2Hosten Sie einen JSON-Feed auf Ihrer Domain, der Ihre Playgrounds beschreibt – mit Feldern wie Titel, Beschreibung, Schwierigkeitsgrad und Download-URL.
3Gehen Sie zu Ihrer Feed-Seite und reichen Sie die URL zu Ihrem Feed ein.
4Swiftgrounds ruft Ihre Playgrounds automatisch ab, analysiert und zeigt sie an.
Apple Developer Documentation: Publishing a Subscription
Nein. Swiftgrounds ist ein Verzeichnis, kein Hosting-Dienst. Das Ziel ist es, die Erfahrung nachzubilden, die Apple ursprünglich in die Swift Playground-App integriert hatte: Herausgeber hosteten Inhalte auf ihrer eigenen Domain und die App abonnierte deren Feeds. Dieses Modell gibt Erstellern die volle Kontrolle über ihre Arbeit.

Sie hosten Ihre Playground-Dateien dort, wo Sie möchten (GitHub Pages, Ihre persönliche Website, ein CDN) und beschreiben sie in einem JSON-Feed. Swiftgrounds liest diesen Feed und macht Ihre Playgrounds auffindbar. Es gibt keinen Upload-Schritt, keine Speicherbegrenzungen und keine Abhängigkeit. Ihre Inhalte bleiben auf Ihrer Domain.
Feed-Format
Swiftgrounds verwendet dasselbe JSON-Feed-Format, das Apple ursprünglich für Swift Playground-Abonnements definiert hat.

Erforderliche Felder auf Feed-Ebene:
formatVersion, title, publisherName, feedIdentifier, contactURL, documents

Erforderliche Dokument-Felder:
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": [ ... ]
}
Apple Developer Documentation: Creating a Subscription
Optionale Dokument-Felder umfassen detailSubtitle, difficultyLevel (beginner, intermediate, advanced, expert), publishedDate, lastUpdatedDate (ISO 8601), thumbnailURL (902×678px), bannerImageURL (1080×400px), previewImageURLs (800×600px) und additionalInformation.

Das Array additionalInformation speichert zusätzliche Metadaten als Name/Wert-Paare, jeweils mit einem name-, value- und optionalem type-Feld ("string" oder "date").
Ja. Um mehrere Sprachen zu unterstützen, verweist Ihre Haupt-Feed-URL auf ein JSON-Objekt, das Gebietsschema-IDs lokalisierte Feed-Dateien zuordnet:
JSON 
{
  "en": "en-feed.json",
  "fr": "fr-feed.json",
  "es": "es-feed.json"
}
Jeder lokalisierte Feed folgt dem Standardformat.
Apple Developer Documentation: Localizing a Subscription Feed
Ja. Apple hat auf der WWDC 2018 eine vollständige Session zum Erstellen und Veröffentlichen von Swift Playground-Abonnements präsentiert. Sie behandelt das Feed-Format ausführlich, einschließlich der Strukturierung von Kapiteln, dem Hinzufügen von Ressourcen und dem Hosten Ihres Feeds.

Die Seite auf der Apple Developer-Website ist inzwischen nicht mehr gelistet, aber das Video und die Folien sind weiterhin zugänglich.
WWDC18 · Session 413 · 35:23
Create Your Own Swift Playgrounds Subscription
Holly Borla & Grace Kendall
HD SD Slides
Domain-Verifizierung
Die Domain-Verifizierung beweist, dass Sie die Domain besitzen, auf der Ihr Feed gehostet wird. Dies verhindert, dass jemand einen Feed von einer Domain einreicht, die er nicht kontrolliert. Ihre Feed-URL muss auf Ihrer verifizierten Domain gehostet werden.
Nachdem Sie Ihre Domain in den Kontoeinstellungen hinzugefügt haben, erhalten Sie einen Verifizierungscode. Sie können mit einer der beiden Methoden verifizieren:

Methode 1: Meta-Tag.
Fügen Sie dies zum <head> Ihrer Startseite hinzu:
HTML 
<meta name="swiftgrounds-verification" content="your-code">
Methode 2: Textdatei.
Erstellen Sie eine Datei unter /.well-known/swiftgrounds-verification.txt, die Ihren Verifizierungscode enthält.
GitHub Pages verwendet standardmäßig Jekyll, das Dateien und Ordner ignoriert, die mit einem Punkt beginnen (wie .well-known). Beheben Sie dies, indem Sie eine leere .nojekyll-Datei im Stammverzeichnis Ihres Repositories hinzufügen:

Shell 
touch .nojekyll
git add .nojekyll
git commit -m "Disable Jekyll processing"
git push
Alternativ können Sie stattdessen die Meta-Tag-Methode verwenden. Diese benötigt den .well-known-Ordner überhaupt nicht.
Konto
Ja, aber um Missbrauch zu verhindern, sind Änderungen des Benutzernamens begrenzt. Nach einer Änderung müssen Sie warten, bevor Sie ihn erneut ändern können. Das genaue Datum, ab dem eine erneute Änderung möglich ist, wird auf Ihrer Kontoseite angezeigt.
Profilbilder werden von Gravatar bereitgestellt.

Um Ihr Bild zu aktualisieren, erstellen oder aktualisieren Sie Ihr Gravatar-Konto mit derselben E-Mail-Adresse, mit der Sie sich bei Swiftgrounds registriert haben.
Das Löschen Ihres Kontos entfernt dauerhaft alle Ihre Daten, einschließlich Profil, Feed, Playgrounds und Domain-Verifizierung. Diese Aktion kann nicht rückgängig gemacht werden.