FT Mobile SDK Android

安装

• 在项目的根目录的build.gradle文件中添加FT SDK的的远程仓库地址

repositories {
    //...
    maven {
        url 'https://mvnrepo.jiagouyun.com/repository/maven-releases'
    }

}

• 在项目的主模块的build.gradle文件中添加FT SDK的依赖

dependencies {
    implementation 'com.cloudcare.ft.mobile.sdk.traker.agent:ft-sdk:1.0.0'
}

关于最新的版本号，请参考更新文档

配置

1. 在程序的入口Application中添加关于FT SDK的初始化配置安装代码。 关于配置项的说明

参数	类型	含义	是否必须
metricsUrl	String	FT-GateWay metrics 写入地址	是
enableRequestSigning	boolean	配置是否需要进行请求签名	是
akId	String	access key ID	enableRequestSigning 为 true 时，必须要填
akSecret	String	access key Secret	enableRequestSigning 为 true 时，必须要填
useOAID	boolean	是否使用oaid字段了解OAID	否
isDebug	boolean	是否需要显示日志	否

示例代码

public class DemoApplication extends Application {
    private String accesskey_id = "xxxx";
    private String accessKey_secret = "xxxxx";

    public DemoApplication() {
        super();
    }

    @Override
    public void onCreate() {
        super.onCreate();

        FTSDKConfig ftSDKConfig = new FTSDKConfig("http://xxxxx",
                true,
                accesskey_id,``
                accessKey_secret);
        ftSDKConfig.setUseOAID(true);
        FTSdk.install(ftSDKConfig);
    }
}

2. 关于权限的配置 FT SDK用到了系统的两个权限，分别为READ_PHONE_STATE、WRITE_EXTERNAL_STORAGE 权限使用说明

名称	使用原因
READ_PHONE_STATE	用于获取手机的设备信息，便于精准分析数据信息
WRITE_EXTERNAL_STORAGE	用户存储缓存数据

关于如何申请动态权限，具体详情参考Android Devloper

方法

1、FT SDK公开了2个埋点方法，用户通过这三个方法可以主动在需要的地方实现埋点，然后将数据上传到服务端。

• 方法一：

/*** 主动埋点
 * @param event 埋点事件名称
 * @param tags 埋点数据
 * @param values 埋点数据
 */
 public void track(String event, JSONObject tags, JSONObject values)

• 方法二：

/**
 * 主动埋点
 * @param event 埋点事件名称
 * @param values 埋点数据
 */
 public void trackValues(String event, JSONObject values)

2、方法使用示例

public void clickText(View view) {
    try {
        JSONObject tags = new JSONObject();
        JSONObject values = new JSONObject();
        tags.put("view","text");
        values.put("userName","admin");
        FTTrack.getInstance().track("ClickView",tags,values);
    } catch (JSONException e) {
        e.printStackTrace();
    }
}

@Override
public boolean onOptionsItemSelected(@NonNull MenuItem item) {
    try {
        JSONObject values = new JSONObject();
        values.put("userName","MenuItem");
        FTTrack.getInstance().trackValues("ClickView",values);
    } catch (JSONException e) {
        e.printStackTrace();
    }
    return super.onOptionsItemSelected(item);
}

常见问题

1.关于OAID

• 介绍

在Android 10版本中，非系统应用将不能获取到系统的IMEI、MAC等信息。面对该问题移动安全联盟联合国内的手机厂商推出了 补充设备标准体系方案，选择用OAID字段作为IMEI等系统信息的替代字段。OAID 字段是由中国信通院联合华为、小米、OPPO、 VIVO 等厂商共同推出的设备识别字段，具有一定的权威性。 关于OAID可移步参考移动安全联盟

• 使用

使用方式和资源下载可参考移动安全联盟的集成文档

示例：

1. 下载好资源文件后，将miit_mdid_x.x.x.arr拷贝到项目的libs目录下，并设置依赖，其中x.x.x代表版本号 获取最新版本

   

2. 将下载的资源中的supplierconfig.json文件拷贝到主项目的assets目录下，并修改里面对应的内容，特别是需要设置appid的部分。 需要设置appid的部分需要去对应厂商的应用商店里注册自己的app。

   

   

3. 设置依赖

implementation files('libs/miit_mdid_x.x.x.arr')

4. 混淆设置

 -keep class com.bun.miitmdid.core.**{*;}

5. 设置gradle编译选项，这块可以根据自己的对平台的选择进行合理的配置

ndk {
    abiFilters 'armeabi-v7a','x86','arm64-v8a','x86_64','armeabi'
}
packagingOptions {
    doNotStrip "*/armeabi-v7a/*.so"
    doNotStrip "*/x86/*.so"
    doNotStrip "*/arm64-v8a/*.so"
    doNotStrip “*/x86_64/*.so"
    doNotStrip "armeabi.so"
}

6. 以上步骤配置完成后，在配置FT SDK时调用FTSDKConfig的setUseOAID(true)方法即可