目前支持分享到新浪微博、微信好友、微信朋友圈、QQ好用、QQ空间。还支持扩展自定义的分享按钮。
-
使用
cocoapods安装在
Podfile中加上下面这行：pod 'MaxShare'打开应用
终端，执行以下命令:$ cd your_project_dir $ pod install -
手动安装
-
克隆本仓库，仓库中包含源码(Source 目录)和打包好的 framework，你可以选一个添加到项目中
-
MaxShareDemo/Frameworks目录中有第三方平台的官方 SDK，把你需要的添加到项目中 -
添加依赖库
CoreTelephony
SystemConfiguration
libsqlite3
libc++
libzImageIO (Weibo SDK 依赖)
-
在 Target -> Build Settings -> Other Link Flags 中加上
-ObjC
-
MaxLeap 中用一个用户系统，可以使用第三方登录，认证信息保存在 MLUser 中。
MaxShare 不依赖于 MaxLeap, 不会自动使用 MLUser 中的第三方平台认证信息，也不会保存分享过程中的认证信息。
**重要：**在 微博应用 >> 应用信息 >> 高级信息 中填写自己应用的 bundleID
**重要：**在 微博应用 >> 应用信息 >> 高级信息 中仔细填写授权回调页和取消授权回调页地址。这个地址在集成微博 SDK 的时候需要用到。
如果集成了 MaxLeap 微博登录模块 MLWeiboUtils.framework，启动代码中应该包含了下面这行：
[MLWeiboUtils initializeWeiboWithAppKey:@"your_weibo_appKey" redirectURI:@"https://api.weibo.com/oauth2/default.html"];
调用这行代码以后，新浪微博分享环境已经初始化。
如果没有集成微博登录模块，则需要下面这行代码来初始化：
[WeiboSDK registerApp:@"your_weibo_appKey"];
// MaxShare 认证时会使用默认的 `redirectUrl`: https://api.weibo.com/oauth2/default.html
如果集成了 MaxLeap 微博登录模块 MLQQUtils.framework，启动代码中应该包含了下面这行：
[MLQQUtils initializeQQWithAppId:@"222222" qqDelegate:self];
调用这行代码以后，QQ 分享环境已经初始化，无需另外配置。
如果没有集成微博登录模块，则需要下面这行代码来初始化：
TencentOAuth *oauth = [[TencentOAuth alloc] initWithAppId:@"your_tecent_appId" andDelegate:delegate];
// 这个 oauth 对象会作用于全局，需要一直存在
首先需要前往微信开放平台，创建微信移动应用。
如果集成了 MaxLeap 微博登录模块 MLWeChatUtils.framework，启动代码中应该包含了下面这行代码：
[MLWeChatUtils initializeWeChatWithAppId:@"wx_appId" appSecret:@"wx_app_secret" wxDelegate:self];
调用这行代码以后，微信分享环境已经初始化，无需另外配置。
如果没有集成微博登录模块，则需要下面这行代码来初始化：
[WXApi registerApp:@"your_wx_appId"];
默认配置下，iOS 9 会拦截 http 协议的请求，并打印如下一行文字：
App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure. Temporary exceptions can be configured via your app's Info.plist file.
问题是，部分社交平台接口都使用 http 协议。而且，应用中也可能需要访问 http 协议的接口。
有一个简单粗暴的解决办法就是，允许所有的 http 请求：
1. 在项目的 info.plist 文件中添加一个字段：NSAppTransportSecurity，值为字典类型
2. 然后再在它下面添加一个字段：NSAllowsArbitraryLoads，值为 YES
WWDC 2016 中，苹果表示将继续收紧对 HTTP 接口的访问限制。从 2017 年 1 月 1 日起，所有新提交的应用不允许使用 NSAllowsArbitraryLoads 绕过 ATS 限制。最好保证应用中所有请求都是使用 HTTPS 协议，否则可能会在应用审核时遇到麻烦。MaxLeap iOS SDK 所有接口默认都使用 HTTPS 协议。
许多社交平台分享都需要跳转到它们的应用中进行，但是iOS 9 对 canOpenURL: 接口做了限制，导致许多社交平台的 SDK 无法正常跳转到对应的应用中进行分享。
解决办法如下：
-
在项目的 info.plist 中添加一个字段：LSApplicationQueriesSchemes，值类型为 Array
-
然后在这个数组中添加需要支持的 scheme，各平台的 scheme 列表如下：
平台 scheme 新浪微博 sinaweibo,
sinaweibohd,
sinaweibosso,
sinaweibohdsso,
weibosdk,
weibosdk2.5微信 wechat,
weixinQQ mqqOpensdkSSoLogin,
mqqopensdkapiV2,
mqqopensdkapiV3,
wtloginmqq2,
mqq,
mqqapiQQ空间 mqzoneopensdk,
mqzoneopensdkapi,
mqzoneopensdkapi19,
mqzoneopensdkapiV2,
mqqOpensdkSSoLogin,
mqqopensdkapiV2,
mqqopensdkapiV3,
wtloginmqq2,
mqqapi,
mqqwpa，
mqzone，
mqq
注：若同时使用QQ和QQ空间，则只添加本格中的即可
如果没有把平台的 scheme 添加到白名单中，系统会打印如下文字信息：
-canOpenURL: failed for URL: “sinaweibohdsso://xxx” – error: “This app is not allowed to query for scheme sinaweibohdsso”
按照上述方法，把 sinaweibohdsso 加入白名单即可。
注意: 腾讯 QQ 分享和微信分享需要安装相应的客户端，否则分享按钮不会出现。
分享需要创建一个 MLShareItem 对象，然后设置类型和相关数据。再按下分享按钮时，不受支持的数据会被忽略。
+ (void)shareItem:(MLShareItem *)item
withContainer:(nullable MaxSocialContainer *)container
completion:(MLSActivityViewControllerCompletionBlock)block;
该接口有三个参数：
item: 要分享的内容container: iPad 会使用这个参数让分享界面以 popover 的形式弹出来block: 用户按下分享按钮后，调用对应平台分享接口的情况，并不是分享结果
使用方法：
// 创建一个 MLShareItem 对象
MLShareItem *item = [MLShareItem itemWithMediaType:MLSContentMediaTypeText];
item.title = @"title";
item.detail = @"detail";
// 创建一个 MaxSocialContainer 对象
// 如果不需要支持 iPad，可以为空
MaxSocialContainer *container = [MaxSocialContainer containerWithBarButtonItem:sender];
[MaxSocialShare shareItem:item withContainer:container completion:^(MLSActivityType activityType, BOOL completed, NSError * _Nullable activityError) {
if (completed) {
// 调用分享接口成功
} else {
// ...
}
}];
-
分享文本
MLShareItem *textItem = [MLShareItem itemWithMediaType:MLSContentMediaTypeText]; // textItem.title = @"文字标题"; // optional, 目前 QQ, 微信，微博 都不支持 textItem.detail = @"文字内容"; // required [MaxSocialShare shareItem:textItem completion:^(MLSActivityType activityType, BOOL completed, NSError * _Nullable activityError) { NSLog(@"share activity (%d) completed: %d", activityType, completed); }]; -
分享图片
MLShareItem *imageItem = [MLShareItem itemWithMediaType:MLSContentMediaTypeImage]; imageItem.attachmentURL = imageUrl; // required，支持 fileURL 和 远程图片链接 imageItem.title = @"图片标题"; // optional, 只有QQ支持 imageItem.detail = @"图片描述"; // optional, 只有QQ支持 imageItem.previewImageData = preview; // optional, 只有QQ支持 [MaxSocialShare shareItem:imageItem completion:^(MLSActivityType activityType, BOOL completed, NSError * _Nullable activityError) { NSLog(@"share activity (%d) completed: %d", activityType, completed); }]; -
分享网页
MLShareItem *webpageItem = [MLShareItem itemWithMediaType:MLSContentMediaTypeWebpage]; // 腾讯，微博，微信都支持以下字段 webpageItem.title = @"网页标题"; webpageItem.detail = @"网页描述"; webpageItem.webpageURL = [NSURL URLWithString:@"网页地址"]; webpageItem.previewImageData = previewImageData; // 预览图 [MaxSocialShare shareItem:webpageItem completion:^(MLSActivityType activityType, BOOL completed, NSError * _Nullable activityError) { NSLog(@"share activity (%d) completed: %d", activityType, completed); }]; -
分享音乐
MLShareItem *musicItem = [MLShareItem itemWithMediaType:MLSContentMediaTypeMusic]; musicItem.title = @"音乐标题"; musicItem.detail = @"音乐描述"; musicItem.previewImageData = previewImageData; // 预览图 musicItem.attachmentURL = [NSURL URLWithString:@"音乐数据流地址"]; musicItem.webpageURL = [NSURL URLWithString:@"音乐网页地址"]; // 微博，微信支持，QQ不支持 [MaxSocialShare shareItem:musicItem completion:^(MLSActivityType activityType, BOOL completed, NSError * _Nullable activityError) { NSLog(@"share activity (%d) completed: %d", activityType, completed); }]; -
分享视频
MLShareItem *videoItem = [MLShareItem itemWithMediaType:MLSContentMediaTypeVideo]; // 以下字段三个平台都支持 videoItem.title = @"视频标题"; videoItem.detail = @"视频描述"; videoItem.previewImageData = previewImageData; // 预览图像 // 微信，微博支持，QQ 不支持 videoItem.webpageURL = [NSURL URLWithString:@"视频网页地址"]; // QQ, 微博支持，微信不支持 videoItem.attachmentURL = [NSURL URLWithString:@"视频数据流地址"]; [MaxSocialShare shareItem:videoItem completion:^(MLSActivityType activityType, BOOL completed, NSError * _Nullable activityError) { NSLog(@"share activity (%d) completed: %d", activityType, completed); }];
MaxSocialShare 支持类似 UIActivityViewController 的扩展方法，可以添加框架现在不支持的平台分享按钮。
扩展通过注册新的 MLSActivity 子类来实现，注册的 Activity 会在分享界面上添加一个按钮，这个按钮的行为由你定义。
下面我们添加一个自定义的分享按钮：
CustomActivity.h 文件:
#import <MaxSocialShare/MaxSocialShare.h>
@interface CustomActivity : MLSActivity
@end
CustomActivity.m 文件:
#import "CustomActivity.h"
// 定义 custom type，注意值不要和已有的重复了
MLSActivityType MLSActivityTypeCustom = 6;
@implementation CustomActivity
+ (MLSActivityType)type {
// 返回 CustomActivity 的类型，如果之前已经注册了跟 MLSActivityTypeCustom 类型值相同的 activity，则会覆盖它
return MLSActivityTypeCustom;
}
+ (BOOL)canPerformWithActivityItem:(MLShareItem *)activityItem {
// 检查 activityItem 来判断是否能处理它
return YES;
}
- (nullable NSString *)title {
// 分享按钮的标题
return @"Custom";
}
- (nullable UIImage *)image {
// 分享按钮的图片
return [UIImage imageNamed:@"custom_share_btn_icon"];
}
- (void)prepareWithActivityItem:(MLShareItem *)activityItem {
// 在这个方法里面对 activityItem 做一些预处理操作
}
- (void)perform {
// 做具体的分享操作
// 重要，操作完成后一定要调一下这个方法，传入错误表示分享操作失败，传入 nil 表示分享成功
[self activityDidFinishWithError:nil];
}
@end
**重要：**最后一步操作：注册 CustomActivity
[MLSActivity registerActivityClass:[CustomActivity class]];
推荐把这行代码写到 CustomActivity 类的 +load 方法中，这样，当 CustomActivity 类加载时，就会自动注册。
@implementation CustomActivity
+ (void)load {
[MLSActivity registerActivityClass:[CustomActivity class]];
}
@end
Souce 目录下放着 MaxSocial 模块的源码
MLShareItem: 一个 shareItem 代表了一条具体的分享内容
MLSActivityViewController: 展现分享界面的控制器，可以直接使用
MaxSocialShare: 包装了 MLSActivityViewController 的接口，使分享更容易使用
MLSActivity: 它的子类定义了分享按钮的图片，标题和行为
internal/: 该目录下是默认的分享按钮的实现