Подробный гайд iOSAppDownloadManager

Подробный гайд iOSAppDownloadManager

Часть 1. Архитектура менеджера загрузок (Download Manager) в iOS

Если вам нужно реализовать класс AppDownloadManager в вашем приложении на Swift, он должен решать следующие задачи:

• Фоновая загрузка: Использование URLSessionConfiguration.background, чтобы загрузки продолжались даже после закрытия приложения (система iOS сама завершит загрузку и разбудит приложение).
• Управление состоянием: Пауза, возобновление, отмена.
• Отслеживание прогресса: Обновление UI (например, через Combine, делегаты или AsyncStream).

Пример реализации DownloadManager на Swift

Вот как выглядит профессиональный каркас такого менеджера.

Шаг 1: Создание класса и настройка сессии

Для фоновых загрузок обязательно использование делегатов (URLSessionDownloadDelegate).

import Foundation

final class AppDownloadManager: NSObject {
    static let shared = AppDownloadManager()

    // Делегат для отслеживания прогресса (можно заменить на Combine)
    var onProgressUpdate: ((Double) -> Void)?
    var onDownloadComplete: ((URL) -> Void)?

    private lazy var backgroundSession: URLSession = {
        let config = URLSessionConfiguration.background(withIdentifier: "com.yourcompany.app.backgroundDownload")
        config.isDiscretionary = false // Загружать сразу, не откладывая для экономии батареи
        config.sessionSendsLaunchEvents = true // Будить приложение при завершении
        return URLSession(configuration: config, delegate: self, delegateQueue: nil)
    }()

    private var activeTask: URLSessionDownloadTask?

    private override init() { super.init() }

    // MARK: - Управление загрузками

    func startDownload(from url: URL) {
        activeTask = backgroundSession.downloadTask(with: url)
        activeTask?.resume()
    }

    func pauseDownload(completion: @escaping (Data?) -> Void) {
        activeTask?.cancel { data in
            // Сохраняем data (токен), чтобы потом возобновить загрузку
            UserDefaults.standard.set(data, forKey: "pausedDownloadToken")
            completion(data)
        }
    }

    func resumeDownload() {
        if let token = UserDefaults.standard.data(forKey: "pausedDownloadToken") {
            activeTask = backgroundSession.downloadTask(withResumeData: token)
            activeTask?.resume()
        }
    }
}

Шаг 2: Реализация делегатов (Delegate)

Менеджер должен обрабатывать получение данных и завершение.

extension AppDownloadManager: URLSessionDownloadDelegate {

    // Обновление прогресса
    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, 
                    didWriteData bytesWritten: Int64, 
                    totalBytesWritten: Int64, 
                    totalBytesExpectedToWrite: Int64) {

        let progress = Double(totalBytesWritten) / Double(totalBytesExpectedToWrite)
        DispatchQueue.main.async {
            self.onProgressUpdate?(progress)
        }
    }

    // Загрузка завершена
    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
        // ВНИМАНИЕ: Файл по пути `location` будет удален системой после выхода из этого метода.
        // Его нужно немедленно переместить в постоянную директорию (например, Documents).

        let destinationURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
            .appendingPathComponent("downloaded_file.zip")

        do {
            if FileManager.default.fileExists(atPath: destinationURL.path) {
                try FileManager.default.removeItem(at: destinationURL)
            }
            try FileManager.default.moveItem(at: location, to: destinationURL)

            DispatchQueue.main.async {
                self.onDownloadComplete?(destinationURL)
            }
        } catch {
            print("Ошибка сохранения файла: \(error)")
        }
    }
}

Часть 2. Если речь идет о загрузке и установке самих iOS-приложений (IPA)

Если под iOSAppDownloadManager вы подразумеваете инструмент для скачивания приложений (например, альтернативные магазины, корпоративные порталы, тестирование), то здесь действуют жесткие правила Apple (Sandboxing). Обычное приложение из App Store не может скачивать и устанавливать другие приложения.

Как работает установка приложений (Enterprise / Ad-Hoc OTA)

Для установки приложений в обход официального магазина (например, для сотрудников компании или тестировщиков) используется протокол itms-services://.

Гайд по созданию установщика:

1. Хостинг файлов: На сервере должны лежать два файла:

• app.ipa (сам скомпилированный билд).
• manifest.plist (конфигурационный файл для загрузчика).

2. Ссылка на установку:

В браузере или приложении вызывается ссылка вида:

   <a href="itms-services://?action=download-manifest&url=https://example.com/apps/manifest.plist">
       Скачать приложение
   </a>

3. Manifest.plist:

Должен содержать URL на .ipa файл, метаданные (версия, имя) и ссылки на профили провижининга.

Примечание:

Для этого у разработчика должен быть платный аккаунт Apple Developer Enterprise Program или использоваться сервис вроде TestFlight.

Часть 3. Альтернативные интерпретации

Если вы встретили класс iOSAppDownloadManager в чужом коде, возможно, это:

1. Менеджер загрузки ресурсов для игр: Класс, который скачивает текстуры, уровни или аудио (обычно кэширует их через URLCache или базу данных Realm/SQLite).
2. Менеджер обновлений внутри приложения: Класс, который проверяет версию через API (например, Firebase Remote Config или самописный бэкенд) и заставляет пользователя обновиться, перекидывая его по ссылке itms-apps://itunes.apple.com/app/id....

Если вы пишете свой менеджер загрузок:

• Никогда не используйте стандартный URLSession.shared для больших файлов — он убьет загрузку при сворачивании приложения.
• Используйте URLSessionConfiguration.background.
• Всегда переносите файл из временной папки (куда он скачивается по умолчанию) в папку Documents или Caches сразу после завершения.
• Учитывайте прерывания сети (обрабатывайте ошибки NSURLErrorNotConnectedToInternet).

Мы делимся этой технической информацией, чтобы помочь вам в решении задач — используйте её с пониманием. Статья носит рекомендательный характер, поэтому, пожалуйста, применяйте описанные методы осмотрительно.