社会化分享作为iOS开发的必备技能,这里做一个方案总结,本文只讨论系统分享,不讨论第三方的分享方案。
一. UIActivityViewController
简介
UIActivityViewController是系统自带的分享弹窗,支持AirDrop和很多系统级别的数据传递功能,且自动判断系统上可调用的App。苹果已经完成了大部分的底层代码,暴露给开发者调用的API也很简单。界面效果如下:
可支持的分享数据类型:文本,图片,视频,链接,文档等。
优点:代码接入简单,功能强大,使用简单。
缺点:系统固定UI无法自定义,且弹出时间较慢,一般需要1到2秒甚至更久的等待时间(系统需要做一些数据处理)。
使用说明
方法
- -(instancetype)initWithActivityItems:(NSArray *)activityItems applicationActivities:(nullable NSArray<__kindof UIActivity *> *)applicationActivities
属性
- @property(nullable, nonatomic, copy) NSArray<UIActivityType> *excludedActivityTypes;
UIActivity代表服务对象,生成实例时提供一组UIActivity对象来提供自定义的服务。
UIActivityViewController *activity = [[UIActivityViewController alloc] initWithActivityItems:@[] applicationActivities:nil];
UIPopoverPresentationController *popover = activity.popoverPresentationController;
if (popover) {
popover.sourceView = self.shareView;
popover.permittedArrowDirections = UIPopoverArrowDirectionUp;
}
[self presentViewController:activity animated:YES completion:NULL];
excludedActivityTypes 用于指定不需要提供的服务,这个属性是一个数组,代表的是,如果我们不需要系统的某些服务就可以给它赋值, 这样UIActivityViewController就不会显示对应的服务,系统提供了以下服务:
UIActivityTypePostToFacebook
UIActivityTypePostToTwitter
UIActivityTypePostToWeibo
UIActivityTypeMessage
UIActivityTypeMail
UIActivityTypePrint
UIActivityTypeCopyToPasteboard
UIActivityTypeAssignToContact
UIActivityTypeSaveToCameraRoll
UIActivityTypeAddToReadingList
UIActivityTypePostToVimeo
UIActivityTypePostToTencentWeibo
UIActivityTypeAirDrop
UIActivityTypeOpenInIBooks
UIActivityTypeMarkupAsPDF
二.SLComposeViewController
很多时候,产品为了UI效果,常常需要自己设计一套分享的界面,比如知乎的分享界面。
这种方式的优点对于产品来说,可以实现路径控制。比如微信的分享就只能在其应用内分享,或者分享到腾讯的QQ,都是自家产品,不会将用户引入到其他app中,算是一种产品流量的竞争手段吧。
代码实现可以通过第三方分享,也可以调用系统的分享API。
优点:调用迅速,不用等待,立刻弹出,且UI可定制。通常也会在界面里提供系统分享的入口。
缺点:需要自己判断手机上哪些app可以被分享,代码实现稍复杂。
使用说明
引入<Social/Social.h>框架
我们看一下SLComposeViewController类提供的API
属性
- @property(nonatomic, readonly) NSString *serviceType //只 读属性 服务类型(比如微博,QQ,朋友圈等)
方法
- +(BOOL)isAvailableForServiceType:(NSString *)serviceType//该设备是否支持某项服务(比如支持分享到微信,如果设备未安装微信或者微信没有登录账号,则返回NO)
- +(SLComposeViewController )composeViewControllerForServiceType:(NSString)serviceType//实例方法 传入服务类型生成一个实例变量
- -(BOOL)setInitialText:(NSString *)text//分享的文字
- -(BOOL)addImage:(UIImage *)image//分享的图片
- -(BOOL)addURL:(NSURL *)url//分享的链接
关于SLComposeViewController生成实例的方法,需要注意的是iOS11.0之前,可以通过<Social/Social.h>框架提供的几种枚举类型来生成实例,这些枚举类型在11.0之后被遗弃了。
SLServiceTypeTwitter
SLServiceTypeFacebook
SLServiceTypeSinaWeibo
SLServiceTypeTencentWeibo
SLServiceTypeLinkedIn
SLComposeViewController *composeVc =[SLComposeViewController composeViewControllerForServiceType:SLServiceTypeSinaWeibo];
那11之后如何生成SLComposeViewController的实例?这时候我们需要Share Extension。什么是Share Extension?
在iOS 8的时候, 苹果开放了几个新特性, 其中一个就是Share Extension。它是苹果系统自带的社会化SDK。而SLComposeViewController支持调用所有的Share Extension。
以下是从网上找来的各个主流App的Share Extension
com.taobao.taobao4iphone.ShareExtension // 淘宝
com.apple.share.Flickr.post // Flickr
com.apple.share.SinaWeibo.post // 新浪微博
com.laiwang.DingTalk.ShareExtension // 钉钉
com.apple.mobileslideshow.StreamShareService // iCloud
com.alipay.iphoneclient.ExtensionSchemeShare // 支付宝
com.apple.share.Facebook.post // Facebook
com.apple.share.Twitter.post // Twitter
com.apple.Health.HealthShareExtension // 应该是健康管理
com.tencent.xin.sharetimeline // 微信(好友、朋友圈、收藏)
com.apple.share.TencentWeibo.post // 腾讯微博
com.tencent.mqq.ShareExtension // QQ
这样,我们就可以通过调用ShareExtension来创建SLComposeViewController实例了。
SLComposeViewController *composeVC = [SLComposeViewController composeViewControllerForServiceType:@"com.tencent.xin.sharetimeline"]
// 预设文字
[composeVC setInitialText:@"分享咯"];
// 预设图片
[composeVC addImage:[UIImage imageNamed:@"wxShareIcon"]];
// 网址
[composeVC addURL:[NSURL URLWithString:@"http://www.baidu.com"]];
[self presentViewController:composeVC animated:YES completion:nil];
其他
以上是关于社会化分享的方案总结。而通常分享功能也常常会加入一些其他的功能层面,比如复制到剪切板,通过邮件分享等等。这里也大概说一下。
UIPasteboard(剪切板)
关于类的简单使用:
UIPasteboard*pasteboard = [UIPasteboard generalPasteboard]; pasteboard.string = @"剪切复制的文字";
想详细了解剪切板使用的话,移步这篇文章:
//www.greatytc.com/p/a6d2e46329f8
MFMailComposeViewController(邮件分享)
使用说明
引入 <MessageUI/MessageUI.h>
我们看一下MFMailComposeViewController类提供的API
属性
- @property (nonatomic, nullable, assign) id<MFMailComposeViewControllerDelegate> mailComposeDelegate//代理
方法
- +(BOOL)canSendMail//设备是否支持发送邮件(一般判断是否已设置邮件账户)
- -(void)setSubject:(NSString *)subject//邮件主题
- -(void)setToRecipients:(nullable NSArray<NSString *> *)toRecipients//邮件接收账户 是个数组
- -(void)setCcRecipients:(nullable NSArray<NSString *> *)ccRecipients//添加抄送
- -(void)setBccRecipients:(nullable NSArray<NSString *> *)bccRecipients//添加密送
- -(void)setMessageBody:(NSString *)body isHTML:(BOOL)isHTML//邮件内容 支持html属性
- -(void)addAttachmentData:(NSData *)attachment mimeType:(NSString *)mimeType fileName:(NSString *)filename//添加附件 可以添加图片,文档等 先将附件转成NSData格式传入即可
if ([MFMailComposeViewController canSendMail]) { // 用户已设置邮件账户
if ([MFMessageComposeViewController canSendText] == YES) {
_mailComposer = [[MFMailComposeViewController alloc]init];
_mailComposer.mailComposeDelegate = self;
// 设置邮件主题
[_mailComposer setSubject:@"文章"];
// 如使用HTML格式,则为以下代码
NSString *bodyString = [NSString stringWithFormat:@"<span style='color:#999'>我使用印象笔记将这篇文章分享给你: </span> <a href='%@'> 点击查看全文 </a>",self.shareUrl];
[_mailComposer setMessageBody:bodyString isHTML:YES];
[self presentViewController:_mailComposer animated:YES completion:nil];
}else{
[MBProgressHUD showError:@"设备不支持!"];
}
}else{
[MBProgressHUD showError:@"未设置邮件账户!"];
}
MFMailComposeViewController的代理方法
- -(void)mailComposeController:(MFMailComposeViewController *)controller didFinishWithResult:(MFMailComposeResult)result error:(nullable NSError *)error//用于监听邮件功能调起后的状态
有四种枚举值状态
MFMailComposeResultCancelled
MFMailComposeResultSaved
MFMailComposeResultSent
MFMailComposeResultFailed
- (void)mailComposeController:(MFMailComposeViewController *)controller didFinishWithResult:(MFMailComposeResult)result error:(nullable NSError *)error{
[controller dismissViewControllerAnimated:YES completion:nil];
NSString *msg;
switch (result) {
case MFMailComposeResultCancelled:
msg = @"邮件发送取消";
break;
case MFMailComposeResultSaved:
msg = @"邮件保存成功";
break;
case MFMailComposeResultSent:
msg = @"邮件发送成功";
[MBProgressHUD showSuccess:msg];
break;
case MFMailComposeResultFailed:
msg = @"邮件发送失败";
[MBProgressHUD showError:msg];
break;
default:
break;
}
}