ヘルプ＆ドキュメント

よくある
ご質問

Playgroundの送信と発見に関して知っておくべきすべてのこと。

一般
Swiftgroundsは、開発者と学生がSwift Playgroundプロジェクトを共有・発見できるコミュニティ主導のプラットフォームです。

2025年1月、AppleはSwift PlaygroundアプリからPlaygroundフィードへの直接サブスクリプション機能を削除しました。

Swiftgroundsはそのギャップを埋めるために構築されました。開発者、教育者、学生がAppleが元々設計したサブスクリプションフィード形式を使って、Swift Playgroundの共有と発見を続けられる場所です。
1アカウントを作成し、ドメインを認証します。
2ドメイン上にPlaygroundを記述するJSONフィードをホストします。タイトル、説明、難易度レベル、ダウンロードURLなどのフィールドを含めます。
3フィードページに移動し、フィードのURLを送信します。
4Swiftgroundsが自動的にフィードを取得、解析、表示します。
Apple Developer Documentation: Publishing a Subscription
いいえ。Swiftgroundsはディレクトリであり、ホスティングサービスではありません。目的は、Appleが元々Swift Playgroundアプリに組み込んだ体験を再現することです。パブリッシャーが自分のドメインでコンテンツをホストし、アプリがそのフィードをサブスクライブするモデルです。このモデルにより、クリエイターは作品の完全な所有権と管理権を持てます。

Playgroundファイルは好きな場所（GitHub Pages、個人サイト、CDNなど）でホストし、JSONフィードで記述してください。Swiftgroundsはそのフィードを読み取り、Playgroundを発見可能にします。アップロード手順もストレージ制限もロックインもありません。コンテンツはあなたのドメインに残ります。
フィード形式
Swiftgroundsは、Appleが元々Swift Playgroundサブスクリプション用に定義したJSON フィード形式を使用しています。

必須のフィードレベルフィールド：
formatVersion, title, publisherName, feedIdentifier, contactURL, documents

必須のドキュメントフィールド：
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
オプションのドキュメントフィールドには、detailSubtitle、difficultyLevel（beginner、intermediate、advanced、expert）、publishedDate、lastUpdatedDate（ISO 8601）、thumbnailURL（902×678px）、bannerImageURL（1080×400px）、previewImageURLs（800×600px）、additionalInformationがあります。

additionalInformation配列は、名前/値のペアとして追加のメタデータを格納します。各ペアにはname、value、およびオプションのtypeフィールド（"string"または"date"）があります。
はい。複数の言語をサポートするには、メインのフィードURLでロケールIDをローカライズされたフィードファイルにマッピングするJSONオブジェクトを指定します：
JSON 
{
  "en": "en-feed.json",
  "fr": "fr-feed.json",
  "es": "es-feed.json"
}
各ローカライズされたフィードは標準形式に従います。
Apple Developer Documentation: Localizing a Subscription Feed
はい。AppleはWWDC 2018でSwift Playgroundサブスクリプションの作成と公開に関する完全なセッションを発表しました。チャプターの構成、リソースの追加、フィードのホスティングなど、フィード形式について詳しく解説しています。

Apple Developerウェブサイトのページは現在非公開ですが、動画とスライドには引き続きアクセスできます。
WWDC18 · Session 413 · 35:23
Create Your Own Swift Playgrounds Subscription
Holly Borla & Grace Kendall
HD SD Slides
ドメイン認証
ドメイン認証は、フィードがホストされているドメインの所有者であることを証明します。これにより、管理していないドメインからフィードを送信することを防ぎます。フィードURLは認証済みドメインでホストされている必要があります。
アカウント設定でドメインを追加すると、認証コードが発行されます。以下のいずれかの方法で認証できます：

方法1：メタタグ。
ホームページの<head>に以下を追加してください：
HTML 
<meta name="swiftgrounds-verification" content="your-code">
方法2：テキストファイル。
/.well-known/swiftgrounds-verification.txtに認証コードを含むファイルを作成してください。
GitHub PagesはデフォルトでJekyllを使用しており、ドット（.well-knownなど）で始まるファイルやフォルダを無視します。リポジトリのルートに空の.nojekyllファイルを追加して修正してください：

Shell 
touch .nojekyll
git add .nojekyll
git commit -m "Disable Jekyll processing"
git push
または、メタタグ方式を使用してください。.well-knownフォルダは不要です。
アカウント
はい。ただし、悪用を防ぐため、ユーザー名の変更には制限があります。ユーザー名を変更した後、再度変更するまでに待機期間があります。次に変更可能な正確な日付はアカウントページに表示されます。
プロフィール画像はGravatarを使用しています。

画像を更新するには、Swiftgroundsで登録したものと同じメールアドレスでGravatarアカウントを作成または更新してください。
アカウントを削除すると、プロフィール、フィード、Playground、ドメイン認証を含むすべてのデータが永久に削除されます。この操作は元に戻すことができません。