Android 集成文档

Android 集成文档

获取appid

登录个推开发者中心,进入个像产品页,按照步骤提示注册应用,可获得appid。

请确保在个像开发者中心正确配置应用包名以及签名(SHA256)

添加maven库地址

在以项目名为命名的顶层build.gradle文件中,添加个推maven库地址,如下所示:

// Maven URL地址
maven {
    url 'http://mvn.gt.igexin.com/nexus/content/repositories/releases'
}

配置依赖

app/build.gradle文件中引用个像SDK依赖库,如下图所示:

dependencies {
    compile 'com.getui:gisdk:3.1.7.0'
}

配置APPID和渠道

app/build.gradle 文件中的 android.defaultConfig 下添加 manifestPlaceholders,如下图所示:

channel config

manifestPlaceholders = [
    GI_APPID : 'your appid',
    GT_INSTALL_CHANNEL : "your channel"
]

"your appid" 是您申请的appid。
"your channel" 为将要发布的渠道。

渠道若为纯数字字符串不能超过int表示的范围

渠道也能够通过GInsightManager 类的 setInstallChannel 方法设置。

Android 9.0 兼容配置

为兼容Android 9.0,务必在 application 节点添加 android:usesCleartextTraffic="true"

初始化

在您应用的启动入口(Application的onCreate中)调用SDK的初始化代码,调用方式如下:


GInsightManager.getInstance().init(this, new IGInsightEventListener() {
    @Override
    public void onSuccess(String giuid) {
        Log.d(TAG,  "init success,  giuid:" + giuid);
    }

    @Override
    public void onError(String error) {
        Log.d(TAG, "init failed, msg:" + error);
    }
});

GInsightManager接口类

SDK功能接口,用于调用GInsight相关功能

方法详细资料

获取GInsightManager单例对象

public static GInsightManager getInstance()

返回:

GInsightManager单例对象

初始化

public void init(Context context, IGInsightEventListener listener)

参数:

context - application上下文

listener - 回调

设置渠道

public void setInstallChannel(String channel)

渠道设置需要在初始化之前

参数:

channel - 您的渠道

获取SDK版本号

public String version()

返回:

SDK版本号

配置混淆

在混淆文件中加入如下配置即可:

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

添加权限声明

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.GET_TASKS" />

文档中心搜索