苹果iOS上的iCloud对于应用有几层意义：

1、App可以像以前和iTunes同步时一样，把App数据备份到iCloud上。这部分功能是所谓out-of-box, just works，无需app开发者进行任何支持的。

2、App开发者可以利用iCloud提供的接口将应用的文档放到云端。这样文档不仅是本地保存，还在云端拥有一份拷贝。在多个设备都使用同一app时，就可以通过iCloud来同步成最新的文档。这方面和代码版本控制软件比较类似。但和上一点不同，app开发者必须使用iCloud API进行支持。

3、这点其实是(2)的扩展。iCloud提供了云端文档存储空间，也就意味着可以和其他app共享文档。所以app开发者可以使用iCloud API将iCloud当作一种网络存储和分享的服务。

这里主要讲一下One Tap Hero里支持的功能(2)。

首先要初始化iCloud的支持。在iOS 5.0之前没有iCloud支持，而用户也可能没有登陆iCloud或者禁用iCloud文档同步。所以这一步必须最先做掉。基本上在[UIApplication applicationDidFinishLaunching: options:]中，加入这些实现即可：

- (void)checkiCloudAvailability

{

if ([[NSFileManager defaultManager] respondsToSelector:@selector(URLForUbiquityContainerIdentifier:)])

{

// get the global concurrent queue

dispatch_queue_t globalQueue = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0);

// get the ubiquity container asynchronously

dispatch_async(globalQueue, ^{

NSURL *container = [[NSFileManager defaultManager] URLForUbiquityContainerIdentifier:nil];

// update you app on the main thread with the result

dispatch_async(dispatch_get_main_queue(), ^{

[self updateWithUbiquityContainer:container];

});

});

}

}

- (void)updateWithUbiquityContainer:(NSURL*)container

{

if (container)

{

// continue with iCloud-specific setup

NSLog(@"iCloud access at %@", container);

self.ubiquityContainer = container;

if (icloud_ready_callback)

{

icloud_ready_callback(container);

}

}

else

{

// iCloud is not available

// continue with non-iCloud setup

NSLog(@"No iCloud access");

self.ubiquityContainer = nil;

}

}

其次我们要适应一下iCloud的文件系统接口。我们不能用传统的fopen或者std::out来操作文件，而是要使用另一套API来操作。这套API为何要这样设计我不清楚，但应该是受到spotlight以及网络搜索引擎的影响。

最后我们要适应的是几乎全异步的API。由于网络延迟，iCloud API被设计成大量使用ObjC block的形式。这点和Game Center很像。

没有了fopen，我们打开文件的操作就要分为3个步骤：

a、使用NSMetaQuery和NSPredicate找到云端的文件（异步）。

b、在NSNotificationCenter注册NSMetadataQueryDidFinishGatheringNotification和NSMetadataQueryDidUpdateNotification事件监听（异步）
。

c、在事件监听函数中，使用UIDocument(或自己实现NSFilePresenter)打开或创建文件（异步），打开函数为

-(void) openWithCompletionHandler:^(BOOL success) ();

创建函数其实和存盘函数一样，为

-(void) saveToURL: forSaveOperation: completionHandler:^(BOOL success) ();

但其中forSaveOperation参数必须传UIDocumentSaveForCreating。

创建或打开文件之后，我们对文档的操作就和平常类似，通过重写UIDocument的

- (BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError **)outError

- (id)contentsForType:(NSString *)typeName error:(NSError **)outError

来分别定义文档内容的读、写。而依旧通过UIDocument的public接口

-(void) openWithCompletionHandler:^(BOOL success) () ;

-(void) saveToURL: forSaveOperation: completionHandler:^(BOOL success) ();

来实际调用读、写操作。

到此为止，iCloud文件的创建、打开、读、写都已完成。但尚缺最重要的一步，也是最麻烦的一步——就是异常处理。

云服务必须处理异常和版本冲突的问题，这是不可避免的。所以iCloud提供了NSNotificationCenter里的UIDocumentStateChangedNotification来处理UIDocument的异常。所以通常我们都在正常查询到文件之后，注册这个事件的处理函数。

在这个处理函数中，我们有2个必须知道的文档状态：UIDocumentStateNormal和UIDocumentStateInConflict

UIDocumentStateInConflict意味着iCloud中有多个冲突的版本，必须通过NSFileVersion把冲突版本的resolved属性都置为YES，iCloud才会转变UIDocumentState。而具体如何解决冲突，则按每个app不同而不同。

UIDocumentStateNormal意味着iCloud文档状态正常。通常情况下，以及解决冲突后，文档都会是UIDocumentStateNormal状态。

至此iCloud的基本支持已完成。下面说一些实现陷阱和遇到的问题。

1、iCloud本身没有提供DAG模型的版本管理，必须用户自己实现。这点上One Tap Hero没有做，所以在处理同步冲突时，只能merge一些过关数据（如星星、最高分等），而无法同步金币等数值（无版本控制则这类数值的合并无正确的语义）。

2、iCloud在一些情况下很容易卡死，特别是API调用不合理的情况下。解决方法是换文件或reset device。例如在UIDocumentStateNormal时调用[UIDocument saveToURL]这种IO操作，似乎就很容易出现iCloud卡死的情况。这点不知是否会在iOS 6.0中加以改进。