聚合數(shù)據(jù)簡(jiǎn)易開發(fā)流程

聚合數(shù)據(jù)SDK簡(jiǎn)介

聚合數(shù)據(jù)SDK是一套基于Android/iOS開發(fā)的程序接口，目前已有Android、iOS版本。開發(fā)者可以使用該套SDK開發(fā)適用于Android/iOS系統(tǒng)移動(dòng)設(shè)備的應(yīng)用，通過調(diào)用SDK接口，可以輕松的訪問聚合的所有數(shù)據(jù)和服務(wù)，構(gòu)建功能豐富、交互性強(qiáng)的應(yīng)用程序
該SDK集成了平臺(tái)上的大部分?jǐn)?shù)據(jù)服務(wù)（除電商SDK、比價(jià)SDK、定位SDK外）,開發(fā)者只需使用聚合SDK即可調(diào)用已經(jīng)申請(qǐng)的數(shù)據(jù)，無(wú)需再針對(duì)不同數(shù)據(jù)編寫程序，更方便用戶快速開發(fā)。

Android SDK V2.0 簡(jiǎn)易開發(fā)指南

該文檔僅適用于Android版本聚合數(shù)據(jù)SDK，下面是簡(jiǎn)易的開發(fā)流程說明。詳細(xì)問題您可以通過 相關(guān)下載 下載相應(yīng)的文檔、示例包、SDK。

一、開發(fā)工具

Android開發(fā)工具有很多，開發(fā)者可根據(jù)自己的喜好進(jìn)行選擇。在此，我們推薦開發(fā)者使用Eclipse作為自己的開發(fā)工具，本套開發(fā)指南也是針對(duì)Eclipse開發(fā)環(huán)境下進(jìn)行編寫的。

二、工程配置

將juhe_sdk_v_X_X.jar以及armeabi文件夾(內(nèi)包含libJuheSDK_v_X_X.so)添加到工程中l(wèi)ibs文件夾下,Android工程會(huì)自動(dòng)將libs文件夾下的jar導(dǎo)入。

通過以上兩步操作后，您就可以正常使用短信驗(yàn)證SDK為您提供的全部功能了。
注意：由于adt插件升級(jí)，若您使用Eclipse adt 22的話，需要對(duì)開發(fā)環(huán)境進(jìn)行相應(yīng)的設(shè)置，方法如下：
1. 在Eclipse 中選中工程，右鍵選 Properties->Java Build Path->Order and Export 使 Android Private Libraries處于勾選狀態(tài)；
2. Project -> clean-> clean all

三、調(diào)用SDK

①：先通過聚合數(shù)據(jù)中心（http://www.juhe.cn/docs）申請(qǐng)所需的數(shù)據(jù)服務(wù)。
②：創(chuàng)建并配置工程（具體方法參見工程配置部分的介紹）；
③：在AndroidManifest中添加開發(fā)密鑰（OPENID）、所需權(quán)限等信息；密鑰在個(gè)人中心->基本資料 頁(yè)面獲取。

1、在application中添加開發(fā)密鑰

<meta-data  
android:name="com.thinkland.juheapi.openid" 

        android:value="開發(fā)者OpenID" /> 
注意：
a. android:name中name的屬性值不能修改，直接復(fù)制即可，修改后無(wú)法通過驗(yàn)證
b. android:value中value的屬性“開發(fā)者OpenID”請(qǐng)?jiān)诰酆蠒?huì)員中心查看

2、添加所需權(quán)限

<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" />  

如下圖所示：

④：在調(diào)用接口之前需要初始化聚合數(shù)據(jù)SDK,只需要初始化一次即可。需要在Application中調(diào)用初始化方法

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()); 
    }

}

四、查找調(diào)用接口的參數(shù)值

在聚合數(shù)據(jù)API官網(wǎng)上http://www.juhe.cn/docs查看接口，并得到調(diào)用接口必須的字段：API， APIID， Method，以及需要設(shè)置的參數(shù)調(diào)用對(duì)應(yīng)接口。
例：生活常用 -> IP地址 -> 根據(jù)IP/域名查詢地址 (前提：已經(jīng)在聚合平臺(tái)申請(qǐng)了該數(shù)據(jù)服務(wù))

api,api_id,method的獲取如下圖所示：

Param的獲取方法：

五、獲取數(shù)據(jù)

Parameters params = new Parameters(); 
params.add("ip", "www.juhe.cn"); 
params.add("dtype", "xml"); 
JuheData.executeWithAPI(數(shù)據(jù)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(); 
        } 
} 
});

*詳細(xì)文檔及其他數(shù)據(jù)說明請(qǐng)通過 http://www.juhe.cn/docs 查閱。

六、返回?cái)?shù)據(jù)示例

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