探索 Apple 托管的 Background Assets

探索 Apple 托管的 Background Assets

本次讲座将以 Background Assets 为基础，介绍用于为游戏和其他应用程序下载内容素材包的新功能。了解 Apple 如何为你托管这些素材包，或如何管理自托管选项。我们将深入探索原生 API 整合及相应的 App Store 实现，并为你提供工具来提升 App 的内容交付体验和用户体验。

章节
- 0:00 - 简介
- 1:01 - Background Assets 新功能
- 7:32 - 示例 App 开发
- 17:24 - Beta 版测试与分发
资源
相关视频

WWDC25
- 借助 App Store Connect API 实现开发流程自动化
- App Store Connect 的新功能
WWDC23
- Background Assets 的新动向
大家好我叫 Gabriel 我是 App Store 团队的一名软件工程师我叫 Jenny 是 App Processing 团队的工程师今天我们将介绍一种通过 Background Assets 在 App Store 上为 App 分发资源的新方式我将讲解 App 与资源在用户设备上的协同机制以及如何利用 Apple 托管服务管理你的资源本次讲座会首先回顾现有资源分发技术包括 Background Assets 接着重点介绍今年的更新包括用于管理 Background Assets 的全新 Swift 与 Objective-C API 以及 Apple 托管服务
我们将演示如何将这些新功能集成到 iOS、iPadOS、macOS、Apple tvOS 和 visionOS App 中并完成本地测试
如果你希望由 Apple 托管和分发资源我们还将带你完成 Beta 版测试和 App Store 分发的准备工作
现在请 Gabriel 为大家回顾 Background Assets 及相关最新进展
谢谢 Jenny 当用户从 App Store 下载 App 时他们希望立即使用它如果打开 App 后还需要等待其他内容下载完成用户可能会直接退出甚至删除 App
通过 Background Assets 我们将帮助开发者更轻松地打造出色的首次启动体验你可以配置系统在设备上的资源下载方式且无需更新主 App 即可随时更新这些资源例如为刚下载游戏的新用户优先提供教程关卡让他们快速开始游玩同时后台继续下载游戏剩余内容提供可通过 App 内购买项目解锁的附加可下载内容 (DLC) 或通过加速提交流程为设备端机器学习模型推送更新至 App Store 假设你正在开发一款包含多个关卡包括教程关卡的游戏对于每个关卡的资源交付你有四种可选方案：将所有资源打包在主 App 套装内、使用 URLSession、按需资源或 Background Assets 这些方案各有优劣我来逐一分析一下
若将所有资源打包在主 App 套装内即使用户只需要其中一部分资源来启动教程关卡也不得不等待全部资源下载完成此外大多数平台有 4GB 的体积限制且更新单个资源时需重新上传并重新提交整个 App 按需资源虽然能让用户更快进入教程关卡因为它允许将部分 App 套装与 TestFlight 或 App Store 分开下载但若想更新某些资源文件仍需重新提交整个 App 更新按需资源是一项传统技术即将被弃用
取而代之的是 Background Assets 这个方案允许你将 App 资源托管在自己的服务器上无需更新整个 App 即可随时更新资源 Background Assets 的核心在于下载器扩展通过编写代码你可以在用户打开 App 前就调度资源下载任务这在你需要完全掌控下载行为及后续处理时非常理想但我们深知对大多数开发者而言最关键的是确保 App 资源随时可用且保持最新借助全新的托管式 Background Assets 系统将自动为你的资源包管理下载、更新、压缩等全流程操作事实上我们已编写了一套系统提供的下载器扩展无需编写任何自定义代码即可直接集成到 App 中此外针对 TestFlight 和 App Store 上架的应用我们推出了 Apple 托管的 Background Assets 服务选择这项服务后你不再需要自行搭建资源服务器 Apple Developer Program 会员已包含 200GB 的托管容量
如果你仍在使用按需资源我们建议你尽快迁移至 Background Assets 通过托管式 Background Assets 你可以将资源文件如游戏教程关卡的贴图、音效和图形处理器着色器等分组打包成多个资源包系统将根据下载策略自动在用户设备上下载这些资源包目前提供三种下载策略：必要资源、预载资源和按需资源必要资源下载策略意味着系统会自动下载资源包并将它整合到安装流程中资源包的下载进度会计入用户在 App Store、TestFlight 或主屏幕上看到的整体下载进度条当安装完成且用户打开 App 时资源包已准备就绪可供使用
预载资源下载策略是指系统在 App 安装期间即开始下载资源包但下载过程可能会在 App 安装完成后继续在后台进行按需资源下载策略则需要你显式调用 API 方法请求后系统才会下载对应的资源包你可以选择自行托管这些资源包或者让 Apple 代你托管现在请 Jenny 来介绍 Apple 服务器如何交付资源包和 App 构建没问题！每个由 Apple 托管的资源包均可用于单个 App 并支持你选择的多个平台设备要下载 App 二进制文件及它使用的资源包你需要先将两者分别上传至 App Store Connect 然后你便可以提交这些文件以供审核以便通过 TestFlight 进行外部测试并提交 App Store 分发
上传后资源包会被分配一个版本号且不与任何特定的 App 构建绑定 App 与资源包在设备上的匹配逻辑取决于资源包版本的状态下面我通过几个示例来说明
假设某个资源包存在三个不同版本版本 1 已在 App Store 正式发布版本 2 面向 TestFlight 外部 Beta 版发布版本 3 则用于 TestFlight 内部 Beta 版每个发布渠道同一时间只能激活一个资源包版本与此同时你设备上的一些 App 版本可能是通过 App Store 下载的也可能是通过 TestFlight 外部 Beta 版或内部 Beta 版获取的服务器会选择在这个特定情景下为你的所有 App 版本提供实时版本的资源包
这意味着从 App Store 下载的 1.0 版本 (第 1 个构建) 将使用资源包版本 1
TestFlight 外部 Beta 版测试中的 2.0 版本 (第 1 个构建) 将使用资源包版本 2 内部 Beta 版测试中的 2.0 版本 (第 2 个构建和第 3 个构建) 将使用资源包版本 3
现在关键是要理解更新资源包版本时的行为逻辑
例如如果你对资源包版本 2 满意可将它提交至 App Store 分发它将取代旧版本并在 App Store 生效
这意味着所有从 App Store 下载的 App 版本包括用户设备上仍安装的旧版都将自动切换使用资源包版本 2 因此在更新资源包前请务必确保它能兼容旧版 App 构建和版本现在我们来看一个 App 构建更新的示例假设你要提交 2.0 版本的第 3 个构建进行外部 Beta 版测试通过审核后如果这个构建是通过外部 Beta 版下载的它将使用较旧的资源包版本 2 若希望它搭配使用较新的资源包版本 3 请务必同时提交这个新的资源包版本现在你已经熟悉了资源包的概念 Gabriel 将为你演示如何创建资源包并在 App 中使用谢谢 Jenny 现在由我来为大家展示如何在 App 中使用托管式 Background Assets
要开始使用托管式 Background Assets 你需要创建资源包、采用新的 API 并在本地测试 App 和资源包
下面我将详细介绍如何创建资源包
你可以使用全新的支持 macOS、 Linux 和 Windows 系统的打包工具这个工具能从你的源代码仓库获取文件并将它们打包成压缩档案以便分发至 TestFlight 和 App Store 在 macOS 系统中这个打包工具已随 Xcode 一同安装而对于 Linux 和 Windows 用户很快就能通过 Apple 开发者网站的下载专区获取现在我将为你演示这款工具的实际操作流程
首先运行模板命令来生成清单模板在 macOS 上安装 Xcode 然后在终端运行 xcrun ba-package template 若使用 Linux 或 Windows 系统需先将工具添加至 shell 的搜索路径再运行 ba-package template 命令打包工具将自动生成清单模板这个清单是一个 JSON 文件你需要填写相关内容以向 Apple 说明资源包的配置信息你可以选择自定义 ID 这个 ID 将用于在 App 代码中识别资源包、设置下载策略以及指定资源包支持的平台组合
首先来填写文件选择器文件选择器用于从你的源代码仓库中选择一组文件包含在资源包中文件选择器分为两种类型：一种是选择单个文件的选择器另一种是选择整个目录
我们来为游戏的开场动画视频添加一个文件选择器使用相对于源代码仓库根目录的相对路径
这个资源包的 ID 是“Tutorial” 因为它包含游戏教程关卡的资源文件现在我们来配置下载策略由于教程是玩家最先体验的内容我们需要让教程资源包在玩家首次打开游戏前就已本地可用因此这种情况非常适合使用必需资源下载策略
这个教程关卡仅与新安装游戏的玩家相关对于已安装游戏和只是更新到新版本的玩家应该不需要重新下载教程
因此我们需要将必需资源下载策略限制为仅首次安装时生效排除后续更新情况这意味着只有当玩家首次在设备上下载游戏时才会获取教程相关的资源包
现在清单文件已填写完毕我们再次运行打包工具来生成压缩档案我们将当前目录设置为代码仓库的根目录并传入清单文件路径以及压缩档案的保存路径现在资源包已打包完成我们来看看如何在游戏中使用它
只需几行代码你就可以使用 Background Assets 中的新 API 来读取资源包中的文件首先我们需要在 Xcode 中添加一个下载器扩展这个下载器扩展能让你的 App 在主程序未运行时例如在安装过程中调度资源包的下载任务
让我们添加一个新目标选择 Background Download 模板
在这里你可以选择使用 Apple 的托管服务或自己的服务器
模板默认生成 Swift 代码但如果你愿意也可轻松替换为 Objective-C 代码
今年系统现已提供一个功能完备的下载器扩展支持自动下载、后台更新等特性你可以直接集成到 App 中而无需编写任何自定义代码 Xcode 通过 Background Download 模板生成的代码片段默认已配置为使用系统实现这意味着你无需编写其他扩展代码
实际上如果你不需要自定义下载行为甚至可以完全移除模板生成的 shouldDownload(_:) 方法存根现在你只需添加几行 Xcode 自动生成的代码即可为 App 集成下载器扩展
若需要自定义下载行为你可以自行实现 shouldDownload(_:) 方法系统会根据资源包的下载策略在计划后台下载每个新资源包时调用这个方法你只需返回一个布尔值来决定是否执行下载即可当你的某些资源包存在特定兼容性要求时这一机制将非常实用现在你已实现下载器扩展接下来了解一下如何在主 App 中使用已下载资源包内的文件
第一步是调用共享的 AssetPackManager 上的 ensureLocalAvailability(of:) 方法这个方法会检查目标资源包是否已下载若未下载则会启动下载流程并等待完成在大多数情况下下载器扩展已预先完成资源包下载因此这个方法会立即返回若遇到需要重新下载资源包的罕见情况建议向用户显示可视化的下载进度信息
在 Swift 中你可以通过异步序列监听 statusUpdates(forAssetPackWithID:) 方法返回的状态更新
而在 Objective-C 中则需要创建一个遵循 BAManagedAssetPackDownloadDelegate 协议的对象并将它赋值给共享资源包管理器的 delegate 属性
如需取消下载只需对下载状态更新中接收到的任意进度结构体调用 cancel() 方法即可当 ensureLocalAvailability(of:) 方法无异常返回时即表示请求的资源包已就绪可在本地直接使用
要读取资源包中的文件请调用共享资源包管理器的 contents(at:searchingInAssetPackWithID:options:) 方法第一个参数是相对于源代码库根目录的相对路径即你先前运行打包工具创建资源包时所在的目录指向你要读取的文件系统会自动将所有资源包合并到一个共享命名空间中实际上就像将你的源代码库从开发机器复制粘贴到用户设备上一样重建了它这意味着当你需要在运行时读取某个特定文件时无需跟踪这个文件位于哪个资源包中默认情况下 contents(at:searchingInAssetPackWithID:options:) 方法会返回一个内存映射数据实例这种设计即使对于占用大量内存的大型资源文件也同样适用
若你需要底层文件描述符访问权限例如以过程式方式将文件读入内存则可改用 descriptor(for:searchingInAssetPackWithID:) 方法但需注意使用完毕后必须手动关闭文件描述符你还可以通过为这两个方法的 assetPackID 参数指定非 nil 值将搜索范围限定到特定资源包系统会自动追踪 App 已下载的资源包并在后台保持它们的更新状态但需注意的是只要 App 仍保留在设备上系统不会自动删除任何资源包因此当确定不再需要某个特定资源包时最佳实践是调用共享资源包管理器的 remove(assetPackID:) 方法及时释放存储空间例如当玩家完成教程关卡后你即可移除“Tutorial”资源包
若玩家重置游戏进度并重新开始教程随时可调用 ensureLocalAvailability(of:) 方法重新下载这个资源包
请注意用户可在设备“Settings”App 的存储空间中查看已下载资源包占用的存储空间接下来你需要将主 App 和下载器扩展添加到同一个 App 组系统会通过这个 App 组协调主 App 与扩展之间的通信
然后在主 App 的 Info.plist 中添加 BAAppGroupID 键将它的字符串值设为 App 组 ID
同时添加 BAHasManagedAssetPacks 键并设置布尔值为 true 或 yes
若使用 Apple 托管服务请添加 BAUsesAppleHosting 键并设置布尔值为 true 或 yes 如未采用 Apple 托管请参阅本讲座“资源”部分的相关文档了解其他必备的 Info.plist 键包括 BAManifestURL 的配置说明完成 App 与扩展配置后现在可开始测试了
我们全新推出了适用于 macOS、Linux 和 Windows 系统的 Background Assets 模拟服务器方便你在提交 TestFlight 或 App Store 前测试资源包下载功能与打包工具一样这个模拟服务器与 macOS 版 Xcode 捆绑发布 Linux/Windows 版本即将登陆 Apple 开发者网站下载中心 Background Assets 采用 HTTPS 进行所有下载操作因此你首先需要签发 SSL 证书为此你需要创建根证书颁发机构在测试设备上安装这个证书颁发机构之后使用这个机构签发 SSL 证书最后启动模拟服务器并配置它使用 SSL 证书更多细节请参阅本讲座 “资源”部分的相关文档完成 SSL 证书签发后你可以运行 ba-serve 命令启动模拟服务器传入要提供的资源包归档文件路径并设置服务器绑定主机地址主机地址可以是 IP 地址、主机名或域名在 macOS 上工具会提示你选择身份凭证即钥匙串中的证书与私钥对在 Linux 或 Windows 平台需通过命令行传入证书及私钥路径传递 help 参数可查看其他选项包括设置自定义端口号 macOS 即将支持跳过身份凭证提示在 iOS、iPadOS 和 visionOS 测试设备上 (Apple tvOS 设备即将支持) 前往“开发者设置” “开发覆盖”选项输入模拟服务器的基准 URL 含主机地址及端口在 macOS 测试设备上运行 xcrun ba-serve url-override 输入相同信息
当你从 Xcode 构建并运行 App 时 App 将从你的模拟服务器下载资源包现在请 Jenny 介绍资源包的 Beta 版测试与分发流程 - Jenny？ - 谢谢 Gabriel 既然你已准备好新版 App 二进制文件和资源包接下来我将演示如何为 TestFlight Beta 版测试和 App Store 分发做准备
若使用 Apple 托管服务你需要将 App 二进制文件与资源包分别上传至 App Store Connect 可选择使用 TestFlight 进行测试最终在 App Store 分发
让我们深入了解一下资源包的上传流程有几种方法可以上传资源包：
若通过拖拽式 UI 界面操作可使用 macOS 系统的“Transporter”App
若需完全掌控流程透明度则可借助 App Store Connect REST API 构建自动化脚本对于简化的命令行界面跨平台的 iTMSTransporter 工具能提供实用命令并代你向 App Store Connect API 发起请求你可以查阅所有这些工具的相关文档接下来我将为你演示如何使用 Transporter 和 App Store Connect API 使用“Transporter”App 只需将 Tutorial.aar 压缩包拖放至 Transporter 窗口
选择目标 App 后点击“交付” 即可将它作为 Tutorial 资源包的新版本上传
你可以直接在 “Transporter”App 中实时查看资源包的上传状态
若需完全掌握上传流程的细节则可使用 App Store Connect API 具体分为三个步骤：创建资源包记录、为资源包创建版本记录然后将压缩包上传至资源包版本首先要创建资源包记录你需要向 backgroundAssets 资源发起 POST 请求
在请求体中需在 assetPackIdentifier 字段填入资源包名称在关联关系部分填入 App 的 Apple 账户这个 API 调用将返回资源包的 UUID 供后续 API 调用使用
接着通过向 backgroundAssetVersions 资源发起 POST 请求来创建资源包新版本
在关联关系部分使用前一步 API 响应提供的资源包 ID 系统会根据现有版本号自动递增生成新版本号此时我们将获得版本 1 API 响应中还会返回一个 ID 用于对应 Tutorial 资源包的版本 1
当资源包版本创建成功后你可以通过 backgroundAssetUploadFiles 资源为 Tutorial.aar 压缩包文件申请上传许可这一步骤与其他上传操作如 App Store 截屏上传类似
需要提供资产类型、文件名、文件大小、MD5 校验
以及与 backgroundAsset 版本 ID 的关联关系调用的响应包含上传文件的 ID、以及详细的上传指引说明
成功上传压缩包后需向 backgroundAssetUploadFiles 发起 PATCH 请求并附上你的上传文件 ID 系统随即开始处理资源包
要查看资源包的处理进度请随时登录 App Store Connect 查看可用资源包的完整信息或调用 App Store Connect API 来获取
在 App Store Connect 中你可以在 TestFlight 标签页下查看资源包的处理状态当上传成功处理后状态将变更为“可供内部测试” 这表示新版本已准备就绪可用于你当前在 TestFlight 进行内部测试的 App 构建版本你将收到一封电子邮件通知你新的资源包版本已可用你还可以设置 Web 挂钩来获取这一通知
想了解更多关于 Web 挂钩的最新信息欢迎观看 WWDC25 讲座 “借助 App Store Connect API 实现开发流程自动化”
若资源包压缩文件在处理过程中发现问题版本状态将变更为 Failed 同时你也会收到通知你可以针对问题进行修复并重新上传新版资源包通过 App Store Connect API 你可以向多个资源发起 GET 请求以查看 App 所有资源包的列表、各资源包的版本记录及每个版本对应的状态可以通过 backgroundAssetVersions 资源实时追踪上传进度
当资源包处理完成后系统将生成内部 Beta 版资源资源包版本会显示为 READY_FOR_TESTING
成功上传 App 二进制文件及资源包后即可在 TestFlight 中开始 Beta 版测试
在 App Store Connect 中你可以看到当前 Tutorial 版本 1 已可供内部测试若希望让更广泛的测试群体体验你的 App 构建版本和资源包你可以单独提交它们进行外部测试
要提交资源包点击具体的版本选择“提交以供外部测试” 版本通过审核后状态将变为 “可供外部测试” 同时你会收到通知
通过 App Store Connect API 你还可以使用 betaBackgroundAssetReviewSubmissions 资源提交资源包版本
可以使用外部 Beta 版资源跟踪审核状态当资源包版本准备好供外部测试时系统会显示
当测试完成后若你准备将资源包版本发布至 App Store 可将它提交至 App Review 在 App Store 分发
你可以前往 App Store Connect 上的“分发”选项卡查看资源包现在你可以单独提交一个资源包版本或与其他资源包、App 版本或其他审核项目捆绑提交若资源包版本与 App 版本同时提交 App Review 团队将使用你选择的资源包版本来审核你的 App
要添加资源包以供审核请单击“选择资源包”
选择版本然后添加至审核队列
审核通过后资源包版本状态将变为 “可供分发”
通过 App Store Connect API 还可以使用 reviewSubmissions 资源提交审核
在审核期间你可以通过 App Store releases 资源查看审核状态当它准备好分发时即表示用户可从 App Store 下载新资源今天我们的内容非常丰富！我们讲解了资源包的概念、如何创建资源包并在 App 中使用以及如何上传并提交至 Apple 托管服务希望本次讲座能帮助你快速上手全新的托管式 Background Assets
现在轮到你动手实践了请尝试使用打包工具创建你的第一个资源包如果你的 App 仍在使用按需资源请评估如何迁移至 Background Assets 查阅相关文档并在 App 中适配全新的 Background Assets API 最后我们期待你的反馈欢迎通过“反馈助理” 告诉我们哪些功能运作良好哪些仍需改进你还可以观看“App Store Connect 的新功能”讲座了解今年 App Store Connect 的所有更新内容此外请观看 WWDC23 的 “App Store Connect 的新功能” 深入了解 Background Assets 的现有功能包括本地测试的实用技巧
感谢参与期待收到你的宝贵意见

{
	"assetPackID": "[Asset-Pack ID]",
	"downloadPolicy": {
		"essential": { // Possible keys: “essential”, “prefetch”, or “onDemand”
			// Essential and prefetch download policies require a list of installation event types. For an on-demand download policy, the value for the “onDemand” key must be an empty object.
			"installationEventTypes": [
				// Remove undesired elements from this array.
				"firstInstallation",
				"subsequentUpdate"
			]
		}
	},
	"fileSelectors": [
		// You can add as many file and/or directory selectors as you want.
		{
			"file": "[Path to File]"
		},
		{
			"directory": "[Path to Directory]"
		}
	],
	"platforms": [
		// Remove undesired elements from this array.
		"iOS",
		"macOS",
		"tvOS",
		"visionOS"
	]
}

10:44 - Add a downloader extension

import BackgroundAssets
import ExtensionFoundation
import StoreKit

@main
struct DownloaderExtension: StoreDownloaderExtension {
	
	func shouldDownload(_ assetPack: AssetPack) -> Bool {
		return true
	}
	
}

11:39 - Download an asset pack

let assetPack = try await AssetPackManager.shared.assetPack(withID: "Tutorial")

// Await status updates for progress information
let statusUpdates = AssetPackManager.shared.statusUpdates(forAssetPackWithID: "Tutorial")
Task {
	for await statusUpdate in statusUpdates {
		// …
  }
}

// Download the asset pack
try await AssetPackManager.shared.ensureLocalAvailability(of: assetPack)

12:22 - Receive download status updates in Objective-C

#import <BackgroundAssets/BackgroundAssets.h>

@interface ManagedAssetPackDownloadDelegate : NSObject <BAManagedAssetPackDownloadDelegate>

@end

@implementation ManagedAssetPackDownloadDelegate

- (void)downloadOfAssetPackBegan:(BAAssetPack *)assetPack { /* … */ }

- (void)downloadOfAssetPackPaused:(BAAssetPack *)assetPack { /* … */ }

- (void)downloadOfAssetPackFinished:(BAAssetPack *)assetPack { /* … */ }

- (void)downloadOfAssetPack:(BAAssetPack *)assetPack hasProgress:(NSProgress *)progress { /* … */ }

- (void)downloadOfAssetPack:(BAAssetPack *)assetPack failedWithError:(NSError *)error { /* … */ }

@end

12:29 - Attach the delegate in Objective-C

static void attachDelegate(ManagedAssetPackDownloadDelegate *delegate) {
	[[BAAssetPackManager sharedManager] setDelegate:delegate];
}

12:33 - Cancel an asset-pack download

let statusUpdates = AssetPackManager.shared.statusUpdates(forAssetPackWithID: "Tutorial")
for await statusUpdate in statusUpdates {
	if case .downloading(_, let progress) = statusUpdate {
		progress.cancel()
	}
}

12:41 - Use an asset pack

// Read a file into memory
let videoData = try AssetPackManager.shared.contents(at: "Videos/Introduction.m4v")

// Open a file descriptor
let videoDescriptor = try AssetPackManager.shared.descriptor(for: "Videos/Introduction.m4v")
defer {
	do {
		try videoDescriptor.close()
	} catch {
		// …
	}
}

13:56 - Remove an asset pack

// Remove the asset pack
try await AssetPackManager.shared.remove(assetPackWithID: "Tutorial")

// Redownload the asset pack
let assetPack = try await AssetPackManager.shared.assetPack(withID: "Tutorial")
try await AssetPackManager.shared.ensureLocalAvailability(of: assetPack)

14:53 - Info.plist

<key>BAAppGroupID</key>
<string>group.com.naturelab.thecoast</string>
<key>BAHasManagedAssetPacks</key>
<true/>
<key>BAUsesAppleHosting</key>
<true/>

- 0:00 - 简介
- 了解后台素材・・一种在 App Store 上分发 App 素材的新方式。回顾当前的素材交付技术，了解新的 Swift 和 Objective-C API，并学习如何在 iOS、iPadOS、macOS、Apple tvOS 和 visionOS 中集成这些功能。此外，还将讨论 Apple 素材托管，包括为 Beta 版测试和 App Store 分发做准备。
- 1:01 - Background Assets 新功能
- 后台素材让你能够将 App 素材与主 App 分开下载和更新，提升了 App 启动体验。这种方式使用户能够立即开始使用 App，同时附加内容会在后台进行下载。素材包主要有三种下载策略：必备、预取和按需。你可以将素材包托管在自己的服务器上，也可以使用新的 Apple 托管后台素材服务，这项服务在 Apple Developer Program 会员资格中包含 200GB 的存储空间。管理式后台素材取代了已弃用的按需资源技术。它提供了更出色的控制和灵活性，让你能够优化 App 性能和用户参与度。系统会自动管理下载、更新和压缩，使它易于实现。
- 7:32 - 示例 App 开发
- 要在 App 中使用管理式后台素材，必须使用适用于 macOS、Linux 和 Windows 的新打包工具创建素材包。这个工具会生成一个 JSON 清单文件，你可以在其中指定素材包的 ID、下载策略、支持的平台以及要通过文件选择器包含的文件。你可以配置下载策略，确保必备素材在 App 启动前就已本地可用，并将下载限制为仅在首次安装时进行。清单填写完成后，打包工具会生成一个压缩归档文件。要将素材包集成到 App 中，请在 Xcode 中添加下载器扩展，用于安排在后台下载素材包。系统提供了一个功能完备的下载器扩展，支持自动下载和更新。在主 App 中使用 AssetPackManager 访问已下载的文件，确保本地可用性，并在必要时等待状态更新，从而通过优化的素材管理提供无缝用户体验。要使用 Background Assets 框架，必须将委托协议附加到共享素材包管理器的 delegate 属性。下载状态更新会提供 progress 结构，必要时可用于取消下载。当 ensureLocalAvailability(of:) 方法无错误返回，表明素材包可供本地使用时，可使用 contents(at:searchingInAssetPackWithID:options:) 或 descriptor(for:searchingInAssetPackWithID:) 方法读取文件。系统会自动管理素材包的更新和存储，但建议手动移除未使用的素材包以释放空间。要实现主 App 与下载器扩展之间的协调，必须将它们添加到同一 App 组，并配置特定的 Info.plist 键。测试时，系统提供了一个需要 SSL 证书的模拟服务器。你必须在测试设备的 Development Overrides 中输入模拟服务器的基准 URL。配置完成后，App 会在测试期间从模拟服务器下载素材包。
- 17:24 - Beta 版测试与分发
- 要为 App 的 TestFlight Beta 测试和 App Store 分发做准备，你必须将 App 二进制文件和素材包上传到 App Store Connect。上传素材包可通过多种方法实现，包括提供拖放界面的 macOS 版“Transporter”App，或实现完全控制和自动化操作的 App Store Connect REST API。使用 API 主要涉及三个步骤：创建素材包记录、创建版本记录，以及上传归档文件。素材包处理完成后，你可以提交以在 TestFlight 中进行内部或外部测试。测试通过后，你可以将素材包版本提交至 App Review 团队，以便在 App Store 上分发。你可以通过 App Store Connect 或 API 监控上传、提交和审核的进度与状态。

章节

资源

相关视频

WWDC25

WWDC23