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":"出错啦"} |