美文网首页
iOS ShareExtension防坑指南

iOS ShareExtension防坑指南

作者: _keepGoingKeepF | 来源:发表于2020-07-24 13:56 被阅读0次

    关于ios shareExtension如何导入以及appgroup共享区间如何设置此文不在赘述,网上很多请自行百度。

    1.自定义分享界面

    删除shareExtension中的storyboard,在info.plist 文件NSExtension 中的NSExtensionPrincipalClass添加自定义VC。

    image

    2.设置分享类型

    在shareExtension info.plist 文件中设置NSExtensionActivationRule

    激活展的规则。默认为字符串“TRUEPREDICATE”,表示在分享菜单中一直显示该扩展。可以将类型改为Dictionary类型,然后添加以下字段

    **NSExtensionActivationSupportsAttachmentsWithMaxCount**(附件最多限制。附件包括File、Image和Movie三大类,单一、混选总量不超过指定数量)
    **NSExtensionActivationSupportsAttachmentsWithMinCount**(附件最少限制,默认至少选择1个附件,分享菜单中才显示扩展插件图标)
    **NSExtensionActivationSupportsImageWithMaxCount**(图片最多限制,超过不显示)
    **NSExtensionActivationSupportsMovieWithMaxCount**(视频最多限制。单一、混选均不超过指定数量)
    **NSExtensionActivationSupportsWebPageWithMaxCount**(Web页面最多限制。默认不支持Web页面分享,需要自己设置一个数值)
    **NSExtensionActivationSupportsWebURLWithMaxCount**(Web链接最多限制。默认不支持分享超链接,需要自己设置一个数值)
    **NSExtensionActivationSupportsFileWithMaxCount**(文件最多限制,为数值类型。文件泛指除Image/Movie之外的附件,例如【邮件】附件、【语音备忘录】
    **NSExtensionActivationSupportsText**(是否支持文本类型,布尔类型,默认不支持。如【备忘录】的分享)
    

    此处如果采用默认字符串TRUEPREDICATE,会导致审核不过。所以老实改成Dictionary吧。

    假如设置了允许发送的数据类型:text、url、image、mp3、mp4、pdf、word、excel、ppt

    image

    3.获取分享的数据

    inputItems是包含NSExtensionItem类型对象的数组。

    NSExtensionItem包含四个属性:

    image
    * hasItemConformingToTypeIdentifier: 
    用于判断是否有typeIdentifier(UTI)所指定的资源存在。存在则返回YES,否则返回NO。该方法结合loadItemForTypeIdentifier:options:completionHandler:使用。
    
    * loadItemForTypeIdentifier:options:completionHandler:
    加载typeIdentifier指定的资源。加载是一个异步过程,加载完成后会触发completionHandler。
    
    * loadPreviewImageWithOptions:completionHandler:
    加载资源的预览图片。
    

    使用方法:

    - (void)doForShare
    {
        __block BOOL hasExistsUrl = NO;
        [self.extensionContext.inputItems enumerateObjectsUsingBlock:^(NSExtensionItem * _Nonnull extItem, NSUInteger idx, BOOL * _Nonnull stop) {
            [item.attachments enumerateObjectsUsingBlock:^(NSItemProvider * _Nonnull itemProvider, NSUInteger idx, BOOL * _Nonnull stop) {
                if ([itemProvider hasItemConformingToTypeIdentifier:@"public.url"])
                {
                    [itemProvider loadItemForTypeIdentifier:@"public.url"
                                                    options:nil
                                          completionHandler:^(id<NSSecureCoding>  _Nullable item, NSError * _Null_unspecified error) {
                                              if ([(NSObject *)item isKindOfClass:[NSURL class]])
                                              {
                                                  NSLog(@"分享的URL = %@", item);
                                              }
                                          }];
                    hasExistsUrl = YES;
                    *stop = YES;
                }
            }];
            if (hasExistsUrl)
            {
                *stop = YES;
            }
        }];
    }
    
    

    其中@"public.url"就是需要导出的数据类型UTI

    UTI分享类型可以参考

    System-Declared Uniform Type Identifiers

    • 这里有一个小技巧,还记得shareExtension info.plist 中的NSExtensionActivationRule吗?如果解析数据不知道数据返回的UTI类型,比如百度地图、高德地图(item.attachments可能返回多个),可以先将NSExtensionActivationRule设置为默认字符串“TRUEPREDICATE”,这样就可以断点测试到item.attachments 获取到数据的UTI,从而获取数据 。
    • 这里除了loadItemForTypeIdentifier获取主要信息外

    
    - (void)loadItemForTypeIdentifier:(NSString*)typeIdentifieroptions:(NSDictionary*)optionscompletionHandler:(NSItemProviderCompletionHandler)completionHandler;
    
    

    还可以使用loadPreviewImageWithOptions获取截图(可能失败,针对网页获取分享截图好用)

    
    - (void)loadPreviewImageWithOptions:(NSDictionary*)optionscompletionHandler:(NSItemProviderCompletionHandler)completionHandler;
    
    
    • 注意在loadItemForTypeIdentifier时获取数据系统是在子线程操作,会有数据同步问题,需要做保护(dispatch_group或dispatch_semaphore_wait等等)。

    • 需要分享地图等多个attachments的类型,可以设置静态变量static int count = 0;

    static int count = 0;
    [obj loadItemForTypeIdentifier:@"public.url" options:nil completionHandler:^(NSURL* item, NSError * **_Null_unspecified** error){
        count ++;
    }];
    [obj loadItemForTypeIdentifier:@"public.image" options:nil completionHandler:^(UIImage * item, NSError * error){
        count ++;
    }];
    [obj loadItemForTypeIdentifier:(NSString *) kUTTypePlainText options:nil completionHandler:^(NSString* item, NSError * error){
        count ++;
    }];
    if(count == item.attachments.count ){
         //完成分享
    }
    
    • 如非必要,不建议使用action.js文件做网页解析。部分网页可能返回了data类型的数据,但是苹果loadItemForTypeIdentifier无法转换成正确类型的数据,从而数据捕获为nil;
    • 如果要 捕获网页的分享内容和标题等信息可以使用attributedTitle、attributedContentText里面的信息。

    4.数据分享

    4.1 appgroup数据读写

    1.NSUserDefaults
    NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.company.appGroupName"];
    //写入数据
    [userDefaults setValue:@"value" forKey:@"key"];
    //读取数据
    NSLog(@"%@", [userDefaults valueForKey:@"key"]);
    
    2.NSFileManager
    //获取分组的共享目录
    NSURL *groupURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.company.appGroupName"];
    NSURL *fileURL = [groupURL URLByAppendingPathComponent:@"demo.txt"];
    //写入文件
    [@"abc" writeToURL:fileURL atomically:YES encoding:NSUTF8StringEncoding error:nil];
    //读取文件
    NSString *str = [NSString stringWithContentsOfURL:fileURL encoding:NSUTF8StringEncoding error:nil];
    NSLog(@"str = %@", str);
    
    • 这里在写入数据时候如果只是文字、链接类的分享内容可以直接writeURl
      如果有图片也可以转base64str
    -(NSString *)UIImageToBase64Str:(UIImage *) image
    
    {
        NSData *data = UIImageJPEGRepresentation(image, 1.0f);
        NSString *encodedImageStr = [data base64EncodedStringWithOptions:NSDataBase64Encoding64CharacterLineLength];
        return encodedImageStr;
    }
    
    
    • 如果需要分享视频或大文件类型,建议使用coreData。

    4.2跳转app

    设置主程序url schem;

    - (void)openApp{
        UIResponder* responder = self;
        responder = [respondernextResponder];
        while((responder = [respondernextResponder]) !=**nil**) {
            if([responderrespondsToSelector@selector(openURL:)] ==YES) {
                //这里的shareExtenion是app的URL Schemes
                [responderperformSelector:@selector(openURL:) withObject:[NSURL URLWithString:[NSString stringWithFormat:@"主程序url shem://"]]];
                //执行分享内容处理
                [self.extensionContext completeRequestReturningItems:**nil** completionHandler:NULL];
            }
        }
    }
    
    • 在主程序openurl中获取appgroup数据
    - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options API_AVAILABLE(ios(9.0));
    

    5.附赠一些可能用到的函数:

    //字符串转图片
    + (UIImage *)Base64StrToUIImage:(NSString *)_encodedImageStr
    {
        NSData *_decodedImageData = [[NSData alloc] initWithBase64Encoding:_encodedImageStr];
        UIImage *_decodedImage = [UIImage imageWithData:_decodedImageData];
        return _decodedImage;
    }
    
    //获取视频一桢截图
    + (UIImage*)getScreenShotImageFromVideoPath:(NSURL*)fileURL
    {
        UIImage *shotImage;
        AVURLAsset *asset = [[AVURLAsset alloc] initWithURL:fileURL options:nil];
        AVAssetImageGenerator *gen = [[AVAssetImageGenerator alloc] initWithAsset:asset];
        gen.appliesPreferredTrackTransform = YES;
        CMTime time = CMTimeMakeWithSeconds(0.0, 600);
        NSError *error = nil;
        CMTime actualTime;
        CGImageRef image = [gen copyCGImageAtTime:time actualTime:&actualTime error:&error];
        shotImage = [[UIImage alloc] initWithCGImage:image];
        CGImageRelease(image);
        return shotImage;
    }
    

    相关文章

      网友评论

          本文标题:iOS ShareExtension防坑指南

          本文链接:https://www.haomeiwen.com/subject/phpjlktx.html