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

Posted 2020-07-13 xiaopihaierletian

第一章  常见问题说明 
在本项目微博开发文档中大家使用新浪微博官方提供的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. 编辑开发者基本信息 

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

2. 身份认证 
在身份认证中填写个人的身份证信息，并上传身份证正反面清晰扫描照片，最后验证手机号码。  
（没有通过身份认证也能创建应用，只是不能提交应用审核，API有些限制，并且创建的应用只有十五个测试用户，需要在应用后台设置，后面的文档中会有说明，不认证也没关系，此处对我们影响不大。）  

详细API说明：http://open.t.sina.com.cn/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://api.weibo.com/oauth2/default.html 

在源代码的根目录下找到Constants.java文件，更改REDIRECT_URL。
c) 生成应用签名 

首先要下载签名工具app_signatures.apk，在该文档所在的文件夹中可以找得到，也可以从网上下载。  
下载地址：http://pan.baidu.com/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) 如果使用真机调试，请先卸载真机上的官方微博客户端和已经安装的微博应用，重
启手机，重新运行程序，填写正确的包名，重新生成签名