Swiftgrounds 通过读取您在自己域名上托管的 JSON Feed 来运作。您始终掌控自己的内容,Swiftgrounds 只负责让它被更多人发现。以下是设置步骤。

1
创建账户
使用用户名和电子邮箱注册。您的用户名将成为您的公开个人主页 URL:swiftgrounds.dev/u/username。用户名每 30 天可更改一次,请选择一个您满意的名称。
2
添加并验证您的域名
在账户设置中,添加您用于托管 Feed 的域名(例如 yoursite.com)。Swiftgrounds 会为您生成一个唯一的验证码。您可以通过在首页添加 meta 标签或在 /.well-known/swiftgrounds-verification.txt 路径下放置文本文件来证明所有权。验证通过后,该域名将永久关联到您的账户,除非您主动移除。您的 Feed 必须托管在已验证的域名上。
3
编写 Feed JSON
在您的域名上创建一个 .json 文件,用于描述您的 Playground 图书。格式遵循 Apple 最初的订阅 Feed 模式。每个条目需要包含标题、副标题、描述、内容标识符、版本号和下载 URL。您还可以添加缩略图、预览图、难度等级和发布日期。

完整的模式说明和示例请参阅常见问题 → Feed 格式
4
提交您的 Feed URL
前往账户中的 Feed 页面,粘贴您的 JSON 文件 URL。Swiftgrounds 会立即获取并解析其中的条目,将它们列入索引。当您更新 Feed 后,点击刷新即可同步最新版本。就这样,您的 Playground 已经上线了。

小贴士

  • 使用 902×678px 的 thumbnailURL 图片,可在 Swiftgrounds 和 Swift Playgrounds 中获得最佳卡片展示效果。
  • difficultyLevel 设为 beginnerintermediateadvancedexpert。这将驱动索引中的筛选标签。
  • 如果您使用 GitHub Pages,请在仓库根目录添加一个空的 .nojekyll 文件,以确保 .well-known 文件夹能正常访问。
  • Feed URL 必须始终保持可访问并返回有效的 JSON。损坏的 Feed 会被标记,并可能从索引中移除。

有疑问?

常见问题涵盖了完整的 Feed 格式、本地化、域名验证等内容。

准备好开始了吗?
创建账户,几分钟内即可提交您的 Feed。
创建账户