iCloud Drive: Appleのクラウドストレージとその仕組み

iOSのiCloud Driveとは？

iCloud DriveはAppleのクラウドファイルサービスで、同じApple IDで認証されたすべてのユーザーデバイスに統一されたドキュメントストレージを提供します。このサービスは2014年にiOS 8およびOS X YosemiteとともにiCloud Documentsの後継として開始されました。

iCloud Driveは、他のクラウドストレージサービス（Google Drive、Dropbox）とは、オペレーティングシステムとの深い統合が異なります。ファイルは追加のアプリをインストールしなくても、macOSのFinderやiOSのファイルアプリに直接表示されます。システムはバックグラウンドで自動的にコンテンツを同期し、Wi-Fiと携帯電話ネットワークを切り替えます。

Apple Platform Overview、2024によると、iCloud Driveは最大30日間のファイルバージョン管理、iCloud Sharingによるフォルダ共有、Spotlightシステム検索との統合をサポートしています。開発者はNSFileCoordinator APIとUbiquityコンテナを介してストレージにアクセスします。

iCloud DriveのアーキテクチャとUbiquity

UbiquityはAppleの用語で、データが“どこにでも存在する”能力を意味します。iCloud Driveのコンテキストでは、これはCloudKitクラウドバックエンドを介してファイルがユーザーのすべてのデバイス間で自動的に同期できるようにするメカニズムです。

Ubiquityコンテナは、アプリケーションのサンドボックス内のディレクトリで、同期用にマークされています。このディレクトリに配置されたファイルは自動的にiCloud Driveにアップロードされ、他のデバイスに配布されます。コンテナへのアクセスはXcodeのCapabilitiesを通じて構成されます。

システムはNSMetadataQueryを介して各ファイルの状態を追跡します。ファイルはローカル（デバイスにダウンロード済み）、リモート（クラウドのみ）、またはダウンロード中のいずれかです。開発者はプログラムでファイルのダウンロードを要求したり、開く前に利用可能性を確認したりできます。

アプリへのiCloud Driveの統合

iCloud Driveの統合は、XcodeでiCloudケイパビリティを追加し、iCloud Documentsサービスを有効にすることから始まります。その後、アプリケーションはFileManagerを介してパスが返される特別なディレクトリであるUbiquityコンテナにアクセスできるようになります。

import UIKit

class DocumentManager {
    func ubiquityURL() -> URL? {
        return FileManager.default
            .url(forUbiquityContainer: nil)
    }

    func saveToICloud(data: Data, filename: String) {
        guard let containerURL = ubiquityURL() else { return }
        let fileURL = containerURL
            .appendingPathComponent(filename)

        do {
            try data.write(to: fileURL)
            Logger.storage.info(
                "Saved \(filename) to iCloud Drive"
            )
        } catch {
            Logger.storage.error(
                "Save failed: \(error.localizedDescription)"
            )
        }
    }

    func listICloudFiles() {
        let query = NSMetadataQuery()
        query.searchScopes = [NSMetadataQueryUbiquitousDocumentsScope]
        query.start()
    }
}

NSDocumentPickerViewControllerは、iCloud Driveからファイルを選択およびインポートするためのシステムUIを提供します。ユーザーは検索、並べ替え、複数選択をサポートする標準のファイルブラウザを表示します。ファイル選択後、アプリケーションはそのURLを受け取り、NSFileCoordinatorを介して作業できます。

重要なルール：iCloud Driveファイルを操作する場合は、読み取りと書き込みにNSFileCoordinatorを使用する必要があります。これにより、操作中にファイルが別のプロセス（同期など）によって変更されないことが保証されます。コーディネーションを怠るとデータが破損する可能性があります。

競合解決とNSFileVersion

バージョンの競合は、同期が完了する前にファイルが2つのデバイスで同時に変更された場合に発生します。iOSはNSFileVersionを介してこのような状況を自動的に検出し、ユーザーまたはアプリケーションが解決する必要がある競合バージョンを作成します。

func resolveConflicts(for fileURL: URL) {
    let conflictVersions = NSFileVersion
        .unresolvedConflictVersionsOfItem(at: fileURL) ?? []

    for version in conflictVersions {
        do {
            let conflictData = try Data(contentsOf: version.url)
            let resolved = mergeData(
                original: try Data(contentsOf: fileURL),
                conflict: conflictData
            )
            try resolved.write(to: fileURL)
            version.remove()
        } catch {
            Logger.sync.error(
                "Conflict resolution failed: \(error)"
            )
        }
    }
}

NSFileVersionは、最大30日間ファイル変更履歴を保存します。各バージョンにはURL、作成日、バージョンを作成したデバイスの識別子が含まれます。2つのデバイスが同じベース識別子で変更を送信すると、システムは自動的にバージョンを競合としてマークします。

解決戦略：アプリケーションは自動的に変更をマージするか（サポートされている形式の場合）、ユーザーにバージョンの選択を表示するか、最後に書き込んだ人が優先（last-writer-wins）戦略を使用できます。Appleはテキストおよび構造化データには自動マージを推奨し、バイナリ形式には競合バージョンをユーザーに表示することを推奨しています。

ストレージの制限と最適化

iCloudの無料ストレージは5GBで、バックアップ、写真、メール、iCloud Driveのすべてのユーザーサービスに分散されています。有料プランは50GBから始まり、最大12TBまであります。ファイル交換が頻繁なアプリケーションでは、これらの制限を考慮することが重要です。

ストレージの最適化：iOSはファイルの排除メカニズムを提供しています。ローカル容量が不足すると、システムはiCloud Driveファイルのキャッシュコピーを削除し、メタデータのみを残すことができます。そのようなファイルを開こうとすると、システムは自動的にクラウドからダウンロードします。開発者はNSFileCoordinatorを介してこのプロセスを制御し、NSMetadataUbiquitousItemDownloadingStatusKeyを介してファイルの状態を確認できます。

WWDC 2022によると、AppleはiCloud Driveを最適化するために次のプラクティスを推奨しています。Ubiquityコンテナにはアプリケーションキャッシュではなくユーザードキュメントのみを保存する。進行状況表示付きの非同期ダウンロードを使用する。ダウンロード前にファイルサイズ情報をユーザーに提供する。大きなファイルの再開サポートを実装する。

重要な注意点：Ubiquityコンテナからファイルを削除すると、ユーザーのすべてのデバイスからも削除されます。一時ファイルの場合は、Ubiquityコンテナの代わりにローカルのDocumentsディレクトリを使用してください。また、同期は瞬時ではなく、ファイルサイズやネットワークによって数秒から数分の遅延が発生する可能性があることに注意してください。