iOS开发中活动视图控制器UIActivityViewController的应用

iOS开发中活动视图控制器UIActivityViewController的应用

    在iOS开发中，UIActivityViewController经常使用来弹出分享面板，其实除了用来社会化分享，UIActivityViewController还有一大应用是用来进行自定义行为。先看以下示例代码：

//活动内容
    NSString * content = @"活动的内容";
    //活动的url
    NSURL * url = [NSURL URLWithString:@"https://www.baidu.com"];
    //活动的图片
    UIImage * image = [UIImage imageNamed:@"ios"];
    UIActivityViewController * con = [[UIActivityViewController alloc]initWithActivityItems:@[content,url,image] applicationActivities:nil];
    //活动行为结束后回调的block
    con.completionWithItemsHandler = ^(UIActivityType activityType, BOOL completed, NSArray * returnedItems, NSError * __nullable activityError){
        NSLog(@"%@\n%@",activityType,returnedItems);
    };
    [self presentViewController:con animated:YES completion:nil];

活动面板以下图：

须要注意，活动面板能够分为3个部分，最上面为AirDrop传输功能，中间为分享相关功能，最下面为数据处理功能。UIActivityViewController继承自UIViewController，类解析以下：

//初始化方法
- (instancetype)init;
- (instancetype)initWithNibName:(nullable NSString *)nibNameOrNil bundle:(nullable NSBundle *)nibBundleOrNil;
- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder;
/*
activityItems参数用来设置活动数据数组，其中能够是任意类型的对象，可是只有能够处理这些数据的行为会被展现出来
applicationActivitie参数能够设置自定义的操做行为，后面会介绍
*/
- (instancetype)initWithActivityItems:(NSArray *)activityItems applicationActivities:(nullable NSArray<__kindof UIActivity *> *)applicationActivitie;
/*
活动行为结束后执行的回调block，其中参数以下：
typedef void (^UIActivityViewControllerCompletionWithItemsHandler)(UIActivityType __nullable activityType, BOOL completed, NSArray * __nullable returnedItems, NSError * __nullable activityError);
activityType:活动的类型
completed:活动是否完成
returnItems:扩展程序返回的数据
*/
@property(nullable, nonatomic, copy) UIActivityViewControllerCompletionWithItemsHandler completionWithItemsHandler;
//这个参数能够设置不被显示的活动类型
@property(nullable, nonatomic, copy) NSArray<UIActivityType> *excludedActivityTypes;

//下面这些方法在iOS8后被弃用 在iOS6-iOS8以前可用
//设置活动行为结束后回调的block
/*
typedef void (^UIActivityViewControllerCompletionHandler)(UIActivityType __nullable activityType, BOOL completed);
*/
@property(nullable, nonatomic, copy) UIActivityViewControllerCompletionHandler completionHandler;

上面初始化方法中有提到activityItems这个参数，系统提供的一些分享与活动行为可支持的数据类型列表以下：

    系统提供了一些活动类型，例如分享到微博、脸书、进行添加提示、发送信息等，系统提供的活动类型列举以下(UIActivityType实际上就是NSString*)：

UIActivityType const UIActivityTypePostToFacebook;//脸书
UIActivityType const UIActivityTypePostToTwitter;//推特
UIActivityType const UIActivityTypePostToWeibo;  // 微博
UIActivityType const UIActivityTypeMessage;//发送信息
UIActivityType const UIActivityTypeMail;//发送邮件
UIActivityType const UIActivityTypePrint;//打印
UIActivityType const UIActivityTypeCopyToPasteboard;//复制
UIActivityType const UIActivityTypeAssignToContact;//关联到联系人
UIActivityType const UIActivityTypeSaveToCameraRoll;//存照片
UIActivityType const UIActivityTypeAddToReadingList;//添加到提醒列表
UIActivityType const UIActivityTypePostToFlickr;//Flickr
UIActivityType const UIActivityTypePostToVimeo;//Vimeo
UIActivityType const UIActivityTypePostToTencentWeibo;//腾讯微博
UIActivityType const UIActivityTypeAirDrop;//AirDrop
UIActivityType const UIActivityTypeOpenInIBooks;//在IBooks中打开

    自定义活动行为须要建立继承于UIActivity类的子类，示例以下：

#import "CustomActivity.h"

@implementation CustomActivity
//设置活动类别
+(UIActivityCategory)activityCategory{
    return UIActivityCategoryShare;
}
//设置活动类型
-(UIActivityType)activityType{
    return @"Custom";
}
//设置活动标题
-(NSString *)activityTitle{
    return @"title";
}
//设置活动图标
-(UIImage *)activityImage{
    return [UIImage imageNamed:@"ios"];
}
//设置是否能够对指定的数据进行响应
-(BOOL)canPerformWithActivityItems:(NSArray *)activityItems{
    NSLog(@"%@",activityItems);
    return YES;
}
//为要响应的活动进行准备工做
- (void)prepareWithActivityItems:(NSArray *)activityItems{
    
}
//响应互动
-(void)performActivity{
    NSLog(@"=========");
    //活动处理完成后 必须调用activityDidFinish函数
    [self activityDidFinish:YES];
}

@end

用自定义的活动对UIActivityViewController进行初始化：

NSString * content = @"活动的内容";
    NSURL * url = [NSURL URLWithString:@"https://www.baidu.com"];
    UIImage * image = [UIImage imageNamed:@"ios"];
    CustomActivity * activity = [[CustomActivity alloc]init];
    UIActivityViewController * con = [[UIActivityViewController alloc]initWithActivityItems:@[content,url,image] applicationActivities:@[activity]];
    con.completionWithItemsHandler = ^(UIActivityType activityType, BOOL completed, NSArray * returnedItems, NSError * __nullable activityError){
        NSLog(@"%@\n%@",activityType,returnedItems);
    };
    [self presentViewController:con animated:YES completion:nil];

效果以下图所示：

    UIActivity类解析以下：

//子类实现，设置自定义活动的类别
/*
typedef NS_ENUM(NSInteger, UIActivityCategory) {
    UIActivityCategoryAction,//行为类别 显示在活动面板下面
    UIActivityCategoryShare,//分享类别，显示在活动面板中间
};
*/
+ (UIActivityCategory)activityCategory;
//子类实现 设置自定义活动的类型 返回字符串
- (nullable UIActivityType)activityType;
//子类实现 设置自定义活动的标题 返回字符串 
- (nullable NSString *)activityTitle;
//子类实现 设置自定义活动的图标 UIImage  
- (nullable UIImage *)activityImage; 
//子类实现 activityItems为活动数据数组 返回布尔值决定此活动是否能够响应这些数据
- (BOOL)canPerformWithActivityItems:(NSArray *)activityItems;
//子类实现 若是上面的方法返回YES，会接着执行这个方法，开发者能够作些活动处理的准备
- (void)prepareWithActivityItems:(NSArray *)activityItems;
//子类实现 返回一个视图控制器做为处理活动的模态视图 活动处理完成后须要调用activityDidFinish方法 
- (nullable UIViewController *)activityViewController; 
//子类实现 若是子类没有实现上一个方法 或者返回nil，则会执行这个方法来处理活动 活动处理完成后须要调用activityDidFinish方法
- (void)performActivity; 
//活动处理完成后须要调用这个方法 以后会通知UIActivityViewController执行活动完成后的回调block
- (void)activityDidFinish:(BOOL)completed;