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.6.0'
}

为了获取SDK启动后的事件响应,还必须实现一个Receiver并在AndroidManifest.xml中配置,示例如下:

<receiver
    android:name="com.xxx.GInsightEventReceiver" android:exported="false">
    <intent-filter>
        <action android:name="com.getui.gis.action.您的AppId" /> <!—-替换成个像的APPID ->
    </intent-filter>
</receiver>

Receiver代码示例如下:

package com.getui.ginsightdemo;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;

import com.getui.gis.sdk.GInsightManager;

public class GInsightEventReceiver extends BroadcastReceiver {

    public static final String TAG = GInsightEventReceiver.class.getSimpleName();

    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getStringExtra("action");
        if (action.equalsIgnoreCase(GInsightManager.ACTION_GIUID_GENERATED)) {
            String giuid = intent.getStringExtra("giuid");
            Log.i(TAG, "giuid = " + giuid);
        }
    }
}

配置渠道

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

channel config

manifestPlaceholders = [
    GT_INSTALL_CHANNEL : "your channel"
]

"your channel" 为将要发布的渠道。

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

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

Android 9.0 兼容配置

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

初始化

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

GInsightManager.getInstance().init (getApplicationContext(), "您的appid");

GInsightManager接口类

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

方法详细资料

获取GInsightManager单例对象

public static GInsightManager getInstance()

返回:

GInsightManager单例对象

初始化

public void init(Context context, String appid)

参数:

context - application上下文

appid - 您的appid

设置渠道

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

文档中心搜索