聚合数据简易开发流程

聚合数据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:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION " />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

如下图所示：


④：在调用接口之前需要初始化聚合数据SDK,只需要初始化一次即可。需要在Application中调用初始化方法
import com.thinkland.sdk.android.SDKInitializer;
import android.app.Application;public class MyApplication extends Application {
@Override
public void onCreate() {
// TODO Auto-generated method stub
super.onCreate();
SDKInitializer.initialize(getApplicationContext());
}}

四、查找调用接口的参数值
在聚合数据API官网上http://www.juhe.cn/docs查看接口，并得到调用接口必须的字段：API， APIID， Method，以及需要设置的参数调用对应接口。
例：生活常用 -> IP地址 -> 根据IP/域名查询地址 (前提：已经在聚合平台申请了该数据服务)

api,api_id,method的获取如下图所示：



Param的获取方法：



五、获取数据

Parameters params = new Parameters();
params.add("ip", "www.juhe.cn");
params.add("dtype", "xml");
JuheData.executeWithAPI(数据ID, "http://apis.juhe.cn/ip/ip2addr", JuheData.GET, params, new DataCallBack() {
@Override
public void resultLoaded(int err, String reason, String result) {
// TODO Auto-generated method stub
if (err == 0) {
tv.setText(result);
} else {
Toast.makeText(getApplicationContext(), reason, Toast.LENGTH_SHORT).show();
}
}
});

*详细文档及其他数据说明请通过 http://www.juhe.cn/docs 查阅。
六、返回数据示例

{
"resultcode":"200",
"reason":"Return Successd!",
"result":{
"area":"江苏省苏州市",
"location":"电信"
}
}