Appleがホストするバックグラウンドアセットの詳細

Appleがホストするバックグラウンドアセットの詳細

このセッションでは、バックグラウンドアセットの知識に基づいて、ゲームやその他のアプリ向けのコンテンツのアセットパックをダウンロードする新しい機能を紹介します。Appleがこれらのアセットパックをホストする方法や、自己ホストのオプションを管理する方法を確認します。ネイティブのAPI統合と対応するApp Storeでの実装について詳しく説明し、アプリのコンテンツ配信とユーザー体験を向上させるためのツールを提供します。

関連する章
- 0:00 - イントロダクション
- 1:01 - バッググラウンドアセットの新機能
- 7:32 - サンプルアプリの開発
- 17:24 - ベータテストと配信
リソース
関連ビデオ

WWDC25
- App Store Connect APIを利用した開発プロセスの自動化
- App Store Connectの新機能
WWDC23
- Background Assetsの新機能
こんにちはGabrielです App Storeチームのソフトウェアエンジニアです Jennyです App Processingチームのエンジニアですここではバックグラウンドアセットを使用して App Storeでアプリのアセットを配信する新しい方法を紹介します皆さんのアプリとアセットがユーザーのデバイスでどのように連携するか説明しますまたアセットでAppleホスティングを使用する方法を紹介しますこのセッションではまずバックグラウンドアセットなど現在利用可能なアセット配信技術を確認します次に今年の新機能を紹介しますバックグラウンドアセットを管理する SwiftとObjective-Cの新しいAPIや Appleホスティングなどです
iOS iPadOS macOS tvOS visionOSのアプリに新機能を組み込む方法とローカルテストを実施する方法を紹介します
Appleによるアセットのホストと配信を希望する皆さんのためにベータ版テストやApp Storeでの配信を準備する方法を説明します
ではGabrielがバックグラウンドアセットの概要と新しい機能について説明します
ありがとう Jenny ユーザーはApp Storeからアプリをダウンロードするときすぐに使用できると期待していますアプリを開いた後別のダウンロードが必要な場合アプリを放置したり削除したりすることがあります
バックグラウンドアセットを使うと優れた初回起動時の体験を簡単に提供できますシステムがアセットをデバイスにダウンロードする方法を構成できメインアプリを更新する必要なくアセットを更新できます例えばゲームを新しくダウンロードしたユーザーにのみすぐにプレイできるようにチュートリアルレベルを提供しゲームの残りの部分をバックグラウンドでダウンロードできますアプリ内課金で有効になるダウンロード可能なオプションコンテンツ別名DLCを提供できます App Storeへの迅速な提出プロセスによりデバイス上の機械学習モデルを更新できますチュートリアルを含む複数の異なるレベルがあるゲームを開発しているとします各レベルでアセットを配信する次の4つのオプションがありますメインのApp Bundleにすべて保持 URLセッションオンデマンドリソースバックグラウンドアセットそれぞれに長所と短所があるのでそれを説明します
メインのApp Bundleにすべて保持する場合チュートリアルレベルを始めるだけの場合でもユーザーはアセットがすべてダウンロードされるのを待つ必要がありますまたほとんどのプラットフォームで 4GBのサイズ制限に達する可能性がありアセットの一部を更新するためにアプリ全体を再アップロードし再提出する必要がありますオンデマンドリソースの場合ユーザーはより迅速にチュートリアルを開始できます TestFlightやApp Storeから App Bundleの一部を個別にダウンロードできるからですただこの場合もアセットファイル数個の更新にアプリ全体を更新する必要がありますオンデマンドリソースは古い技術であり非推奨になる予定です
その後継がバックグラウンドアセットでありデベロッパがアプリのアセットを独自のサーバでホストしますアセットはいつでも更新できアプリ全体の更新は不要です Background Assetsの中核はダウンローダー拡張機能ですユーザーがアプリを開く前にアセットをダウンロードするスケジュールをコーディングできますこれはダウンロードの動作と後処理を完全に制御する場合に最適ですしかし皆さんの多くにとって重要なことはアプリのアセットが利用可能で最新の状態であることです新しい Managed Background Assets機能ではシステムがアセットパックのダウンロード更新圧縮などを自動的に管理します実際当社はシステム提供のダウンロードまたは拡張機能を作成しましたこれはカスタムコードなしでアプリに組み込めますさらに TestFlightおよびApp Store上のアプリ向けの Appleがホストする新しいバックグラウンドアセットサービスを使用すると Appleホスティングオプションを使用して独自のサーバ上でアセットをホストする必要がありません Apple Developer Programのメンバーシップに含まれる 200GBのAppleホスティング容量を利用できます
現在オンデマンドリソースを使用している場合はバックグラウンドアセットへの移行を開始することをお勧めします Managed Background Assetsでは複数のアセットパックを作成しゲームのチュートリアルレベルのためのテクスチャサウンドエフェクト GPUシェーダなどアセットファイルの一部をそれぞれのアセットパックにグループ化しますシステムはダウンロードポリシーに基づきアセットパックをユーザーのデバイスに自動的にダウンロードしますダウンロードポリシーには必須プリフェッチオンデマンドの 3つがあります必須ダウンロードポリシーではシステムが自動的にアセットパックをダウンロードしインストールプロセスにダウンロードを統合しますアセットパックは App Store TestFlight ホーム画面でユーザーが目にするダウンロードの進行状況全体に寄与しますインストールが完了してユーザーがアプリを開くとアセットパックは使用できる状態です
プリフェッチダウンロードポリシーではアプリのインストール中にアセットパックのダウンロードが開始されますがアプリのインストールが完了した後にダウンロードがバックグラウンドで続行される可能性がありますオンデマンドダウンロードポリシーでは APIメソッドを明示的に呼び出してリクエストした場合のみアセットパックがダウンロードされますアセットパックは自分でホストするほか Appleもホストできますここからは Jennyが Appleのサーバでアセットパックとアプリのビルドを配信する方法を説明しますわかりました Appleがホストする各アセットパックは複数のプラットフォームにわたる 1つのアプリに対して使用できますデバイスにアプリのバイナリとそのアセットパックをダウンロードするにはまず両方をApp Store Connectに別途アップロードする必要がありますその後 TestFlightの外部テストおよび App Storeでの配信に関する審査のために提出できます
アップロードされたアセットパックにはバージョンが割り当てられますこれは特定のアプリのビルドに紐付けられていませんデバイス上でのアプリとアセットパックの対応はアセットパックバージョンの状態で決まります例を挙げて説明します
同じアセットパックに対して 3つの異なるバージョンがあるとしますバージョン1はApp Storeで公開済みでバージョン2はTestFlightで外部ベータ版として公開されバージョン3はTestFlightで内部ベータ版として公開されます各コンテキストで公開できるアセットパックのバージョンは1つだけです同時に App Storeからダウンロードしたまたは TestFlightの外部ベータ版や内部ベータ版としてダウンロードしたアプリのビルドがデバイス上にありますサーバはその特定のコンテキストにあるすべてのアプリビルドに対応するアセットパックの公開バージョンを配信します
つまり App Storeからダウンロードされたアプリのバージョン1.0ビルド1はアセットパックバージョン1を使用します
TestFlightの外部ベータ版で利用可能なアプリのバージョン2.0ビルド1はアセットパックバージョン2を使用します内部ベータ版のアプリのバージョン2.0 ビルド2および3はアセットパックバージョン3を使用します
ここでアセットパックバージョンの更新を行うときの動作を理解することが重要です
例えばアセットパックバージョン2が完成した場合 App Storeでの配信用に提出できますそれが古いバージョンの代わりに App Storeで公開されます
つまり App Storeからダウンロードされたアプリのすべてのバージョンはユーザーのデバイスにインストールされている古いバージョンも含めアセットパックバージョン2を使用するように自動的に切り替えられますそのためアセットパックを更新する前に古いビルドやバージョンでも機能するか確認します次にアプリのビルドを更新する例を見てみましょう例えばアプリのバージョン2.0ビルド3を外部ベータ版テスト用に送信するとします承認後外部ベータ版を通じてビルドがダウンロードされた場合そのビルドは古いアセットパックであるバージョン2を使用します新しいアセットパックバージョン3が使用されるようにするにはアセットパックバージョンも確実に提出してくださいアセットパックの概念を理解できたと思いますので Gabrielに作成方法とアプリでの使用方法を説明してもらいましょうありがとう Jenny ではアプリでManaged Background Assetsを使用する方法を説明します
Managed Background Assetsの使用を開始するにはアセットパックを作成し新しいAPIを採用してアプリとアセットパックをローカルでテストします
アセットパックの作成方法を説明します
macOS Linux およびWindows用の新しいパッケージ化ツールを使用してソースリポジトリからファイルを取得し TestFlightやApp Storeへの配信用に圧縮アーカイブとしてパッケージ化できますパッケージ化ツールはmacOSの Xcodeに同梱されており Linux Windows用も Apple Developerサイトのダウンロードページでまもなく入手できますツールの動作をお見せします
まずターミナルコマンドを実行してマニフェストテンプレートを生成します macOSでXcodeをインストールしターミナルで xcrun ba-package templateを実行します LinuxまたはWindowsではシェルの検索パスでツールを使用可能にし ba-package templateを実行しますパッケージ化ツールがマニフェストテンプレートを生成しますマニフェストはJSONファイルで入力してAppleにアセットパックについて伝えますカスタムIDはデベロッパが選択できますこれを使用してアプリのコードダウンロードポリシー対応プラットフォームでアセットパックを識別します
まずファイルセレクタを入力しましょうファイルセレクタはアセットパックに含めるソースリポジトリ内のファイルセットを選択しますファイルセレクタは2種類あります個々のファイルを選択するものとディレクトリ全体を選択するものです
ソースリポジトリのルートからの相対パスを使用してゲームの紹介用カットシーンビデオのファイルセレクタを追加しましょう
ゲームのチュートリアルレベルのアセットファイルが含まれるため IDはTutorialとします次にダウンロードポリシーを設定しますチュートリアルはユーザーが最初に体験するためユーザーが初めてゲームを開く前にアセットパックをローカルで利用可能にしますこの状況は必須ダウンロードポリシーを使用するのに最適です
このチュートリアルレベルは新規にゲームをインストールするユーザーにのみ関係しますすでにゲームをプレイしているユーザーや新バージョンに更新するユーザーはチュートリアルを再度ダウンロードする必要がありません
そこで必須ダウンロードポリシーを最初のインストールのみに制限して以降の更新は除外しますつまりダウンロードが初めてのユーザーのみチュートリアルのアセットを取得します
マニフェストを入力したのでパッケージ化ツールをもう一度実行して圧縮アーカイブを生成しましょう現在のディレクトリをリポジトリのルートに設定しマニフェストへのパスとアーカイブの保存先のパスを指定しますアセットパックをパッケージ化したのでゲームで使用する方法を確認します
わずか数行のコードでバックグラウンドアセットの新しいAPIを使用してアセットパック内のファイルを読み取ることができますまずダウンローダー拡張機能を Xcodeに追加しますダウンローダー拡張機能はメインアプリが動作していないインストール中などにアプリでアセットパックをダウンロードするようにスケジュールするものです
対象を追加し Background Download テンプレートを選択します
ここでは Appleホスティングを使用するか独自にホストするかを選択できます
Swiftコードが生成されますが Objective-Cコードに簡単に置き換えることができます
今年新たにシステムはフル機能のダウンローダー拡張機能を提供し自動ダウンロードやバックグラウンド更新などをサポートしておりカスタムコードなしでアプリに組み込むことができます Background Downloadテンプレートで Xcodeが生成したスニペットはデフォルトでシステム実装を使用するようにすでに設定されています他の拡張機能コードは必要ありません
実際ダウンロード動作をカスタマイズする必要がない場合はスタブのshouldDownload(_:)メソッドを削除できますつまり Xcodeが生成したわずか数行のコードを使用してアプリにダウンローダー拡張機能を追加できます
ダウンロード動作をカスタマイズする場合は shouldDownload(_:)のカスタム実装を提供できます新しいアセットパックごとに shouldDownload(_:)実装が呼び出されダウンロードポリシーに基づいてバックグラウンドでのダウンロードを計画しダウンロードの続行を決定するブール値を返せますこれはアセットパックの一部に特定の互換性要件がある場合に便利ですダウンローダー拡張機能を実装したのでダウンロードしたアセットパック内のファイルをアプリで使う方法を説明します
最初のステップは共有された 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でない引数を指定することで検索を特定のアセットパックに制限することもできますダウンロードしたパックをトラッキングしバックグラウンドで自動的にアセットパックを最新の状態に保ちますただしアプリがインストールされている間はアセットパックは自動的に削除されませんそのため特定のアセットパックを使用なくなった場合は共有されたアセットパックマネージャに対してremove(assetPackWithID:)メソッドを呼び出してストレージ領域を解放することをお勧めします例えばユーザーがチュートリアルレベルのプレイを終えたときチュートリアルのアセットパックを削除できます
ユーザーがゲームの進捗をリセットしてチュートリアルをもう一度プレイし始めた場合などいつでも ensureLocalAvailability(of:)を呼び出しアセットパックを再度ダウンロードすることができます
ユーザーはデバイスの設定アプリのストレージビューでアプリとダウンロードしたアセットパックが消費しているストレージ容量を確認できることに注意してください次のステップはメインアプリとダウンローダー拡張機能の両方を同じアプリグループに追加することですシステムはメインアプリと拡張機能の間の調整を容易にするためにアプリグループを使用します
アプリグループIDを文字列値として使用し BAAppGroupIDキーをメインアプリのInfo.plistに追加します
また trueまたはyesをブール値として指定し BAHasManagedAssetPacksキーを追加します
Appleホスティングを使用する場合は trueまたはyesをブール値として指定し BAUsesAppleHostingキーを追加します Appleホスティングを使用しない場合このセッションのリソースセクションで関連ドキュメントを参照して BAManifestURLなど他の必要なInfo.plistキーの詳細を確認してくださいアプリと拡張機能を設定したので次にテストを行います
TestFlightまたはApp Storeにアプリを提出する前にアセットパックのダウンロードをテストするための macOS Linux Windows用のバックグラウンドアセット模擬サーバを作成しましたパッケージ化ツールと同様に模擬サーバは macOSのXcodeに同梱されており LinuxおよびWindows用もまもなく Apple Developer Webサイトのダウンロードセクションで入手できますバックグラウンドアセットではダウンロードすべてにHTTPSを使用します最初にSSL証明書を発行する必要がありますそのためにルート認証局を作成しますさらにその認証局をテストデバイスにインストールしますその後認証局を使用して SSL証明書を発行し最後に模擬サーバを起動してそのSSL証明書を指定します詳しくはこのセッションのリソースセクションで関連するドキュメントをご参照ください SSL証明書を発行したら ba-serveを実行して模擬サーバを起動し提供するアセットパックアーカイブへのそれぞれのパスを渡してバインドするホストを設定しますホストには IPアドレスホスト名またはドメイン名を指定できます macOSでは IDを選択するよう求められますこれは証明書とキーチェーンから得られる秘密鍵のペアです LinuxまたはWindowsでは証明書と秘密鍵をコマンドライン上で渡す必要があります helpフラグを渡すとカスタムポート番号を設定するオプションなど追加のオプションを確認できますまた macOSでは IDのプロンプトをスキップする機能が近日追加される予定です iOS iPadOS visionOSや近日公開予定のtvOSのテストデバイスではのでホストとポートを含め模擬サーバのベースURLを入力します macOSのテストデバイスでは xcrun ba-serve url-overrideを実行し同じ情報を入力します
Xcodeでアプリをビルドして実行する場合は該当のアセットパックが模擬サーバからダウンロードされますここからは再びJennyがベータ版テストとアセットパックの配信について説明します - Jenny お願いします - ありがとう Gabriel 新しいアプリのバイナリパックとアセットパックを準備できたので TestFlightのベータテストと App Storeでの配信を準備する方法を説明します
Appleホスティングを使用している場合はアプリバイナリとアセットパックの両方を別途App Store Connectにアップロードし必要に応じてTestFlightでテストし最終的にApp Storeで配信します
アセットパックでのこのプロセスを詳しく見てみましょうアセットパックは複数の方法でアップロードできます
ドラッグ＆ドロップのUI体験を求める場合 macOS用のTransporterアプリが使えます
完全な制御と透明性を求める場合は App Store Connect REST APIで独自の自動化を構築できます簡素化されたコマンドライン操作をご希望の場合はクロスプラットフォームの iTMSTransporterの便利なコマンドで App Store Connect APIをリクエストできますこれらのツールの詳細についてはドキュメントをご参照くださいここでは TransporterとApp Store Connect APIの使い方を説明します Transporterアプリでは Tutorial.aar アーカイブをTransporterのウィンドウにドラッグ＆ドロップするだけです
それを追加するアプリを選択しをクリックしますチュートリアルのアセットパックの新しいバージョンが生成されます
アセットパックのアップロードの状態を Transporterアプリで確認できます
アップロードプロセスの完全に確認することを希望する場合は App Store Connect APIがお勧めです次の3つの手順に従う必要がありますアセットパックレコードを作成しアセットパックのバージョンレコードを作成します次にアセットパックバージョンに対するアーカイブをアップロードしますまずアセットパックレコードを作成するには backgroundAssetsリソースに対する POST要求を行います
要求本文にアセットパックの名前 assetPackIdentifierを入力しアプリのApple IDを relationshipsセクションに追加しますこれを呼び出すと応答としてアセットパックのUUIDが返されますそれを後のAPI呼び出しで使用できます
backgroundAssetVersionsリソースに POSTを要求してアセットパックの新しいバージョンを作成します
relationshipsセクションには前のAPI応答で提供されたアセットパックのIDを使用しますこの操作により既存のバージョンに基づいてバージョン番号が自動的に繰り上がりますここではバージョン1ですまた応答で取得するIDでチュートリアルのアセットパックのバージョン1を一意に特定できます
アセットパックバージョンを正常に作成したら backgroundAssetUploadFilesリソースを使用して Tutorial.aarアーカイブファイルのアップロードを予約します App Storeのスクリーンショットなどの他のアップロード操作と似ています
ここではアセットタイプファイル名ファイルサイズ MD5チェックサムが必要です
またバックグラウンドアセットのバージョンIDとの関係も含めますこの呼び出しの応答にはアップロードファイルのIDとアップロード手順の詳細が含まれます
アーカイブのアップロードに成功したらアップロードファイルIDを指定して backgroundAssetUploadFilesに対する PATCH呼び出しを行うとアセットパックの処理が開始されます
アセットパックの進捗を確認するには App Store Connectや App Store Connect APIで利用可能なアセットパックについての最も包括的な情報を常に得ることができます
App Store Connectではタブでアセットパックの処理ステータスを確認できますアップロードが正常に処理されるとステータスはになります TestFlightの内部テスト用に公開されているアプリビルドで新しいバージョンを使用できますアセットパックの新しいバージョンの準備ができたことを通知するメールが届きますこの通知を受け取るために Webhookを設定することもできます
今年追加されたWebhookの機能は WWDC25の「Automate your development process with the App Store Connect API」セッションをご覧ください
ただし処理中にアセットパックのアーカイブファイルに問題が見つかった場合はバージョンの状態はになり通知も送信されますその場合は問題を修正しアセットパックを新しいバージョンとして再度アップロードできます App Store Connect APIを使用すると GET要求を行って様々なリソースを得ることができアプリのすべてのアセットパックのリスト各アセットパックのバージョンや状態を確認できます backgroundAssetVersionsリソースでアップロードをトラッキングできます
アセットパックが処理されると内部ベータ版リリースリソースが作成されますアセットパックバージョンは READY_FOR_TESTINGです
アプリのバイナリとアセットパックの両方を正常にアップロードしたら TestFlightでベータ版テストを開始できます
App Store Connectでは現在チュートリアルのバージョン1が内部テストの準備済みであることがわかりますより多くの人たちを対象にアプリビルドとアセットパックバージョンをテストする場合それらを外部テスト用に別途提出できます
アセットパックを提出するには特定のバージョンをクリックしを選択しますバージョンが承認されると状態がに変化し通知が届きます
App Store Connect APIでは betaBackgroundAssetReviewSubmissions リソースを使用してアセットパックバージョンを提出できます
外部ベータ版リリースリソースで審査状況をトラッキングできますこれはアセットパックバージョンの外部テストの準備ができたことを示します
テスト後アセットパックバージョンを App Storeで公開する準備ができたら App Storeで配信するために App Reviewに提出できます
App Store Connectのタブに移動してアセットパックを表示できます 1つのアセットパックバージョンのみを提出したり他のアセットパックアプリバージョンまたは他の審査アイテムと一緒に提出したりできますアセットパックバージョンとアプリバージョンを一緒に提出した場合 App Reviewチームは選択したアセットパックバージョンを使用してアプリを審査します
審査用のアセットパックを追加するにはをクリックし
バージョンを選択して審査用に追加します
提出が承認されるとアセットパックバージョンがになります
App Store Connect APIを使用する場合 reviewSubmissionsリソースを使用して審査に提出することもできます
審査中に App Storeリリースリソースで審査の状態を確認できます配信準備完了になった場合アプリを使用しているユーザーは App Storeから新しいアセットをダウンロードできます今回はかなり多くのトピックを取り上げましたアセットパックの概要アセットパックの作成アプリでの使用 Appleホスティング用のアップロードと提出です新しいManaged Background Assetsを使うのに役立てば幸いです
次は皆さんの番ですパッケージ化ツールを使用して最初のアセットパックを作成してみてくださいさらに現在オンデマンドリソースをアプリで使用している場合はバックグラウンドアセットに移行する方法を評価してくださいドキュメントを基に新しいバックグラウンドアセットAPIをアプリに採用してくださいご意見をお待ちしていますフィードバックアシスタントで役立った内容や改善点をお知らせください App Store Connectに今年追加されたその他の新しい機能については「What's new in App Store Connect」をご視聴くださいさらにバックグラウンドアセットの既存機能の詳細とローカルテストに関する役立つヒントについては WWDC23の「What's new in 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/>

関連する章

リソース

関連ビデオ

WWDC25

WWDC23