Android SDK说明文档
目录 |
概述
微博Android平台SDK为第三方微博应用提供了文档易用的微博API调用服务,使第三方客户端无需了解复杂的验证,API调用过程。并可以实现分享到微博的功能,可以分享文字,或者多媒体信息到内置的分享页面,并发送到微博。
名词解释
整体架构
主要类说明:
- 1、Weibo: 微博API 接口类,对外提供weibo api的调用,包括登录,API调用,微博分享等功能。
- 2、AsyncWeiboRunner:微博api异步执行类,封装了回调接口,通过创建线程来调用Weibo中的接口方法。
- 3、Utility:互联网工具类,包括接口请求GET/POST封装,BASE64等encode,decode方法。
- 4、WeiboException:微博异常封装类,封装了微博的各个异常。
接口说明
Class com.weibo.net.Weibo:
获取request token
获取access token
获取Oauth2.0 的access token
微博API请求
分享到微博
通过XAuth认证获取用户身份
通过Oauth2.0隐式授权认获取AccessToken
实例分析
以下代码的具体信息请参考com_weibo_android_example工程。svn地址为: http://weibo-android-sdk.googlecode.com/svn/example
登录
第一步In AuthorizeActivity: 获取微博实体类,传入app key, secret,以及callback_url。
第二步In AuthorizeActivity:
用获取到的oauth token , oauth_token_secret访问open api authorize页面。
第三步 In TestActivity:
获取到callback的oauth_verifier,并根据它获取accessToken,完成登录。
访问微博API
第一步 In TestActivity: 调用Weibo实体类中request进行简单的微博API访问,前提是accessToken已经获取到。
分享到微博
第一步 in TestActivity: 得到weibo实体类,传入我们需要分享的文字”abc”, 以及要分享的图片路径”picPath”。
第二步 in TestActivity:
调用微博中share2weibo方法,传入activity引用,调起我们的分享页面。
异步调用AsyncWeiboRunner中API方法
第一步In ShareActvity: 调用类实现一部回调RequestLisener接口。
第二步In ShareActvity:
调用异步upload接口,实现发微博功能。
第三步In ShareActvity: 实现回调,对发表成功onComplete,以及发表失败onError的情况进行处理。
通过Oauth2.0隐式授权获得AccessToken
第一步 In AuthorizeActivity: 调用setRedirectUrl方法设置应用回调页。
对于Mobile客户端应用来说,是不存在Server的,故此处的应用回调页地址只要与新浪微博开放平台->我的应用->应用信息->高级应用->授权设置->应用回调页中的url地址保持一致就可以了,如图所示:
第二步In AuthorizeActivity: 实现WeiboDialogListener接口。授权成功后可在onComplete函数中获得accesstoken信息。具体如何保存、使用accesstoken信息由开发者自行处理。
第三步 In AuthorizeActivity:
调用authorize方法,弹出授权对话框,进行授权。授权成功后即可获得accestoken。
SDK使用说明
- 1、将SDK的工程项目导入到eclipse中
- 在eclipse中选择File->Import->General->Existing Projects into Workspace。注意:SDK工程的编码格式为UTF-8。如图所示:
- 2、在需要集成本SDK的工程项目中添加Library
- 右键 -> Properties -> Android。设置Library属性,如图所示:
- 3、Manifest文件中必须包含以下permission:
- <uses-permission android:name="android.permission.INTERNET"></uses-permission>
- <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
- <uses-permission android:name="android.permission.WRITE_APN_SETTINGS"></uses-permission>
- <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
- 4、代码中将APP_KEY, APP_SECRET存放在Weibo类中,可以修改成其他传参方式设置
- In Weibo
- In TestActivity
- 5、SDK使用及修改必须遵守微博开发者协议,以及开源软件协议