iCloud文檔儲存編程相對索引值資料存放區而言比較複雜,涉及到自訂文檔類、獲得iCloud文檔目錄、尋找Ubiquity容器中的文檔、儲存文檔和解決文檔衝突等內容。
執行個體:iCloud文檔儲存編程設計
執行個體介紹一下iCloud文檔儲存編程過程,畫面中有一個文字框和一個按鈕控制項,在裝置1輸入內容,點擊“儲存資料”按鈕,將資料儲存iCloud伺服器。右圖是裝置2畫面,過幾秒鐘後裝置2上會讀取iCloud伺服器端資料,並顯示在文字框中。
配置Xcode工程
編寫iCloud文檔儲存編應用程式也需要在Xcode工程中進行一些配置,選擇TAGETS→MyNotes→Summary→Entitlements
在圖中Ubiquity Contrainers添加com.51work6.MyNotes,這是Ubiquity容器標識,可以有多個Ubiquity容器標識,這個容器標識代表著不同的目錄。com.51work6.MyNotes代表目錄如下所示:
/var/mobile/Library/Mobile Documents/98Z3R5XU29~com~51work6~MyNotes/
其中的98Z3R5XU29是在iOS開發人員配置門戶網站建立App ID時候產生的,它被稱為Team ID。
如果應用中沒有使用iCloud索引值資料存放區key-Value Store可以不用配置。
自訂文檔類
我 們需要自己封裝一個文檔類,它繼承抽象類別UIDocument,而UIDocument實現NSFilePresenter協議。實現 NSFilePresenter協議的類,它所代表的檔案和目錄可以被查看和編輯,這些NSFilePresenter實作類別與檔案協調者類 NSFileCoordinator結合使用,可以協調管理檔案或目錄。
這個類我們命名為MyCloudDocument, MyCloudDocument的代碼如下:
#import <UIKit/UIKit.h> @interface MyCloudDocument : UIDocument ①@property (strong, nonatomic) NSString *contents;@end #import ”MyCloudDocument.h”@implementation MyCloudDocument //載入資料- (BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError **)outError ②{if ([contents length] > 0){self.contents = [[NSString alloc] initWithData:contents encoding:NSUTF8StringEncoding]; ③}return YES;}//儲存資料- (id)contentsForType:(NSString *)typeName error:(NSError **)outError ④{return [self.contents dataUsingEncoding:NSUTF8StringEncoding]; ⑤}@end
獲得iCloud文檔目錄
iCloud文檔目錄是指在Ubiquity容器下的Document目錄,因此獲得了Ubiquity容器的根目錄,就可以獲得的iCloud文檔目錄了。
ViewController.m中的 ubiquitousDocumentsURL方法可以iCloud文檔目錄:
//請求本地Ubiquity容器,從容器中獲得Document目錄URL- (NSURL *)ubiquitousDocumentsURL {NSFileManager* fileManager = [NSFileManager defaultManager]; ①NSURL* containerURL = [fileManagerURLForUbiquityContainerIdentifier:@"98Z3R5XU29.com.51work6.MyNotes"]; ②containerURL = [containerURL URLByAppendingPathComponent:@"Documents"]; ③return containerURL;}
尋找Ubiquity容器中的文檔
獲得iCloud文檔目錄後,我們需要找到容器中的檔案。查詢容器中的檔案需要註冊兩個廣播通知:
NSMetadataQueryDidFinishGatheringNotification 查詢結束髮出通知;
NSMetadataQueryDidUpdateNotification 查詢結束,進入開始更新階段發出的通知;
ViewController.m中註冊和解除通知代碼如下:
- (void)viewDidLoad{[super viewDidLoad];//為查詢iCloud檔案的變化,註冊通知[[NSNotificationCenter defaultCenter] addObserver:selfselector:@selector(updateUbiquitousDocuments:)name:NSMetadataQueryDidFinishGatheringNotification object:nil];[[NSNotificationCenter defaultCenter] addObserver:selfselector:@selector(updateUbiquitousDocuments:)name:NSMetadataQueryDidUpdateNotification object:nil]; //查詢iCloud檔案的變化[self searchFilesOniCloud]; }- (void)didReceiveMemoryWarning{[super didReceiveMemoryWarning];[[NSNotificationCenter defaultCenter] removeObserver:self];}
儲存文檔
儲存文檔很簡單,它是在ViewController.m中的 saveClick:方法處理的,saveClick:方法是點擊按鈕時候觸發:
- (IBAction)saveClick:(id)sender {_myCloudDocument.contents = _txtContent.text;[_myCloudDocument updateChangeCount:UIDocumentChangeDone];[_txtContent resignFirstResponder];}
保 存成功之後我們可以在其它裝置上看看是否iCloud中已經有abc.txt文檔了。如果使用Mac OS X系統電腦,我們可以在“系統喜好設定”中打 開iCloud對話方塊,點擊“管理”按鈕可以開啟iCloud空間管理對話方塊,其中的MyNotes是我應用程式名稱,右邊的abc.txt建立的檔案。
如果在iPhone、iPod touch和iPad等iOS裝置中查看,可以啟動設定應用程式,也進入到儲存空間管理中,我的iPod touch中查看的情況。
出自《iOS網路編程與雲端應用最佳實務》作者:關東升 @tony_關東升