源码
iOS扩展—Document Provider-ios学习从入门到精通尽在姬长信
姬長信分享最热门的ios资讯
投稿文章，作者：M0nk1y
1. 开发流程梗概
1.1. 创建一个文件编辑器 App，具有打开、导入其它 App 的文件；移动、导出、保存文件到其它 App 的 功能。
1.2. 创建一个可以检察自己文件的 App，具有 Document Provider 扩展。
1.3. 在 Document Provider 扩展里编写处理打开、导入、移动、导出文件事件的代码
1.4. 在 File Provider 扩展里编写协调文件的代码。
2. 两个要害字
2.1 共享容器。
一个沙盒能与另一个沙盒进行文件交换只能在共享容器里进行，通过创建 App Groups 就可以获得共享容器了。
2.2 文件权限。
当需要访问不在 App 自身的沙盒或者自身共享容器里的资源时，需要申请权限访问，使用到 NSURL 的两个要领:
开始宁静访问：- (BOOL)startAccessingSecurityScopedResource
停止宁静访问：- (void)stopAccessingSecurityScopedResource
3. 文件编辑器 MKTextEdit
创建一个面目目样 App 项目，界面如此：
运行起来酱紫：
因为这个 App 需要有访问其他 App 文件的权限，所以我们得开启它的 iCloud 功能，打开 iCloud 需要提供苹果开发者账号。
3.1 面目目样建
面目目样建文件并输入标题和内容后，我们可以对文件进行移动、导入和保存。移动和导入前要先保存文件，因为我们移动和导入都要提供文件的在 App 里的地址。
3.2 打开文件
需要 UIDocumentMenuViewController 打开一个菜单选项，里面默认提供 iCloud 具有 Document Provider 扩展的 App。
- (void)displayDocumentPickerWithURIs:(NSArray *)UTIs {
UIDocumentMenuViewController *importMenu = [[UIDocumentMenuViewController alloc] initWithDocumentTypes:UTIs inMode:documentPickerMode];
importMenu.delegate = self;
[self presentViewController:importMenu animated:YES completion:nil];
}UTI，Uniform Type Identifier 可以查询。
documentPickerMode 为 UIDocumentPickerModeOpen。
当选择了某个菜单时时会调用署理要领：
#pragma mark - UIDocumentMenuDelegate
-(void)documentMenu:(UIDocumentMenuViewController *)documentMenu didPickDocumentPicker:(UIDocumentPickerViewController *)documentPicker
{
documentPicker.delegate = self;
[self presentViewController:documentPicker animated:YES completion:nil];
}打开一个 UIDocumentPickerViewController 控制器，以 iCloud 为例，里面提供了一系列文件选择，当选择了某个文件时，调用 UIDocumentPickerViewController 的署理要领。
-(void)documentPicker:(UIDocumentPickerViewController *)controller didPickDocumentAtURL:(NSURL *)url
{
[controller dismissViewControllerAnimated:YES completion:nil];
}署理返回的 url 是刚选择的文件在共享容器的位置，我们可以倒霉用这地址对该文件进行操作了。
3.2 读取打开的文件
- (void)openFile:(NSURL *)url
{
//1.获取文件宁静访问权限
BOOL accessing = [url startAccessingSecurityScopedResource];
if(accessing){
[activityView startAnimating];
//2.通过文件协调器读取文件地址
NSFileCoordinator *fileCoordinator = [[NSFileCoordinator alloc] initWithFilePresenter:nil];
[fileCoordinator coordinateReadingItemAtURL:url
options:NSFileCoordinatorReadingWithoutChanges
error:nil
byAccessor:^(NSURL * _Nonnull newURL) {
[activityView stopAnimating];
//3.读取文件协调器提供的面目目样地址里的数据
NSString *fileName = [newURL lastPathComponent];
NSString *contStr = [NSString stringWithContentsOfURL:newURL encoding:NSUTF8StringEncoding error:nil];
//4.把数据保存在当地缓存
[self saveLocalCachesCont:contStr fileName:fileName];
}];
}
//6.停止宁静访问权限
[url stopAccessingSecurityScopedResource];
}1. 文件协调器 —— NSFileCoordinator，它与 File Provider extension 关联，当我们使用文件协调器读取、写入文件时都会触发 File Provider extension 的要领。等下介绍。
2. 可以看看打开的地址为：
`file:///Users/AllenChow/Library/Developer/CoreSimulator/Devices/F7999205-1D00-4683-A2E1-EBB8B32D67BE/data/Library/Mobile%20Documents/com~apple~CloudDocs/newFile.txt`
地址是位于 iCloud 里的。
3.3 保存打开的文件
当编辑过打开的文件后，进行保存时：
//1.通过文件协调器写入文件
NSFileCoordinator *fileCoorDinator = [NSFileCoordinator new];
NSError *error = nil;
[fileCoorDinator coordinateWritingItemAtURL:lastURL
options:NSFileCoordinatorWritingForReplacing
error:&error
byAccessor:^(NSURL * _Nonnull newURL) {
//2.获取宁静访问权限
BOOL access = [newURL startAccessingSecurityScopedResource];
//3.写入数据
if(access && [content writeToURL:newURL atomically:YES encoding:NSUTF8StringEncoding error:nil]){
NSLog(@"保存原文件成功");
}
//4.停止宁静访问权限
[newURL stopAccessingSecurityScopedResource];
}];lastURL 是之前打开文件时 `-(void)documentPicker:(UIDocumentPickerViewController *)controller didPickDocumentAtURL:(NSURL *)url` 返回的地址。我们把文件保存回这个地址。
至此，我们已经完成了`在 App 内打开 另一个 App 的文件 ——> 读取 ——> 编辑 ——> 保存`的过程了。
3.4 导入文件
跟打开文件一样，但是 `documentPickerMode` 为 `UIDocumentPickerModeOpen`。
回调要领为：
- (void)importFile:(NSURL *)url
{
[activityView startAnimating];
//1.通过文件协调工具来得到面目目样的文件地址，以此得到文件庇护功能
NSFileCoordinator *fileCoordinator = [[NSFileCoordinator alloc] initWithFilePresenter:nil];
[fileCoordinator coordinateReadingItemAtURL:url options:NSFileCoordinatorReadingWithoutChanges error:nil byAccessor:^(NSURL * _Nonnull newURL) {
[activityView stopAnimating];
//2.直接读取文件
NSString *fileName = [newURL lastPathComponent];
NSString *contStr = [NSString stringWithContentsOfURL:newURL encoding:NSUTF8StringEncoding error:nil];
//3.把数据保存在当地缓存
[self saveLocalCachesCont:contStr fileName:fileName];
}];
}我们看看导入的模式下打开文件的地址为：
`file:///Users/AllenChow/Library/Developer/CoreSimulator/Devices/F7999205-1D00-4683-A2E1-EBB8B32D67BE/data/Containers/Data/Application/82EE4511-930E-46FB-83B9-C6099C6A91A4/tmp/com.donlinks.MKTextEdit-Inbox/newFile.txt`
地址是位置 MKTextEdit App 里的临时文件夹，说明了导入模式下文件是拷贝进来 App 的，所以我们可以直接读取文件数据。
3.5 移动和导出文件
移动和导出的处理方式一样的，只有带给 Document Provider extension 的 documentPickerMode 纷歧样，我们可以凭据这个参数，如果是移动模式则删除 MKTextEdit App 里的文件，如果是导出模式就拷贝文件到共享容器。
- (IBAction)export:(id)sender {
//1. 保存缓存文件
[self modify:nil];
documentPickerMode = UIDocumentPickerModeExportToService;
NSURL *fileURL = [NSURL fileURLWithPath: [CachesFilePath stringByAppendingPathComponent: currentFileName]];
//2.打开文件选择器
[self displayDocumentPickerWithURL:fileURL];
}
- (void)displayDocumentPickerWithURL:(NSURL *)url {
UIDocumentMenuViewController *importMenu = [[UIDocumentMenuViewController alloc] initWithURL:url inMode:documentPickerMode];
importMenu.delegate = self;
[self presentViewController:importMenu animated:YES completion:nil];
}这次打开文件选择器提供的参数是 URL 并不是 UTI 了。
4. 共享容器提供方 MKDocumentProvider
当你想让自己 App 里的文件能够提供给其他 App 读取和编辑，需要做两件事：
1. 创建 Document Provider extension 和 File Provider extension
2. 提供共享容器，把共享的文件放到容器里。
4.1 创建扩展
记得勾选 Include a File Provider extension 
, 命名，完成。会弹出这样一个询问你时候激活 Scheme 的框，选择激活（Activate）。
创建 Document Provider extension 之后会附带一个 File Provider extension。
修改运行扩展时执行的主应用：
4.2 创建 App Groups
到项目的 Capabilities 里找到 App Groups，点击开启：
Document Provider extension 和 File Provider extension 也要开启 App Groups 而且都要用同一个 group。
创建完 Document Provider 扩展需要的乳后，我们来运行看看效果：
4.3 MKDocumentProvider 展示共享容器的文件
#pragma mark - 获取共享容器文件夹路径
- (NSString *)storagePath {
NSURL *groupURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:APP_GROUP_ID];
NSString *groupPath = [groupURL path];
NSString *_storagePath = [groupPath stringByAppendingPathComponent:APP_FILE_NAME];
NSFileManager *fileManager = [NSFileManager defaultManager];
if (![fileManager fileExistsAtPath:_storagePath]) {
[fileManager createDirectoryAtPath:_storagePath withIntermediateDirectories:NO attributes:nil error:nil];
}
return _storagePath;
}4.4 Document Provider extension
扩展的入口是一个 UIDocumentPickerExtensionViewController 类。在3.2 打开文件的使用 UIDocumentPickerViewController 展示的就是这个界面了，我们可以自界说这个界面。
- (void)dismissGrantingAccessToURL:(nullable NSURL *)url;
调用此要领来关闭该文档选择器的视图控制器以及所提供的授权访问的网址。每种模式都有自己所要求的URL。有关其完整的详细信息，请参阅：Dismissing the User Interface。
-(void)prepareForPresentationInMode:(UIDocumentPickerMode)mode;
当开始展示界面时自动调用，可以凭据 mode 来做界面定制。
NSArray *validTypes
当在打开和导入模式下才有值，值为 UTI
NSURL *documentStorageURL
共享容器地址
NSURL *originalURL
源文件地址，只有在移动和导入模式下才有值，访问该地址需要申请宁静访问权限。
4.4.1 打开和导入
在打开和导入模式下，我们需要用户点击了文件就关闭文档选择器和返回文件地址 URL
4.4.2 移动和导出
在移动和导出模式下，我们提供个按钮让用户确定保存的路径，当点击按钮的时候保存文件到共享容器：
- (void)exportFile
{
NSURL *originalURL = self.originalURL;
NSString *fileName = [originalURL lastPathComponent];
NSString *exportFilePath = [storagePath stringByAppendingPathComponent: fileName];
//1. 获取宁静访问权限
BOOL access = [originalURL startAccessingSecurityScopedResource];
if(access){
//2. 通过文件协调器访问读取该文件
NSFileCoordinator *fileCoordinator = [NSFileCoordinator new];
NSError *error = nil;
[fileCoordinator coordinateReadingItemAtURL:originalURL options:NSFileCoordinatorReadingWithoutChanges error:&error byAccessor:^(NSURL * _Nonnull newURL) {
//3.保存文件到共享容器
[self saveFileFromURL:newURL toFileURL: [NSURL fileURLWithPath:exportFilePath]];
}];
}
//4. 停止宁静访问权限
[originalURL stopAccessingSecurityScopedResource];
}4.4 文件提供法式 File Provider extension
文件提供法式应用扩展允许在主应用法式的沙箱外使用打开和移动操作来访问文件。当 MKTextEdit 使用文件协调器 `NSFileCoordinator ` 打开不存在 MKDocumentProvider 的文件时，我们可以使用 `- (void)startProvidingItemAtURL:(NSURL *)url completionHandler:(void (^)(NSError *))completionHandler` 要领来为 MKTextEdit 创建面目目样文件：
//文件庇护，文件不存在则创建面目目样文件
- (void)startProvidingItemAtURL:(NSURL *)url completionHandler:(void (^)(NSError *))completionHandler {
NSError* error = nil;
__block NSError* fileError = nil;
NSFileManager *fileMgr = [NSFileManager defaultManager];
NSString *filePath = [url path];
if([fileMgr fileExistsAtPath:filePath]){ //1
//文件已存在，返回
completionHandler(error);
return;
}
//文件不存在，创建面目目样文件，并写入url
NSData *fileData = [@"面目目样建文件：" dataUsingEncoding:NSUTF8StringEncoding]; //2
[self.fileCoordinator coordinateWritingItemAtURL:url options:NSFileCoordinatorWritingForReplacing error:&error byAccessor:^(NSURL *newURL) {
[fileData writeToURL:newURL options:0 error:&fileError]; //3
}];
if (error!=nil) {
completionHandler(error);
} else {
completionHandler(fileError);
}
}5. 搞掂
Demo: MKDocumentProvider
用意志战胜身体的惰性！
本文由 姬長信 创作，文章地址：https://blog.isoyu.com/archives/565.html
采用知识共享署名4.0 国际许可协议进行许可。除注明转载/出处外，均为本站原创或翻译，转载前请务必署名。最后编辑时间为:7 月 4, 2016 at 12:00 下午
