iOS ShareExtension防坑指南

關(guān)于ios shareExtension如何導(dǎo)入以及appgroup共享區(qū)間如何設(shè)置此文不在贅述,網(wǎng)上很多請自行百度。

1.自定義分享界面

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

image

2.設(shè)置分享類型

在shareExtension info.plist 文件中設(shè)置NSExtensionActivationRule

激活展的規(guī)則。默認為字符串“TRUEPREDICATE”,表示在分享菜單中一直顯示該擴展??梢詫㈩愋透臑镈ictionary類型,然后添加以下字段

**NSExtensionActivationSupportsAttachmentsWithMaxCount**(附件最多限制。附件包括File、Image和Movie三大類,單一、混選總量不超過指定數(shù)量)
**NSExtensionActivationSupportsAttachmentsWithMinCount**(附件最少限制,默認至少選擇1個附件,分享菜單中才顯示擴展插件圖標)
**NSExtensionActivationSupportsImageWithMaxCount**(圖片最多限制,超過不顯示)
**NSExtensionActivationSupportsMovieWithMaxCount**(視頻最多限制。單一、混選均不超過指定數(shù)量)
**NSExtensionActivationSupportsWebPageWithMaxCount**(Web頁面最多限制。默認不支持Web頁面分享,需要自己設(shè)置一個數(shù)值)
**NSExtensionActivationSupportsWebURLWithMaxCount**(Web鏈接最多限制。默認不支持分享超鏈接,需要自己設(shè)置一個數(shù)值)
**NSExtensionActivationSupportsFileWithMaxCount**(文件最多限制,為數(shù)值類型。文件泛指除Image/Movie之外的附件,例如【郵件】附件、【語音備忘錄】
**NSExtensionActivationSupportsText**(是否支持文本類型,布爾類型,默認不支持。如【備忘錄】的分享)

此處如果采用默認字符串TRUEPREDICATE,會導(dǎo)致審核不過。所以老實改成Dictionary吧。

假如設(shè)置了允許發(fā)送的數(shù)據(jù)類型:text、url、image、mp3、mp4、pdf、word、excel、ppt

image

3.獲取分享的數(shù)據(jù)

inputItems是包含NSExtensionItem類型對象的數(shù)組。

NSExtensionItem包含四個屬性:

image
* hasItemConformingToTypeIdentifier: 
用于判斷是否有typeIdentifier(UTI)所指定的資源存在。存在則返回YES,否則返回NO。該方法結(jié)合loadItemForTypeIdentifier:options:completionHandler:使用。

* loadItemForTypeIdentifier:options:completionHandler:
加載typeIdentifier指定的資源。加載是一個異步過程,加載完成后會觸發(fā)completionHandler。

* loadPreviewImageWithOptions:completionHandler:
加載資源的預(yù)覽圖片。

使用方法:

- (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"就是需要導(dǎo)出的數(shù)據(jù)類型UTI

UTI分享類型可以參考

System-Declared Uniform Type Identifiers

  • 這里有一個小技巧,還記得shareExtension info.plist 中的NSExtensionActivationRule嗎?如果解析數(shù)據(jù)不知道數(shù)據(jù)返回的UTI類型,比如百度地圖、高德地圖(item.attachments可能返回多個),可以先將NSExtensionActivationRule設(shè)置為默認字符串“TRUEPREDICATE”,這樣就可以斷點測試到item.attachments 獲取到數(shù)據(jù)的UTI,從而獲取數(shù)據(jù) 。
  • 這里除了loadItemForTypeIdentifier獲取主要信息外


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

還可以使用loadPreviewImageWithOptions獲取截圖(可能失敗,針對網(wǎng)頁獲取分享截圖好用)


- (void)loadPreviewImageWithOptions:(NSDictionary*)optionscompletionHandler:(NSItemProviderCompletionHandler)completionHandler;

  • 注意在loadItemForTypeIdentifier時獲取數(shù)據(jù)系統(tǒng)是在子線程操作,會有數(shù)據(jù)同步問題,需要做保護(dispatch_group或dispatch_semaphore_wait等等)。

  • 需要分享地圖等多個attachments的類型,可以設(shè)置靜態(tài)變量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文件做網(wǎng)頁解析。部分網(wǎng)頁可能返回了data類型的數(shù)據(jù),但是蘋果loadItemForTypeIdentifier無法轉(zhuǎn)換成正確類型的數(shù)據(jù),從而數(shù)據(jù)捕獲為nil;
  • 如果要 捕獲網(wǎng)頁的分享內(nèi)容和標題等信息可以使用attributedTitle、attributedContentText里面的信息。

4.數(shù)據(jù)分享

4.1 appgroup數(shù)據(jù)讀寫

1.NSUserDefaults
NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.company.appGroupName"];
//寫入數(shù)據(jù)
[userDefaults setValue:@"value" forKey:@"key"];
//讀取數(shù)據(jù)
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);
  • 這里在寫入數(shù)據(jù)時候如果只是文字、鏈接類的分享內(nèi)容可以直接writeURl
    如果有圖片也可以轉(zhuǎn)base64str
-(NSString *)UIImageToBase64Str:(UIImage *) image

{
    NSData *data = UIImageJPEGRepresentation(image, 1.0f);
    NSString *encodedImageStr = [data base64EncodedStringWithOptions:NSDataBase64Encoding64CharacterLineLength];
    return encodedImageStr;
}

  • 如果需要分享視頻或大文件類型,建議使用coreData。

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

  • 此處補充一段:(關(guān)于多圖分享的經(jīng)驗):
    當遇到圖片太大,數(shù)量較多的情況。如果直接批量轉(zhuǎn)成base64str可能會因為超出widget的內(nèi)存限制而被系統(tǒng)強制殺掉。在widget中內(nèi)存限制為120M。最好將圖片先壓縮一下然后再轉(zhuǎn)。此處我嘗試了系統(tǒng)的壓縮辦法
NSData*imageData=UIImageJPEGRepresentation(item, 0.2);

然而并不好用。使用drawInRect重繪圖片:

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

也會因為內(nèi)存問題直接退出。

最后采用直接壓縮像素的方法,此內(nèi)存消耗很小,圖片質(zhì)量也可以保護的比較高(至少高過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];
    //創(chuàng)建縮略圖等比縮放大小,會根據(jù)長寬值比較大的作為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跳轉(zhuǎn)app

設(shè)置主程序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://"]]];
            //執(zhí)行分享內(nèi)容處理
            [self.extensionContext completeRequestReturningItems:**nil** completionHandler:NULL];
        }
    }
}
  • 在主程序openurl中獲取appgroup數(shù)據(jù)
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options API_AVAILABLE(ios(9.0));

5.附贈一些可能用到的函數(shù):

//字符串轉(zhuǎn)圖片
+ (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;
}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容