File Provider Extension이란 뭐인가, iOS 파일 액세스 확장

iOS에서 File Provider Extension이란 뭐인가?

File Provider Extension은 iOS 및 macOS에서 애플리케이션이 시스템 Files 앱을 통해 외부 소스에서 파일에 액세스할 수 있도록 하는 앱 확장 기능입니다. 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가 없습니다 — 파일 읽기, 쓰기, 이름 바꾰기 및 삭제 요청을 처리하는 헤들리스 프로세스입니다. 모든 작업은 NSFileProviderManager를 통해 비동기적으로 수행됩니다.

중요한 구별: File Provider Extension은 별도 프로세스에서 실행되며 메모리가 부족할 때 시스템에 의해 종료될 수 있습니다. 따라서 공급자는 식별자와 동기 캐시를 영구 저장소에 저장하여 재시작 후 상태를 복구할 수 있어야 합니다.

NSFileProviderItem 모델: 파일과 폴더

NSFileProviderItem은 공급자 계층에서 개별 파일 또는 폴더를 설명하는 프로토콜입니다. 각 항목은 고유 식별자, 이름, 유형(파일 또는 폴더), 생성 및 수정 날짜, 크기 및 플래그(오프라인 사용 가능, 읽기 전용)가 있습니다.

프로토콜은 NSFileProviderItemProtocol을 통해 확장 기능도 지원합니다: 태그(색상 레이블), 아이콘, 버전 관리 및 사용자 직접 작업. 큰 파일의 경우 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를 통해 버전 객돌 감지를 지원합니다. 파일이 로컬과 원격에서 동시에 변경되면 공급자는 동기 앵커를 사용하여 마지막으로 동기화된 버전을 확인하고 마지막 작성자 승 전략 또는 객돌 복사본 생성으로 객돌을 해결합니다.

보안 및 확장 산박스

File Provider Extension은 엄격한 iOS 산박스 내에서 작동합니다. 확장 기능은 호스트 애플리케이션의 파일 시스템에 직접 액세스할 수 없고, 반대로 애플리케이션도 공급자의 파일을 직접 읽을 수 없습니다. 모든 데이터 교환은 Files.app 시스템 API를 통해 이루어집니다.

사용자 파일에 대한 액세스는 명시적인 상호작용을 통해서만 가능합니다: 사용자가 애플리케이션에서 Files.app에서 파일을 열면 시스템이 격리된 컨테이너에 파일의 임시 복사본을 만듭니다. 받는 애플리케이션은 공급자의 저장소에 있는 원본이 아닌 이 복사본을 처리합니다.

Apple Security Guide, 2024에 따르면 공급자는 전송 중 데이터 압호화(TLS 1.3)를 구현해야 하며 캐시된 파일에 대해 선택적으로 디스크 압호화를 추가할 수 있습니다. 사용지 인증은 별도의 FileProviderUI 구성 요소를 통해 수행되며, 안전한 자격 증명 입력을 위해 확장 산박스 밖에서 실행됩니다.

주요 제한 사항: 확장 기능은 임의 코드를 실행할 수 없습니다 — NSFileProviderManager를 통해서만 요청을 처리합니다. 파일 작업을 넘는 모든 로직은 기본 애플리케이션에서 구현되어야 하며 앱 그룹 또는 XPC 서비스를 통해 호출되어야 합니다.