Swiftgroundsは、あなたが自分のドメインでホストするJSONフィードを読み取ることで動作します。コンテンツの管理はあなた自身が行い、Swiftgroundsはそれを発見可能にするだけです。設定方法は以下のとおりです。
パブリッシャーガイド
公開
方法
4つのステップでSwift PlaygroundブックとアプリをSwiftgroundsに掲載しましょう。
1
アカウントを作成する
ユーザー名とメールアドレスでサインアップしてください。ユーザー名は
swiftgrounds.dev/u/usernameの公開プロフィールURLになります。ユーザー名は30日ごとに1回変更できますので、気に入ったものを選んでください。
2
ドメインを追加して認証する
アカウント設定で、フィードをホストするドメイン(例:
yoursite.com)を追加してください。Swiftgroundsから固有の認証コードが発行されます。ホームページにメタタグを追加するか、/.well-known/swiftgrounds-verification.txtにテキストファイルを配置して所有権を証明してください。認証が完了すると、ドメインはあなたのアカウントに恒久的にリンクされます(削除するまで)。フィードはこの認証済みドメインでホストする必要があります。
3
フィードJSONを作成する
ドメイン上にPlaygroundブックを記述する
完全なスキーマと例についてはFAQ → フィード形式をご覧ください。
.jsonファイルを作成してください。形式はAppleが元々定義したサブスクリプションフィードスキーマに従います。各エントリには、タイトル、サブタイトル、説明、コンテンツ識別子、バージョン、ダウンロードURLが必要です。サムネイル画像、プレビュー画像、難易度レベル、公開日なども含めることができます。完全なスキーマと例についてはFAQ → フィード形式をご覧ください。
4
フィードURLを送信する
アカウントのフィードページに移動し、JSONファイルのURLを貼り付けてください。Swiftgroundsが即座に取得・解析し、インデックスに掲載します。フィードを更新したら、更新ボタンを押して最新バージョンを同期してください。以上です。あなたのPlaygroundが公開されます。
ヒント
- thumbnailURLの画像は902×678pxにすると、SwiftgroundsとSwift Playgroundsで最適なカード表示になります。
- difficultyLevelは
beginner、intermediate、advanced、またはexpertに設定してください。これによりインデックスのフィルターチップが制御されます。 - GitHub Pagesを使用する場合は、リポジトリのルートに空の
.nojekyllファイルを追加して、.well-knownフォルダが正しく配信されるようにしてください。 - フィードURLは常にアクセス可能で、有効なJSONを返す必要があります。壊れたフィードはフラグが立てられ、インデックスから非表示になる場合があります。
ご質問は?
FAQでは、フィード形式の詳細、ローカリゼーション、ドメイン認証などについて説明しています。
始める準備はできましたか?
アカウントを作成して、数分でフィードを送信しましょう。