implementation 'com.tencent.mars:mars-xlog:1.2.5'
第二步添加so库:添加so库在main文件夹下面新建一个jniLibs文件夹,用于存放armeabi-v7a文件夹,里面的两个so文件,都是通过Mars工程编译后得到的但是要完成Mars的编译其实挺麻烦的,需要ndk、cmake,如果是Windows环境还要visual studio安装了最新版也许还会报错,反正挺掉头发的然后,不要忘了在gradle中配置abiFilters:ndk { abiFilters "armeabi-v7a" }
第三步是添加权限,AndroidManifest.xml里:<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
也可以在MainActivity或者MainApplication里面申请权限:ActivityCompat.requestPermissions(this,new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},123);
这里是以Java为编程语言的,如果有使用kotlin的同学,可以自行转换一下第四步就是初始化XLog了,如果前面没有在gradle中配置abiFilters,也可以在初始化之前加载一下so库,加载方法://加载so库 System.loadLibrary("c++_shared"); System.loadLibrary("marsxlog");
初始化的代码: String logPath = this.getExternalFilesDir("").getPath() + "/test/xlog"; //日志地址 String cachePath = this.getExternalFilesDir("").getPath() + "/test/xlog/cache"; //缓存地址 Log.d("XLOG", logPath); Xlog xlog = new Xlog(); xlog.setConsoleLogOpen(10,true); //是否把日志打印到控制台 xlog.appenderOpen(Xlog.LEVEL_DEBUG, Xlog.AppednerModeAsync, cachePath, logPath, "dbxLog", 10); //开启日志
这里需要注意几点:如果你的程序使用了多个进程,不要把多个进程的日志输出到同一个文件中,保证每个进程独享一个日志文件;保存log的目录请使用单独的目录,不要存放任何其他文件防止被xlog自动清理功能误删;debug版本下建议把控制台日志打开,日志级别设为Verbose或者Debug,release版本建议把控制台日志关闭,日志级别使用Info;cachePath这个参数必传,mmap文件会放在这个目录,如果传空串,可能会发生SIGBUS的crash初始化都顺利完成后,就可以在后续业务代码中使用XLog打印日志了,比如这样: TextView tv = (TextView) findViewById(R.id.tv_one); tv.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Toast.makeText(MainActivity.this, "Hello", Toast.LENGTH_SHORT).show(); com.tencent.mars.xlog.Log.i("test","hello world!"); } });
最后别忘了在合适的生命周期中关闭日志,关闭方法如下:Log.appenderClose()
获取log日志从前面初始化的动作中,就可以知道日志都存放在了logPath的目录里面可以直接通过adb pull取出来日志文件解压直接获取到的是定义的前缀(appenderOpen方法中传入的nameprefix参数)+日期+.xlog的日志文件因为没有进行加密,使用Mars项目中的decode_mars_nocrypt_log_file.py进行解压缩就可以:python decode_mars_nocrypt_log_file.py dbxLog-20220502.xlog
执行完就能获取到直接阅读的.log文件了python decode_mars_nocrypt_log_file.py文件在Mars的位置是:mars/log/crypt/需要注意的是这个解压脚本使用的是python2,如果你不想在本地安装python2,就想使用python3的话,可以自己对这个解压脚本修改一下总结xlog相对以前的一些日志库,还是有很大提升的,但是项目的文档几乎没什么用,介绍十分潦草,没有对应的Api文档说明网上的一些集成教程也因为版本的原因或多或少都有一些小坑,总能踩中几个(图片来源网络,侵删)
0 评论