Rork Max アプリでダウンロードをアプリ終了後も続ける — バックグラウンド URLSession の設計と再起動復帰

extension BackgroundDownloadManager: URLSessionDownloadDelegate {
    func urlSession(_ session: URLSession,
                    downloadTask: URLSessionDownloadTask,
                    didFinishDownloadingTo location: URL) {
        // HTTP ステータスの検証を忘れない（404 の HTML も「成功」で届く）
        guard let response = downloadTask.response as? HTTPURLResponse,
              (200...299).contains(response.statusCode) else {
            return
        }
        guard let sourceURL = downloadTask.originalRequest?.url else { return }
 
        let dest = FileManager.default
            .urls(for: .applicationSupportDirectory, in: .userDomainMask)[0]
            .appendingPathComponent(sourceURL.lastPathComponent)
 
        do {
            try? FileManager.default.removeItem(at: dest)
            // 非同期にせず、この場で同期的に移動する
            try FileManager.default.moveItem(at: location, to: dest)
        } catch {
            // 移動失敗はダウンロード失敗として扱い、再試行キューへ
        }
    }
}

// AppDelegate.swift
import UIKit
 
final class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication,
                     handleEventsForBackgroundURLSession identifier: String,
                     completionHandler: @escaping () -> Void) {
        guard identifier == BackgroundDownloadManager.sessionIdentifier else {
            completionHandler()
            return
        }
        // すぐ呼ばず、保持しておく
        BackgroundDownloadManager.shared.backgroundCompletionHandler = completionHandler
        // 同じ identifier でセッションを再生成し delegate を配線し直す
        _ = BackgroundDownloadManager.shared
    }
}
 
@main
struct MyApp: App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
 
    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

extension BackgroundDownloadManager {
    func urlSessionDidFinishEvents(forBackgroundURLSession session: URLSession) {
        DispatchQueue.main.async {
            self.backgroundCompletionHandler?()
            self.backgroundCompletionHandler = nil
        }
    }
}

func urlSession(_ session: URLSession, task: URLSessionTask,
                didCompleteWithError error: Error?) {
    guard let error = error as NSError? else { return }  // nil なら正常完了
    if let resumeData = error.userInfo[NSURLSessionDownloadTaskResumeData] as? Data {
        saveResumeData(resumeData, for: task.originalRequest?.url)
    } else {
        scheduleRetry(for: task.originalRequest?.url)  // 最初からやり直し
    }
}
 
func resumePendingDownloads() {
    for (url, data) in loadAllResumeData() {
        let task = session.downloadTask(withResumeData: data)
        task.resume()
        clearResumeData(for: url)
    }
}

画像パックのダウンロード機能を実装してください。
- URLSessionConfiguration.background を使い、アプリがサスペンド・終了されても
  nsurlsessiond 側で転送が継続する構成にする
- completion handler 型 API は使わず、URLSessionDownloadDelegate で受ける
- didFinishDownloadingTo では一時ファイルを同期的に Application Support へ移動する
- AppDelegate に handleEventsForBackgroundURLSession を実装し、
  urlSessionDidFinishEvents で completionHandler を呼ぶ
- 失敗時は resumeData を保存し、次回起動時に再開する