Android 集成文档

获取appid

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

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

添加maven库地址

在以项目名为命名的顶层build.gradle文件中，添加个推maven库地址：

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

配置依赖

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

dependencies {
    implementation 'com.getui:gisdk:3.3.2.0'
      implementation 'com.getui:gtc:3.1.7.0'
}

配置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);
    }
});

注意事项：为了保证 SDK 服务稳定，开发者需在 App《隐私政策》的 “与授权合作伙伴共享”条款中，将 个推的用户隐私政策 加入其中。并确保在 App 首次运行时通过明显方式提示终端用户阅读您的 App《隐私政策》，取得终端用户的合法授权后，再初始化 SDK ，详情可查看：个推合规指南 。

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集成视频