一.概述
ShareSDK是一个封装了微博,QQ,微信等40多个平台登录和分享功能的第三方库,他可以支持分享文字,图片,链接等常见格式,微博还可以分享linkcard卡片模式,微信分享小程序以及打开小程序等功能。功能非常之强大。使用此SDK可以节省开发的成本,节省开发时间,更方便的是如果有不了解的可以得到他们的技术的一对一解答,不知道你们是怎么样的,反正我经历过其他第三方平台的洗礼,只能说他们那边的服务真心不咋样,解答效率,态度实在与ShareSDK没法比。下面来跟我了解下他们的集成吧!
二.使用
1.准备工作
(1)申请ShareSDK的AppKey以及第三方平台的AppKey
ShareSDK的AppKey直接到Mob官网申请即可,具体的注册应用的流程请参考这里:Mob创建应用流程
(2)其他第三方平台的AppKey需要到对应的第三方平台注册应用申请:
新浪微博请参考:新浪微博注册流程
QQ请参考:QQ注册流程
微信请参考:微信注册流程
2.下载SDK
点击 这里下载
下载的时候根据自己需求选择需要的平台,我这里选择的是默认分享视图,只测试微博,微信,QQ。
下载之后解压出来如下,我们需要导入项目的是这整个SDK资源文件:
3.开始集成
(1)将上面下载的SDK文件夹拖进Xcode项目里,如下图:
注意:直接拖SDK进去请务必在上述步骤中选择“Create groups ”单选按钮组。如果你选择“Create folder references”,一个蓝色的文件夹引用将被添加到项目并且将无法找到它的资源。
(2)添加依赖库,添加步骤如下图:
必须添加的依赖库如下(Xcode 7 之后 .dylib库后缀名更改为.tbd):
libc++.tbd
libz.tbd
libsqlite3.tbd
以下依赖库根据社交平台添加:
新浪微博SDK依赖库
ImageIO.framework
Photos.framework
QQ好友和QQ空间SDK依赖库
libsqlite3.tbd
微信SDK依赖库
libsqlite3.tbd
(3)设置ShareSDK的Appkey
i.在项目工程的Info.plist 中如图增加 MOBAppKey 和 MOBAppSecret 两个字段
在 MOBAppKey中 设置ShareSDK的appKey,MOBAppSecret中 设置ShareSDK的appSecret,如下图:
(4)调用初始化方法初始化对应的第三方社交平台
i.打开XXXAppDelegate.m(XXX代表你的工程名字)导入头文件
#import <ShareSDK/ShareSDK.h>
ii.在- (BOOL)application: didFinishLaunchingWithOptions:方法中调用registPlatforms方法来初始化
[ShareSDK registPlatforms:^(SSDKRegister *platformsRegister) {
//QQ
[platformsRegister setupQQWithAppId:@"100371282" appkey:@"aed9b0303e3ed1e27bae87c33761161d"];
//微信
[platformsRegister setupWeChatWithAppId:@"wx617c77c82218ea2c" appSecret:@"c7253e5289986cf4c4c74d1ccc185fb1" universalLink:@"https://www.sandslee.com/"];
//新浪
[platformsRegister setupSinaWeiboWithAppkey:@"568898243" appSecret:@"38a4f8204cc784f81f9f0daaf31e02e3" redirectUrl:@"http://www.sharesdk.cn"];
}];
return YES;
}
(5)添加分享代码
i.需要在分享的视图中导入的头文件
#import <ShareSDK/ShareSDK.h>
#import <ShareSDKUI/ShareSDK+SSUI.h>
ii.调用构造分享参数接口和分享的接口
//1、创建分享参数**
NSMutableDictionary *shareParams = [NSMutableDictionary dictionary];
[shareParams SSDKSetupShareParamsByText:@"分享内容"
images:[[NSBundle mainBundle] pathForResource:@"COD13" ofType:@"jpg"]
url:[NSURL URLWithString:@"http://mob.com"]
title:@"分享标题"
type:SSDKContentTypeAuto];
//2、分享(可以弹出我们的分享菜单和编辑界面)**
[ShareSDK showShareActionSheet:nil //(第一个参数要显示菜单的视图, iPad版中此参数作为弹出菜单的参照视图,在ipad中要想弹出我们的分享菜单,这个参数必须要传值,可以传自己分享按钮的对象,或者可以创建一个小的view对象去传,传值与否不影响iphone显示)
customItems:nil
shareParams:shareParams
sheetConfiguration:nil
onStateChanged:^(SSDKResponseState state,
SSDKPlatformType platformType,
NSDictionary *userData,
SSDKContentEntity *contentEntity,
NSError *error,
BOOL end)
switch (state) {
case SSDKResponseStateSuccess:
{
NSLog(@"分享成功");
break;
}
case SSDKResponseStateFail:
{
NSLog(@"分享失败~~%@",error.description);
break;
}
default:
break;
}
}
];
(6)如果需要授权登录功能,可以调用以下接口
#import <ShareSDK/ShareSDK.h>
[ShareSDK authorize:SSDKPlatformTypeWechat settings:nil onStateChanged:^(SSDKResponseState state, SSDKUser *user, NSError *error) {
switch (state) {
case SSDKResponseStateSuccess:
NSLog(@"%@",[user.credential rawData]);
break;
case SSDKResponseStateFail:
{
NSLog(@"--%@",error.description);
//失败
break;
}
case SSDKResponseStateCancel:
//用户取消授权
break;
default:
break;
}
}];
(7)配置平台的URL Scheme
i.微信的URL Scheme的配置就是微信开放平台注册应用获取得到的AppID,在URL Types中添加微信AppID 即可;
ii.微博的URL Scheme的配置就是微博开放平台注册应用获取到的Appkey,并在前面加wb前缀,格式为wb+AppKey;
iii.QQ的URL Scheme的配置就是腾讯开放平台注册应用获取到的AppID,并且转成十六进制,另外在前面加QQ前缀,格式为:QQ+ AppId的16进制(如果appId转换的16进制数不够8位则在前面补0,如转换的是:5FB8B52,则最终填入为:QQ05FB8B52 ,则最终填入为:QQ05FB8B52 注意:转换后的字母要大写)那么如何转换的,这个可以在网上找一个在线十进制转十六进制的转换器进行转换就可以,例如http://www.sojson.com/hexconvert.html
具体配置见下图:
(6)配置平台的白名单
在iOS 9下涉及到平台客户端跳转,系统会自动到项目info.plist下检测是否设置平台Scheme。对于需要配置的平台,如果没有配置,就无法正常跳转平台客户端。因此要支持客户端的分享和授权等,需要配置Scheme名单。
具体方法:
1)、在项目的info.plist中添加一LSApplicationQueriesSchemes,类型为Array。
2)、然后给它添加一个需要支持的项目,类型为字符串类型;
各平台****OpenURL****白名单说明
新浪微博
sinaweibo
sinaweibohd
sinaweibosso
sinaweibohdsso
weibosdk
weibosdk2.5
微信
weixin
weixinULAPI
mqzoneopensdk,
mqzoneopensdkapi
mqzoneopensdkapi19
mqzoneopensdkapiV2
mqqOpensdkSSoLogin
mqqopensdkapiV2
mqqopensdkapiV3
wtloginmqq2
mqqapi
mqqwpa
mqzone
mqq
mqqopensdkapiV4
(7)另外一些相关配置
**1)新浪微博,微信SDK都需要在项目的Build Settings中的Other Linker Flags添加”-ObjC”,如果不配置有可能会崩溃。步骤如下: **
2)新浪微博网页授权分享需要暂时退回到http协议。步骤如下:
具体方法:
在项目的info.plist中添加一个Key:App Transport Security Settings,类型为字典类型。
然后给它添加一个Key:Allow Arbitrary Loads,类型为Boolean类型,值为YES;
3)新浪微博客户端分享还需要在plist文件里添加隐私权限配置:相册权限:Privacy - Photo Library Usage Description ,如下图:
4)微信,qq注册应用的时候都需要配置universalLink,也需要同时在XCode项目里配置,如下图:
以上就是完整的集成步骤,到这里就结束了!很简单的吧!