登录分享的那些事-ShareSDK

一.概述

ShareSDK是一个封装了微博,QQ,微信等40多个平台登录和分享功能的第三方库,他可以支持分享文字,图片,链接等常见格式,微博还可以分享linkcard卡片模式,微信分享小程序以及打开小程序等功能。功能非常之强大。使用此SDK可以节省开发的成本,节省开发时间,更方便的是如果有不了解的可以得到他们的技术的一对一解答,不知道你们是怎么样的,反正我经历过其他第三方平台的洗礼,只能说他们那边的服务真心不咋样,解答效率,态度实在与ShareSDK没法比。下面来跟我了解下他们的集成吧!

二.使用

1.准备工作

(1)申请ShareSDK的AppKey以及第三方平台的AppKey

ShareSDK的AppKey直接到Mob官网申请即可,具体的注册应用的流程请参考这里:Mob创建应用流程

(2)其他第三方平台的AppKey需要到对应的第三方平台注册应用申请:

新浪微博请参考新浪微博注册流程

QQ请参考QQ注册流程

微信请参考微信注册流程

2.下载SDK

点击 这里下载
下载的时候根据自己需求选择需要的平台,我这里选择的是默认分享视图,只测试微博,微信,QQ。

image

下载之后解压出来如下,我们需要导入项目的是这整个SDK资源文件:

image

3.开始集成

(1)将上面下载的SDK文件夹拖进Xcode项目里,如下图:

image
image
image

注意:直接拖SDK进去请务必在上述步骤中选择“Create groups ”单选按钮组。如果你选择“Create folder references”,一个蓝色的文件夹引用将被添加到项目并且将无法找到它的资源。

(2)添加依赖库,添加步骤如下图:

image
必须添加的依赖库如下(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,如下图:

image

(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

具体配置见下图:

image

(6)配置平台的白名单

在iOS 9下涉及到平台客户端跳转,系统会自动到项目info.plist下检测是否设置平台Scheme。对于需要配置的平台,如果没有配置,就无法正常跳转平台客户端。因此要支持客户端的分享和授权等,需要配置Scheme名单。

具体方法:

1)、在项目的info.plist中添加一LSApplicationQueriesSchemes,类型为Array。

2)、然后给它添加一个需要支持的项目,类型为字符串类型;

image

各平台****OpenURL****白名单说明

新浪微博

sinaweibo

sinaweibohd

sinaweibosso

sinaweibohdsso

weibosdk

weibosdk2.5

微信

wechat

weixin

weixinULAPI

QQ

mqzoneopensdk,

mqzoneopensdkapi

mqzoneopensdkapi19

mqzoneopensdkapiV2

mqqOpensdkSSoLogin

mqqopensdkapiV2

mqqopensdkapiV3

wtloginmqq2

mqqapi

mqqwpa

mqzone

mqq

mqqopensdkapiV4

(7)另外一些相关配置

**1)新浪微博,微信SDK都需要在项目的Build Settings中的Other Linker Flags添加”-ObjC”,如果不配置有可能会崩溃。步骤如下: **

image

2)新浪微博网页授权分享需要暂时退回到http协议。步骤如下:

具体方法:

在项目的info.plist中添加一个Key:App Transport Security Settings,类型为字典类型。

然后给它添加一个Key:Allow Arbitrary Loads,类型为Boolean类型,值为YES;

image

3)新浪微博客户端分享还需要在plist文件里添加隐私权限配置:相册权限:Privacy - Photo Library Usage Description ,如下图:

image

4)微信,qq注册应用的时候都需要配置universalLink,也需要同时在XCode项目里配置,如下图:

image

以上就是完整的集成步骤,到这里就结束了!很简单的吧!

image
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容