Android 集成文档

Android 集成文档

获取appid

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

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

添加maven库地址

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

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

配置依赖

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

dependencies {
    //请将此处的 ${version} 替换成您当前相应的 SDK 版本号,如 3.3.0.1
    implementation 'com.getui:gisdk:${version}'
}

配置APPID和渠道

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

defaultConfig {
    applicationId "你的应用包名"
     ....

    manifestPlaceholders = [
                  //从 3.3.0.1 版本开始,APPID 占位符从 GI_APPID 切换为 GETUI_APPID 
                  //后续所有产品的 APPID 均统一配置为 GETUI_APPID 占位符
            GETUI_APPID       : "your appid",

                  //渠道若为纯数字则不能超过 int 表示的范围。 
            GT_INSTALL_CHANNEL      : "your channel"
    ]
}

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

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

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

注意: 对于同时集成个推多个产品SDK,且SDK之间的APPID值不一致的用户,可以任选一个SDK的APPID配置到GETUI_APPID占位符中,其余SDK在AndroidManifest文件中务必添加对应的标签来补充APPID,参考以下配置:

<application>

  ....
  <!-- 补充个推SDK的appid -->
  <meta-data
        android:name="PUSH_APPID"
    android:value="个推SDK的appid" />

  <!-- 补充个验SDK的appid -->
  <meta-data
        android:name="GY_APP_ID"
    android:value="个验SDK的appid" />

  <!-- 补充个数SDK的appid -->
  <meta-data
        android:name="GS_APPID"
    android:value="个数SDK的appid" />

  <!-- 补充个像SDK的appid -->
  <meta-data
        android:name="GI_APPID"
    android:value="个像SDK的appid" />

  ....
</application> 


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.**{*;}

Android Maven集成视频

文档中心搜索