File Provider Extension: что это, расширение доступа к файлам iOS

Что такое File Provider Extension в iOS?

File Provider Extension — это app extension в iOS и macOS, которое позволяет приложению предоставлять доступ к файлам из внешних источников через системное приложение Файлы. Оно появилось в iOS 11 и заменило механизм Document Provider, добавив поддержку синхронизации, поиска и тэгов.

Основная задача File Provider Extension — выступать мостом между внешним хранилищем (облачным сервером, корпоративным NAS, FTP) и Files.app. Пользователь видит файлы и папки так, будто они хранятся локально, хотя на самом деле данные могут находиться на удалённом сервере. Расширение работает в фоновом режиме, синхронизируя содержимое по мере необходимости.

По данным WWDC 2024, Apple активно развивает FileProvider API: добавлена поддержка инкрементальной синхронизации, улучшена производительность для больших директорий и появилась возможность групповых операций. Это делает File Provider Extension предпочтительным способом интеграции внешних файлов в экосистему Apple.

Как работает File Provider Extension

Архитектура File Provider Extension состоит из двух компонентов: основное расширение (тип файл-провайдера) и опциональное UI-расширение для аутентификации и конфигурации. Основное расширение реализует протокол NSFileProviderExtension и обрабатывает все запросы от Files.app.

import FileProvider

class CloudFileProvider: NSFileProviderExtension {
    override func item(for identifier: NSFileProviderItemIdentifier) throws -> NSFileProviderItem {
        guard let item = storage
            .item(for: identifier) else {
            throw NSError(domain: NSFileProviderErrorDomain,
                              code: NSFileProviderError.noSuchItem.rawValue)
        }
        return item
    }

    override func urlForItem(with identifier: NSFileProviderItemIdentifier) -> URL {
        return fileCoordinator.urlForItem(with: identifier)
    }
}

Когда пользователь открывает Files.app и выбирает ваш провайдер, система запускает расширение в фоновом процессе. Расширение не имеет UI — это headless-процесс, который обрабатывает запросы на чтение, запись, переименование и удаление файлов. Все операции выполняются асинхронно через NSFileProviderManager.

Важный нюанс: File Provider Extension живёт в отдельном процессе и может быть завершён системой при нехватке памяти. Поэтому провайдер должен уметь восстанавливать состояние после перезапуска, сохраняя идентификаторы и кэш синхронизации в постоянное хранилище.

Модель NSFileProviderItem: файлы и папки

NSFileProviderItem — это протокол, который описывает отдельный файл или папку в иерархии провайдера. Каждый элемент имеет уникальный идентификатор, имя, тип (файл или папка), даты создания и модификации, размер и флаги (доступен офлайн, только для чтения).

Протокол также поддерживает расширенные возможности через NSFileProviderItemProtocol: тэги (цветные метки), иконки, версионирование и кастомные действия. Для больших файлов реализуется поддержка докачки (resumable transfers) через NSFileProviderService.

По данным WWDC 2023, Apple рекомендует использовать замыкания (NSFileProviderItemFields) для обновления только изменившихся свойств, а не всего объекта. Это значительно ускоряет синхронизацию при пакетных обновлениях — например, когда меняется только размер группы файлов.

Движок синхронизации и NSFileProviderManager

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

class SyncManager {
    let providerManager = NSFileProviderManager.default

    func signalUpdate(for item: NSFileProviderItemIdentifier) {
        providerManager.signalEnumerator(
            for: item.parentItemIdentifier
        ) { error in
            if let error = error {
                Logger.sync.error(
                    "Failed to signal: \(error.localizedDescription)"
                )
            }
        }
    }

    func uploadItem(at url: URL, itemId: NSFileProviderItemIdentifier) {
        providerManager.registerURLBasedItem(
            with: itemId,
            url: url
        )
    }
}

Движок синхронизации — это логика, которую разработчик реализует самостоятельно. Apple не предоставляет встроенного механизма синхронизации — только API для уведомления системы об изменениях. Провайдер сам решает, как загружать файлы с сервера, кэшировать их локально и разрешать конфликты редактирования.

Конфликты: система поддерживает обнаружение конфликтов версий через NSFileProviderSyncAnchor. Когда файл изменяется одновременно локально и удалённо, провайдер использует sync anchor для определения последней синхронизированной версии и разрешения конфликта по стратегии «последний пишущий» или через создание конфликтующей копии.

Безопасность и песочница расширения

File Provider Extension работает внутри строгой песочницы (sandbox) iOS. Расширение не имеет прямого доступа к файловой системе приложения-хоста и наоборот — приложение не может читать файлы провайдера напрямую. Весь обмен данными идёт через системные API Files.app.

Доступ к файлам пользователя возможен только через явное взаимодействие: пользователь открывает файл из Files.app в приложении, и система создаёт временную копию файла в изолированном контейнере. Приложение-получатель работает с этой копией, а не с оригиналом в хранилище провайдера.

По данным Apple Security Guide, 2024, провайдер обязан реализовать шифрование данных при передаче (TLS 1.3) и может опционально добавить шифрование на диске для кэшированных файлов. Аутентификация пользователя выполняется через отдельный UI-компонент FileProviderUI, который запускается вне песочницы расширения для безопасного ввода учётных данных.

Ключевое ограничение: расширение не может запускать произвольный код — оно обрабатывает только запросы через NSFileProviderManager. Любая логика, выходящая за рамки файловых операций, должна быть реализована в основном приложении и вызываться через app groups или XPC services.