新浪微博开发者平台应用申请及配置说明

第一章常见问题说明

在本项目微博开发文档中大家使用新浪微博官方提供的WeiboSDKDemo为大家演示项目基本环境的搭建，后面的开发也是在此基础上进行开发，目的是方便大家学习和理解项目结构、新浪微博的认证授权及新浪微博API调用。

WeiboSDKDemo使用的appkey、授权回调地址和debug.keystore均是新浪微博官提供的，并且WeiboSDKDemo的包名不能更改，在大家熟悉项目结构之后，也可以自己在新浪微博开放平台上申请开发者账号，并且创建自己的应用，就不必使用新浪微博官方提供的了，创建过程可以参考第二章和第三章。

在使用WeiboSDKDemo注意事项：

1.使用WeiboSDKDemo时不能更改WeiboSDKDemo中所用的包名

（com.sina.weibo.sdk.demo），在src根目录下的Constants.java文件中提供了AppKey ，一定要使用这个appKey，否则将会导致新浪官方的授权认证服务器上的签名认证失败。

2.一定要使用Demo中提供的debug.keystore

3.MD5工具是根据keystore来生成签名的，不同的keystore生成的签名是不一样的。此Demo

的签名是用官网提供的keystore生成的，若要顺利运行Demo程序，需要进行设置或是替换keystore，两种方法可以选择其中一种进行操作：

方法一：替换keystore，把Android默认的debug.keystore（在C:\Users\xxxx\.android目录下）替换成官方在Hithub上提供的debug.keystore。

方法二：在Eclipse中设置工程keystore，在Eclipse中点击“Windows -> Preferences -> Android -> Build”，在Custom debug keystore 中选择Demo中的debug.keystore，点击Apply -> OK，Demo即可正常运行。

4.WeiboSDKDemo整个工程中采用UTF-8格式编码，右键项目名称，点击 Properties ->

Resource ,右侧视图中点击Other，选择UTF-8模式。

5.Target SDK 和 Minimum SDK都要选择android 4.0 以上的版本。

6.必须使用Eclipse3.0以上版本，JDK1.6或JDK1.7（1.6以下和1.8均没有经过测试）

7.关于进入主界面刷新等待的问题，多次刷新等待请尝试重启eclipse和虚拟机，建议使

用真机进行调试。

第二章开发者申请

1.编辑开发者基本信息

登录新浪微博开发平台https://www.360docs.net/doc/da7656733.html,/，在网页右上角的个人头像和昵称下面点击“编辑开发者信息”，选择开发者类型为个人，填写真实的个人信息，网站可以填写个人的博客，填写完成之后点击提交。

2.身份认证

在身份认证中填写个人的身份证信息，并上传身份证正反面清晰扫描照片，最后验证手机号码。

（没有通过身份认证也能创建应用，只是不能提交应用审核，API有些限制，并且创建的应用只有十五个测试用户，需要在应用后台设置，后面的文档中会有说明，不认证也没关系，此处对我们影响不大。）

详细API说明：https://www.360docs.net/doc/da7656733.html,/wiki/%E5%BE%AE%E5%8D%9AAPI）

完成上面两步之后，点击我的应用，显示信息如下：

第三章创建应用（此处非常重要）

点击微博开放平台导航栏上的“微链接”，在“下拉菜单”中点击移动应用，显示页面如下：

点击立即接入，创建新应用：

按上面截图填写应用名称、应用分类和应用平台，点击创建按钮，进入应用页面：

创建应用成功后，就可以查看到应用的app key和App Secret了，查看上图中画红框的部分。就需要填写应用信息，应用信息中最关键的部分上图中红框中的部分，Android签名包名信息，下面我们讲解如何生存Android签名。

1.生成Android签名并填写基本信息

a)更改debug.keystore

在新浪微博提供的WeiboSDKDemo中，我们使用的是WeiboSDKDemo中提供的debug.keystore，现在我们已经申请到appkey，第一步就是要更改debug.keystore。

一般情况下，对于一个公司来说，公司只需要保存两个keystore 即可，debug.keystore 和release.keystore，前者用于测试，后者用于发布。

在我们使用Eclipse创建一个应用时，默认使用的是Eclipse提供的debug.keystore，如果以前使用过新浪微博官方提供的debug.keystore，就要删除掉，如果使用的就是Eclipse默认的debug.keystore，那么就不需要更改。

点击Windows –> perferences -> Android -> Build，如下图所示，使用默认的debug.keystore，如果Custom debug keystore内有东西，删除掉Custom debug keystore的内容。

b)更改appkey和回调地址

在应用信息-> 基本信息中找到appkey，复制appkey，在源代码的根目录下找到Constants.java文件，更改appkey。

在应用信息–> 高级信息中填写授权回调页和取消授权回调页：

填写地址：https://https://www.360docs.net/doc/da7656733.html,/oauth2/default.html

在源代码的根目录下找到Constants.java文件，更改REDIRECT_URL。

c)生成应用签名

首先要下载签名工具app_signatures.apk，在该文档所在的文件夹中可以找得到，也可以从网上下载。

下载地址：https://www.360docs.net/doc/da7656733.html,/s/1c051IwS

如果使用的是虚拟机：

最好在使用之前清除虚拟机中的数据，在启动虚拟机的时候勾选Wipe user data。

在虚拟机启动之后，首先运行程序，将微博应用安装到虚拟机上，至少运行一次，这时程序会出错，先不用管（一定要确保是Eclipse默认的debug.store，appkey和REDIRECT_URL 都和开发者平台上的信息一致）。

然后在虚拟机上安装app_signatures.apk，可以通过虚拟机内的浏览器下载app_signatures.apk，也可以手动点击Eclipse中的DDMS界面，在File Explorer中手动将app_signatures.apk上传到虚拟机上。

然后运行app_signatures.apk，输入Android应用包名（package name），就是AndroidManifest.xml文件中的package。

点击生成按钮，会生成一串字符串，将字符串复制到开发者平台上应用信息–> 基本信息中的Android签名中，填写对应的Android包名（一定要确保Android包名和手机应用中的包名一直，签名正确）。

如果使用的是真机调试：

如果手机上安装了新浪微博的官方客户端，首先要删除手机上的新浪微博微博官方客户端，然后删除我们正在开发微博客户端，最后重启一次手机，将应用程序安装到手机上，至少运行一次。

然后安装app_signatures.apk，运行app_signatures.apk，然后运行app_signatures.apk，输入Android应用包名（package name），就是AndroidManifest.xml文件中的package。

点击生成按钮，会生成一串字符串，将字符串复制到开发者平台上应用信息–> 基本信息中的Android签名中，填写对应的Android包名（一定要确保Android包名和手机应用中的包名一直，签名正确）。

到此，我们已经成功的生成了应用签名填了，然后填写剩下的基本信息，填写的方法可以参考下。

然后点击保存信息，提交审查。（只要保存信息就可以了，即使审核没有通过，也没有影响。）

2.添加测试账号

未通过审核的应用只有提供了十五个测试账号，点击应用信息-> 测试信息，将你测试时使用的新浪微博账号添加进去。

到此我们成功的在新浪微博开发平台创建一个移动应用了。

3.常见问题说明

1、出现auth exception：sso package or sign error

手机上的包名生成的签名与开放平台上的签名不一致，请按照以下步骤执行：

1)检查debug.keystore是否使用的是eclipse默认的debug.keystore，请使用eclipse默认

的debug.keystore

2)检查应用程序的appkey是否正确，回调地址是否填写正确

3)检查包名是否正确

4)如果使用的是虚拟机，清除虚拟机的所有数据，重新虚拟机，安装应用程序，执行

一次，填写正确的包名，重新生成签名

5)如果使用真机调试，请先卸载真机上的官方微博客户端和已经安装的微博应用，重

启手机，重新运行程序，填写正确的包名，重新生成签名