前言
最近项目须要加入第三方分享功能,看了网上的一些第三方SDK的介绍,以为ShareSDK是一个很强大方便的第三方工具,因此选择了ShareSDK来完成。这里记录一下完整的集成与使用流程。
1.申请ShareSDK的AppKey以及第三方平台的AppKey
ShareSDK的AppKey直接到Mob官网申请便可,具体的注册应用的流程请参考这里:Mob建立应用流程
(我这里的Demo为了方便直接用了ShareSDK的Demo里面提供的AppKey,可是建立的项目Bundle id要和ShareSDK的Demo里一致。真实项目须要本身另外申请,这个大家本身参考下注册流程哈,按照步骤来走,怎么也得会的哈~~~~~~~~~~)
2.下载SDK
下载地址:http://www.mob.com/downloadDetail/ShareSDK/ios
下载的时候根据本身需求选择须要的平台,我这里选择的是默认分享视图,只测试微博,微信,QQ。
下载以后解压出来以下,咱们须要导入项目的是这整个SDK资源文件:
3.开始集成
(1)将上面下载的SDK文件夹拖进Xcode项目里,以下图:
注意:直接拖SDK进去请务必在上述步骤中选择“Create groups ”单选按钮组。若是你选择“Create folder references”,一个蓝色的文件夹引用将被添加到项目而且将没法找到它的资源。
(2)添加依赖库,添加步骤以下图:
必须添加的依赖库以下(Xcode 7 以后 .dylib库后缀名更改成.tbd):html
libz.dylib libstdc++.dylib JavaScriptCore.framework
如下依赖库根据社交平台添加:
新浪微博SDK依赖库ios
libsqlite3.dylib
QQ好友和QQ空间SDK依赖库c++
libsqlite3.dylib
微信SDK依赖库sql
libsqlite3.dylib
(3)设置ShareSDK的Appkey并调用初始化方法初始化对应的第三方社交平台
i.在项目工程的Info.plist 中如图增长 MOBAppKey 和 MOBAppSecret 两个字段
在 MOBAppKey中 设置ShareSDK的appKey,MOBAppSecret中 设置ShareSDK的appSecret,以下图:json
ii.打开AppDelegate.m(表明你的工程名字)导入头文件**api
#import <ShareSDK/ShareSDK.h> #import <ShareSDKConnector/ShareSDKConnector.h> //腾讯开放平台(对应QQ和QQ空间)SDK头文件 #import <TencentOpenAPI/TencentOAuth.h> #import <TencentOpenAPI/QQApiInterface.h> //微信SDK头文件 #import "WXApi.h" //新浪微博SDK头文件 #import "WeiboSDK.h"
iii.在- (BOOL)application: didFinishLaunchingWithOptions:方法中调用registerActivePlatforms方法来初始化微信
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {** // Override point for customization after application launch. [ShareSDK registerActivePlatforms:@[ @(SSDKPlatformTypeSinaWeibo), @(SSDKPlatformTypeWechat), @(SSDKPlatformTypeQQ)] onImport:^(SSDKPlatformType platformType) { switch (platformType) { case SSDKPlatformTypeWechat: [ShareSDKConnector connectWeChat:[WXApi class]]; break; case SSDKPlatformTypeQQ: [ShareSDKConnector connectQQ:[QQApiInterface class] tencentOAuthClass:[TencentOAuth class]]; break; case SSDKPlatformTypeSinaWeibo: [ShareSDKConnector connectWeibo:[WeiboSDK class]]; break; default: break; } } onConfiguration:^(SSDKPlatformType platformType, NSMutableDictionary *appInfo) { switch (platformType) { case SSDKPlatformTypeSinaWeibo: //设置新浪微博应用信息,其中authType设置为使用SSO+Web形式受权 [appInfo SSDKSetupSinaWeiboByAppKey:@"568898243" appSecret:@"38a4f8204cc784f81f9f0daaf31e02e3" redirectUri:@"http://www.sharesdk.cn" authType:SSDKAuthTypeBoth]; break; case SSDKPlatformTypeWechat: [appInfo SSDKSetupWeChatByAppId:@"wx4868b35061f87885" appSecret:@"64020361b8ec4c99936c0e3999a9f249"]; break; case SSDKPlatformTypeQQ: [appInfo SSDKSetupQQByAppId:@"100371282" appKey:@"aed9b0303e3ed1e27bae87c33761161d" authType:SSDKAuthTypeBoth]; break; default: break; } }]; return YES; }
(4)添加分享代码
i.须要在分享的视图中导入的头文件app
#import <ShareSDK/ShareSDK.h> #import <ShareSDKUI/ShareSDK+SSUI.h>
ii.调用构造分享参数接口和分享的接口ide
//一、建立分享参数** NSMutableDictionary *shareParams = [NSMutableDictionary dictionary]; [shareParams SSDKSetupShareParamsByText:@"分享内容" images:[[NSBundle mainBundle] pathForResource:@"COD13" ofType:@"jpg"] url:[NSURL URLWithString:@"http://mob.com"] title:@"分享标题" type:SSDKContentTypeAuto];//二、分享(能够弹出咱们的分享菜单和编辑界面)** [ShareSDK showShareActionSheet:nil //要显示菜单的视图, iPad版中此参数做为弹出菜单的参照视图,只有传这个才能够弹出咱们的分享菜单,能够传分享的按钮对象或者本身建立小的view 对象,iPhone能够传nil不会影响 items:nil shareParams:shareParams onShareStateChanged:^(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; } } ];
(5)配置平台的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 *微信* wechat weixin *QQ* 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 ,以下图:
以上就是完整的集成步骤,到这里就结束了!很简单的吧!
效果以下:
阅读原文