如何使用 iCloud 存储和同步应用程序文件

Question

我已经有一个 iPhone 应用程序，它将数据存储在本地文档文件夹的文件中。现在我了解了 iCloud 技术，我的第一个问题是：当我有时检查新版本时，有没有办法使用 iCloud 作为目录？

我的意思是：我可以避免使用 UIDocument、文件协调器和文件演示器吗？我只是想知道是否可以将 iCloud 视为特殊文件夹并仅使用 NSFileManager 来推送和检索文件。

最后说明：我不使用 Core Data 或任何数据库，我只有一个数据文件。

编辑：

我已经阅读了 Apple iCloud 官方文档，因此请勿将我链接到它们。我只需要一些代码示例。

Answer 1

对我来说“有效”的很简单：

NSFileManager *fm = [NSFileManager defaultManager];

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

if (ubiq == nil) {
    return NO;
}

NSError *theError = nil;

[fm setUbiquitous:true itemAtURL:backupUrl destinationURL:[[ubiq URLByAppendingPathComponent:@"Documents" isDirectory:true] URLByAppendingPathComponent:backupName] error:&theError];

Apple 说要调用非 UI 线程。让文件“移动”。您可以通过 NSMetaDataQuery 查询它们，如下所示：

self.query = [[NSMetadataQuery alloc] init];
[self.query setSearchScopes:[NSArray arrayWithObject:NSMetadataQueryUbiquitousDocumentsScope]];
NSPredicate *pred = [NSPredicate predicateWithFormat: @"%K like '*.db'", NSMetadataItemFSNameKey];
[self.query setPredicate:pred];
[[NSNotificationCenter defaultCenter] addObserver:self 
                                         selector:@selector(queryDidFinishGathering:) 
                                             name:NSMetadataQueryDidFinishGatheringNotification 
                                           object:self.query];

[self.query startQuery];

- (void)queryDidFinishGathering:(NSNotification *)notification {
    NSMetadataQuery *query = [notification object];
    [query disableUpdates];
    [query stopQuery];

    [self loadData:query];

    [[NSNotificationCenter defaultCenter] removeObserver:self name:NSMetadataQueryDidFinishGatheringNotification object:query];

    self.query = nil; 
}

通过查询结果进行枚举的示例：

- (void)loadData:(NSMetadataQuery *)query {
    [self.backups removeAllObjects];

    for (NSMetadataItem *item in [query results]) {
        NSURL *url = [item valueForAttribute:NSMetadataItemURLKey];
        [self.backups addObject:url.lastPathComponent];
    }

    [_table reloadData];

    [self.loadingBackupIndicator stopAnimating];
    self.loadingIndicatorLabel.text = [NSString stringWithFormat: @"%d backups found", [self.backups count]];
}

并开始具体文件的“下载”：

NSFileManager *fm = [NSFileManager defaultManager];

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

if (ubiq == nil) {
    return NO;
}

NSError *theError = nil;

bool started = [fm startDownloadingUbiquitousItemAtURL:[[ubiq URLByAppendingPathComponent:@"Documents" isDirectory:true] URLByAppendingPathComponent:backupName] error:&theError];

NSLog(@"started download for %@ %d", backupName, started);

if (theError != nil) {
    NSLog(@"iCloud error: %@", [theError localizedDescription]);
}

检查文件“正在下载”：

- (BOOL)downloadFileIfNotAvailable {
    NSNumber *isIniCloud = nil;

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

    NSURL *file = [[ubiq URLByAppendingPathComponent:@"Documents" isDirectory:true] URLByAppendingPathComponent:self.backupName];

    if ([file getResourceValue:&isIniCloud forKey:NSURLIsUbiquitousItemKey error:nil]) {
        // If the item is in iCloud, see if it is downloaded.
        if ([isIniCloud boolValue]) {
            NSNumber*  isDownloaded = nil;
            if ([file getResourceValue:&isDownloaded forKey:NSURLUbiquitousItemIsDownloadedKey error:nil]) {
                if ([isDownloaded boolValue]) {
                    [self.loadingBackupIndicator stopAnimating];
                    self.loadingIndicatorLabel.text = @"Downloaded";

                    ....

                    [[NSFileManager defaultManager] copyItemAtPath:[file path] toPath:restorePath error:&theError ];

                    ....

                    return YES;
                }

                self.loadingCheckTimer = [NSTimer timerWithTimeInterval:3.0f target:self selector:@selector(downloadFileIfNotAvailable) userInfo:nil repeats:NO];
                [[NSRunLoop currentRunLoop] addTimer:self.loadingCheckTimer forMode:NSDefaultRunLoopMode];

                return NO;
            }
        }
    }

    return YES;
}

我没想到代码那么长，很抱歉在这里提供非常原始的片段。无意说以上可以成为代码的生产质量，只是分享概念。

我还没有将我的应用程序内的内容提​​交给苹果，所以不能说这会被应用程序商店“批准”（如果他们发现或关心......）

Answer 2

我知道你的感受，iCloud 有点令人畏惧。然而，我认为没有办法绕过 UIDocument、文件协调器等并简单地使用 iCloud 作为一个简单的文件夹。

如果您正在寻找易于理解的示例代码，请查看这篇文章：

iCloud 基础知识和代码示例

我提供了完整的示例代码，其中涵盖了 iCloud 的最低限度，并且几乎像目录一样使用它。也许这会让您在使用 UIDocument、文件协调器等时不再那么畏惧。

但是，像您一样，我希望有一种更简单、更兼容的方式来实现良好的旧文档文件夹想法。然而，由于这是 iCloud，而且 iCloud 还可以做更多事情（例如在不同设备上保持所有内容同步、不断更新到云等），因此无法绕过 UIDocument 等。

Answer 3

您可以使用 NSFileManager 将单个文件上传到 iCloud。我在我的博客上发布了关于如何执行此操作的完整演练，但以下是相关的 NSFileManager 代码：

NSURL *destinationURL = [self.ubiquitousURL URLByAppendingPathComponent:@"Documents/image.jpg"]
[[NSFileManager defaultManager] setUbiquitous:YES 
                                    itemAtURL:sourceURL
                               destinationURL:destinationURL
                                        error:&error]

Answer 4

确实没有办法绕过使用 UIDocument。我在第一次使用 iCloud 时尝试这样做，但事实证明，如果没有 UIDocument，这将是一场灾难。使用 UIDocument 乍一看似乎需要做很多额外的工作，但事实并非如此。

您可以在一小时内轻松地对 UIDocument 进行子类化，并使其能够处理任何类型的文件（只需将 content 属性设置为 NSData）。与标准文件系统相比，它还提供了许多好处：

• 更改跟踪
• 文件冲突解决
• 文档状态支持
• 增强的保存/打开/关闭功能

老实说，花一两个小时阅读 Apple 文档然后使用它是非常值得花时间和精力的力量。有关 iCloud 文档存储的优秀入门文章可以在 Apple 的开发者文档。

---

我编写了一个 UIDocument 子类，可以处理任何类型的文件（特别是 NSData）。您可以在 GitHub 上查看、下载和修改 UIDocument 子类的代码。

创建文档：

// Initialize a document with a valid file path
iCloudDocument *document = [[iCloudDocument alloc] initWithFileURL:fileURL];

// Set the content of the document
document.contents = content;

// Increment the change count
[document updateChangeCount:UIDocumentChangeDone];

保存现有文档：

// Save and close the document
[document closeWithCompletionHandler:nil];

保存新文档：

[document saveToURL:document.fileURL forSaveOperation:UIDocumentSaveForCreating completionHandler:nil];

您还可以使用 NSMetadataQuery 同步存储在 iCloud 中的所有文件。 Apple 提供了一个非常好的使用 NSMetadata 查询来同步应用程序文件的示例。另外，请确保在执行这些操作之前检查 iCloud（提示：使用 NSFileManager 上的 ubiquityIdentityToken 方法）。

---

您可能还需要考虑使用开源库，例如 iCloud Document Sync。 iCloud Document Sync 项目使存储和同步应用程序文件变得非常容易：

通过一行代码方法将 iCloud 集成到 iOS 文档项目中。快速轻松地从 iCloud 同步、上传、管理和删除文档。有助于让 iCloud 也为开发者“正常工作”。

在几乎每个 iCloud Document Sync 方法中，您所要做的就是将文件数据作为参数传递，然后它会处理其余的事情（保存、同步等）。

免责声明：我是开源项目 iCloud Document Sync 的一名贡献开发人员。不过，我相信这个项目会对你有利，并且与这个问题相关。这不是促销或广告。

Answer 5

使用此代码：

+ (NSString *)Pathsave {
    NSString *os5 = @"5.0";

    NSString *currSysVer = [[UIDevice currentDevice] systemVersion];
    NSString *path = [NSHomeDirectory() stringByAppendingPathComponent:@"Documents"];

    if ([currSysVer compare:os5 options:NSNumericSearch] == NSOrderedAscending) {
       // Lower than 4
        return path;
    } else if ([currSysVer compare:os5 options:NSNumericSearch] == NSOrderedDescending) {
        // 5.0.1 and above        
        return path;
    } else {
        // iOS 5
        path = [NSHomeDirectory() stringByAppendingPathComponent:@"Library/Caches"];
        return path;
    }

    return nil;
}