iOS通过UIActivityViewController实现原

作者: KingWorld | 来源:发表于2021-06-24 13:54 被阅读0次

首先要说的是，为什么如此多的分享平台，可以直接集成各个平台的分享功能，还要来实现系统原生的分享功能。没办法，分享功能被微信大大禁用了，设计诱导用户分享，那就只能绕一个圈将内容分享出去，并且还不会影响现在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。

当弹出视图框的时候，我们发现上边很多图标是我们用不到，我们可以将用不到的图标去掉，用到的函数是

 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实现分享详解

iOS通过UIActivityViewController实现原

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读