建站
咨詢
售后
建站咨詢
新聞中心
簡(jiǎn)介
CloudKit是蘋(píng)果公司推出的基于iCloud的遠(yuǎn)程數(shù)據(jù)存儲(chǔ)服務(wù)。它為存儲(chǔ)和使用用戶的iCloud賬戶的后端存儲(chǔ)服務(wù)共享應(yīng)用數(shù)據(jù)提供了一種低成本的選擇方案。
總體來(lái)看，CloudKit主要提供了兩個(gè)組件：
- 一個(gè)網(wǎng)絡(luò)中心，用于管理記錄類(lèi)型和任何公共數(shù)據(jù)。
- 一組API，用于在iCloud和設(shè)備之間傳輸數(shù)據(jù)。
CloudKitr的安全性是很高的。用戶的私有數(shù)據(jù)受到完全保護(hù)，因?yàn)殚_(kāi)發(fā)人員只能訪問(wèn)他們自己的私人數(shù)據(jù)庫(kù)而不能查看任何其他用戶的私人數(shù)據(jù)。
對(duì)于只運(yùn)行于iOS平臺(tái)的使用大量數(shù)據(jù)但不需要服務(wù)器端大量邏輯的應(yīng)用程序來(lái)說(shuō)，CloudKit是一個(gè)不錯(cuò)的選擇。此外，CloudKit也可用于網(wǎng)絡(luò)和服務(wù)器應(yīng)用程序。
在這個(gè)CloudKit教程中，您將獲得使用CloudKit的切身體驗(yàn)，即你需要?jiǎng)?chuàng)建一個(gè)名為BabiFüd的餐廳評(píng)級(jí)應(yīng)用程序。
為何選擇CloudKit？
你可能想知道，為什么要選擇基于核心數(shù)據(jù)（Core Data）基礎(chǔ)之上的CloudKit，而不是其他BaaS（后端即服務(wù)）產(chǎn)品，甚至是基于你自己的服務(wù)器？
原因有三：簡(jiǎn)單性，高信譽(yù)度和低成本。
簡(jiǎn)單性
不像其他的后端解決方案，CloudKit僅需要很少的設(shè)置。你不必選擇、配置或安裝服務(wù)器。此外，安全性和伸縮性也都由蘋(píng)果公司來(lái)處理。
只需在蘋(píng)果官方網(wǎng)站注冊(cè)成為iOS開(kāi)發(fā)者項(xiàng)目成員，您就擁有了使用CloudKit的資格。你不必注冊(cè)額外的服務(wù)或創(chuàng)建新帳戶。當(dāng)您在自己的應(yīng)用程序中啟用CloudKit支持時(shí)，所有必要的服務(wù)器設(shè)置都將魔術(shù)般自動(dòng)發(fā)生。
你不需要下載額外的庫(kù)并對(duì)它們進(jìn)行配置。CloudKit就像任何其他iOS框架一樣導(dǎo)入。CloudKit框架本身通過(guò)提供一些針對(duì)常見(jiàn)操作的便利的API實(shí)現(xiàn)了一定程度的簡(jiǎn)單性。
這也方便了用戶使用。由于在設(shè)備設(shè)置（甚至是設(shè)置結(jié)束進(jìn)入應(yīng)用程序時(shí)）時(shí)CloudKit使用的是輸入的iCloud憑據(jù)，所以沒(méi)有必要建立復(fù)雜的登錄屏幕。只要用戶登錄，他們就可以無(wú)縫地開(kāi)始使用你的應(yīng)用程序。
高信譽(yù)度
CloudKit的另一個(gè)好處是，通過(guò)依靠蘋(píng)果公司而不是應(yīng)用程序開(kāi)發(fā)人員，用戶可以相信他們的數(shù)據(jù)的隱私性和安全性。CloudKit能夠把您（開(kāi)發(fā)人員）與用戶數(shù)據(jù)隔離開(kāi)來(lái)。
雖然在調(diào)試程序時(shí)無(wú)法訪問(wèn)可能令人沮喪，但另一個(gè)方面這也帶來(lái)一定好處，因?yàn)槟悴槐負(fù)?dān)心安全或說(shuō)服用戶其數(shù)據(jù)的安全性。如果一個(gè)應(yīng)用程序用戶信任iCloud，那么他們也可以信任作為開(kāi)發(fā)人員的你。
低成本
***，對(duì)于任何開(kāi)發(fā)者來(lái)說(shuō)，運(yùn)行服務(wù)的成本也是一個(gè)巨大的投資。即使是***的服務(wù)器主機(jī)也不能為小型、免費(fèi)或廉價(jià)的應(yīng)用程序提供低成本的解決方案。所以總是會(huì)有與運(yùn)行應(yīng)用程序相關(guān)的成本問(wèn)題。
借助于CloudKit，你可以實(shí)現(xiàn)針對(duì)免費(fèi)的公共數(shù)據(jù)的適量的存儲(chǔ)和數(shù)據(jù)傳輸。在WWDC 2015視頻的CloudKit新增功能（https://developer.apple.com/videos/play/wwdc2015/704/）中提供了非常詳盡的收費(fèi)解釋。
上述所有這些優(yōu)勢(shì)，使得CloudKit服務(wù)成為Mac和iOS應(yīng)用程序開(kāi)發(fā)中更值得選擇的解決方案。
BabiFüd項(xiàng)目功能介紹
本教程中提供的BabiFüd示例應(yīng)用程序使用時(shí)下最標(biāo)準(zhǔn)的“速度餐廳”型應(yīng)用程序風(fēng)格。不是沿用傳統(tǒng)式的基于食品質(zhì)量、服務(wù)速度以及價(jià)格等評(píng)價(jià)標(biāo)準(zhǔn)，而是使用新型的兒童友好性進(jìn)行評(píng)價(jià)。這包括設(shè)施更換、加高座椅和健康性食品選擇等可用性標(biāo)準(zhǔn)。
應(yīng)用程序包含四個(gè)選項(xiàng)卡：一個(gè)附近的餐館列表；一個(gè)附近餐館地圖展示；用戶生成注釋和功能設(shè)置。附近的餐館列表選項(xiàng)卡是您將在本教程中使用的唯一部分。當(dāng)然，你現(xiàn)在就可以一瞥運(yùn)行中的這個(gè)示例應(yīng)用程序。
開(kāi)發(fā)過(guò)程中，我使用了一個(gè)模型類(lèi)來(lái)支持這些視圖，并封裝對(duì)CloudKit的調(diào)用。其中，CloudKit對(duì)象稱為記錄（Record）。模型中主要的記錄類(lèi)型是一個(gè)Establishment，它代表了你的應(yīng)用程序中不同的餐館。
開(kāi)始
首先，請(qǐng)下載本教程中的啟動(dòng)項(xiàng)目，地址是https://cdn2.raywenderlich.com/wp-content/uploads/2016/06/BabiFud-Cloudkit-Starter.zip。
你必須改變你的應(yīng)用程序的資源標(biāo)識(shí)符和團(tuán)隊(duì)類(lèi)型，然后才能開(kāi)始編碼。為了從蘋(píng)果公司獲得必要的授權(quán)，您需要設(shè)置團(tuán)隊(duì)。擁有一個(gè)獨(dú)特的資源標(biāo)識(shí)符可以使得很多的事更容易操作。
現(xiàn)在，請(qǐng)使用Xcode打開(kāi)工程BabiFud.xcodeproj。然后，從「Project Navigator」下選擇BabiFud項(xiàng)目，然后選擇「BabiFud target」。接下來(lái)，選擇「General」選項(xiàng)卡，使用一些獨(dú)特的字符串內(nèi)容更換資源標(biāo)識(shí)符（Bundle Identifier）。標(biāo)準(zhǔn)的做法是，使用反向域名符號(hào)并包括項(xiàng)目名稱。然后，選擇合適的團(tuán)隊(duì)（Team）：
現(xiàn)在，你需要在你的應(yīng)用程序中設(shè)置CloudKit支持，并創(chuàng)建一些容器來(lái)保存數(shù)據(jù)。
權(quán)限和容器
在向應(yīng)用程序中添加任何數(shù)據(jù)之前，你需要一個(gè)容器來(lái)保存應(yīng)用程序的記錄。容器，其實(shí)僅是一個(gè)概念上的位置術(shù)語(yǔ)，對(duì)應(yīng)于所有應(yīng)用程序在服務(wù)器上的數(shù)據(jù)。它分為公共和私有數(shù)據(jù)庫(kù)兩個(gè)組。
要?jiǎng)?chuàng)建一個(gè)容器，你首先需要擁有啟用您的應(yīng)用程序的iCloud權(quán)限?，F(xiàn)在，請(qǐng)從目標(biāo)編輯器選擇【Capabilities】選項(xiàng)卡。然后，把iCloud部分中的開(kāi)關(guān)切換為ON。
現(xiàn)在，Xcode可能會(huì)提示您輸入與您的iOS開(kāi)發(fā)者帳戶相關(guān)聯(lián)的蘋(píng)果ID。如果是這樣，那么根據(jù)要求輸入即可。***，通過(guò)勾選【Services】組中的CloudKit復(fù)選框來(lái)啟用CloudKit。
這將創(chuàng)建一個(gè)名為iCloud.
克服Xcode中iCloud安裝錯(cuò)誤
如果你在創(chuàng)建權(quán)限、構(gòu)建項(xiàng)目或運(yùn)行應(yīng)用程序時(shí)看到任何警告或錯(cuò)誤，并注意到Xcode抱怨容器ID；那么，下面提供一些故障排除提示，供您參考：
- 如果有任何的警告或錯(cuò)誤顯示在【iCloud】部分中的【Steps】組中；那么，你可以嘗試按下「Fix Issue」按鈕。這可能需要反復(fù)操作好幾次。
- 應(yīng)用程序的包ID和iCloud的容器要相匹配并存在于開(kāi)發(fā)人員帳戶中，這一點(diǎn)是很重要的。例如，如果包標(biāo)識(shí)為“com.
.BabiFud”，那么，iCloud的容器名稱應(yīng)是“iCloud.”，再加上資源包ID“iCloud.com. .BabiFud”。 - iCloud的容器名稱必須是唯一的，因?yàn)檫@是使用CloudKit訪問(wèn)數(shù)據(jù)的全球標(biāo)識(shí)符。由于iCloud的容器名稱包含了資源ID，所以該資源ID也必須是唯一的（這就是為什么它必須由com.raywendrelich.BabiFud進(jìn)行修改的原因）。
- 為了過(guò)權(quán)限這一關(guān)，應(yīng)用程序/包ID顯示于【Certificates】，【Identifiers】和【Profiles】的App ID部分。這意味著，用于簽名應(yīng)用程序的證書(shū)必須來(lái)自于設(shè)置的團(tuán)隊(duì)ID并且必須列出應(yīng)用程序ID；這也就是iCloud的容器id。通常情況下，如果你登錄了一個(gè)有效的開(kāi)發(fā)帳戶，Xcode能夠自動(dòng)地完成這一切。不幸的是，這有時(shí)會(huì)導(dǎo)致不同步情況。你可以通過(guò)一個(gè)新的ID刷新來(lái)重新開(kāi)始，并使用iCloud的功能窗格更改CloudKit容器ID以便進(jìn)行匹配。否則，要解決這個(gè)問(wèn)題，你可能要編輯info.plist文件或BabiFud.entitlements文件，以確保ID值反映你為應(yīng)用程序設(shè)置的包ID。
CloudKit控制面板簡(jiǎn)介
在創(chuàng)建完工程所必需的餐館數(shù)據(jù)之后，下一步就是創(chuàng)建一些記錄類(lèi)型來(lái)定義您的應(yīng)用程序所使用的數(shù)據(jù)。您可以使用CloudKit控制面板來(lái)實(shí)現(xiàn)這一點(diǎn)。從工程的【Capabilities】窗格中點(diǎn)擊【CloudKit Dashboard】，如圖所示。
【注意】你還可以通過(guò)在瀏覽器中打開(kāi)網(wǎng)址https://icloud.developer.apple.com/dashboard/ 來(lái)啟動(dòng)CloudKit控制面板。
這個(gè)控制面板是什么樣子呢？請(qǐng)觀察一下這個(gè)圖形：
注意到，該控制面板由四部分組成：架構(gòu)（Schema），公共數(shù)據(jù)（Public Data），私有數(shù)據(jù)（Private Data）和管理員（Admin）。
其中，Schema部分代表CloudKit容器中的***層次對(duì)象：記錄類(lèi)型（Record Types），安全角色（Security Roles）及訂閱類(lèi)型（Subscription Types）。在本教程中，你只要關(guān)心記錄類(lèi)型即可。
記錄類(lèi)型（Record Types），是一組定義了單個(gè)記錄的字段。對(duì)于面向?qū)ο缶幊潭?，一個(gè)記錄類(lèi)型就像一個(gè)類(lèi)。一個(gè)記錄可以被認(rèn)為是一個(gè)特殊的記錄類(lèi)型的實(shí)例。它代表了容器中的結(jié)構(gòu)化數(shù)據(jù)，就像數(shù)據(jù)庫(kù)中的一個(gè)典型的行，它封裝了一系列鍵/值對(duì)。
公共數(shù)據(jù)（PUBLIC DATA）和私有數(shù)據(jù)（PRIVATE DATA）部分，可以讓您在您能夠訪問(wèn)的數(shù)據(jù)庫(kù)中添加數(shù)據(jù)或搜索數(shù)據(jù)。請(qǐng)記住，作為一名開(kāi)發(fā)人員你可以訪問(wèn)所有的公共數(shù)據(jù)，但只能訪問(wèn)你自己的私有數(shù)據(jù)。其中，「User Records」存儲(chǔ)關(guān)于當(dāng)前iCloud用戶的數(shù)據(jù)，如姓名和電子郵件等?！赣涗泤^(qū)域」（Record Zone）（這里使用的是默認(rèn)的區(qū)域），用于提供一個(gè)邏輯組織到一個(gè)私有數(shù)據(jù)庫(kù)；實(shí)現(xiàn)方法是對(duì)記錄進(jìn)行分組。注意，自定義區(qū)域支持原子事務(wù)，即允許在處理其它操作之前把多個(gè)記錄同時(shí)保存。不過(guò)，有關(guān)自定義區(qū)域的探討已經(jīng)超出本教程的范圍。
管理員（ADMIN）部分，能夠針對(duì)您的團(tuán)隊(duì)成員提供不同的權(quán)限配置控制。如果你有多個(gè)開(kāi)發(fā)團(tuán)隊(duì)成員，你可以在這里限制他們編輯數(shù)據(jù)的能力。當(dāng)然，這也超出本教程范圍。
添加餐館記錄類(lèi)型
現(xiàn)在，請(qǐng)略微想一想你的應(yīng)用程序的設(shè)計(jì)吧。你要跟蹤的每一家餐館都對(duì)應(yīng)大量的數(shù)據(jù)：名稱、位置以及各種兒童友好的設(shè)施的可用性，等等。記錄類(lèi)型使用字段來(lái)定義每個(gè)記錄包含的各個(gè)部分中的數(shù)據(jù)。
選擇記錄類(lèi)型（Record Types）后，單擊詳細(xì)信息窗格左上方的+圖標(biāo)添加一個(gè)新的記錄類(lèi)型，如圖所示。
命名你剛剛創(chuàng)建的新記錄類(lèi)型為「Establishment」。
你會(huì)看到出現(xiàn)一行字段，其中定義了字段名、字段類(lèi)型和索引等，如下圖所示。注意，有一個(gè)字段使用了默認(rèn)名稱「StringField」，這是系統(tǒng)自動(dòng)為您創(chuàng)建的。
接下來(lái)，你要使用新名字「Name」替換「StringField」。字段類(lèi)型和索引默認(rèn)已匹配您所需要的***個(gè)字段的定義，但接下來(lái)，你需要對(duì)于其他一些字段改變字段類(lèi)型和索引。單擊【Add Field…】并根據(jù)需要增加新的字段即可。***，你需要添加以下字段：
當(dāng)你添加完所有字段后，你的字段列表應(yīng)該是這樣的：
點(diǎn)擊頁(yè)面底部【Save】按鈕保存您的新的記錄類(lèi)型。
現(xiàn)在，您已經(jīng)準(zhǔn)備好向您的數(shù)據(jù)庫(kù)中添加一些示例記錄了。
選擇左側(cè)導(dǎo)航窗格中【PUBLIC DATA】下部的【Default Zone】。該區(qū)域?qū)膽?yīng)用程序的所有公共記錄。如果還沒(méi)有選定，那么請(qǐng)從中心窗格的下拉列表中選擇「Establishment」記錄類(lèi)型。然后單擊右側(cè)詳細(xì)信息窗格中的+圖標(biāo)或【New Record】按鈕，如下圖所示：
這將創(chuàng)建一個(gè)新的空的Establishment記錄。
此時(shí)，您已經(jīng)準(zhǔn)備好為您的應(yīng)用程序輸入一些測(cè)試數(shù)據(jù)了。
需要說(shuō)明的是，下面的示例數(shù)據(jù)都是虛構(gòu)的。這些餐館數(shù)據(jù)都位于蘋(píng)果總部附近，這樣它們可以很容易地出現(xiàn)在模擬器上。
現(xiàn)在，請(qǐng)輸入如下表所述的每個(gè)記錄：
【注意】每個(gè)CoverPhoto元素對(duì)應(yīng)的圖像文件都包含在Xcode項(xiàng)目的「Supporting Files\Sample Images」文件夾中。要將圖像添加到Establishment記錄中，只需將其拖動(dòng)到CoverPhoto字段中即可。
一旦保存完所有三個(gè)記錄，控制面板應(yīng)該是這樣的：
對(duì)于每個(gè)記錄，輸入的值都代表了數(shù)據(jù)的數(shù)據(jù)庫(kù)描述部分。在應(yīng)用程序中，數(shù)據(jù)類(lèi)型是不同的。例如，SeatingType和ChangingTable都是結(jié)構(gòu)類(lèi)型的。所以，對(duì)于SeatingType字段指定的int值可能對(duì)應(yīng)于“high chair”或“booster”這樣的座位。對(duì)于HealthyOption和KidsMenu這兩個(gè)字段指定的int值表示布爾類(lèi)型：其中，0是指沒(méi)有這一項(xiàng)，1則指有這一項(xiàng)。
***，運(yùn)行應(yīng)用程序需要你有一個(gè)可以用于開(kāi)發(fā)的iCloud帳戶。請(qǐng)參考蘋(píng)果官方文檔https://developer.apple.com/library/tvos/documentation/DataManagement/Conceptual/CloudKitQuickStart/EnablingiCloudandConfiguringCloudKit/EnablingiCloudandConfiguringCloudKit.html#//apple_ref/doc/uid/TP40014987-CH2-SW7。
另外，您還需要在iPhone模擬器中輸入與此帳戶相關(guān)聯(lián)的icloud憑據(jù)。請(qǐng)參考蘋(píng)果官方文檔https://developer.apple.com/library/tvos/documentation/DataManagement/Conceptual/CloudKitQuickStart/CreatingaSchemabySavingRecords/CreatingaSchemabySavingRecords.html#//apple_ref/doc/uid/TP40014987-CH3-SW12。
現(xiàn)在，切換回Xcode中。從下一節(jié)開(kāi)始，你要把上面創(chuàng)建的數(shù)據(jù)集成到您的應(yīng)用程序中！
查詢餐館記錄
CKQuery對(duì)象用于從數(shù)據(jù)庫(kù)中選擇記錄。CKQuery描述了如何找到符合特定條件的特定類(lèi)型的所有記錄。這些條件可以是這樣的：所有記錄都有一個(gè)以N開(kāi)頭的Name字段；所有記錄都帶有兒童增高座椅；所有記錄都要滿足在3公里以內(nèi)。這些類(lèi)型的表達(dá)式都通過(guò)NSPredicate對(duì)象編碼于Cocoa庫(kù)中。NSPredicate能夠評(píng)估對(duì)象，看它們是否符合指定條件。NSPredicate也用在核心數(shù)據(jù)（Core Data）中，并且自然地融入CloudKit中，因?yàn)橹^詞通常被定義用于針對(duì)某個(gè)字段的比較方面。
事實(shí)上，CloudKit僅支持NSPredicate功能的一個(gè)子集。這些功能包括：數(shù)學(xué)比較，字符串和集合操作（例如“字段匹配列表中的項(xiàng)目之一”），還提供了一個(gè)特殊的距離函數(shù)。函數(shù)distanceToLocation:fromLocation:被專(zhuān)門(mén)添加到NSPredicate對(duì)象定義中，特別支持CloudKit以匹配帶有位置字段的記錄——此已知位置位于指定半徑的范圍內(nèi)。接下來(lái)的內(nèi)容中將詳細(xì)介紹這種類(lèi)型謂詞的用法。對(duì)于其他類(lèi)型的查詢中，CKQuery類(lèi)參考文檔（https://developer.apple.com/library/ios/documentation/CloudKit/Reference/CKQuery_class/）中包含了有關(guān)其支持的功能及如何使用的詳細(xì)描述。
【注意】CloudKit包括了對(duì)CLLocation對(duì)象的支持。有一些核心定位框架對(duì)象（Core Location Framework）包含了有關(guān)地理坐標(biāo)的信息。這使得開(kāi)發(fā)人員可以很容易創(chuàng)建一個(gè)查詢來(lái)尋找指定地理區(qū)域內(nèi)的餐館——而不需要我們自己進(jìn)行所有繁瑣的坐標(biāo)運(yùn)算。
接下來(lái)，在Xcode中打開(kāi)文件Model/ Model.swift。該文件中包含了所有您的應(yīng)用程序進(jìn)行服務(wù)器調(diào)用的存根。
現(xiàn)在，請(qǐng)使用下面的內(nèi)容來(lái)更換fetchEstablishments(_:radiusInMeters:)方法：
- func fetchEstablishments(location:CLLocation, radiusInMeters:CLLocationDistance) {
- // 1
- let radiusInKilometers = radiusInMeters / 1000.0
- // 2
- let locationPredicate = NSPredicate(format: "distanceToLocation:fromLocation:(%K,%@) < %f", "Location", location, radiusInKilometers)
- // 3
- let query = CKQuery(recordType: EstablishmentType, predicate: locationPredicate)
- // 4
- publicDB.performQuery(query, inZoneWithID: nil) { [unowned self] results, error in
- if let errorerror = error {
- dispatch_async(dispatch_get_main_queue()) {
- self.delegate?.errorUpdating(error)
- print("Cloud Query Error - Fetch Establishments: \(error)")
- }
- return
- }
- self.items.removeAll(keepCapacity: true)
- results?.forEach({ (record: CKRecord) in
- self.items.append(Establishment(record: record,
- database: self.publicDB))
- })
- dispatch_async(dispatch_get_main_queue()) {
- self.delegate?.modelUpdated()
- }
- }
- }
現(xiàn)在，我們按編號(hào)來(lái)分析一下上面代碼的功能：
1. CloudKit在其距離謂詞中利用公里為計(jì)算單位。這一行簡(jiǎn)單地把radiusInMeters轉(zhuǎn)換為公里。
2. 根據(jù)從當(dāng)前位置到他們的位置的距離謂詞對(duì)餐館進(jìn)行篩選。這個(gè)語(yǔ)句使用從用戶的當(dāng)前位置到指定距離內(nèi)的位置值來(lái)查找所有餐館。
3. 使用謂詞和記錄類(lèi)型創(chuàng)建CKQuery對(duì)象。執(zhí)行查詢時(shí)兩者都將被使用。
4. ***，方法performQuery（_：inZoneWithID：completionHandler :）負(fù)責(zé)發(fā)送查詢到iCloud中，并等待任何匹配的結(jié)果。通過(guò)傳遞nil作為inZoneWithID參數(shù)值，可以針對(duì)你所在的默認(rèn)區(qū)域進(jìn)行查詢；也就是說(shuō)，針對(duì)你的公共數(shù)據(jù)庫(kù)。如果你既想從公共數(shù)據(jù)庫(kù)也想從私有數(shù)據(jù)庫(kù)中檢索記錄，那么，你必須使用一個(gè)單獨(dú)的調(diào)用來(lái)查詢每個(gè)數(shù)據(jù)庫(kù)。
你可能想知道：CKDatabase的實(shí)例publicDB從何而來(lái)？讓我們來(lái)看看文件Model.swift的頂部的代碼吧。
- let container: CKContainer
- let publicDB: CKDatabase
- let privateDB: CKDatabase
- init() {
- // 1
- container = CKContainer.defaultContainer()
- // 2
- publicDB = container.publicCloudDatabase
- // 3
- privateDB = container.privateCloudDatabase
- }
在這里，您定義了您的數(shù)據(jù)庫(kù)：
1. 默認(rèn)容器是指您在iCloud的功能窗格中指定的那個(gè)。
2. 公共數(shù)據(jù)庫(kù)是指在你的應(yīng)用程序的所有用戶中共享的那個(gè)。
3. 私有數(shù)據(jù)庫(kù)只包含屬于當(dāng)前登錄的用戶（在本實(shí)例中即指你）的數(shù)據(jù)。
總之，此代碼將從公共數(shù)據(jù)庫(kù)中檢索一些地方餐館，但為了在任何應(yīng)用程序中看到相應(yīng)的數(shù)據(jù)，必須把它關(guān)聯(lián)到一個(gè)視圖控制器。
創(chuàng)建需求回調(diào)函數(shù)
你可以借助熟悉的委托模式來(lái)管理通知的問(wèn)題。下面這個(gè)協(xié)議位于Model.swift文件的頂部；當(dāng)然，你需要在你的視圖控制器中實(shí)現(xiàn)這個(gè)協(xié)議：
- protocol ModelDelegate {
- func errorUpdating(error: NSError)
- func modelUpdated()
- }
- 現(xiàn)在，打開(kāi)文件MasterViewController.swift，并用以下內(nèi)容替換modelUpdated()方法原有內(nèi)容：
- func modelUpdated() {
- refreshControl?.endRefreshing()
- tableView.reloadData()
- }
當(dāng)新數(shù)據(jù)可用時(shí)此方法會(huì)被調(diào)用。在方法tableView(_:cellForRowAtIndexPath:)中實(shí)現(xiàn)了所有關(guān)于表格視圖單元格與CloudKit對(duì)象綁定的代碼。您可以自行分析學(xué)習(xí)，恕在此不再贅述。
接下來(lái)，在文件MasterViewController.swift中，請(qǐng)使用如下內(nèi)容更換errorUpdating(_ :)方法：
- func errorUpdating(error: NSError) {
- let alertController = UIAlertController(title: nil,
- message: error.localizedDescription,
- preferredStyle: .Alert)
- alertController.addAction(UIAlertAction(title: "Dismiss",
- style: .Default,
- handler: nil))
- presentViewController(alertController, animated: true, completion: nil)
- }
當(dāng)查詢產(chǎn)生錯(cuò)誤時(shí)調(diào)用此方法?？赡苡捎诰W(wǎng)絡(luò)條件較差或特定CloudKit問(wèn)題（如丟失或不正確的用戶憑據(jù)或沒(méi)有記錄從查詢返回等）發(fā)生錯(cuò)誤。
當(dāng)處理任何一種遠(yuǎn)程服務(wù)器連接時(shí)，良好的錯(cuò)誤處理是必不可少的?，F(xiàn)在，這段代碼只顯示給用戶返回的錯(cuò)誤信息。
但是，目前程序中存在的非常普遍的問(wèn)題是：一個(gè)是用戶不能登錄到iCloud；另一個(gè)是程序還不具有支持用戶自動(dòng)登錄icloud的功能。建議您自己修改一下errorUpdating(_:)方法使之至少能夠處理這些情況。提示：目前這兩類(lèi)錯(cuò)誤都返回1（CKErrorCode）。
現(xiàn)在，請(qǐng)構(gòu)建和運(yùn)行示例項(xiàng)目。目前，你應(yīng)該看到一個(gè)幾近完整的餐館單位名單列表了。
查詢排錯(cuò)
如果你正在使用iOS模擬器但卻發(fā)現(xiàn)列表控件中沒(méi)有填充任何內(nèi)容，那么，你務(wù)必確保從Xcode的菜單項(xiàng)【Debug\Simulate Location\San Francisco, CA, USA】下設(shè)置了正確的位置。如果您需要在Xcode中改變這一位置，那么你可以從應(yīng)用程序的下拉列表中選擇其他位置，從而實(shí)現(xiàn)強(qiáng)制刷新而不是被動(dòng)地等待位置觸發(fā)。
如果您使用的是iPhone或iPad且啟用了定位服務(wù)而列表仍未填充，那么說(shuō)明餐館沒(méi)有足夠接近你當(dāng)前的位置。此時(shí)，你有兩個(gè)選擇：改變樣本數(shù)據(jù)的坐標(biāo)以便更接近您的當(dāng)前位置；或者使用模擬器來(lái)運(yùn)行應(yīng)用程序。還有第三個(gè)選擇，但不是非常實(shí)用，即你不得不前往庫(kù)比提諾（Cupertino）并進(jìn)入蘋(píng)果公司地區(qū)進(jìn)行試驗(yàn)。
如果數(shù)據(jù)未顯示正確——或者根本不顯示，那么，請(qǐng)使用CloudKit控制面板檢查樣本數(shù)據(jù)。確保所有的記錄都存在，而且你已經(jīng)將它們添加到默認(rèn)區(qū)域，而且它們的值都是正確的。如果您需要重新輸入數(shù)據(jù)，那么你可以通過(guò)單擊回收站圖標(biāo)刪除記錄（參考下圖）。
調(diào)試CloudKit錯(cuò)誤有時(shí)可能非常棘手。在撰寫(xiě)本文時(shí)，CloudKit錯(cuò)誤消息中并不包含大量信息。要確定錯(cuò)誤的原因，您需要查看與你的特定數(shù)據(jù)庫(kù)操作相關(guān)連的錯(cuò)誤代碼。使用數(shù)字錯(cuò)誤代碼，查找相匹配的CKErrorCode枚舉值進(jìn)行分析。在文檔中的名稱和說(shuō)明將幫助你縮小問(wèn)題原因的分析范圍。
【注意】對(duì)于可通過(guò)CloudKit返回的錯(cuò)誤代碼列表，請(qǐng)參閱CloudKit框架常量參考（https://developer.apple.com/library/ios/documentation/CloudKit/Reference/CloudKit_constants/#//apple_ref/c/tdef/CKErrorCode）。
下面是一些常見(jiàn)的錯(cuò)誤枚舉和相關(guān)說(shuō)明：
- BadContainer——指定的容器是未知的或未經(jīng)授權(quán)的。
- NotAuthenticated——當(dāng)前用戶沒(méi)有通過(guò)驗(yàn)證，也沒(méi)有用戶記錄可用。如果用戶未登錄到iCloud時(shí)可能出現(xiàn)這種情況。
- UnknownItem——指定的記錄不存在。
當(dāng)你得到餐館的名單列表時(shí)，你可能已經(jīng)注意到了，你可以看到服務(wù)餐館名稱及其提供的服務(wù)。但沒(méi)有顯示圖像！是云端那邊出問(wèn)題了嗎？
當(dāng)您檢索服務(wù)餐館記錄時(shí)，將自動(dòng)檢索對(duì)應(yīng)的圖像。但是，您仍然需要執(zhí)行必要的步驟來(lái)將圖像加載到你的應(yīng)用程序中。這需要借助于云端方法了！
使用二進(jìn)制資源
對(duì)于二進(jìn)制形式的資源數(shù)據(jù)，如圖像，都有相關(guān)聯(lián)的記錄。在本文實(shí)例中，你的應(yīng)用程序的資源數(shù)據(jù)都會(huì)顯示于MasterViewController表視圖的餐館照片中。
在本節(jié)中，您需要添加邏輯來(lái)加載當(dāng)檢索餐館記錄時(shí)已下載的資源。
為此，打開(kāi)文件Model/Establishment.swift，并用下面的代碼更換loadCoverPhoto（_ :)方法：
- func loadCoverPhoto(completion:(photo: UIImage!) -> ()) {
- // 1
- dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND, 0)) {
- var image: UIImage!
- // 4
- defer {
- completion(photo: image)
- }
- // 2
- guard let asset = self.record["CoverPhoto"] as? CKAsset,
- path = asset.fileURL.path,
- imageData = NSData(contentsOfFile: path) else {
- return
- }
- // 3
- image = UIImage(data: imageData)
- }
- }
此方法從asset有關(guān)屬性中加載相關(guān)圖片：
1. 雖然你下載了資源，但同時(shí)您還檢索了記錄的其余部分?jǐn)?shù)據(jù)，因此，你需要使用異步方式加載圖像。如你所見(jiàn)，我們把有關(guān)代碼全部封裝在dispatch_async代碼塊內(nèi)。
2. 資源存儲(chǔ)在CKRecord中，作為CKAsset的實(shí)例，所以需要相應(yīng)地轉(zhuǎn)換一下。接下來(lái)，從資源提供的本地文件URL中加載圖像數(shù)據(jù)。
3. 使用圖像數(shù)據(jù)來(lái)創(chuàng)建UIImage的一個(gè)實(shí)例。
4. 執(zhí)行與檢索的圖像相關(guān)的completion回調(diào)函數(shù)。請(qǐng)注意，不管執(zhí)行哪一個(gè)return語(yǔ)句，延遲（defer）塊都被執(zhí)行。例如，如果沒(méi)有圖像資源，那么，在返回時(shí)永遠(yuǎn)不會(huì)設(shè)置image變量的值，當(dāng)然也就不顯示餐廳對(duì)應(yīng)的圖像。
現(xiàn)在，請(qǐng)構(gòu)建和運(yùn)行示例項(xiàng)目。你會(huì)注意到，由于上面的云端操作，現(xiàn)在餐館的圖像顯示出來(lái)了！
目前，在CloudKit資源中還存在兩個(gè)不足：
- 資源只能在CloudKit中作為記錄屬性存在，你不能把它們單獨(dú)存儲(chǔ)。刪除記錄也會(huì)刪除所有相關(guān)資源。
- 因?yàn)橘Y源與記錄數(shù)據(jù)的其余部分在同一時(shí)間下載，所以，獲取資源會(huì)產(chǎn)生一定的負(fù)面性能影響。如果您的應(yīng)用程序使用了大量的資源，那么，你應(yīng)該專(zhuān)門(mén)存儲(chǔ)一下?lián)碛匈Y源的不同類(lèi)型記錄的引用。
總結(jié)
到現(xiàn)在為止，你應(yīng)該已經(jīng)看到了我們的最終項(xiàng)目中所提供的功能。目前，該應(yīng)用程序已經(jīng)可以下載餐館記錄，并把它們的詳細(xì)資料和照片加載到程序的表視圖中。
實(shí)際上，您還可以從以下幾個(gè)方面進(jìn)一步增強(qiáng)本文中的示例應(yīng)用：
允許用戶添加自己的照片、筆記、評(píng)論和投訴。這將有助于他們避免再次遭遇不愉快的經(jīng)歷。
允許用戶使用地圖創(chuàng)建一個(gè)新的餐館記錄。你可以把這樣的功能添加到Model類(lèi)中，用于把相應(yīng)記錄保存到公共或私有數(shù)據(jù)庫(kù)中。
添加過(guò)濾和搜索支持。工程提供的Model類(lèi)中已經(jīng)構(gòu)建了一個(gè)帶有一個(gè)距離謂詞的CKQuery，可以把它修改為一個(gè)更復(fù)雜的謂詞。當(dāng)然，CloudKit也是支持基于字符串字段的文本搜索的。
提高應(yīng)用程序的性能和數(shù)據(jù)加載體驗(yàn)。你會(huì)注意到，本教程中在一切準(zhǔn)備就緒時(shí)使用了一些工具方法來(lái)調(diào)用所需的完成處理器函數(shù)。另外，CKDatabase的實(shí)例也提供了基于NSOperation的方法來(lái)更好地控制API執(zhí)行方式。
為程序提供緩存和同步支持；這樣當(dāng)應(yīng)用程序連接到網(wǎng)絡(luò)時(shí)，它能夠保持線下響應(yīng)并保持內(nèi)容***。
使用蘋(píng)果公司推出的有著強(qiáng)大后端API支持的CloudKit，相信你能夠把你的應(yīng)用程序提升到一個(gè)更高的水平！
本文名稱：Swift+CloudKit開(kāi)發(fā)入門(mén)篇
文章路徑：http://m.fisionsoft.com.cn/article/cosgidj.html
