如何为 iOS 应用正确启用 iCloud 文档同步?
How do I properly enable iCloud document sync for iOS app?
在我的 cordova iOS 应用程序中,用户可以将他们的数据备份到一个文件中,该文件保存在应用程序容器内的 Documents 文件夹中,然后应该将其同步到 iCloud。但是,尽管文件已保存,但它永远不会同步到 iCloud,所以很明显我一定遗漏了一些东西。这些是我采取的步骤:
- 在 developer.apple.com 上注册的 iCloud 容器和在 xcode 中启用的 iCloud 文档功能:
NSUbiquitousContainers
词典添加到 Info.plist:
- 存档构建已创建并上传至 App Store,构建通过 Test Flight 发布给测试人员(注意:应用已通过审核流程并已发布至 App Store)。
- 请注意,Cordova config.xml 不 包含
BackupWebStorage
设置,因此应启用云备份(不确定这是否会影响文档同步)。
- 用户保存备份文件,保存到应用程序的Documents文件夹(注意:应用程序使用cordova-plugin-file插件将文件保存到插件变量
cordova.file.documentsDirectory
指示的位置):
此时我希望看到 xBrowserSync 出现在存储和 iCloud 使用设置中,但我没有:
我也没有在 iCloud Drive 应用程序中看到 xBrowserSync 文件夹:
当然,我从来没有看到文件同步到我的 Mac 或 icloud.com。
显然我遗漏了什么,但我看不到什么。我已经阅读了很多关于如何使这项工作正常进行的 SO 帖子,但我发现 Apple 的文档不清楚且令人困惑,所以我有点被困在这一点上。有人能给我指出正确的方向吗?
经过进一步阅读,我相信我知道这里缺少什么。我没有意识到您需要明确告诉 iOS 将文件上传到 iCloud Document Storage,这将允许文件出现在用户设备上的 iCloud Drive 中。
所以,我需要编写一些 (iOS) 代码,利用 FileManager
class 来:
- 调用
url(forUbiquityContainerIdentifier:)
方法以获取本地 iCloud 容器的位置并对其进行初始化(此时该应用程序将出现在存储和 iCloud 使用设置中)
- 通过调用
setUbiquitous(_:itemAt:destinationURL:)
告诉 iOS 将文件上传到 iCloud
我正在构建一个非常基本的 Cordova 插件来执行此操作。完成后,我会用 link 更新此答案。
编辑:
我开发的cordova插件叫做cordova-plugin-icloud-document-storage。目前只实现了上传文件到iCloud(即setUbiquitous
),没有实现FileManager
class的其他iCloud功能(比如如管理云更新或版本冲突)。如果有人想开发此功能,请提交拉取请求。
在我的 cordova iOS 应用程序中,用户可以将他们的数据备份到一个文件中,该文件保存在应用程序容器内的 Documents 文件夹中,然后应该将其同步到 iCloud。但是,尽管文件已保存,但它永远不会同步到 iCloud,所以很明显我一定遗漏了一些东西。这些是我采取的步骤:
- 在 developer.apple.com 上注册的 iCloud 容器和在 xcode 中启用的 iCloud 文档功能:
NSUbiquitousContainers
词典添加到 Info.plist:
- 存档构建已创建并上传至 App Store,构建通过 Test Flight 发布给测试人员(注意:应用已通过审核流程并已发布至 App Store)。
- 请注意,Cordova config.xml 不 包含
BackupWebStorage
设置,因此应启用云备份(不确定这是否会影响文档同步)。 - 用户保存备份文件,保存到应用程序的Documents文件夹(注意:应用程序使用cordova-plugin-file插件将文件保存到插件变量
cordova.file.documentsDirectory
指示的位置):
此时我希望看到 xBrowserSync 出现在存储和 iCloud 使用设置中,但我没有:
我也没有在 iCloud Drive 应用程序中看到 xBrowserSync 文件夹:
当然,我从来没有看到文件同步到我的 Mac 或 icloud.com。
显然我遗漏了什么,但我看不到什么。我已经阅读了很多关于如何使这项工作正常进行的 SO 帖子,但我发现 Apple 的文档不清楚且令人困惑,所以我有点被困在这一点上。有人能给我指出正确的方向吗?
经过进一步阅读,我相信我知道这里缺少什么。我没有意识到您需要明确告诉 iOS 将文件上传到 iCloud Document Storage,这将允许文件出现在用户设备上的 iCloud Drive 中。
所以,我需要编写一些 (iOS) 代码,利用 FileManager
class 来:
- 调用
url(forUbiquityContainerIdentifier:)
方法以获取本地 iCloud 容器的位置并对其进行初始化(此时该应用程序将出现在存储和 iCloud 使用设置中) - 通过调用
setUbiquitous(_:itemAt:destinationURL:)
告诉 iOS 将文件上传到 iCloud
我正在构建一个非常基本的 Cordova 插件来执行此操作。完成后,我会用 link 更新此答案。
编辑:
我开发的cordova插件叫做cordova-plugin-icloud-document-storage。目前只实现了上传文件到iCloud(即setUbiquitous
),没有实现FileManager
class的其他iCloud功能(比如如管理云更新或版本冲突)。如果有人想开发此功能,请提交拉取请求。