iOS使用ShareSDK,轻松实现分享
爱你爱自己
8年前
<p>我们在开发过程中常碰到要进行第三方分享的需求,我使用的是ShareSDK.</p> <p>关于ShareSDK的使用,官方文档已介绍的很详细了,在这里跟大家分享一下我自己的思路.</p> <h2>ShareSDK功能介绍</h2> <blockquote> <p>1.分享与转换<br> 2.社会化登陆<br> 3.评论和赞<br> 4.社会化数据统计</p> </blockquote> <p>此篇文章只介绍分享与转换,使用的是ShareSDK－iOS v3.x,其中一张效果图如下</p> <p><img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/2a15e67e83cffeb829df5562d27ef639.jpg"></p> <p>使用步骤1-非代码部分</p> <blockquote> <ul> <li>获取App Key,登陆后台,添加应用即可</li> <li>下载SDK并加入工程</li> <li>参见文档,添加你需要的相应的平台依赖库</li> <li>对你需要分享的社交平台授权登陆</li> <li>适配iOS9系统</li> <li>新浪微博需要单独配置”ObjC”</li> </ul> </blockquote> <ul> <li> <p>社交平台授权登陆详解</p> <ol> <li>在需要的开放平台注册应用,并取得相应的AppID<br> <a href="http://bbs.mob.com/forum.php?mod=viewthread&tid=275&page=1&extra=#pid860">各社交平台申请AppKey的网址及申请流程汇总</a><br> 你申请时填写的应用名称和图标均会显示</li> </ol> </li> </ul> <blockquote> <img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/a62d8260db47ab5af97708be71cc69d4.jpg"> <p>4B615883-F186-4DC7-92DB-DC31AE79023E.png</p> <img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/6e2bb6346a7cf749ec559d3955628580.jpg"> <p>B45C1F48-1F9A-4347-BDD8-BCA94C827F51.png</p> </blockquote> <pre> <code class="language-objectivec">2. 在info.plist文件下的URL Types中添加授权,配置各个社交平台登录时需要的url schemes即可 3. 目前新浪微博SDK需要在项目的Build Settings中的Other Linker Flags添加”-ObjC”，如果不配置有可能会崩溃</code></pre> <ul> <li> <p>适配iOS9系统详解</p> <ol> <li> <p>iOS9系统默认会拦截对http协议接口的访问,但大部分社交平台接口不支持https协议,可能无法授权分享,解决办法为关闭https, 使用http协议</p> </li> <li> <p>iOS9新建项目默认需要支持Bitcode,但小部分社交平台SDK不支持Bitcode,解决办法为暂时关闭对Bitcode的支持</p> </li> <li> <p>iOS9如果涉及到平台客户端跳转,系统会自动到项目<br> info.plist下检测是否设置了平台Scheme,对于需要配置的平台，如果没有配置，就无法正常跳转平台客户端。因此要支持客户端的分享和授权等，需要配置Scheme名单,即白名单</p> </li> </ol> </li> </ul> <blockquote> <p>注意! 若想跳转客户端,既要添加白名单,又要在URL Types里面添加授权,缺一不可!</p> </blockquote> <p>使用步骤2-代码部分</p> <blockquote> <ul> <li>导入ShareSDK及其他平台SDK头文件</li> <li>设置ShareSDK的App Key</li> <li>初始化第三方平台</li> <li>添加分享实现代码</li> </ul> </blockquote> <p>列举几个常用的分享实现方法</p> <blockquote> <ul> <li>首先要设置分享参数(标题,内容,图片,路径,内容类型)</li> <li>可直接定制社交平台的分享参数(各平台参数不同)</li> <li>直接分享内容(设置要分享的平台,分享参数,回调)</li> <li>进行内容编辑后分享(比直接分享内容,多了一个其他分享平台类型的参数)</li> <li>显示分享菜单(视图,可调整顺序的菜单项,分享参数[可统一内容,也可单独设置每个平台分享的不同内容],状态变更事件)</li> <li>还有很多方法,例如"一键分享至多个平台""@好友和话题"等等,可查阅头文件,在这里不一一列举了</li> </ul> </blockquote> <p>设置分享参数</p> <pre> <code class="language-objectivec">- (void)SSDKSetupShareParamsByText:(NSString *)text images:(id)images url:(NSURL *)url title:(NSString *)title type:(SSDKContentType)type;</code></pre> <p>直接定制微信好友的分享参数</p> <pre> <code class="language-objectivec">- (void)SSDKSetupWeChatParamsByText:(NSString *)text title:(NSString *)title url:(NSURL *)url thumbImage:(id)thumbImage image:(id)image musicFileURL:(NSURL *)musicFileURL extInfo:(NSString *)extInfo fileData:(id)fileData emoticonData:(id)emoticonData type:(SSDKContentType)type forPlatformSubType:(SSDKPlatformType)platformSubType;</code></pre> <p>直接分享内容</p> <pre> <code class="language-objectivec">+ (void)share:(SSDKPlatformType)platformType parameters:(NSMutableDictionary *)parameters onStateChanged:(SSDKShareStateChangedHandler)stateChangedHandler;</code></pre> <p>进行内容编辑后分享</p> <pre> <code class="language-objectivec">+ (SSUIShareContentEditorViewController *)showShareEditor:(SSDKPlatformType)platformType otherPlatformTypes:(NSArray *)otherPlatformTypes shareParams:(NSMutableDictionary *)shareParams onShareStateChanged:(SSUIShareStateChangedHandler)shareStateChangedHandler;</code></pre> <p>显示分享菜单</p> <pre> <code class="language-objectivec">+ (SSUIShareActionSheetController *)showShareActionSheet:(UIView *)view items:(NSArray *)items shareParams:(NSMutableDictionary *)shareParams onShareStateChanged:(SSUIShareStateChangedHandler)shareStateChangedHandler;</code></pre> <blockquote> <ul> <li>总结,若想分享到某一社交平台:<br> 要添加社交平台依赖库<br> 一定要在社交平台获得授权并在你的工程内授权登陆<br> 不要忘记添加白名单<br> 在AppDelegate中导入社交平台SDK头文件<br> 在AppDelegate中初始化社交平台<br> 然后写代码就OK了</li> </ul> </blockquote> <p>Demo1: 实现直接分享至新浪微博功能</p> <p>初始化新浪微博平台代码</p> <pre> <code class="language-objectivec"> /** * 参数1: 传入AppKey * 参数2: 需要连接社交平台SDK时触发 * 参数3: 需要连接社交平台SDK时触发 * 参数4: 在此事件中写入连接代码。第四个参数则为配置本地社交平台时触发，根据返回的平台类型来配置平台信息。 */ [ShareSDK registerApp:@"你的App Key" activePlatforms:@[ @(SSDKPlatformTypeSinaWeibo), ] onImport:^(SSDKPlatformType platformType) { switch (platformType) { case SSDKPlatformTypeSinaWeibo: [ShareSDKConnector connectWeibo:[WeiboSDK class]]; break; default: break; } } onConfiguration:^(SSDKPlatformType platformType, NSMutableDictionary *appInfo) { switch (platformType) { case SSDKPlatformTypeSinaWeibo: //设置新浪微博应用信息,其中authType设置为使用SSO＋Web形式授权 [appInfo SSDKSetupSinaWeiboByAppKey:@"你的Key" appSecret:@"你的Secret" redirectUri:@"你要分享的路径" authType:SSDKAuthTypeBoth]; break; default: break; } } ];</code></pre> <p>实现分享代码</p> <pre> <code class="language-objectivec"> //调用构造分享参数接口和分享的接口 NSArray* imageArray = @[[UIImage imageNamed:@"222.jpg"],[UIImage imageNamed:@"111.jpg"]]; if (imageArray) { //创建分享参数 NSMutableDictionary *shareParamDic = [NSMutableDictionary dictionary]; [shareParamDic SSDKSetupShareParamsByText:@"我是分享的具体内容" images:imageArray url:[NSURL URLWithString:@"http://www.baidu.com"] title:@"我是分享的标题" type:SSDKContentTypeAuto]; //进行分享(可以弹出我们的分享菜单和编辑界面) [ShareSDK share:SSDKPlatformTypeSinaWeibo parameters:shareParamDic onStateChanged:^(SSDKResponseState state, NSDictionary *userData, SSDKContentEntity *contentEntity, NSError *error) { switch (state) { case SSDKResponseStateSuccess: { UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"分享成功" message:nil delegate:nil cancelButtonTitle:@"确定" otherButtonTitles:nil]; [alertView show]; break; } case SSDKResponseStateFail: { UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"分享失败" message:[NSString stringWithFormat:@"%@", error] delegate:nil cancelButtonTitle:@"确定" otherButtonTitles:nil]; [alertView show]; break; } case SSDKResponseStateCancel: { UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"分享已取消" message:nil delegate:nil cancelButtonTitle:@"确定" otherButtonTitles:nil]; [alertView show]; break; } default: break; } }]; }</code></pre> <p>效果图</p> <p><img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/c8f56ff9b7f87097f9a7177b4fd63b9b.jpg"></p> <blockquote> <p>注意:<br> 正常情况下,现在已经可以跳转新浪微博,直接进行分享了,但若有以下几种情况,会导致无法正常分享</p> </blockquote> <ul> <li>在sina开放平台中,你的应用程序必须绑定正确的Bundle Id,若填写错误,会显示下图</li> </ul> <p><img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/e50e5cd3dba67b8bd5cf617d2dd1f192.jpg"></p> <ul> <li>在sina开放平台中,你的应用程序必须是审核通过的,如果未通过,无法实现自动登录微博分享,会弹出网页需要你手动登录,登录后也不会跳转微博,会直接返回提示你分享成功</li> </ul> <p><img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/e4739b234ad13616e3595c8f070a83df.jpg"><br> <br> <img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/478f8ef9c7cf6bae3d8e561eba4c4b29.jpg"></p> <ul> <li>补充一个,如果没有初始化社交平台,会出现下图</li> </ul> <p><img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/a9e015b9590af55d126c730056e07997.jpg"></p> <p>Demo2: 实现显示分享菜单功能</p> <p>初始化各个平台代码</p> <pre> <code class="language-objectivec"> [ShareSDK registerApp:@"你的App Key" activePlatforms:@[ @(SSDKPlatformTypeSinaWeibo), @(SSDKPlatformSubTypeWechatSession), @(SSDKPlatformSubTypeWechatTimeline), @(SSDKPlatformSubTypeWechatFav), @(SSDKPlatformTypeQQ), @(SSDKPlatformSubTypeQZone), ] onImport:^(SSDKPlatformType platformType) { switch (platformType) { case SSDKPlatformTypeSinaWeibo: [ShareSDKConnector connectWeibo:[WeiboSDK class]]; break; case SSDKPlatformTypeWechat: { [ShareSDKConnector connectWeChat:[WXApi class]]; } case SSDKPlatformTypeQQ: { [ShareSDKConnector connectQQ:[QQApiInterface class] tencentOAuthClass:[TencentOAuth class]]; } default: break; } } onConfiguration:^(SSDKPlatformType platformType, NSMutableDictionary *appInfo) { switch (platformType) { case SSDKPlatformTypeSinaWeibo: //设置新浪微博应用信息,其中authType设置为使用SSO＋Web形式授权 [appInfo SSDKSetupSinaWeiboByAppKey:@"你的Key" appSecret:@"你的Secret" redirectUri:@"你的分享链接" authType:SSDKAuthTypeBoth]; break; case SSDKPlatformTypeWechat: [appInfo SSDKSetupWeChatByAppId:@"" appSecret:@""]; break; case SSDKPlatformTypeQQ: [appInfo SSDKSetupQQByAppId:@"" appKey:@"" authType:SSDKAuthTypeSSO]; break; default: break; } } ];</code></pre> <p>实现分享代码</p> <pre> <code class="language-objectivec"> //设置分享参数,内容一致 NSMutableDictionary *shareParams = [NSMutableDictionary dictionary]; [shareParams SSDKSetupShareParamsByText:[NSString stringWithFormat:@"%@%@", @"你好", [NSURL URLWithString:@"http://wiki.mob.com/ios简洁版快速集成/"]] images:[NSURL URLWithString:@"111.jpg"] url:[NSURL URLWithString:@"111.jpg"] title:@"llalal" type:SSDKContentTypeAuto]; // 显示分享菜单 SSUIShareActionSheetController *sheet = [ShareSDK showShareActionSheet:nil items:@[ @(SSDKPlatformSubTypeWechatFav), @(SSDKPlatformTypeSinaWeibo), @(SSDKPlatformTypeQQ), @(SSDKPlatformSubTypeQZone), @(SSDKPlatformSubTypeWechatSession), @(SSDKPlatformSubTypeWechatTimeline), ] shareParams:shareParams onShareStateChanged:^(SSDKResponseState state, SSDKPlatformType platformType, NSDictionary *userData, SSDKContentEntity *contentEntity, NSError *error, BOOL end) { switch (state) { case SSDKResponseStateBegin: break; case SSDKResponseStateSuccess: if (platformType == SSDKPlatformTypeCopy) { NSLog(@"复制成功"); } else { NSLog(@"分享成功"); } break; case SSDKResponseStateFail: if (platformType == SSDKPlatformTypeCopy) { NSLog(@"复制失败"); } else { NSLog(@"分享失败"); } NSLog(@"失败：%@", error); break; default: break; } }];</code></pre> <ul> <li>备注:如果要中文显示,需要在info.plist文件中设置一下,如下图所示</li> </ul> <p><img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/d5b60c3086f4d10838062f3aaf6a83b1.jpg"><br> <br> <img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/2505412d3a8e7fdecff9fc778eee4be1.jpg"></p> <p>效果图如下</p> <p><img alt="iOS使用ShareSDK,轻松实现分享" src="https://simg.open-open.com/show/d31ba5c733c2290041c4d1935359e362.png"></p> <p>参考文档</p> <p><a href="/misc/goto?guid=4959675334290578693">ShareSDK官方文档</a><br> <a href="/misc/goto?guid=4959675334373622558">适配iOS9文档</a></p> <p><br> </p> <p><a href="/misc/goto?guid=4959675334459774218">阅读原文</a></p> <p> </p>