iOS ShareExtension防坑指南

关于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  _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。

============================================================================

• 此处补充一段:(关于多图分享的经验)：
  当遇到图片太大，数量较多的情况。如果直接批量转成base64str可能会因为超出widget的内存限制而被系统强制杀掉。在widget中内存限制为120M。最好将图片先压缩一下然后再转。此处我尝试了系统的压缩办法

NSData*imageData=UIImageJPEGRepresentation(item, 0.2);

然而并不好用。使用drawInRect重绘图片：

UIGraphicsBeginImageContextWithOptions(size, NO, 1);
[image drawInRect:CGRectMake(0,0,size.width,size.height)];
 image = UIGraphicsGetImageFromCurrentImageContext();
 UIGraphicsEndImageContext();

也会因为内存问题直接退出。

最后采用直接压缩像素的方法，此内存消耗很小，图片质量也可以保护的比较高（至少高过WX吧，哈哈哈...）

- (UIImage *)resizeScaleImage:(CGFloat)scale {
    
    CGSize imgSize = self.size;
    CGSize targetSize = CGSizeMake(imgSize.width * scale, imgSize.height * scale);
    NSData *imageData = UIImageJPEGRepresentation(self, 1.0);
    CFDataRef data = (__bridge CFDataRef)imageData;
    
    CFStringRef optionKeys[1];
    CFTypeRef optionValues[4];
    optionKeys[0] = kCGImageSourceShouldCache;
    optionValues[0] = (CFTypeRef)kCFBooleanFalse;
    CFDictionaryRef sourceOption = CFDictionaryCreate(kCFAllocatorDefault, (const void **)optionKeys, (const void **)optionValues, 1, &kCFTypeDictionaryKeyCallBacks, &kCFTypeDictionaryValueCallBacks);
    CGImageSourceRef imageSource = CGImageSourceCreateWithData(data, sourceOption);
    CFRelease(sourceOption);
    if (!imageSource) {
        NSLog(@"imageSource is Null!");
        return nil;
    }
    //获取原图片属性
    int imageSize = (int)MAX(targetSize.height, targetSize.width);
    CFStringRef keys[5];
    CFTypeRef values[5];
    //创建缩略图等比缩放大小，会根据长宽值比较大的作为imageSize进行缩放
    keys[0] = kCGImageSourceThumbnailMaxPixelSize;
    CFNumberRef thumbnailSize = CFNumberCreate(NULL, kCFNumberIntType, &imageSize);
    values[0] = (CFTypeRef)thumbnailSize;
    keys[1] = kCGImageSourceCreateThumbnailFromImageAlways;
    values[1] = (CFTypeRef)kCFBooleanTrue;
    keys[2] = kCGImageSourceCreateThumbnailWithTransform;
    values[2] = (CFTypeRef)kCFBooleanTrue;
    keys[3] = kCGImageSourceCreateThumbnailFromImageIfAbsent;
    values[3] = (CFTypeRef)kCFBooleanTrue;
    keys[4] = kCGImageSourceShouldCacheImmediately;
    values[4] = (CFTypeRef)kCFBooleanTrue;
    
    CFDictionaryRef options = CFDictionaryCreate(kCFAllocatorDefault, (const void **)keys, (const void **)values, 4, &kCFTypeDictionaryKeyCallBacks, &kCFTypeDictionaryValueCallBacks);
    CGImageRef thumbnailImage = CGImageSourceCreateThumbnailAtIndex(imageSource, 0, options);
    UIImage *resultImg = [UIImage imageWithCGImage:thumbnailImage];
    
    CFRelease(thumbnailSize);
    CFRelease(options);
    CFRelease(imageSource);
    CFRelease(thumbnailImage);
    
    return resultImg;
}

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 *)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;
}