帮助与文档

> >

# MobAPI集成文档

一、配置gradle

1、打开项目根目录的build.gradle,在buildscrip–>dependencies 模块下面添加  classpath ‘com.mob.sdk:MobSDK:+’,如下所示;

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        ...
        classpath 'com.mob.sdk:MobSDK:+'

    }
}

2、在使用MobAPI模块的build.gradle中,添加MobSDK插件和扩展,如:

// 添加插件
apply plugin: 'com.mob.sdk'

// 在MobSDK的扩展中注册MobAPI的相关信息
MobSDK {
    appKey "d580ad56b4b5"
    appSecret "7fcae59a62342e7e2759e9e397c82bdd"

    MobAPI {}
}

二、添加代码

1、初始化MobSDK

如果您没有在`AndroidManifest`中设置`appliaction`的类名,MobSDK会将这个设置为`com.mob.MobApplication`,但如果您设置了,请在您自己的Application类中调用:

MobSDK.init(this);

以初始化MobSDK。

2、获取API工具类

MobAPI提供了多个Web应用,每个应用对应我们SDK的一个API工具类,如使用下面的代码可以得到一个用以执行天气预报查询的工具类:

Weather api = (Weather) MobAPI.getAPI(Weather.NAME);

3、执行操作

所有的API请求都是异步的,为了返回操作结果,发送请求时需要设置操作回调,具体如下:

// 获取一个手机归属地API
Mobile api = (Mobile) APICloud.getAPI(Mobile.NAME);
// 执行归属地查询
api.phoneNumberToAddress("13800138000", new APICallback() {
    public void onSuccess(API api, int action, Map<String, Object> result) {
        // TODO 添加处理操作完成的代码
    }

    public void onError(API api, int action, Throwable details) {
        // TODO 添加处理操作失败的代码
    }
});

回调方法“onSuccess”和“onError”都在主线程执行。

4、使用自定义操作工具类

如果我们SDK内置的API工具类不能满足您的需求,您还可以使用我们提供的自定义操作工具类来组装自己的请求:

CustomAPI api = MobAPI.getCustomAPI();

得到CustomAPI实例以后,可以通过其提供的“get”、“post”等方法完成实际请求。详情可以参考我们的演示程序和API文档。

 三、混淆设置

MobAPI已经做了混淆处理,再次混淆会导致不可预期的错误,请在您的混淆脚本中添加如下的配置,跳过对MobAPI的混淆操作:

-keep class com.mob.**{*;}
-dontwarn com.mob.**

四、注意事项

1. MobSDK默认为MobAPI提供最新版本的集成,如果您想锁定某个版本,可以在`MobAPI`下设置“version "某个版本"”来固定使用这个版本
2. 如果使用MobSDK的模块会被其它模块依赖,请确保依赖它的模块也引入MobSDK插件,或在此模块的gradle中添加:

repositories {
    jcenter()
}

非Gradle集成方式点这里

相关文档