CloudKit 是 Apple 提供的雲端資料服務,建構在 iCloud 之上。它讓 App 可以把資料同步到使用者的 iCloud 帳戶,也能透過 Dashboard 管理公開資料、私有資料與資料模型。
CloudKit 主要包含兩部分:一是網頁版 Dashboard,用於管理公開資料的記錄類型與結構;二是 API,用於 App 與 iCloud 之間的資料傳輸。
開發者可以在 Dashboard 中定義 Record Type,也就是資料模型。每個 Record Type 可包含多個欄位,例如字串、數字、日期、位置、二進位資料與檔案關聯。
在 Xcode 專案的 Capabilities 中,可以開啟 iCloud 功能。若勾選 CloudKit 或 iCloud Documents,系統通常會產生以 iCloud 開頭的 Container 識別碼。

Xcode 中的 iCloud 能力設定
若需要正式建置或測試,通常要設定對應的證書與描述檔。CloudKit Dashboard 可直接從 Xcode 或 Apple 開發者後台進入,用於管理容器與資料結構。
在 Apple 開發者後台的 Identifiers 中,可以建立 iCloud Container。Container 名稱通常需要唯一,且常與 App 的 Bundle Identifier 相關聯。

iCloud Containers 設定
建立 Container 後,還需在 App IDs 中開啟 iCloud 能力,並選擇 Include CloudKit support。接著將 App ID 與剛才建立的 iCloud Container 綁定,再重新產生描述檔。

為 App ID 開啟 iCloud 與 CloudKit
若 Xcode 中仍出現設定錯誤,通常需要檢查 Bundle Identifier、Container ID、描述檔與 entitlements 是否一致。只要其中一項不匹配,編譯或執行時就可能出現權限問題。
進入 CloudKit Dashboard 後,可以看到 Schema、Public Data、Private Data 與 Admin 等區塊。Schema 用於定義資料結構,Public Data 與 Private Data 則分別存放公開與私有資料。

從開發者後台進入 CloudKit Dashboard

CloudKit Dashboard 首頁
在 Record Types 中,可以新增資料模型。每個模型可加入多個欄位,並指定欄位型別。常見型別包括字串、數字、日期、位置、檔案與物件關聯。

新增 Record Type

設定欄位型別
建立好模型後,即可在 Default Zone 中查看資料。若欄位包含圖片或檔案,通常會使用 CKAsset 型別,並搭配本機檔案 URL 進行處理。

在 Default Zone 中查看資料

使用 Asset 型別儲存圖片
在專案中引入 CloudKit.framework 後,即可透過 CKContainer 與 CKDatabase 操作資料。公開資料庫與私有資料庫的差異在於可見範圍:開發者可查看公開資料,但使用者私有資料僅限本人裝置與帳戶存取。
新增資料時,可建立 CKRecord,並指定 Record Type 與 Record ID。Record ID 類似主鍵,可用於後續查詢、更新與刪除。若需要儲存圖片,可先將圖片寫入本機沙盒,再以檔案 URL 建立 CKAsset。
查詢單筆資料時,可使用 Record ID 直接抓取。查詢多筆資料時,則可建立 CKQuery 並搭配 NSPredicate。更新資料時,通常先抓取既有紀錄,再修改欄位並重新儲存。刪除資料時,則依 Record ID 執行刪除操作。
在實際專案中,建議將 CloudKit 操作封裝成獨立服務層,避免把網路與雲端邏輯散落在 view controller 中。同時也要處理錯誤、網路狀態與帳戶可用性,避免在 iCloud 未啟用時造成功能中斷。
整體而言,CloudKit 適合需要跨裝置同步、公開資料或輕量雲端儲存的 App。透過 Dashboard 建立資料模型,再以程式碼進行 CRUD 操作,可以快速完成雲端功能整合。