iOS: iCloud开发案例

序言:本文通过一个简单的项目工程的开发工作,浅谈一下iCloud开发。项目地址:YTiCloudDocumentsProject
开发需求:把一些比较简单比较重要的文件保存在iCloud云盘中,以便在不同的iOS设备中共享使用。
集成开发过程:

    1. 给工程配置iCloud capabilities:
1.png

这里我勾选的是iCould Documents,另外还有两项Key-Value storage和CloudKit。其中Key-value storage是类似与userDefault一样,主要用于保存配置及状态。iCloud Documents主要用于保存文档文件等,CloudKit是苹果的一个框架,可以实现类似于数据库存储,可以在开发者中心配置CloudKit Dashboard,是后台中心。根据我们的需求,我们选择ICloud Documents进行开发。
这时候项目结构中会出现IcloudProject.entitlements文件,内容如下:


2.png

从中了解到我们选择的Containers是Use default container,其indentifier是iCloud.+bundleid。当然我们也可以选择Specify custom containers,并且可以配置多个indentifier,代表多个container区域,每个Indentifier代表一个区域,类似于SandBox,用于保存文件。

    1. 获取默认的根目录
      我们要备份或者保存的文件就保存在这个文件夹或者其子文件夹下
//默认的icloud Documents容器的Indentifier
NSString * const ubiquityIndentifier = @"iCloud.com.0101.yetaiwen.IcloudProject";

//获取icloud Documents根文件夹或者子文件夹地址
NSURL* getDocumentUrlWithPath(NSString *path)
{
    NSURL *url = nil;
    url = [[NSFileManager defaultManager]URLForUbiquityContainerIdentifier:ubiquityIndentifier];
    NSLog(@"------url:%@",url);
    if (url && path) {
        url = [url URLByAppendingPathComponent:path];
        return url;
    }else if(!path) {
        return url;
    }else {
        NSLog(@"Please check out that iCloud had been signed in");
        return url;
    }
    return url;
}
    1. 导入文件到iCloud账户中,及以上根目录下
    NSURL *url = getDocumentUrlWithPath(nil);
    for (NSString *documentName in self.documents)
    {
        [[NSFileManager defaultManager] copyItemAtPath:[[NSBundle mainBundle].resourcePath stringByAppendingPathComponent:documentName]
                                                toPath:[url.path stringByAppendingPathComponent:documentName]
                                                 error:nil];
    }
    1. 通过简单封装的工具类去查询获取iCould账户下的文件列表
-(void)loadiCloudDirectory
{
    [_metaQuery stopQuery];
    _metaQuery = nil;
    _metaQuery = [[NSMetadataQuery alloc]init];
    _metaQuery.searchScopes = @[NSMetadataQueryUbiquitousDataScope];
    _metaQuery.notificationBatchingInterval = 15;
    NSOperationQueue *queue = [NSOperationQueue mainQueue];
    _metaQuery.operationQueue = queue;
    [[NSNotificationCenter defaultCenter]addObserver:self selector:@selector(gatherFinish:) name:NSMetadataQueryDidFinishGatheringNotification object:_metaQuery];
    [[NSNotificationCenter defaultCenter]addObserver:self selector:@selector(gatherFinish:) name:NSMetadataQueryDidUpdateNotification object:_metaQuery];
    [_metaQuery startQuery];
}
    1. 在通知中获取到具体文件的信息并保存,以便在tableView中展示
-(void)gatherFinish:(NSNotification*)nofification
{
    NSMetadataQuery *query = nofification.object;
    [query disableUpdates];
    NSLog(@"------resultCount:%lu",query.resultCount);
    [[NSNotificationCenter defaultCenter]removeObserver:self name:NSMetadataQueryDidFinishGatheringNotification object:query];
    [[NSNotificationCenter defaultCenter]removeObserver:self name:NSMetadataQueryDidUpdateNotification object:query];
    if (query.resultCount > 0) {
        NSArray *result = query.results;
        NSMutableArray *datasource = [NSMutableArray array];
        for (NSMetadataItem *item in result) {
            NSDictionary *dic = [item valuesForAttributes:@[NSMetadataItemFSNameKey,NSMetadataItemURLKey,NSMetadataItemFSContentChangeDateKey,NSMetadataItemFSSizeKey,NSMetadataItemContentTypeKey]];
            [datasource addObject:dic];
        }
        if (self.delegate) {
            [self.delegate iCloudDatasourceUpdate:[datasource copy]];
        }
    }
    [query enableUpdates];
}
    1. 在打开iCoud文件时用到了UIDocument这个类,我们运用UIDocument的子类,并重写方法:
//写数据时,我们需要提供待写的Data
-(id)contentsForType:(NSString *)typeName error:(NSError * *)outError
{
    NSLog(@"---写---%@",typeName);
    return _fileData;
}
//读数据时,我们去处理系统返回的Data
-(BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError * *)outError
{
    NSLog(@"---读---%@",typeName);
    _fileData = contents;
    return YES;
}

从上面也可以看出,其实在线打开iCloud文件,其实是下载到了本地然后从本地打开文件。

PS:在iCloud使用过程中,iOS设备一定要登录了iCloud账号。否则,iCloud的存储路径返回为nil,无法完成相关的操作。

4.png
3.png