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

第一章常见问题说明在本项目微博开发文档中大家使用新浪微博官方提供的WeiboSDKDemo为大家演示项目基本环境的搭建，后面的开发也是在此基础上进行开发，目的是方便大家学习和理解项目结构、新浪微博的认证授权及新浪微博API调用。WeiboSDKDemo使用的appkey、授权回调地址和debug.keystore均是新浪微博官提供的，并且WeiboSDKDemo的包名不能更改，在大家熟悉项目结构之后，也可以自己在新浪微博开放平台上申请开发者账号，并且创建自己的应用，就不必使用新浪微博官方提供的了，创建过程可以参考第二章和第三章。在使用WeiboSDKDemo注意事项：1.使用WeiboSDKDemo时不能更改WeiboSDKDemo中所用的包名（com.sina.weibo.sdk.demo），在src根目录下的Constants.java文件中提供了AppKey，一定要使用这个appKey，否则将会导致新浪官方的授权认证服务器上的签名认证失败。2.一定要使用Demo中提供的debug.keystore3.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”，在Customdebugkeystore中选择Demo中的debug.keystore，点击Apply-OK，Demo即可正常运行。4.WeiboSDKDemo整个工程中采用UTF-8格式编码，右键项目名称，点击Properties-Resource,右侧视图中点击Other，选择UTF-8模式。5.TargetSDK和MinimumSDK都要选择android4.0以上的版本。6.必须使用Eclipse3.0以上版本，JDK1.6或JDK1.7（1.6以下和1.8均没有经过测试）7.关于进入主界面刷新等待的问题，多次刷新等待请尝试重启eclipse和虚拟机，建议使用真机进行调试。第二章开发者申请1.编辑开发者基本信息登录新浪微博开发平台，在网页右上角的个人头像和昵称下面点击“编辑开发者信息”，选择开发者类型为个人，填写真实的个人信息，网站可以填写个人的博客，填写完成之后点击提交。2.身份认证在身份认证中填写个人的身份证信息，并上传身份证正反面清晰扫描照片，最后验证手机号码。（没有通过身份认证也能创建应用，只是不能提交应用审核，API有些限制，并且创建的应用只有十五个测试用户，需要在应用后台设置，后面的文档中会有说明，不认证也没关系，此处对我们影响不大。）详细API说明：）完成上面两步之后，点击我的应用，显示信息如下：第三章创建应用（此处非常重要）点击微博开放平台导航栏上的“微链接”，在“下拉菜单”中点击移动应用，显示页面如下：点击立即接入，创建新应用：按上面截图填写应用名称、应用分类和应用平台，点击创建按钮，进入应用页面：创建应用成功后，就可以查看到应用的appkey和AppSecret了，查看上图中画红框的部分。就需要填写应用信息，应用信息中最关键的部分上图中红框中的部分，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，如果Customdebugkeystore内有东西，删除掉Customdebugkeystore的内容。b)更改appkey和回调地址在应用信息-基本信息中找到appkey，复制appkey，在源代码的根目录下找到Constants.java文件，更改appkey。在应用信息–高级信息中填写授权回调页和取消授权回调页：填写地址：在源代码的根目录下找到Constants.java文件，更改REDIRECT_URL。c)生成应用签名首先要下载签名工具app_signatures.apk，在该文档所在的文件夹中可以找得到，也可以从网上下载。下载地址：如果使用的是虚拟机：最好在使用之前清除虚拟机中的数据，在启动虚拟机的时候勾选Wipeuserdata。在虚拟机启动之后，首先运行程序，将微博应用安装到虚拟机上，至少运行一次，这时程序会出错，先不用管（一定要确保是Eclipse默认的debug.store，appkey和REDIRECT_URL都和开发者平台上的信息一致）。然后在虚拟机上安装app_signatures.apk，可以通过虚拟机内的浏览器下载app_signatures.apk，也可以手动点击Eclipse中的DDMS界面，在FileExplorer中手动将app_signatures.apk上传到虚拟机上。然后运行app_signatures.apk，输入Android应用包名（packagename），就是AndroidManifest.xml文件中的package。点击生成按钮，会生成一串字符串，将字符串复制到开发者平台上应用信息–基本信息中的Android签名中，填写对应的Android包名（一定要确保Android包名和手机应用中的包名一直，签名正确）。如果使用的是真机调试：如果手机上安装了新浪微博的官方客户端，首先要删除手机上的新浪微博微博官方客户端，然后删除我们正在开发微博客户端，最后重启一次手机，将应用程序安装到手机上，至少运行一次。然后安装app_signatures.apk，运行app_signatures.apk，然后运行app_signatures.apk，输入Android应用包名（packagename），就是AndroidManifest.xml文件中的package。点击生成按钮，会生成一串字符串，将字符串复制到开发者平台上应用信息–基本信息中的Android签名中，填写对应的Android包名（一定要确保Android包名和手机应用中的包名一直，签名正确）。到此，我们已经成功的生成了应用签名填了，然后填写剩下的基本信息，填写的方法可以参考下。然后点击保存信息，提交审查。（只要保存信息就可以了，即使审核没有通过，也没有影响。）2.添加测试账号未通过审核的应用只有提供了十五个测试账号，点击应用信息-测试信息，将你测试时使用的新浪微博账号添加进去。到此我们成功的在新浪微博开发平台创建一个移动应用了。3.常见问题说明1、出现authexception：ssopackageorsignerror手机上的包名生成的签名与开放平台上的签名不一致，请按照以下步骤执行：1)检查debug.keystore是否使用的是eclipse默认的debug.keystore，请使用eclipse默认的debug.keystore2)检查应用程序的appkey是否正确，回调地址是否填写正确3)检查包名是否正确4)如果使用的是虚拟机，清除虚拟机的所有数据，重新虚拟机，安装应用程序，执行一次，填写正确的包名，重新生成签名5)如果使用真机调试，请先卸载真机上的官方微博客户端和已经安装的微博应用，重启手机，重新运行程序，填写正确的包名，重新生成签名