基础集成

1. 域名设置

在预初始化之前，开发者需要在调用SDK任意其它接口之前最先调用QtConfigure.setCustomDomain()接口设置私有化环境收数域名。

/**
 * 设置上传统计日志的主域名和备用域名。此函数必须在SDK预初始化/初始化函数调用之前调用。SDK会优先将统计数据上报到主域名，失败的情况下会再尝试将数据上报到备用域名。
 * 主域名primaryDomain或不能传入null或者空串，如果传入null或者空串，SDK预初始化函数会抛出SdkDomainUndefined运行时异常。
 * @param standbyDomain 备用域名可以传入null或者空串，此时SDK认为备用域名和主域名完全相同。SDK上传数据失败后第二次也会向主域名上报数据。
 * 传入的域名参数应该包含"https://" 前缀。	 
*/
public static void setCustomDomain(String primaryDomain, String standbyDomain)

APM稳定性库相关域名接口：

public static void setCustomDomainCrash（String url）

APM性能库相关的域名接口：

public static void setCustomDomainCrash（String url）

示例：

public class MainApplication extends Application {
  
 @Override
 public void onCreate() {
 super.onCreate();

 QtConfigure.setCustomDomain("xxxxxx", null); // 请传入您自己的收数域名
 UMEfs.setCustomDomainEfs("xxxxxx");// 请传入您自己的性能库的收数域名
 UMCrash.setCustomDomainCrash("xxxxxx");// 请传入您自己的稳定性库的收数域名
 
 //打开调试log(线上环境请关闭)
 QtConfigure.setLogEnabled(true);
 QtConfigure.preInit(this,"您的appkey","应用商店名称");
 QtTrackAgent.disableActivityPageCollection();

如果数据统计和性能体验使用的是一个收数域名，那么仅需要设置"QtConfigure.setCustomDomain"即可。

2. 用户账号统计

可选功能，与统计分析使用同一套接口，设置后在产品后台会同展示用户账号

1、默认在统计用户时以设备为标准，如果需要统计应用自身的账号，请使用以下接口：

public static void onProfileSignIn(String ID);
public static void onProfileSignIn(String Provider, String ID);

2、账号登出时需调用此接口，调用之后不再发送账号相关内容。

public static void onProfileSignOff();

3. 合规初始化

3.1 初始化接口

由于工信部的合规要求，App在用户同意隐私政策前不可以获取任何个人信息，所以初始化为以下操作：

1.预初始化

请在宿主App的Application.onCreate函数中调用基础组件库初始化函数。

// SDK预初始化函数不会采集设备信息，也不会上报数据。 
// preInit预初始化函数耗时极少，不会影响App首次冷启动用户体验
QtConfigure.preInit(this,"您的AppKey","Channel");

2.正式初始化

请务必在用户同意隐私政策后，再初始化SDK。

// 正式初始化SDK，务必调用 
QtConfigure.init(this,"您的AppKey",QtConfigure.DEVICE_TYPE_PHONE, "");

3.2 Appkey获取

在产品的“管理控制台”——》“应用管理”中，找到您的应用获取。

4. 日志打印

可通过QtConfigure.setLogEnabled(boolean)接口控制LOG的输出。

注意：

• App正式上线前请关闭SDK运行调试日志。避免无关Log输出。

日志开关

可以通过调用如下方法控制SDK运行调试日志是否输出，默认情况下SDK运行调试日志关闭。需要用户手动打开。

/**
* 设置组件化的Log开关
* @param boolean 默认为false，如需查看LOG设置为true
*/
QtConfigure.setLogEnabled(true);

注意：

• 如果查看初始化过程中的LOG，一定要在调用初始化方法前将LOG开关打开。

日志等级

• 日志分为四种等级，方便用户查看：

• Error（打印SDK集成或运行时错误信息）。

• Warn（打印SDK警告信息）。

• Info（打印SDK提示信息）。

• Debug（打印SDK调试信息）。