iOS 文件导入、打开和导出

2023-03-15  本文已影响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文件中的配置如下:

<key>CFBundleDocumentTypes</key>
    <array>
        <dict>
            <key>CFBundleTypeName</key>
            <string>TXT File</string>
            <key>LSHandlerRank</key>
            <string>Owner</string>
            <key>LSItemContentTypes</key>
            <array>
                <string>public.plain-text</string>
            </array>
        </dict>
    </array>

至此,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文件中的配置如下:

<key>UTExportedTypeDeclarations</key>
    <array>
        <dict>
            <key>UTTypeConformsTo</key>
            <array>
                <string>public.directory</string>
                <string>public.plain-text</string>
            </array>
            <key>UTTypeDescription</key>
            <string>ABC File</string>
            <key>UTTypeIconFiles</key>
            <array/>
            <key>UTTypeIdentifier</key>
            <string>com.demo.abc</string>
            <key>UTTypeTagSpecification</key>
            <dict>
                <key>public.filename-extension</key>
                <array>
                    <string>abc</string>
                </array>
                <key>public.mime-type</key>
                <array/>
            </dict>
        </dict>
    </array>

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

打开文件

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

- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options

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

- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)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]];
            
            // 自定义文件类型,一定要设置UTI
            NSString *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 - <UIDocumentInteractionControllerDelegate>
- (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:

奇迹读书地址

上一篇下一篇

猜你喜欢

热点阅读