跳转至

自定义标签使用

编译配置方式

  1. 在 build.gradle 中创建多个 productFlavors 来做区分区分标签

    android{
        //…
        productFlavors {
            prodTest {
                buildConfigField "String", "CUSTOM_VALUE", "\"Custom Test Value\""
                //…
            }
            prodPublish {
                buildConfigField "String", "CUSTOM_VALUE", "\"Custom Publish Value\""
                //…
            }
        }
    }
    
  2. 在 RUM 配置中添加对应 BuildConfig 常量

    FTSdk.initRUMWithConfig(
            new FTRUMConfig()
                .addGlobalContext(CUSTOM_STATIC_TAG, BuildConfig.CUSTOM_VALUE)
                //... 添加其他配置
    );
    
    FTSdk.initRUMWithConfig(
                FTRUMConfig()
                    .addGlobalContext(CUSTOM_STATIC_TAG, BuildConfig.CUSTOM_VALUE)
                    //… 添加其他配置
            )
    

运行时读写文件方式

  1. 通过存文件类型数据,例如 SharedPreferences,配置使用 SDK,在配置处添加获取标签数据的代码。

    SharedPreferences sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE);
    String customDynamicValue = sp.getString(CUSTOM_DYNAMIC_TAG, "not set");
    
    // 配置 RUM
    FTSdk.initRUMWithConfig(
         new FTRUMConfig().addGlobalContext(CUSTOM_DYNAMIC_TAG, customDynamicValue)
         //… 添加其他配置
    );
    
    val sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE)
    val customDynamicValue = sp.getString(CUSTOM_DYNAMIC_TAG, "not set")
    
    //配置 RUM
    FTSdk.initRUMWithConfig(
         FTRUMConfig().addGlobalContext(CUSTOM_DYNAMIC_TAG, customDynamicValue!!)
         //… 添加其他配置
    )
    
  2. 在需要时添加修改文件数据的方法。

    public void setDynamicParams(Context context, String value) {
        SharedPreferences sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE);
        sp.edit().putString(CUSTOM_DYNAMIC_TAG, value).apply();
    }
    
    fun setDynamicParams(context: Context, value: String) {
                val sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE)
                sp.edit().putString(CUSTOM_DYNAMIC_TAG, value).apply()
    
            }
    
  3. 最后重启应用,详情请见 SDK Demo

SDK 运行时添加

在 SDK 初始化完毕之后,使用 FTSdk.appendGlobalContext(globalContext)、FTSdk.appendRUMGlobalContext(globalContext)、FTSdk.appendLogGlobalContext(globalContext) 可以动态添加标签,设置完毕后会立即生效。随后,RUM 或 Log 后续上报的数据会自动附带对应标签。

这种使用方式适合延迟获取数据的场景,例如标签数据需要通过登录、接口请求或本地异步初始化之后才能拿到。

Warning

避免与 SDK 初始化配置中的 globalContext 或 SDK 内置字段使用相同 key;同名时,初始化配置中的静态标签优先级高于动态添加的标签。

使用方法

/**
 * 动态设置全局 tag
 * @param globalContext
 */
public static void appendGlobalContext(HashMap<String,Object> globalContext)

/**
 * 动态设置 RUM 全局 tag
 * @param globalContext
 */
public static void appendRUMGlobalContext(HashMap<String,Object> globalContext)

/**
 * 动态设置 log 全局 tag
 * @param globalContext
 */
public static void appendLogGlobalContext(HashMap<String,Object> globalContext)
/**
 * 动态设置全局 tag
 * @param globalContext
 */
fun appendGlobalContext(globalContext: HashMap<String, Any>)

/**
 * 动态设置 RUM 全局 tag
 * @param globalContext
 */
fun appendRUMGlobalContext(globalContext: HashMap<String, Any>)

/**
 * 动态设置 log 全局 tag
 * @param globalContext
 */
fun appendLogGlobalContext(globalContext: HashMap<String, Any>)
//SDK 初始化伪代码,从网络获取到参数后,再进行标签设置

FTSdk.init() 

getInfoFromNet(info){
    HashMap<String, Object> globalContext = new HashMap<>();
    globalContext.put("delay_key", info.value);
    FTSdk.appendGlobalContext(globalContext)
}

代码示例

HashMap<String, Object> globalContext = new HashMap<>();
globalContext.put("global_key", "global_value");
FTSdk.appendGlobalContext(globalContext);

HashMap<String, Object> rumGlobalContext = new HashMap<>();
rumGlobalContext.put("rum_key", "rum_value");
FTSdk.appendRUMGlobalContext(rumGlobalContext);

HashMap<String, Object> logGlobalContext = new HashMap<>();
logGlobalContext.put("log_key", "log_value");
FTSdk.appendLogGlobalContext(logGlobalContext);
val globalContext = hashMapOf<String, Any>(
    "global_key" to "global_value"
)
FTSdk.appendGlobalContext(globalContext)

val rumGlobalContext = hashMapOf<String, Any>(
    "rum_key" to "rum_value"
)
FTSdk.appendRUMGlobalContext(rumGlobalContext)

val logGlobalContext = hashMapOf<String, Any>(
    "log_key" to "log_value"
)
FTSdk.appendLogGlobalContext(logGlobalContext)

文档评价

文档内容是否对您有帮助?