iOS 文件导入、打开和导出
迪丽瓦拉
2025-05-28 20:19:45
0

前言

最近公司的活比较少,空闲时间十分多,遍寻思着写一款APP。在这个过程中需要导入、打开和导出文件,于是研究了一下。

目前写的这个是本地阅读软件,后续会把在写这个APP用到的技术以及遇到的问题都整理出来,通过博客的形式分享给大家。

奇迹读书地址

可以先看上一篇文章《统一类型标识符概述》,CSDN地址,简书地址。

文件导入

要向APP导入文件,首先得注册支持的文件类型。

以TXT文件为例,选中项目->info->Document Types,添加一个文件类型。

Name:名称,字符串值,我这里填写“TXT File”,可以随便起一个自己喜欢的名字。

Types:文件类型,其实就是UTIs,我这里填“public.plain-text”,也可以填写多个由“,”分割开

Hand Rank:优先级,其值由Owner,Alternate,Default到None以此递减。这里我填写“Owner”最高优先级,能够使在导入文件的应用列表中显示靠前。

最终在Info.plist文件中的配置如下:

CFBundleDocumentTypesCFBundleTypeNameTXT FileLSHandlerRankOwnerLSItemContentTypespublic.plain-text

至此,APP就拥有了导入文本文件(不仅仅是TXT文件,还包括其他如.h、.m等文本)的能力。因为UTIs具有类似编程语言里类的继承特性,“public.plain-text”这个UTI不仅仅表示TXT这一种文件,而是表示的文本文件,任何属于这个类型子文件类型都是能够识别、导入的。

导入特殊(不存在、自定义)类型文件

当需要导入一种不存在或者说自定义的文件时,必须先为这类文件申明UTIs,可以通过上一篇文章了解。

这里以“.abc”文件为例,选中项目->info->Exported Type Identifiers,点击“+”号来申明一个UTIs,在导出文件类型中申明的原因是让别的APP可以导入、识别此UTI。

Description:描述,其实可以随便写一个自己喜欢的描述,我这里填“ABC File”

Extensions:扩展,其实就是文件后缀名,我这里填写“abc”

Identifier:这就是真正的UTI字符串,按照UTI语法规定的要求填写(简单来说,只允许使用ASCII字符的子集,不能使用“_”、“:”等一些特殊字符,自定义不能以public、dyn域开始,以com域开始使用反向dns格式),我这里填写“com.demo.abc”

Mime Types:表示文件类型的一种形式,因为这是自定义类型,并不是系统不支持的一种存在且拥有Mime type的类型,所以我这里选择不填。

Confirms to:物理上、功能上属于哪种类型,因为想定义一种文本文件类型的UTI,所以这里物理上继承public.directory、功能上继承public.plain-text,以“,”分割开“public.directory, public.plain-text”。

Icons:图标资源名称,由于我没有画图标,这里选择不填

Reference URL:引用文档的URL,由于没有制作该URL,这里选择不填

最终在Info.plist文件中的配置如下:

UTExportedTypeDeclarationsUTTypeConformsTopublic.directorypublic.plain-textUTTypeDescriptionABC FileUTTypeIconFilesUTTypeIdentifiercom.demo.abcUTTypeTagSpecificationpublic.filename-extensionabcpublic.mime-type

至此,就申明了一个UTI,可以在Document Types中按照之前的方法配置导入UTI,这样就可以导入.abc文件了。

打开文件

当导入文件时,选择某APP打开,会调用该APP的UIApplicationDelegate协议申明的如下方法:

- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary *)options

打开文件,我选择使用UIDocumentInteractionController,注意实现其UIDocumentInteractionControllerDelegate代理方法,具体代码如下:

- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary *)options
{NSString *urlType = @"file://";if ([url.absoluteString hasPrefix:urlType]) {RRLog(@"----收到文件:%@----", url);RRLog(@"----收到文件:%@----", url.scheme);// 去除URL协议NSString *sourcePath = url.resourceSpecifier;// url 字符串解码(因为可能存在中文或特殊字符)sourcePath = [sourcePath stringByRemovingPercentEncoding];// 建议移动到缓存目录中,或者使用后删除文件,避免产生垃圾文件NSString *cachePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject];NSString *targetPath = [cachePath stringByAppendingPathComponent:url.lastPathComponent];NSError *error = nil;[NSFileManager.defaultManager moveItemAtPath:sourcePath toPath:targetPath error:&error];if (error) {// 删除文件,避免产生垃圾文件[NSFileManager.defaultManager removeItemAtURL:url error:nil];} else {UIDocumentInteractionController *controller = [UIDocumentInteractionController interactionControllerWithURL:[NSURL fileURLWithPath:targetPath]];// 自定义文件类型,一定要设置UTINSString *extensionName = [[url.lastPathComponent componentsSeparatedByString:@"."] lastObject];if ([extensionName isEqualToString:@"abc"]) {controller.UTI = @"com.demo.abc";}controller.delegate = self;[controller presentPreviewAnimated:YES];}return YES;}//其它第三方处理return YES;
}// 遵守协议,实现协议方法
#pragma mark - 
- (UIViewController *)documentInteractionControllerViewControllerForPreview:(UIDocumentInteractionController *)controller {return self.window.rootViewController;
}

打开文件需要注意的地方有以下几点:

如果要使用接收到的文件URL的路径字符串,一定要去除URL协议名(使用路径获取文件是不带URL协议名file://的),并且Unicode解码(URL会对中文和特殊字符进行Unicode编码)

使用后一定要删除文件,或者将文件移动到缓存目录、临时文件目录再使用(磁盘空间不足时系统会清理),不然就会产生垃圾文件(以后拿不到这个文件URL或者目录路径了)。

如果打开的文件是自定义类型,那么一定要配置、设置UTI。

导出文件

将文件导出、分享比较简单,使用UIActivityViewController:

    UIActivityViewController *share = [[UIActivityViewController alloc] initWithActivityItems:@[[NSURL fileURLWithPath:path]] applicationActivities:nil];if (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad) {share.popoverPresentationController.sourceView = self.view;share.popoverPresentationController.sourceRect = CGRectMake(RR_SCREEN_WIDTH - 50, 0, 50, view.frame.size.height);share.popoverPresentationController.permittedArrowDirections = UIPopoverArrowDirectionAny;}[self presentViewController:share animated:YES completion:nil];

这里有一个问题需要注意,UIActivityViewController和UIAlertController的UIAlertControllerStyleActionSheet状态如果在ipad上运行会奔溃,因为在iPad中这两种控制器是以泡沫窗口的形式弹出,需要设置UIPopoverPresentationController的相关属性,如上述代码或者设置popoverPresentationController的barButtonItem。

后记

最后再分享一遍这个APP:

奇迹读书地址

相关内容