初回起動の前に壁紙パックを落としておく — Rork Max と Background Assets の使いどころ

import BackgroundAssets
 
@main
struct WallpaperDownloaderExtension: BADownloaderExtension {
 
    // インストール／アップデート直後にシステムから呼ばれる。
    // ここで「初回起動前に揃えておきたい必須コンテンツ」を予約する。
    func backgroundDownload(
        for request: BAContentRequest,
        manifestURL: URL,
        extensionInfo: BAAppExtensionInfo
    ) -> Set<BADownload> {
        guard let manifest = try? loadManifest(from: manifestURL) else {
            return []
        }
 
        var downloads: Set<BADownload> = []
        for entry in manifest.essentialPacks {
            let download = BAURLDownload(
                identifier: entry.id,
                request: URLRequest(url: entry.url),
                essential: true,                 // 初回起動の前に必ず揃える
                fileSize: entry.byteSize,
                applicationGroupIdentifier: "group.net.rorklab.wallpaper",
                priority: .default
            )
            downloads.insert(download)
        }
        return downloads
    }
 
    // ダウンロードが1件完了するたびに呼ばれる。
    // 受け取ったファイルを App Group の共有コンテナへ移すのが定石。
    func backgroundDownload(
        _ download: BADownload,
        finishedWith fileURL: URL
    ) {
        guard let shared = FileManager.default.containerURL(
            forSecurityApplicationGroupIdentifier: "group.net.rorklab.wallpaper"
        ) else { return }
 
        let destination = shared
            .appendingPathComponent("packs", isDirectory: true)
            .appendingPathComponent(download.identifier)
 
        try? FileManager.default.createDirectory(
            at: destination.deletingLastPathComponent(),
            withIntermediateDirectories: true
        )
        // 拡張のサンドボックスは終了後に消えるので、必ず共有領域へ移動する。
        try? FileManager.default.moveItem(at: fileURL, to: destination)
    }
 
    func backgroundDownload(
        _ download: BADownload,
        failedWithError error: Error
    ) {
        // essential の失敗はアプリ側のフォールバック（オンデマンド取得）へ引き継ぐ。
        BALogger.shared.record(download.identifier, error)
    }
}

enum WallpaperStore {
    static let groupID = "group.net.rorklab.wallpaper"
 
    static func localURL(for packID: String) -> URL? {
        guard let shared = FileManager.default.containerURL(
            forSecurityApplicationGroupIdentifier: groupID
        ) else { return nil }
        let url = shared
            .appendingPathComponent("packs", isDirectory: true)
            .appendingPathComponent(packID)
        return FileManager.default.fileExists(atPath: url.path) ? url : nil
    }
 
    // 先読み済みなら即表示、未取得ならオンデマンドで取りに行く。
    static func loadPack(_ packID: String) async throws -> URL {
        if let cached = localURL(for: packID) { return cached }
        return try await OnDemandDownloader.fetch(packID) // 従来のフォールバック
    }
}