聚合数据SDK简介
聚合数据SDK是一套基于Android/iOS开发的程序接口,目前已有Android、iOS版本。开发者可以使用该套SDK开发适用于Android/iOS系统移动设备的应用,通过调用SDK接口,可以轻松的访问聚合的所有数据和服务,构建功能丰富、交互性强的应用程序
该SDK集成了平台上的大部分数据服务(除电商SDK、比价SDK、定位SDK外),开发者只需使用聚合SDK即可调用已经申请的数据,无需再针对不同数据编写程序,更方便用户快速开发。
Android SDK V2.0 简易开发指南
该文档仅适用于Android版本聚合数据SDK,下面是简易的开发流程说明。详细问题您可以通过相关下载下载相应的文档、示例包、SDK。
一、开发工具
Android开发工具有很多,开发者可根据自己的喜好进行选择。在此,我们推荐开发者使用Eclipse作为自己的开发工具,本套开发指南也是针对Eclipse开发环境下进行编写的。
二、工程配置
将juhe_sdk_v_X_X.jar以及armeabi文件夹(内包含libJuheSDK_v_X_X.so)添加到工程中libs文件夹下,Android工程会自动将libs文件夹下的jar导入。
通过以上两步操作后,您就可以正常使用短信验证SDK为您提供的全部功能了。
注意:由于adt插件升级,若您使用Eclipse adt 22的话,需要对开发环境进行相应的设置,方法如下:
1. 在Eclipse 中选中工程,右键选 Properties->Java Build Path->Order and Export 使 Android Private Libraries处于勾选状态;
2. Project -> clean-> clean all
三、调用SDK
①:先通过聚合数据中心(http://www.juhe.cn/docs)申请所需的数据服务。
②:创建并配置工程(具体方法参见工程配置部分的介绍);
③:在AndroidManifest中添加开发密钥(OPENID)、所需权限等信息;密钥在个人中心->基本资料 页面获取。
1、在application中添加开发密钥
<Meta-data
android:name="com.thinkland.juheapi.openid"
android:value="开发者OpenID" />
注意:
a. android:name中name的属性值不能修改,直接复制即可,修改后无法通过验证
b. android:value中value的属性“开发者OpenID”请在聚合会员中心查看
2、添加所需权限
<uses-permission android:"android.permission.ACCESS_NETWORK_STATE"/>
"android.permission.INTERNET"/>
"android.permission.ACCESS_WIFI_STATE"/>
"android.permission.ACCESS_COARSE_LOCATION "/>
"android.permission.READ_PHONE_STATE"/>
如下图所示:
④:在调用接口之前需要初始化聚合数据SDK,只需要初始化一次即可。需要在Application中调用初始化方法
importcom.thinkland.sdk.android.SDKInitializer;
importandroid.app.Application;
publicclassMyApplicationextendsApplication {
@Override
publicvoidonCreate() {
//TODOAuto-generated method stub
super.onCreate();
SDKInitializer.initialize(getApplicationContext());
}
}
四、查找调用接口的参数值
在聚合数据API官网上http://www.juhe.cn/docs查看接口,并得到调用接口必须的字段:API, APIID, Method,以及需要设置的参数调用对应接口。
例:生活常用 -> IP地址 -> 根据IP/域名查询地址(前提:已经在聚合平台申请了该数据服务)
api,api_id,method的获取如下图所示:
五、获取数据
Parametersparams=newParameters(); params.add("ip","www.juhe.cn"); params.add("dtype","xml"); JuheData.executeWithAPI(数据ID,"http://apis.juhe.cn/ip/ip2addr",JuheData.GET,params,newDataCallBack(){ @Override publicvoidresultLoaded(interr,Stringreason,Stringresult){ //TODOAuto-generatedmethodstub if(err==0){ tv.setText(result); }else{ Toast.makeText(getApplicationContext(),reason,Toast.LENGTH_SHORT).show(); } } });
*详细文档及其他数据说明请通过 http://www.juhe.cn/docs 查阅。
六、返回数据示例
{ "resultcode":"200","reason":"ReturnSuccessd!","result":{ "area":"江苏省苏州市","location":"电信" } }