此文档介绍Android崩溃分析SDK提供的接口。
自定义异常
崩溃信息SDK提供了上报自定义异常的API，方便您上报自定义异常。每次上报最多携带8条自定义异常。
recordException
上报自定义异常。
接口定义
void recordException(@NonNull Throwable throwable)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
throwable | Throwable | 是 | 异常 |
代码示例
ApmCrashAnalysis.getInstance().recordException(new RuntimeException("This is an non-fatal"));添加日志信息
崩溃信息SDK提供了添加日志信息的API，以便您添加额外的日志信息。
log
添加日志信息。
单次崩溃可多次调用log接口添加日志，但是单次崩溃最大携带的日志是64K。如果超过64K，会按时间顺序删除最早的日志。
接口定义
void log(@NonNull String message)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
message | String | 是 | 日志信息 |
添加自定义维度
崩溃分析SDK提供了一系列API，以便您可以自定义维度数据。
单次崩溃最多携带64条key/value对。
setCustomKey
添加值是boolean类型的数据。
接口定义
void setCustomKey(@NonNull String key, boolean value)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | boolean | 是 | 值 |
setCustomKey
添加值是double类型的数据。
接口定义
void setCustomKey(@NonNull String key, double value)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | double | 是 | 值 |
setCustomKey
添加值是float类型的数据。
接口定义
void setCustomKey(@NonNull String key, float value)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | float | 是 | 值 |
setCustomKey
添加值是int类型的数据。
接口定义
void setCustomKey(@NonNull String key, int value)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | int | 是 | 值 |
setCustomKey
添加值是long类型的数据。
接口定义
void setCustomKey(@NonNull String key, long value)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | long | 是 | 值 |
setCustomKey
添加值是String类型的数据。
接口定义
void setCustomKey(@NonNull String key, @NonNull String value)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | String | 是 | 值，最长1024位，超过会截断。 |
setCustomKeys
添加一批键值对。
接口定义
void setCustomKeys(@NonNull CustomKeysAndValues keysAndValues)
所属类
ApmCrashAnalysis
参数说明
参数 | 类型 | 是否必填 | 说明 |
keysAndValues | 是 | 一批键值对。 |
CustomKeysAndValues
CustomKeysAndValues可以包含一组自定义的键值对。
putString
添加值是String类型的数据。
接口定义
CustomKeysAndValues.Builder putString(@NonNull String key, @NonNull String value)
所属类
CustomKeysAndValues.Builder
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | String | 是 | 值，最长1024位，超过会截断。 |
putBoolean
添加值是boolean类型的数据。
接口定义
CustomKeysAndValues.Builder putBoolean(@NonNull String key, boolean value)
所属类
CustomKeysAndValues.Builder
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | boolean | 是 | 值 |
putDouble
添加值是double类型的数据。
接口定义
CustomKeysAndValues.Builder putDouble(@NonNull String key, double value)
所属类
CustomKeysAndValues.Builder
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | double | 是 | 值 |
putFloat
添加值是float类型的数据。
接口定义
CustomKeysAndValues.Builder putFloat(@NonNull String key, float value)
所属类
CustomKeysAndValues.Builder
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | float | 是 | 值 |
putLong
添加值是long类型的数据。
接口定义
CustomKeysAndValues.Builder putLong(@NonNull String key, long value)
所属类
CustomKeysAndValues.Builder
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | long | 是 | 值 |
putInt
添加值是int类型的数据。
接口定义
CustomKeysAndValues.Builder putInt(@NonNull String key, int value)
所属类
CustomKeysAndValues.Builder
参数说明
参数 | 类型 | 是否必填 | 说明 |
key | String | 是 | 键，最长1024位，超过会截断。 |
value | int | 是 | 值 |
build
构建CustomKeysAndValues实例。
接口定义
CustomKeysAndValues build()
所属类
CustomKeysAndValues.Builder
返回值说明
类型 | 说明 |
CustomKeysAndValues | CustomKeysAndValues实例 |