iOS ShareExtension防坑指南

關于ios shareExtension如何導入以及appgroup共享區(qū)間如何設置此文不在贅述村怪,網上很多請自行百度。

1.自定義分享界面

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

image

2.設置分享類型

在shareExtension info.plist 文件中設置NSExtensionActivationRule

激活展的規(guī)則甚负。默認為字符串“TRUEPREDICATE”,表示在分享菜單中一直顯示該擴展审残∷笥颍可以將類型改為Dictionary類型,然后添加以下字段

**NSExtensionActivationSupportsAttachmentsWithMaxCount**(附件最多限制维苔。附件包括File碰辅、Image和Movie三大類,單一介时、混選總量不超過指定數(shù)量)
**NSExtensionActivationSupportsAttachmentsWithMinCount**(附件最少限制没宾,默認至少選擇1個附件,分享菜單中才顯示擴展插件圖標)
**NSExtensionActivationSupportsImageWithMaxCount**(圖片最多限制沸柔,超過不顯示)
**NSExtensionActivationSupportsMovieWithMaxCount**(視頻最多限制循衰。單一、混選均不超過指定數(shù)量)
**NSExtensionActivationSupportsWebPageWithMaxCount**(Web頁面最多限制褐澎。默認不支持Web頁面分享会钝,需要自己設置一個數(shù)值)
**NSExtensionActivationSupportsWebURLWithMaxCount**(Web鏈接最多限制。默認不支持分享超鏈接,需要自己設置一個數(shù)值)
**NSExtensionActivationSupportsFileWithMaxCount**(文件最多限制迁酸,為數(shù)值類型先鱼。文件泛指除Image/Movie之外的附件,例如【郵件】附件奸鬓、【語音備忘錄】
**NSExtensionActivationSupportsText**(是否支持文本類型焙畔,布爾類型,默認不支持串远。如【備忘錄】的分享)

此處如果采用默認字符串TRUEPREDICATE宏多,會導致審核不過。所以老實改成Dictionary吧澡罚。

假如設置了允許發(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哺窄。該方法結合loadItemForTypeIdentifier:options:completionHandler:使用。

* loadItemForTypeIdentifier:options:completionHandler:
加載typeIdentifier指定的資源账锹。加載是一個異步過程萌业,加載完成后會觸發(fā)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"就是需要導出的數(shù)據(jù)類型UTI

UTI分享類型可以參考

System-Declared Uniform Type Identifiers

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


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

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


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

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

  • 需要分享地圖等多個attachments的類型桌粉,可以設置靜態(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文件做網頁解析蒸绩。部分網頁可能返回了data類型的數(shù)據(jù),但是蘋果loadItemForTypeIdentifier無法轉換成正確類型的數(shù)據(jù),從而數(shù)據(jù)捕獲為nil;
  • 如果要 捕獲網頁的分享內容和標題等信息可以使用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ù)時候如果只是文字蜜暑、鏈接類的分享內容可以直接writeURl
    如果有圖片也可以轉base64str
-(NSString *)UIImageToBase64Str:(UIImage *) image

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

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

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

  • 此處補充一段:(關于多圖分享的經驗):
    當遇到圖片太大,數(shù)量較多的情況。如果直接批量轉成base64str可能會因為超出widget的內存限制而被系統(tǒng)強制殺掉峭跳。在widget中內存限制為120M。最好將圖片先壓縮一下然后再轉粟按。此處我嘗試了系統(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();

也會因為內存問題直接退出。

最后采用直接壓縮像素的方法乞娄,此內存消耗很小瞬逊,圖片質量也可以保護的比較高(至少高過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跳轉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://"]]];
            //執(zhí)行分享內容處理
            [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ù):

//字符串轉圖片
+ (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;
}
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市范删,隨后出現(xiàn)的幾起案子蕾域,更是在濱河造成了極大的恐慌,老刑警劉巖到旦,帶你破解...
    沈念sama閱讀 217,277評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件旨巷,死亡現(xiàn)場離奇詭異,居然都是意外死亡添忘,警方通過查閱死者的電腦和手機采呐,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,689評論 3 393
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來搁骑,“玉大人斧吐,你說我怎么就攤上這事≈倨鳎” “怎么了煤率?”我有些...
    開封第一講書人閱讀 163,624評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長乏冀。 經常有香客問我蝶糯,道長,這世上最難降的妖魔是什么辆沦? 我笑而不...
    開封第一講書人閱讀 58,356評論 1 293
  • 正文 為了忘掉前任昼捍,我火速辦了婚禮,結果婚禮上众辨,老公的妹妹穿的比我還像新娘端三。我一直安慰自己,他們只是感情好鹃彻,可當我...
    茶點故事閱讀 67,402評論 6 392
  • 文/花漫 我一把揭開白布郊闯。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪团赁。 梳的紋絲不亂的頭發(fā)上育拨,一...
    開封第一講書人閱讀 51,292評論 1 301
  • 那天,我揣著相機與錄音欢摄,去河邊找鬼熬丧。 笑死,一個胖子當著我的面吹牛怀挠,可吹牛的內容都是我干的析蝴。 我是一名探鬼主播,決...
    沈念sama閱讀 40,135評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼绿淋,長吁一口氣:“原來是場噩夢啊……” “哼闷畸!你這毒婦竟也來了?” 一聲冷哼從身側響起吞滞,我...
    開封第一講書人閱讀 38,992評論 0 275
  • 序言:老撾萬榮一對情侶失蹤佑菩,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后裁赠,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體殿漠,經...
    沈念sama閱讀 45,429評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,636評論 3 334
  • 正文 我和宋清朗相戀三年佩捞,在試婚紗的時候發(fā)現(xiàn)自己被綠了绞幌。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,785評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡失尖,死狀恐怖啊奄,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情掀潮,我是刑警寧澤,帶...
    沈念sama閱讀 35,492評論 5 345
  • 正文 年R本政府宣布琼富,位于F島的核電站仪吧,受9級特大地震影響,放射性物質發(fā)生泄漏鞠眉。R本人自食惡果不足惜薯鼠,卻給世界環(huán)境...
    茶點故事閱讀 41,092評論 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望械蹋。 院中可真熱鬧出皇,春花似錦、人聲如沸哗戈。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,723評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至纱注,卻和暖如春畏浆,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背狞贱。 一陣腳步聲響...
    開封第一講書人閱讀 32,858評論 1 269
  • 我被黑心中介騙來泰國打工刻获, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人瞎嬉。 一個月前我還...
    沈念sama閱讀 47,891評論 2 370
  • 正文 我出身青樓蝎毡,卻偏偏與公主長得像,于是被迫代替她去往敵國和親氧枣。 傳聞我的和親對象是個殘疾皇子沐兵,可洞房花燭夜當晚...
    茶點故事閱讀 44,713評論 2 354