新浪微博开发者平台应用申请及配置说明
第一章 常见问题说明在本项目微博开发文档中大家使用新浪微博官方提供的WeiboSDKDemo 为大家演示项目基本环境的搭建,后面的开发也是在此基础上进行开发,目的是方便大家学习和理解项目结构、新浪微
第一章 常见问题说明
在本项目微博开发文档中大家使用新浪微博官方提供的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:Usersxxxx.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/微博API)
完成上面两步之后,点击我的应用,显示信息如下:
第三章 创建应用(此处非常重要)
点击微博开放平台导航栏上的“微链接”,在“下拉菜单”中点击移动应用,显示页面如下:
点击立即接入,创建新应用:
按上面截图填写应用名称、应用分类和应用平台,点击创建按钮,进入应用页面:
创建应用成功后,就可以查看到应用的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 包名和手机应用中的包名一直,签名正确)。
到此,我们已经成功的生成了应用签名填了,然后填写剩下的基本信息,填写的方法可以参考下。
然后点击保存信息,提交审查。(只要保存信息就可以了,即使审核没有通过,也没有影响。)