操作手册 • App Store • iOS、iPadOS 和 CarPlay

将 iOS 构建发布到 App Store

控制面板会交给你一个完整的 Xcode 项目:无需 CocoaPods、无需 Swift 包、无需拉取任何内容。你用你的团队签名、归档、上传到 App Store Connect,并通过 App Review。CarPlay 是 Apple 单独授予的权限,所以放在最后。

Apple Developer Program:每年 $99 Xcode 26 或更高版本,运行于 macOS iOS 16 及更高版本,iPhone 和 iPad

操作步骤

标签以 2026 年的 Xcode 26 和 App Store Connect 为准。Apple 会在版本之间重命名界面;每一步都会说明该界面的用途。

1

注册 Apple Developer Program

  1. 在 developer.apple.com/programs 使用电台长期控制的 Apple 账户进行注册。
  2. 以个人身份注册(App Store 会显示你的个人姓名作为卖家)或以组织身份注册(显示法律实体名称;需要其 D-U-N-S 编号)。
  3. 支付 $99 年费。审批可能需要几天,组织通常更久。
2

准备 Xcode

  1. 从 Mac App Store 免费安装 Xcode。
  2. 使用 Xcode 26 或更高版本:自 2026 年起,App Store Connect 会拒绝基于早于 iOS 26 的 SDK 构建的上传。
  3. 在 Xcode → 设置 → 账户 下添加你的开发者账户,以便自动签名能够创建证书和描述文件。
3

打开项目并设置团队

  1. 从面板下载 Xcode 项目(.zip)并解压。
  2. 打开 StationApp.xcodeproj。
  3. 选择 StationApp target,打开 签名与功能。
  4. 保持 自动管理签名 开启,并选择你的 团队。Bundle identifier 已由 Config/Station.xcconfig 预设;Xcode 会在你的团队上将其注册为 App ID。

不要改动构建设置。所有电台专属内容都位于 Config/Station.xcconfig,由生成器写入,手动编辑会与面板下次构建的内容产生偏差。

4

创建 App Store Connect 记录

  1. 在 appstoreconnect.apple.com,前往 App,然后 + → 新建 App。
  2. 平台选择 iOS;名称不超过 30 个字符;选择主要语言。
  3. 选择第 3 步注册的 bundle ID,并输入 SKU:一个你自行选择的内部参考编号,不会公开显示。

如果菜单中没有该 bundle ID,请在 developer.apple.com 的 证书、标识符与描述文件 → 标识符 下手动注册,并从面板复制该值。

5

归档并上传构建

  1. 将运行目标设置为 Any iOS Device (arm64)。
  2. Product → Archive。Organizer 会打开新的归档。
  3. Distribute App → App Store Connect,接受默认选项。
  4. 等待处理;构建完成后会出现在 App Store Connect 中,Apple 会发送一封电子邮件。

出口合规:Info.plist 将 ITSAppUsesNonExemptEncryption 设为 NO,因此处理后的构建不应等待加密问题。

6

完善列表元数据

  1. App 信息:副标题(可选)和主要类别,通常为 音乐。对于内容权利,声明该应用流式播放你自己的广播。
  2. 价格与供应范围:免费层级,以及你希望覆盖的地区。
  3. App 隐私:输入生成的隐私政策 URL,然后声明该应用不收集数据。列表会显示 未收集数据,这与编译进构建的隐私清单一致。
  4. 版本元数据:描述、关键词、支持 URL、版权,以及处理后的构建。
  5. 截图:目标设备系列为 iPhone 和 iPad,因此两套截图都是必需的。在模拟器中以最大的 iPhone 和 iPad 机型运行应用,并使用 文件 → 存储屏幕 进行截取。
  6. 年龄分级:针对你的节目内容完成 Apple 的问卷。

App Store 图标从构建的资源目录中读取;App Store Connect 没有单独的图标上传。

7

向 App Review 说明情况

  1. 在 App Review 信息 下,输入一个可联系到的联系人。
  2. 取消勾选 需要登录:该应用没有账户,因此无需提供演示凭据。
  3. 使用 备注 将该应用描述为电台的官方播放器,用于其直播流、节目表和播客;如果你不是连续播出,请提供你的播出时段。
  4. 准备好音乐授权文件。审核人员可能会根据准则 5.2.3 要求提供你有权流式播放音乐的证据。

准则 4.2.6:Apple 会拒绝由模板生成的应用,除非内容提供者自行提交。从电台自己的开发者账户提交是合规路径,这也是面板从不代你发布的原因。

8

提交

  1. 在版本页面上,点击 添加以供审核,然后 提交至 App Review。
  2. 大多数审核会在几天内完成。问题会出现在 App Store Connect 中,通常无需新构建即可在那里回答。
  3. 获批后,可手动发布,或让该版本自动发布。
9

申请并启用 CarPlay

CarPlay 音频应用需要你的团队拥有 com.apple.developer.carplay-audio 权限,该权限只能由 Apple 授予。

  1. 团队的账户持有人提交 Apple 的 CarPlay 权限申请,类别选择音频。回复通常需要一到三周。
  2. 在此之前,请保持面板的 CarPlay 开关关闭。在没有该权限的团队上,CarPlay 项目会因描述文件缺少该权限而导致自动签名失败。
  3. 获得授权后,启用面板上标记为“Apple 已批准我的应用使用 CarPlay”的开关,重新构建 iOS 并下载新项目。它会切换到 CarPlay Info.plist 和权限文件。
  4. 按第 5 步归档并上传,创建一个与面板中构建所示版本匹配的新 App Store 版本,附加该构建并提交。

更新:同样的循环,从重新构建到提交。电台的 feed 承载流、节目表、播客和链接,因此这些都不需要新版本。

需要帮助?与我们在线交谈

Xcode 中的签名错误、App Review 的拒绝或缺失的 bundle ID:随时通过在线聊天发送给支持团队。

所有操作手册