(→SDK功能特性) |
|||
(未显示2个用户的22个中间版本) | |||
第1行: | 第1行: | ||
− | + | =移动客户端接入= | |
+ | <div class="wiki_txtJ"> | ||
+ | 为方便移动应用接入微博,微博开放平台提供了移动SDK及相关接口相结合的模式。微博移动SDK,竭在方便移动应用开发者更快捷地接入微博开放平台,集成用微博账号登录、分享到微博能功能,同时优化了WebView,使第三方应用在登录、分享时有了更好的用户体验。 | ||
+ | </div> | ||
− | |||
− | + | =SDK功能特性= | |
+ | <div class="wiki_txtJ"> | ||
+ | '''用微博账号登录''' | ||
+ | </div> | ||
− | |||
− | |||
− | + | <div class="wiki_txtJ"> | |
− | + | 微博SDK支持原生、H5多场景下的授权登录,在用户安装有微博客户端的前提下,原生授权登录流程仅需一步,中间没有H5页面加载,十分快捷。 | |
− | + | {{Img_polaroid|src=https://weiboblog-wordpress.stor.sinaapp.com/uploads/2015/01/image0051-600x308.png}} | |
− | + | 对移动应用提供授权刷新机制,使用微博SDK的第三方应用,可获得Refresh Token权限,实现一次授权,更长的有效期。集成微博移动SDK后,第三方需要更加关注自身应用的安全性,第三方客户端无需在本地存储微博开放平台的APP SECRET,验证应用需要用到包名和签名(签名仅针对Android) | |
− | + | 用户没有安装微博客户端的情况下,需要使用H5页完成授权,用户可能需要先登录微博。 | |
− | + | ||
− | |||
− | |||
− | + | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72207.png}} | |
− | + | 授权机制请参考授权技术说明文档:[[授权机制|授权机制]] | |
+ | </div> | ||
− | |||
+ | <div class="wiki_txtJ"> | ||
+ | '''分享到微博''' | ||
+ | </div> | ||
− | |||
− | |||
− | |||
+ | <div class="wiki_txtJ"> | ||
+ | SDK提供了原生、H5多种分享方式供开发者自由选择,无论用户手机中是否安装了微博客户端,用户都能顺利分享。 | ||
− | |||
− | |||
+ | 原生唤起分享的流程,发布后微博来源显示第三方应用名称。 | ||
− | |||
− | |||
− | |||
− | {{ | + | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72208.png}} |
− | + | ||
− | + | 分享链接LinkCard解析,在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊链接,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。 | |
− | + | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72211.png}} | |
− | |||
− | |||
− | + | 分享链接LinkCard解析,需要深度合作的第三方才能接入,请有需求的第三方联系微博开放平台。 | |
+ | </div> | ||
− | |||
− | |||
− | + | ==SDK版本支持== | |
− | |||
− | + | ===iOS SDK=== | |
− | + | <div class="wiki_txtJ"> | |
− | + | 目前最新版本的 iOS SDK 为 3.3.3,针对苹果应用商店对采集 IDFA 的审核问题,最新版 iOS SDK 去除了采集 IDFA 等隐私信息的代码,使开发者集成 iOS SDK 时,能够顺利的通过苹果应用商店的审核。 | |
+ | </div> | ||
− | |||
+ | <div class="wiki_taglist"> | ||
+ | <ul class="clearfix"> | ||
+ | <li style="font-size:14px;">[[移动客户端接入#SDK接入流程|SDK接入流程]]</li> | ||
+ | <li style="font-size:14px;">[https://github.com/sinaweibosdk/weibo_ios_sdk iOS SDK下载]</li> | ||
+ | </ul> | ||
+ | </div> | ||
− | |||
− | |||
− | + | ===Android SDK=== | |
− | + | <div class="wiki_txtJ"> | |
+ | 目前最新版本的 Android SDK 为 12.5.0,按照工信部关于个人隐私保护的要求,最新版 Android SDK 已经去除了采集相关设备信息的代码,使开发者集成 Android SDK 时,能够顺利的通过各大应用商店的审核。 | ||
+ | </div> | ||
− | |||
− | === | + | <div class="wiki_taglist"> |
+ | <ul class="clearfix"> | ||
+ | <li style="font-size:14px;">[[移动客户端接入#SDK接入流程|SDK接入流程]]</li> | ||
+ | <li style="font-size:14px;">[https://github.com/sinaweibosdk/weibo_android_sdk/tree/master/2019SDK Android SDK下载]</li> | ||
+ | </ul> | ||
+ | </div> | ||
− | |||
− | |||
− | {{ | + | ==SDK接入流程== |
+ | |||
+ | |||
+ | <div class="wiki_txtJ"> | ||
+ | '''1、注册成为开发者,创建移动应用''' | ||
+ | </div> | ||
+ | |||
+ | |||
+ | <div class="wiki_txtJ"> | ||
+ | 如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 :[[新手指南]] | ||
+ | |||
+ | |||
+ | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72205.png}} | ||
+ | |||
+ | |||
+ | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72203.png}} | ||
+ | |||
+ | |||
+ | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72201.png}} | ||
− | |||
创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。 | 创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。 | ||
− | + | </div> | |
− | |||
− | |||
− | |||
+ | <div class="wiki_txtJ"> | ||
+ | '''2、创建应用完成后,进行SDK配置''' | ||
+ | </div> | ||
− | |||
− | + | <div class="wiki_txtJ"> | |
+ | 在 “我的应用 - 应用信息” 中查看您所创建应用的 APPKEY 及 APP SECRET,请妥善保管您的这些信息,这将成为您集成SDK、调用微博开放平台API的身份标志: | ||
− | |||
− | |||
+ | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd411.png}} | ||
− | |||
− | |||
− | + | 在 “我的应用 - 应用信息 - 高级信息” 中填写您的应用回调页,这样才能使SDK的授权流程正常进行。如果您的APP SECRET发生泄露,您也可以通过该页面中的重置按钮对其重置: | |
− | |||
+ | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd5.jpg}} | ||
− | |||
− | + | 注:通常移动客户端没有网页回调地址,您可以在回调页地址处填写微博开放平台提供的默认回调页,该页面用户不可见,仅用于完成SDK授权流程。微博移动SDK默认回调页:<nowiki>https://api.weibo.com/oauth2/default.html</nowiki> | |
− | + | 在 “我的应用 - 应用信息” 填写您的移动应用的平台信息,iPhone 应用填写 Apple ID 和 Buddle ID,Android 应用填写包名,签名及下载地址(各字段含义在填写表单中均有说明)。 | |
− | |||
− | === | + | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72204.png}} |
+ | </div> | ||
+ | |||
+ | |||
+ | |||
+ | <div class="wiki_txtJ"> | ||
+ | '''3、下载并集成对应平台的微博移动SDK到你的应用中''' | ||
+ | </div> | ||
+ | |||
+ | |||
+ | <div class="wiki_txtJ"> | ||
+ | 当您开发完您的应用后,您就可以通过 “我的应用” 页面提交审核了。只有当您的应用通过审核后,才能让除测试账号之外的微博用户使用微博账号登录您的移动客户端,并在微博中正确显示您的来源地址等。 | ||
+ | |||
+ | |||
+ | {{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd611.png}} | ||
+ | </div> | ||
− | |||
− | |||
==移动应用商务合作== | ==移动应用商务合作== | ||
− | |||
− | + | 移动SDK中的LinkCard权限需要合作申请,商务对接请发邮件至:[mailto:zhangdi2@staff.weibo.com zhangdi2@staff.weibo.com]、[mailto:siqin1@staff.weibo.com siqin1@staff.weibo.com]、[mailto:lingxia@staff.weibo.com lingxia@staff.weibo.com] | |
+ | |||
+ | |||
==SDK常见使用问题== | ==SDK常见使用问题== | ||
+ | |||
1、应用无法唤起微博客户端 | 1、应用无法唤起微博客户端 | ||
第150行: | 第178行: | ||
− | |||
− | |||
+ | |||
+ | |||
+ | {{#a:nobtns|noheading}} | ||
__NOTOC__ | __NOTOC__ |
2023年2月1日 (三) 14:13的最后版本
移动客户端接入
为方便移动应用接入微博,微博开放平台提供了移动SDK及相关接口相结合的模式。微博移动SDK,竭在方便移动应用开发者更快捷地接入微博开放平台,集成用微博账号登录、分享到微博能功能,同时优化了WebView,使第三方应用在登录、分享时有了更好的用户体验。
SDK功能特性
用微博账号登录
微博SDK支持原生、H5多场景下的授权登录,在用户安装有微博客户端的前提下,原生授权登录流程仅需一步,中间没有H5页面加载,十分快捷。
对移动应用提供授权刷新机制,使用微博SDK的第三方应用,可获得Refresh Token权限,实现一次授权,更长的有效期。集成微博移动SDK后,第三方需要更加关注自身应用的安全性,第三方客户端无需在本地存储微博开放平台的APP SECRET,验证应用需要用到包名和签名(签名仅针对Android)
用户没有安装微博客户端的情况下,需要使用H5页完成授权,用户可能需要先登录微博。
授权机制请参考授权技术说明文档:授权机制
分享到微博
SDK提供了原生、H5多种分享方式供开发者自由选择,无论用户手机中是否安装了微博客户端,用户都能顺利分享。
原生唤起分享的流程,发布后微博来源显示第三方应用名称。
分享链接LinkCard解析,在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊链接,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。
分享链接LinkCard解析,需要深度合作的第三方才能接入,请有需求的第三方联系微博开放平台。
SDK版本支持
iOS SDK
目前最新版本的 iOS SDK 为 3.3.3,针对苹果应用商店对采集 IDFA 的审核问题,最新版 iOS SDK 去除了采集 IDFA 等隐私信息的代码,使开发者集成 iOS SDK 时,能够顺利的通过苹果应用商店的审核。
Android SDK
目前最新版本的 Android SDK 为 12.5.0,按照工信部关于个人隐私保护的要求,最新版 Android SDK 已经去除了采集相关设备信息的代码,使开发者集成 Android SDK 时,能够顺利的通过各大应用商店的审核。
SDK接入流程
1、注册成为开发者,创建移动应用
2、创建应用完成后,进行SDK配置
在 “我的应用 - 应用信息” 中查看您所创建应用的 APPKEY 及 APP SECRET,请妥善保管您的这些信息,这将成为您集成SDK、调用微博开放平台API的身份标志:
在 “我的应用 - 应用信息 - 高级信息” 中填写您的应用回调页,这样才能使SDK的授权流程正常进行。如果您的APP SECRET发生泄露,您也可以通过该页面中的重置按钮对其重置:
注:通常移动客户端没有网页回调地址,您可以在回调页地址处填写微博开放平台提供的默认回调页,该页面用户不可见,仅用于完成SDK授权流程。微博移动SDK默认回调页:https://api.weibo.com/oauth2/default.html
在 “我的应用 - 应用信息” 填写您的移动应用的平台信息,iPhone 应用填写 Apple ID 和 Buddle ID,Android 应用填写包名,签名及下载地址(各字段含义在填写表单中均有说明)。
3、下载并集成对应平台的微博移动SDK到你的应用中
当您开发完您的应用后,您就可以通过 “我的应用” 页面提交审核了。只有当您的应用通过审核后,才能让除测试账号之外的微博用户使用微博账号登录您的移动客户端,并在微博中正确显示您的来源地址等。
移动应用商务合作
移动SDK中的LinkCard权限需要合作申请,商务对接请发邮件至:zhangdi2@staff.weibo.com、siqin1@staff.weibo.com、lingxia@staff.weibo.com
SDK常见使用问题
1、应用无法唤起微博客户端
应用无法唤起微博客户端实现分享,主要是因为程序中的APPKEY,包名和签名(仅限Android)信息和在平台填写的不一致。