iOS ShareExtension防坑指南

2020-07-24 本文已影响0人 _keepGoingKeepF

关于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防坑指南

1.自定义分享界面

2.设置分享类型

3.获取分享的数据

如非必要,不建议使用action.js文件做网页解析。部分网页可能返回了data类型的数据,但是苹果loadItemForTypeIdentifier无法转换成正确类型的数据，从而数据捕获为nil;

如果要捕获网页的分享内容和标题等信息可以使用attributedTitle、attributedContentText里面的信息。

4.数据分享

4.1 appgroup数据读写

4.2跳转app

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

猜你喜欢

热点阅读

iOS ShareExtension防坑指南

1.自定义分享界面

2.设置分享类型

3.获取分享的数据

如非必要,不建议使用action.js文件做网页解析。部分网页可能返回了data类型的数据,但是苹果loadItemForTypeIdentifier无法转换成正确类型的数据，从而数据捕获为nil;

如果要 捕获网页的分享内容和标题等信息可以使用attributedTitle、attributedContentText里面的信息。

4.数据分享

4.1 appgroup数据读写

4.2跳转app

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

猜你喜欢

热点阅读

如果要捕获网页的分享内容和标题等信息可以使用attributedTitle、attributedContentText里面的信息。