Background Assetsについて

Background Assetsについて

Background Assetsフレームワークを使用して、CDNから大きなファイルを直接ダウンロードし、Appやゲームの初回起動時のエクスペリエンスを向上させる方法をご確認ください。Appの初回インストール時、Appの更新時、ユーザがAppを使用しているときに定期的にバックグラウンドのダウンロードをスケジュールする方法を紹介します。また、スケジュールされたダウンロードを管理して、ユーザが必要なときに必要なコンテンツを確実に入手する方法についても解説します。

リソース
関連ビデオ

Tech Talks
- ハイエンドゲームのiPhone 15 Proへの展開
WWDC23
- Background Assetsの新機能
WWDC21
- HTTP/3とQUICによあるネットワーキングの加速
ダウンロード

♪ 落ち着いた雰囲気のヒップホップ音楽 ♪ ♪ こんにちは Jaredです Appleのソフトウェアエンジニアです本日は今年発表となった iOS iPadOS macOSにおける新しいフレームワークについてお話しします Background Assetsと呼ばれよく知っているAppやみなさんさんが開発されている Appのユーザー体験を著しく充実させると信じております最初に新しい Background Assets フレームワークをご紹介しその後でこのフレームワークをAppに採用する方法をお見せしますその後 Extensionの概要とそれが提供する新しい機能について軽くご説明します最後にベストプラクティスと本日学んだことをおさらいしますスタートする前に私たちがここで何を解決しようとしているかを説明します待つことというのは面白いものではありません私たちのソフトウェアを使われる方々に待てと言うと不満が募り Appが提供する体験が損なわれます例えば完璧なAppを見つけるのに App Storeをずっと検索した経験はありませんか？完璧そうなのがやっと見つかり「入手」ボタンをタップします期待はどんどん募るばかりその後すぐにネットワーク接続や Appのサイズによってダウンロード完了まで待つ必要があることに気づきます数秒待った後 iPhoneを置きコーヒーでも飲みながらマインドフルネスや我慢強くなるための実践本を読みます数時間経ってiPhoneを取り使うのを１日中待っていた完璧なAppを使おうとワクワクします Appを起動した瞬間に別のダウンロードが始まります困惑してしまいます１日中iPhoneをさわらなかったのになぜまだ待たされるのでしょうか？ Appをインストールした後にこのコンテンツを自動的にダウンロードしないのでしょうか？インターネット接続が遅い場合イライラしてAppを消去してしまうでしょう誰もこんな経験をしたくないのが本音ですよねこれはみなさんのせいではなくこれをより優れた体験にできることは間違いありませんそこで自信を持って今年ご紹介するのが Background Assetsですこのフレームワークは Appのユーザー体験を充実させるために開発されました Appが起動した瞬間に最高の第一印象を提供するためです Background Assetsは既存のワークフローと柔軟に連携するよう設計されています多くのみなさんはすでに複雑なアセット管理システムを構築しています私たちはこのフレームワークがすでに開発されたみなさんのソリューションに適合するようまた App Storeへの追加の提出を行わずに Appに更新されたコンテンツをプッシュできることを望んでいますゲームやその他のAppが発売された後に追加のコンテンツが必要になるのはよくありますアートテクスチャの更新やゲームレベルのバグ修正のように Background Assetsでは Appのライフサイクルの外でアセットのスケジューリングと更新が実行可能になります最初にAppが起動される前や Appが夜中に更新された後にアセットが存在することが重要であると私たちは考えていますそのためAppの起動時にコンテンツが利用可能になるよう仕組みを作成しましたさらにフレームワークの採用がより簡単になるとみなさんがAppで使うことを推奨しやすくなります大量のアセットが事前にダウンロードされる必要があるあらゆる場所で使用していただけますそうすればAppの待機時間を短縮しコンテンツの進捗バーを表示することができますこのフレームワークがどのようにこの問題を解決してくれるのか？と不思議に思うかもしれませんできる限り拡張可能にするためにバックグラウンドでのコンテンツダウンロード向け App Extensionを作成しましたこの新しいExtensionは当社のプラットフォームの別のExtensionが使用する強力なApp Extensionの仕組みの上に構築されていますこれによりAppのライフサイクルの外でコードを実行できるようになります例えばこのExtensionは初めてAppをインストールしそのAppが初回起動される前の段階で実行されますまたAppがバックグラウンドで自動更新された場合にも実行されますこれにより Appが更新されユーザがAppを開く前にコンテンツをスケジューリングしダウンロードすることが確実に可能になります最後にExtensionは定期的にバックグラウンドでも実行され更新されたアセットを確認し定期的にスケジューリングすることができますここで注意が必要なのは Extensionのランタイムは長くないということですそのためExtensionでスケジューリングするすべての作業を迅速にこなす必要がありますダウンロードがすばやくスケジューリングされないとシステムがこのExtensionを終了させてしまいます他にも注意事項がありますこのExtensionを定期的に実行する頻度は Appの使用頻度によってコントロールされます Appが頻繁に使用されていない場合このExtensionのランタイムの頻度が落ちる形となります以上が Background Assetsの概要です Appが起動した時にアセットが利用可能である状態を確実なものにしますこれはAppがインストールまたは更新されユーザがそのAppを起動する前に実行されるExtensionによって行われますではプロジェクトにこのフレームワークを採用し使い始める方法をご説明しますフレームワーク内の Download Managerは Background Assets システムサービスでコミュニケーションを行うための主な手段となりますこのManagerはシングルトンオブジェクトで App全体で使用できます Managerを使用してアセットをフォアグラウンドまたはバックグラウンドでのダウンロードを予約します Appが起動する前に開始した可能性がある現在進行中のダウンロードの取得することもできますダウンロードのキャンセルも可能ですすでに予約されているかダウンロードの最中で最初にリクエストしたアセットが必要でなくなった場合に便利です AppとExtensionの間の排他アクセスを管理するための同期メカニズムも導入しました ExtensionとAppによる同時予約や既存のダウンロードの変更を防ぐためですお見せしたい例がありますがそれはもう少し後で Background Assetsの使用がいかに簡単かをお見せしましょう APIのいくつかの基本を段階的に説明しますそれからこれをすべて折り込み App Extensionにまとめる方法を説明しますまず Background Assets フレームワークモジュールをインポートします次はリモートアセットのある場所を示す URLを定義します簡単ですね次にExtensionと Appの両方が属する Appグループコンテナを定義します同じグループに AppとExtensionがあればダウンロード中と完了後のアセットを管理できるようになります Appグループについてよく知らない場合は Xcode 14 の Signing & Capabilityセクションで簡単に追加できますこれは２つ以上のAppが同じリソースこの場合AppとExtensionにアクセスできるようにする強力な機能です次にdownload オブジェクトを作成 Background Assets フレームワークは複数のオブジェクトをサポートしますしかしこの例では最も一般的なBAURLDownloadにフォーカスしますイニシャライザですぐにURLと Appグループ識別子を取り入れたのがわかりますこの情報はシステムにダウンロードの内容と結果のファイルがどこに保管されるかを伝えますまた識別子を取り入れこの識別子を使って AppとExtension内で起動するダウンロードを追跡しますエンジンは同じ識別子から１件のダウンロードのみを許可しますそのため識別子を一意にしてください次に BADownloaderManager 共有オブジェクトの参照を保持します Download Managerは Background Assetsの単一のインターフェイスですこれでダウンロードの監視キャンセル予約ができます次に弱い参照を BADownloadManagerDelegate プロトコルに適合するデリゲートにパスしますこのプロトコルについてはこの後すぐにお話ししますここで重要なのはこれが予約されたダウンロードに関するメッセージを受信する点です後はDownload Managerにダウンロードの予約をリクエストするだけです何らかの理由でスケジューリングできない場合はエラーが表示されますバックグラウンドでのスケジューリングに加えフォアグラウンド用の APIも提供していますフォアグラウンドでの実行は優先度を上げるだけでなく即座にダウンロードを有効にすることも可能でこれはURLSession内のデフォルトセッション構成と似ていますこのAPIは Appが Extensionにより予約されたバックグラウンドのダウンロードをフォアグラウンドに昇格させるために作成しましたここでご注意ください Extension内からのフォアグラウンドのダウンロードはできません Appからのみ初期化できます ExtensionはUIを提示せずユーザはその実行に気づかないため Extensionではバックグラウンドでのスケジューリングのみが可能です Appが既存のバックグラウンドダウンロードをフォアグラウンドに昇格させたい場合はマネージャから現在アクティブなダウンロードのリストをフェッチすることで簡単に実現します返されたリストには現在スケジューリングされているダウンロードが記載されそれにはスケジューラにある進行中や待機中のものも含まれる場合があります次にAppは startForegroundDownloadを呼び出して昇格するプロセスを開始しますダウンロードがすでにフォアグラウンドにいる場合このメソッドの呼び出しは何も効果がありませんしかしダウンロードがバックグラウンドにいると最初に停止されこの時点までダウンロードされたコンテンツを再びダウンロードする必要なくフォアグラウンドで再開しますこれはBackground Assetsを使ってバックグラウンドで予約されたダウンロードをいかに簡単にフォアグラウンドに昇格できるかをシンプルで効果的に示してくれます実にシンプルです Download Managerはダウンロードをスケジューリング管理するためのプライマリなインターフェイスですこれらのダウンロードオブジェクトが処理されるとデリゲートオブジェクトがメッセージを受信しますではデリゲートについて説明しますデリゲートはExtensionや Appによりスケジュールされたすべてのダウンロードのメッセージを受信します複数のダウンロードがスケジューリングされている場合コールバックがそのすべてを受信しますここでダウンロードオブジェクトの一意の識別子を使いそれらを区別します Appはデリゲートが BADownloadManagerで設定された瞬間にコールバックを受信しますシステムはコールバックをキューに追加しません Appがデリゲートメソッドの１つに対応しない場合やデリゲートが設定されていない場合 Extensionが呼び起されメッセージを処理しますデリゲートがApp内の BADownloadManagerで設定されていない場合 Extensionがメッセージを受信することを覚えていてください Appがフォアグラウンドにいてユーザに提示されている場合でデリゲートが設立されている場合コールバックはAppに送信され Extensionは呼ばれません ExtensionはAppがデリゲートのコールバックを処理しない場合のみ起動しますダウンロードが完了または失敗し Appがこのメッセージを処理しない場合 Extensionが起動します Extensionはどんなコールバックにも呼び起されるわけではなく BADownloadManagerDelegateと BADownloaderExtension プロトコルの間で共通のインターフェイスを共有しているコールバックのみですダウンロードの成功または失敗がデリゲートとプロトコル間の共通のインターフェイスの例です App Extensionには独自のエントリポイントがありそれに呼び起されますが Extensionがその時点で実行されている場合 BADownloadManagerでデリゲートを設定できますこれを行うと AppとExtensionの両方がデリゲートへの重複したメッセージを受信します Extensionはデリゲートメッセージを処理しません BADownloaderExtensionで定義されたエントリポイントのみで起動します Download Managerのデリゲートのプロトコルを見てみましょう最初の機能はダウンロードの開始時にメッセージを受信するものですこれはデバイスが特定のダウンロードを予約した時に追跡するのに役立ちますダウンロードが停止した場合も通知を受けます停止が発生する例として Extensionがバックグラウンドでダウンロードを開始し Appがフォアグラウンドへの昇格をリクエストした時ですこの昇格の間にダウンロードが一時停止する間隔があります Download Managerはフォアグラウンドでのダウンロードの監視を許可しますチャレンジリクエストに答えるメカニズムも提供していますこれは接続の信頼性の検証や接続を認証するための認証情報の提供に役立ちます最も重要な関数は失敗または完了したダウンロードを処理するものです失敗した場合は再度スケジューリングするか原因を判断する必要があります成功した場合はシステムはオペレーティングシステムが管理されている場所にファイルを保存しますデバイスにスペースが十分にない場合システムがファイルを削除してくれますファイルはシステムが提供した場所に保管することを強くお勧めします絶対に移動させる必要があるファイルだけを移動し後でオリジナルのファイルを削除しない限り重複させないでください Downloader Managerのデリゲートプロトコルは AppやExtensionが予約したダウンロードに関するメッセージを受信するためのものです Extensionのエントリポイントではありませんそこで次のトピックです Background Assetsで最も期待される機能「Extension」を見てみましょう Extensionはユーザが Appを起動させる前にダウンロードをスケジューリングするのを可能にしますこれによりアセットが最小の待機時間で Appでの最高の体験を提供するために準備が整っていることを確実にできます先述のように新しい App Extensionを導入しましたこれは既存のプロジェクトの中の Xcode内で作成できますちなみにExtensionは Appがインストールまたは更新された時に実行するので Appの変更で常に最新のアセットが揃うことを確実にしますまたユーザがAppを使用する頻度に応じて定期的に実行されますユーザが毎日Appを使用するとシステムはこの行動を記憶し Extensionはより頻繁に実行されますしかしAppがまったく起動されない場合この定期的な確認の頻度は低下します新しいExtensionはライフサイクルが短くアセットのダウンロードに使用を制限するためにサンドボックスも小さいものとなっていますこのExtensionではすばやい決断を行うべきでして実装もBackground Assets フレームワークに限定すべきです Extensionを詳しく見る前に Extensionを起動させるためにいくつかのものを設定する必要がありますこれらの変更は Appが App Storeでの提供に承認されるための要件でもあります Appの情報プロパティリストでいくつかの追加のキーを定義する必要がありますこれはExtensionのInfo.plistに配置できません Appのみです最初のキーは BAInitialDownloadRestrictions これはExtensionに設定する制限を指定するためのディクショナリですこの制限はApp Reviewにより審査されるのでできる限り正確にしてください次はディクショナリ内のそれぞれのキーを見てみましょう最初の制限は DownloadAllowanceですこれはバイトで表現され最初のAppインストール中に Extension内でリクエストする最大のダウンロードサイズですこのサイズはダウンロードをリクエストするすべてのサイズの合計となります各ファイルのサイズではありません次はDomainAllowListですこれは文字列で表現されるドメインの配列を取り入れますプレフィックスワイルドカードをサポートし Extensionがダウンロードを許可されているホスト名のリストを取り入れますここで重要な点は DownloadAllowanceや AllowListなどの BAInitialDownloadRestrictionsのキーはAppの最初のインストール後にのみ適用される形となります Appが起動するとこれらの制限は適用されなくなります最後の必須のキーは Info.plistのルートにあるこれらのアセットのための追加のストレージの Appが必要とする最大サイズです圧縮されたアセットをダウンロードしたい場合この値は最後に抽出される非圧縮のサイズですここに表示される数字は Appがダウンロードされる前に App Storeに表示されます管理についてお話ししたところで Extensionのエントリポイントの詳細をお話ししますプロトコルから定義した関数は Appではなくシステムにより呼び出されます AppがExtensionとの対話に責任を持つ他のApp Extensionとは異なり Background Download Extensionはシステムが仲介しますシステムがExtensionのライフサイクルを維持するため一時的なサービスとして見られるべきですプロトコル内の関数が呼び出された場合そこで行われる作業を最小限に抑えることが重要ですこれが起動した後 Extensionはすばやく終了しますここは解凍する場所や時間のかかる複雑な操作を行う場所ではありません Extensionで作業する際の利点の１つは Appで利用可能なすべての BackgroundAssets APIが Extension内でも使えることですただしForegroundDownload APIは除外されますつまりAppで行うように BADownloadManagerを使えるということです実際に AppとExtensionの両方で同じコードでアセットの予約や管理を行う何かが作成できることにお気づきになるでしょうまた Extensionを作成する際はどちらも共通のAppグループにいる必要があります同じグループの識別子を使い AppとExtensionがコンテンツを読み書きできるようにしますではExtensionを適合させる Downloader Extension プロトコルを見てみましょう最初に気づくのは Download Manager デリゲートプロトコルとかなり似ているところです前述のように BADownloadManagerを使い Extension内からデリゲートを構築することができますしかしExtensionを呼び出せるのはこのエントリポイントのみです最初の関数はAppが最初にインストールされた時に呼び出されます Appは起動していませんが Extensionは起動していますこれはAppが起動された時に最高の体験を提供するために必要なダウンロードをスケジューリングするのに最適な機会となりますまた最初の Appインストールの間はダウンロードの制約が適用されています Info.plistで定義した BADownloadRestrictions キーを確認して許可されている最大ダウンロードサイズとドメインを把握する必要があります次の関数はApp Storeが Appを更新した際に呼び出されますユーザがAppスイッチャで Appを終了していない限り新しく更新された Extensionが起動し作業をスケジューリングすることができます checkForUpdates関数は Extensionがシステムにより定期的に呼び出されるのをサポートするのでバックグラウンドダウンロードの必要がある更新を知ることができますこの関数はユーザが Appを使用する頻度により呼び出されます認証チャレンジリクエストへの反応のサポートも利用可能でダウンロードするファイルが信頼のおけるソースからのものに制限できます最後にデリゲートと同様にダウンロードの失敗や成功の通知を受けます backgroundDownloadDidFail 関数ではエラーが返されませんエラーはステートと共に BADownload オブジェクトの変数で取得できます最後の３つの関数は Extensionがダウンロードを予約していない場合でも呼び出すことができることを覚えていてください Appがダウンロードを予約したのにバックグラウンドになった場合は Extensionがダウンロードを実行することになります AppやExtensionで BADownloaderManagerを使用する方法がわかったところで AppとExtensionが同時に実行するという意味を調べてみましょう例えばシステムが Extensionを呼び起こして定期的に更新を確認させようとしますこの確認を行うために Extensionはネットワークにアクセスする必要があり BADownloaderManagerでカタログのダウンロードや利用可能な更新済みのアセットのリストを提供する他のメタデータのダウンロードのスケジューリングをします例えばファイルが100KBの小さなサイズのカタログでそれに含まれる大型の複数ギガバイトのアセットをダウンロードする必要があるとします Extensionはスケジューリングしたダウンロードがいつ完了したか失敗したかを知る必要があり Download Managerにデリゲートをアタッチします Download Managerのデリゲートは小さなファイルをダウンロードしてどの大型のアセットがスケジューリングされるか判断するため Extensionエントリポイントで使用されますまたExtension エントリポイントは即座に呼び出されるかは保証されませんダウンロードが完了すると Extensionはデリゲート経由でメッセージを受信これでExtensionはカタログファイルにアクセスできダウンロードされたファイルで何を行うか決定する必要があります Extensionがファイルを読みカタログのどのアセットがデバイスにダウンロードされるかを決定するはずです次にExtensionはこの大型のアセットのバックグラウンドダウンロードを予約しますダウンロードされたファイルは必要なくなり Extensionはファイルを削除するはずですこれは適切なように聞こえますが Extensionが実行し独自の BADownloadManageを作成している最中に Appが起動したら？では見てください Appが起動し更新されたコンテンツがあるかを知りたがりますアセットが最新状態かを判断するために利用できる Appグループにバージョン番号があるかもしれません Appは最新のカタログがダウンロードされる前に起動したためマネージャから現在のダウンロードをフェッチしカタログのダウンロードは現在進行中でデリゲート内で完了を待っていることに気づきますしかしここで問題です AppとExtensionのどちらもそれぞれのデリゲートからダウンロード完了というメッセージを受け取りますこれはデータ競合が起こったという意味です AppとExtensionの両方は同時にファイルを読み削除しようとします問題ですこれはAppかExtensionが存在しないファイルを読もうとしているからですここではAppと Extensionを App内の２つのスレッドのように考える必要があります幸いにも Background Assetsは AppとExtensionを同期する方法を提供しますではそれについて説明しましょう Background Assetsなら AppとExtensionの同期が非常に簡単です今表示されているのはダウンロードが完了した時の Download Maangerのデリゲート関数です AppやExtensionがアクセスできるファイルへのローカルパスを含む URLが提供されていますこの例ではこのファイルの排他制御を確保します次にDownload Manager への参照をつかみ completionハンドラを取り入れる withExclusiveControl 関数を使用しますすべてのコードは completionハンドラ内で実行され排他制御を必要とするその他の呼び出しと共通で排他制御を行いますつまりAppが completionハンドラから戻る前に ExtensionがwithExclusiveControlを呼び出した場合 Extensionは待つという意味です反対方向でも同じことが適用されます Extensionが排他制御を先に得ると AppはExtensionが終了するかスコープから退出して制御をリリースするまで待ちますここで覚えていただきたいのは排他制御の取得は失敗する場合があることです失敗する確率は非常に低いですが失敗した場合はコードが処理するべきです排他制御を取得できないのを確認するには関数により生成されたエラーが nilでないかを確認しますこの後はAppやExtensionが文脈内で排他的にアクセスできます先ほどの例に基づくと必要に応じてファイルのコンテンツを読み整理することが有効になりましたその他のAppやExtensionが排他制御にアクセスする機会を得た場合　すでにファイルが処理されたのを知っているからですこれを達成するにはファイルが存在するかデータベースやPリストに書かれているか確認します Background Downloader Extensionは Appの大容量のアセットのダウロードをスケジューリング収集するためのものですランタイムが短いので Extension内の作業は最小限に抑えてくださいまた ExtensionとAppを共通のAppグループに含みどちらもダウンロードされたファイルにアクセスできるようにしましょう最後にExtensionでは Appではなくシステムが仲介します基本的なBackground Download Extensionを作成する方法を学んだので Background Assetsの実装の準備が整いましたではおさらいです Download Managerは AppとExtensionの間のダウンロードのスケジューリングと調整を行うために使用しますそのため両方で Download Managerを使用してください AppがフォアグラウンドにいなくてもExtensionは Appインストールや更新時システムが判断した定期的な間隔で起動します Appが起動しバックグランドでダウンロードされていたコンテンツが応対される場合即座にダウンロードをフォアグラウンドに送ります Extensionが処理できるのはバックグランドのみです Appがダウンロードをフォアグラウンドに送ることでコンテンツはできる限り迅速に表示されます Download Managerへの排他的なアクセスが必要な場合は排他制御APIを使用してくださいそうすればAppやExtensionはその間隔でランタイムを持ちますこれは非常に便利でExtensionがコンテナへのアクセスやダウンロードの管理で Appと競合するのを防止しますこのセッションから何か参考になることがあるとすれば Appの起動を待つ間の貧弱な体験ですタスクを待つ間に Appを使用可能にして待ち時間を短縮する方法に現在取り組んでいます待ち時間を短縮する方法の１つとして Background Assets フレームワークと Background Download Extensionを導入しましょうこれを使うことによりみなさんのAppは起動する前にコンテンツを利用可能にできますドキュメントもご覧くださいこのセッションでは説明できなかった Extensionのテスト方法やエントリポイントのシミュレーションなど他の情報が含まれていますみなさんと Background Assetsを共有しフィードバックを頂けるのが楽しみです Feedback Assistantを使用して長所や改善点を教えてくださいこれは新しいフレームワークなので調整する機会は十分にありますみなさんが興味を持つような他のセッションもございます次のセッションを是非ご覧ください『HTTP３によるネットワーキングの加速』 Background Assetsと組み合わせて使えますまた別のセッション『オンデマンドリソースの紹介』では Appleがコンテンツをホストしファイルはリクエストでダウンロードできる Background Assetsの代替品をご紹介しますどちらのセッションも魅力的でとても参考になりますご清聴ありがとうございました Appleの全社員を代表してすばらしいWWDCをお過ごしください！ ♪

5:28 - Getting started with Background Assets

// Getting started with Background Assets
import BackgroundAssets

let url = URL(string: "https://cdn.example.com/large-asset.bin")!
let appGroupIdentifier = "group.WWDC.AssetContainer"
let download = BAURLDownload ( identifier: "Large-Asset",
                               request: URLRequest(url:url),
                               applicationGroupIdentifier:
                                appGroupIdentifier )

let manager = BADownloadManager.shared
manager.delegate = self  // BADownloadManagerDelegate protocol

// Schedule download at an opportunistic time determined by the system
do {
    try manager.schedule(download)
} catch {
    print("Failed to schedule download. \(error)")
}

// or Schedule download in foreground
do {
    try manager.startForegroundDownload(download)
} catch {
    print("Failed to start foreground download. \(error)")
}

// or Promote downloads to foreground.
do {
    for download in try await manager.fetchCurrentDownloads) {
       try manager.startForegroundDownload(download)
    }
} catch {
    print("Failed to promote downloads to foreground \(error)")
}

10:28 - BADownloadManager delegate protocol

// BADownloadManager protocol definition
public protocol BADownloadManagerDelegate : NSObjectProtocol {
    optional func downloadDidBegin(_ download: BADownload)

    optional func downloadDidPause(_ download: BADownload)

    optional func download(_ download: BADownload,
                           bytesWritten: Int64,
                           totalBytesWritten: Int64,
                           totalExpectedBytes: Int64)

    optional func download(_ download: BADownload, didReceive challenge: URLAuthenticationChallenge) async -> (URLSession.AuthChallengeDisposition, URLCredential?)

    optional func download(_ download: BADownload, failedWithError error: Error)

    optional func download(_ download: BADownload, finishedWithFileURL fileURL: URL)
}

15:37 - BADownloaderExtension protocol

// BADownloaderExtension protocol definition
public protocol BADownloaderExtension : NSObjectProtocol {
    optional func applicationDidInstall(metadata: BAApplicationExtensionInfo)

    optional func applicationDidUpdate(metadata: BAApplicationExtensionInfo)

    optional func checkForUpdates(metadata: BAApplicationExtensionInfo)

    optional func download(_ download: BADownload, didReceive challenge: URLAuthenticationChallenge) async -> (URLSession.AuthChallengeDisposition, URLCredential?)

    optional func backgroundDownloadDidFail(failedDownload: BADownload)

    optional func backgroundDownloadDidFinish(finishedDownload: BADownload, fileURL: URL)
  
    optional func extensionWillTerminate()
}

19:40 - Synchronizing between app and extension

// Synchronizing between app and extension
func download(_ download: BADownload, finishedWithFileURL fileURL: URL) {
    let manager = BADownloadManager.shared
    manager.withExclusiveControl { error in
        guard error == nil else {
            print("Unable to acquire exclusive control \(String(describing: error))")
            return
        }
        // Exclusive control acquired
        // All code in this scope ensures mutual exclusion between extension and app
        do {
            let data = try Data(contentsOf: fileURL, options: .mappedIfSafe)
            // Do something with memory mapped data
            try FileManager.default.removeItem(at: fileURL)
        } catch {
            print("Unable to read/cleanup file data. \(error)")
        }
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

Tech Talks

WWDC23

WWDC21