iOS通过UIActivityViewController实现原生分享功能

首先要说的是,为什么如此多的分享平台,可以直接集成各个平台的分享功能,还要来实现系统原生的分享功能。没办法,分享功能被微信大大禁用了,设计诱导用户分享,那就只能绕一个圈将内容分享出去,并且还不会影响现在APP的功能(分享就会得到报酬 ),UIActivityViewController就出来了,这是系统所带的原生的分享功能,在相册中我们肯定经常使用,可以将图片视频直接分享至我们需要的平台,或者保存至系统的剪切板,备忘录等。
1.简单实现

 NSString *textToShare = @"要分享的文本内容"; 

UIImage *imageToShare = [UIImage imageNamed:@"iosshare.jpg"]; 

NSURL *urlToShare = [NSURL URLWithString:@"http://www.baidu.com"];

 NSArray *activityItems = @[textToShare, imageToShare, urlToShare];

 UIActivityViewController *activityVC = [[UIActivityViewController alloc]initWithActivityItems:activityItems applicationActivities:nil];

举例

模拟器截图所有没有微信图标。

2.参数介绍
activityItems是要分享的内容,包括图片、图片、网址。
但是在此要注意的是不是所有平台都支持这三种内容的分享,例如微信,不能同时分享图片和网址,文字不能直接往外分享,下图是几个平台分享概略

image

第二个参数是一个UIActivity对象的数组,代表了应用程序支持的自定义服务。这个参数可以是nil。

  1. 当弹出视图框的时候,我们发现上边很多图标是我们用不到,我们可以将用不到的图标去掉,用到的函数是
 activityVC.excludedActivityTypes = @[UIActivityTypePostToFacebook,UIActivityTypePostToTwitter, UIActivityTypePostToWeibo,UIActivityTypeMessage,UIActivityTypeMail,UIActivityTypePrint,UIActivityTypeCopyToPasteboard,UIActivityTypeAssignToContact,UIActivityTypeSaveToCameraRoll,UIActivityTypeAddToReadingList,UIActivityTypePostToFlickr,UIActivityTypePostToVimeo,UIActivityTypePostToTencentWeibo,UIActivityTypeAirDrop,UIActivityTypeOpenInIBooks];

以上是将能去掉的都隐藏,以上都是系统默认的功能。
实现到这我们发现,其实这个功能可以分为两大类,操作和分享,在分享类中,我们可以分享到我们三方平台,还可以分享到系统的相册等平台,在操作类中,我们可以发现我们可以将文字等保存至剪贴板,消息等。
4.分享之后的回调
回调有两个函数,先说第一个

 UIActivityViewControllerCompletionHandler myBlock = ^(NSString *activityType,BOOL completed) { 

 NSLog(@"activityType :%@", activityType); 

 if (completed)  {   

 NSLog(@"completed");
  }  
else  {
   NSLog(@"cancel"); 
 } 

completionHandler,当post结束之后(无论是done还是cancell)该blog都会被调用
 activityVC.completionHandler = myBlock;

还有一个回调

typedef void (^UIActivityViewControllerCompletionWithItemsHandler)(UIActivityType __nullable activityType, BOOL completed, NSArray * __nullable returnedItems, NSError * __nullable activityError);

returnedItems是一个包含NSExtensionItem对象的数组;activityError指出出错原因
当我们分享成功或者分项取消的时候,都活调用block函数
activityType:是分享到什么平台,如果是系统的平台,会打印系统枚举类中的名字,微信等三方平台会打印com.tencent.xin.sharetimeline
成功后completed为YES否则为NO。我们在成功后或者失败后调用我们需要执行的代码。
5.补充
UIActivity可以自定义,上边的图标以及按钮可以自己进行自定义,也可以实现与各大分享平台的对接。暂时没有用到,因此没有具体实现。

简单的实现功能就是如此,学习中,与君共勉。


我们在使用系统分享的时候,会发现有些平台系统分享是不支持的,比如你想分享到四个平台,系统支持三个,另一个不支持。这个时候我们可以通过自定义UIActivity将另一个平台加到系统分享中。

UIActivity是个抽象类,我们需要继承他,实现他定义的方法。我们以分到Instagram为例,详细的说明具体实现过程。先来看一下效果,这里有两个Instagram,一个是系统的,一个是我自定义的(我这个图片是随便找的),点击之后都能成功分享到Instagram。

直接上代码,每一处我都写了注释:

.h文件

// 设定一个类型
UIKIT_EXTERN UIActivityType const UIActivityTypeShareToInstagram;

NS_ASSUME_NONNULL_BEGIN
@interface InstagramActivity : UIActivity

@end
NS_ASSUME_NONNULL_END

.m文件

#import "InstagramActivity.h"

UIActivityType const UIActivityTypeShareToInstagram = @"com.report.activity.ShareToInstagarm"; // 格式抄的苹果的

@interface InstagramActivity ()
@property (nonatomic, strong) NSString *dataURL; // 分享数据URL
@end

@implementation InstagramActivity

// 用来判断是什么Activity类型
- (NSString *)activityType{
    return UIActivityTypeShareToInstagram;
}

// 决定在UIActivityViewController中显示的位置,最上面是AirDrop,中间是Share,下面是Action
+ (UIActivityCategory)activityCategory{
    return UIActivityCategoryShare;
}

// 显示的Title
- (NSString *)activityTitle{
    return @"Instagram";
}

// 显示的图标
- (UIImage *)activityImage{
    /*
    For iPhone and iPod touch, images on iOS 7 should be 60 by 60 points; on earlier versions of iOS, you should use images no larger than 43 by 43 points. For iPad, images on iOS 7 should be 76 by 76 points; on earlier versions of iOS you should use images no larger than 60 by 60 points. On a device with Retina display, the number of pixels is doubled in each direction.
     */
    if ([[UIDevice currentDevice].model isEqualToString:@"iPad"]) {
         return [UIImage imageNamed:@"instagram_76x76"];
    }else{
        return [UIImage imageNamed:@"instagram_60x60"];
    }
}

#pragma mark   -  数据处理
// 根据item的不同类型判断是否显示
- (BOOL)canPerformWithActivityItems:(NSArray *)activityItems{

    // 我们要实现的instagram分享,只支持图片  (如果是微信,还要判断是否安装微信)
    BOOL support = NO;
    for (id obj in activityItems) {
        if ([obj isKindOfClass:UIImage.class]) {
            support = YES;
        }
        // 有一个支持就取消遍历
        if (support) break;
    }
    return support;
}


- (void)prepareWithActivityItems:(NSArray *)activityItems{

    // 点击动作即将执行的准备阶段, 可以用来处理一下值或者逻辑, items就是要传输的数据
    for (id obj in activityItems) {

        if([obj isKindOfClass:UIImage.class]){
            // 获取图片的URL
            [self getImageURLWithImage:obj complete:^(NSString *text) {
                 self.dataURL = text;
            }];

            break; // 只支持分享一张, 这里直接跳出循环
        }
    }
}


#pragma mark   -  事件处理
// 点击UIActivity的动作消息,处理点击后的相应逻辑, 没有自定义的UIViewController才会调用此方法, 需要在最后消除掉UIActivityviewController
- (void)performActivity{
    NSString *instagramURL = nil;

    instagramURL = [NSString stringWithFormat:@"instagram://library?AssetPath=%@&InstagramCaption=",self.dataURL.length ? self.dataURL:@"assets-library"];

    if ([[UIApplication sharedApplication] canOpenURL:instagramURL.url]) {
        [[UIApplication sharedApplication] openURL:instagramURL.url];
    }
    else{
        AlertView *alert = [[AlertView alloc] initWithContent:@"You didn't install \"Instagram\",Please try again after install \"Instagram\""];
        alert.singleButton = YES;
        [alert show];
    }
    [self activityDidFinish:YES];
}


// 获取图片的URL 与本文关系不大,可以忽略
- (void)getImageURLWithImage:(UIImage *)image complete:(StringBlock)complete{

    if (!image) return;

    // 先保存到相册
    [LGImageManager saveImage:image completion:^(NSError *error) {

        // 其实分享的URL直接用 instagram://library?AssetPath=assets-library ins会自动帮我们获取相册最后一张图片,我们只需要保存一下就OK了

        if (TARGET_IPHONE_SIMULATOR == 1 && TARGET_OS_IPHONE == 1) {return;}

        // 从相册获取最后一张图片资源
        PHAsset *asset = [LGImageManager getAllAssetInPhotoAlbumWithAscending:NO allowSelectVideo:NO allowSelectImage:YES allowSelectGif:NO allowSelectLivePhoto:NO limitCount:1].firstObject;

        NSString *imageURL = [NSString stringWithFormat:@"file:///var/mobile/Media/%@/%@",[asset valueForKey:@"directory"],[asset valueForKey:@"filename"]];
        if (complete && imageURL) complete(imageURL);
    }];
}

@end

已经自定义了InstagramActivity,下面说说使用

- (void)shareToInstagram{
    
    // 分享的内容: 一张图片
    NSArray *activityItems = @[[UIImage imageNamed:@"share_content"]];
    // 创建一个InstagramActivity对象 放在数组里,也可以添加其他的类型
    NSArray *activities = @[[InstagramActivity new]];

    UIActivityViewController *activityVC = [[UIActivityViewController alloc] initWithActivityItems:activityItems applicationActivities:activities];
    // 执行performActivity方法之后的回调
    activityVC.completionWithItemsHandler = ^(UIActivityType  _Nullable activityType, BOOL completed, NSArray * _Nullable returnedItems, NSError * _Nullable activityError) {
        // do something
    };
    if ([[UIDevice currentDevice].model isEqualToString:@"iPad"]) {
        activityVC.modalInPopover = true;

        activityVC.popoverPresentationController.sourceView = self.view;
        activityVC.popoverPresentationController.sourceRect = CGRectMake([UIScreen mainScreen].bounds.size.width * 0.5,self.view.bounds.size.height, 1.0, 1.0);
    }
    [self presentViewController:activityVC animated:YES completion:nil];
}

要成功调起Instagram,需要在info.plist文件中添加白名单。右击info.plist->Opne as->Source Code,然后加上下面代码

    <key>LSApplicationQueriesSchemes</key>
    <array>
        <string>instagram</string>
    </array>
    <key>NSPhotoLibraryAddUsageDescription</key>
    <string>We need to access your album to save picture</string>
    <key>NSPhotoLibraryUsageDescription</key>
    <string>We need to access your album to get pictures</string>

参考:iOS通过UIActivityViewController实现原生分享功能
iOS自定义UIActivity实现分享详解

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,539评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,911评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,337评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,723评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,795评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,762评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,742评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,508评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,954评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,247评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,404评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,104评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,736评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,352评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,557评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,371评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,292评论 2 352

推荐阅读更多精彩内容