iOS项目已经添加mbugly或mdebugging插件重要提示:因这两个插件都含有崩溃日志收集,若已添加mbugly插件请更新至1.0.9,若已添加mdebugging插件请更新至1.0.9,否则可能导致无法采集崩溃日志
因要上传到阿里云oss服务器,必须依赖阿里云oss上传插件;
MLogCollection.writeToFile(log,success,error);
调用writeToFile方法写入普通日志文件时,会一直把日志信息追加进同一个文件里面;
若文件已经达到maxSize,则会新增一个日志文件,后续日志将追加进此文件内;
maxSize默认初始值为200kb,若要修改maxSize的值,请调用
setLogMaxSize
方法。
参数 | 类型 | 必填 | 作用 |
---|---|---|---|
log | string | 是 | 要写入文件的日志 |
success | function | 是 | 成功回调 |
error | function | 是 | 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"} |
MLogCollection.setConfigParams(config,success,error);
参数 | 类型 | 必填 | 作用 |
---|---|---|---|
config | json | 是 | 配置参数,追加进崩溃日志里面。 |
success | function | 是 | 成功回调 |
error | function | 是 | 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"} |
注意:
config
格式为{"p":"fast", "a":"analysis", "...":"..."}
p
对应product
,a
对应app
,p
和a
用于获取oss
上传文件授权Token
。如果p和a没有赋过值,会导致无法获取Token,日志无法上传。p
和a
保存逻辑:如果config
中含p
或a
,那么将会覆盖之前的p
或a
,如果不含,则使用之前存储的p
或a
...
表示支持任意扩展key
,value
config
内容将会追加入crash_log
中MLogCollection.getBasicInformation(success);
参数 | 类型 | 必填 | 作用 |
---|---|---|---|
success(result) | function | 是 | 成功回调,result为基础信息,是一个json字符串,字段详情请参考天眼属性文档 |
MLogCollection.setLogCollectionLevel(level,success,error);
参数 | 类型 | 必填 | 作用 |
---|---|---|---|
level | string | 是 | 设置采集级别: all:允许崩溃日志采集上传,允许天眼普通日志写入和上传; event:只允许天眼普通日志写入和上传; crash:只允许崩溃日志采集和上传; none:禁止所有日志采集和上传。 |
success | function | 是 | 成功回调 |
error | function | 是 | 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"} |
调用writeToFile方法写入普通日志文件时,会一直把日志信息追加进同一个文件里面;
若文件已经达到maxSize,则会新增一个日志文件,后续日志将追加进此文件内;
如果不调用此方法,插件默认初始值为200kb。
MLogCollection.setLogMaxSize(maxSize,success,error);
参数 | 类型 | 必填 | 作用 |
---|---|---|---|
maxSize | int | 是 | 普通日志文件size最大值,单位kb |
success | function | 是 | 成功回调 |
error | function | 是 | 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"} |
上传过程中,若文件个数较多,只压缩规定内的数目文件成zip上传到oss服务器,其他的等待下次上传时机;
如果不调用此方法,插件默认初始值为10。
MLogCollection.setCompressionNumber(number,success,error);
参数 | 类型 | 必填 | 作用 |
---|---|---|---|
number | int | 是 | 文件压缩个数 |
success | function | 是 | 成功回调 |
error | function | 是 | 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"} |