新浪微博Android客户端开发SDK包

# ReadMe 为了方便第三方开发者快速集成微博 SDK，我们提供了以下联系方式，协助开发者进行集成： **QQ群：248982250** **QQ群：284084420（已满）** **邮箱：sdk4wb@sina.cn** **微博：移动新技术** 虽然我们提供了若干文档，但总有不尽人意的地方，为了快速上手，少走弯路，我们建议您采用以下方式来了解并集成微博SDK。 * Step 1：浏览 ReadMe 了解大致情况 * Step 2：运行示例程序 [WeiboSDKDemo.apk][4] 或 [Demo][5] 了解 SDK 提供的所有功能 * Step 3：查看 [微博Android平台SDK文档V2.5.0.pdf][1] 深入了解如何使用 * Step 4：参照 [Demo][5] 进行开发 **如果您在使用过程中有些问题不清楚如何解决**，请先仔细阅读：[常见问题FAQ][2]，尝试能否找到对应的答案。 **如果您对 SDK 中提供的某个类、API 不明确**，请在 [API文档说明][8] 中查找对应的注解。 另外，关于 SDK 的 Bug 反馈、用户体验，以及建议与不足等，请大家尽量提交到 Github 上，充分利用好 Github 这一工具。 目前 SDK 有很多不足之处，请给我们一些时间，我们会力争为第三方开发者提供一个规范、简单易用、稳定可靠、可扩展、可定制的 SDK。 ------ # Release-Note: Android SDK V2.5.0 ## 版本变更： 1. 重构网络模块代码 2. 提供同步和异步的网络请求接口 3. 简化网络请求接口 4. 提供网络模块常用接口，如获取用户信息 5. 提供网络请求后的数据结构，如User、微博信息流等数据结构 6. 修正若干BUG 7. 简化文档 ------ # 快速上手 ## 概述 微博 Android 平台 SDK 为第三方应用提供了简单易用的微博API调用服务，使第三方客户端无需了解复杂的验证机制即可进行授权登陆，并提供微博分享功能，可直接通过微博官方客户端分享微博。 >本文档详细内容请查阅：[微博Android平台SDK文档V2.5.0.pdf][1] ------ # 名词解释 | 名词 | 注解 | | -------- | :----- | | AppKey | 分配给每个第三方应用的 app key。用于鉴权身份，显示来源等功能。| | RedirectURI | 第三方应用授权回调页面。建议使用默认回调页`https://api.weibo.com/oauth2/default.html` ，可以在新浪微博开放平台->我的应用->应用信息->高级应用->授权设置->应用回调页中找到。| | Scope | 通过scope，平台将开放更多的微博核心功能给开发者，同时也加强用户隐私保护，提升了用户体验，用户在新OAuth2.0授权页中有权利选择赋予应用的功能。| | AccessToken | 表示用户身份的 token，用于微博 API 的调用。| | Web 授权 | 通过WebView进行授权，并返回Token信息。| | SSO 授权 | 通过唤起微博客户端进行授权，并返回Token信息。| ------ ## 功能列表 ### 1. 认证授权 - SSO 授权：在**有客户端**的情况下，使用 SSO 授权登陆；无客户端的情况下，自动唤起 Web 授权（**推荐使用**） - Web 授权：在**没有客户端**的情况下，可直接使用该授权 - Code 码授权：无须应用的包名和签名，通过应用的`APP_KEY`和`APP_SECRET` 授权（**不推荐使用，有安全隐患**），详情请查看Demo中`WBAuthCodeActivity`中说明 ### 2. 微博分享 通过微博SDK，第三方应用能够分享文字、图片、视频、音乐等内容，目前分享有三种方式： **有微博客户端情况** * 通过第三方应用唤起微博客户端进行分享（该分享方式为第三方客户端通常的使用方式） * 通过微博客户端唤起第三方应用进行分享（该分享方式需要合作接入，详情请查看：http://t.cn/aex4JF） **无微博客户端情况** * 通过`OpenAPI`进行分享，直接使用`StatusesAPI`类中的`upload`、`update`或`uploadUrlText`函数进行分享即可，或直接使用`AsyncWeiboRunner#requestAsync`方法，自己进行HTTP请求实现分享，详见：[使用异步接口来发送一条带图片的微博][7]。 ### 3. 登录/注销按钮 微博SDK目前提供了两类登录按钮：一种是一键登陆按钮，一种是登陆/注销按钮。两者都是调用了SSO登录。 ### 4. 开放接口 微博SDK目前提供了一个简单的OpenAPI接口调用框架，并封装了一些简单的开放接口，以供大家参考： 微博OpenAPI接口地址：http://open.weibo.com/wiki/%E5%BE%AE%E5%8D%9AAPI | API类 | 说明 | | -------- | :----- | | UsersAPI | 用于获取用户的信息。| | StatusesAPI | 用于发送微博、获取微博等。| | CommentsAPI | 用于获取评论。| | LogoutAPI | 用于回收用户的授权。| | InviteAPI | 提供好友邀请功能，支持登录用户向自己的微博互粉好友发送私信邀请、礼物。| **注意**：目前我们只提供了一部分接口，主要原因是API过于庞大，对每一个API做测试也是一件非常耗时的事情，因此，我们优先开放第三方在使用时，最关心的几个API（如上表格），其它API继续放在`com.sina.weibo.sdk.openapi.legacy`下。 实际上，我们将这些API没有全部开放出来，也是希望第三方开发者能够和我们一起维护这些API，将修改后的代码Push到Github上。 另外，网络模块已重构了一个易用点的框架，第三方开发者可直接通过 Http 请求来调用 OpenAPI 接口，详见：[网络请求框架的使用][6]。 ------ ## API文档说明 http://sinaweibosdk.github.io/weibo_android_sdk/doc ------ ## 运行示例代码 为了方便第三方应用更快的集成微博 SDK，更清晰的了解目前微博 SDK 所提供的功能，我们在 GitHub 上提供了一个简单的 **示例工程** 以及对应的 **APK安装包** 。 **方式一：**通过 adb install 命令直接安装 WeiboSDKDemo.apk **方式二：**在 Eclipse 中导入并运行 WeiboSDKDemo 工程（详情请查看[微博Android平台SDK文档V2.5.0.pdf][1]中：**运行示例代码**） ***注意：通过方式二运行工程时，请务必替换默认的 debug.keystore文件，否则无法正确的授权成功。另外，该debug.keysotre 是新浪官方的，除了编译运行官方 DEMO 外，请不要直接使用它，出于安全的考虑，您应该为自己的应用提供一份 keysotre。*** >在C:\Users\XXXXX\\.android目录下，把Android默认的debug.keystore替换成官方在GitHub上提供的debug.keystore。 ## 微博SDK及DEMO工程目录结构及分析 微博SDK目前以是**部分开源**的形式提供给第三方开发者的，简单来说，可以分为以下三部分： * **闭源部分**：weibosdkcore.jar，该JAR包集成了微博授权、SSO登录以及分享等核心功能。**另外，在V2.5.0中，我们将网络模块框架也加入其中，方便开发者进行OpenAPI的网络请求**。 * **开源部分**：WeiboSDK工程（Library），**该工程引用了weibosdkcore.jar**，这里面主要是对OpenAPI进行了简单的封装，第三方可以参考使用流程，模仿并添加自己需要的接口，利用OpenAPI接口获取用户信息，分享微博等，另外，还提供了一键登录/注销功能。 * **Demo部分**：WeiboSDKDemo工程，**该工程引用了WeiboSDK工程**，提供了目前微博所支持的所有功能的示例代码。 ------ ## 集成前准备 ### 1. 申请应用程序的APP_KEY 在这一步中，您需要在微博开放平台上，对您的应用进行注册，并获取APP_KEY，添加应用的授权回调页（Redirect URI）。详情请仔细阅读：移动客户端接入（http://t.cn/aex4JF ） ### 2. 注册应用程序的包名和签名 您需要在微博开放平台上注册应用程序的包名和签名后，才能正确进行授权。 请注意：包名和签名未注册，或者签名注册不正确，都会导致无法授权。 应�