前言:
俗话说,工欲善其事,必先利其器。logcat是我们通过日志排查bug的重要武器之一。从某个版本开始,logcat改版了,改版之后,也许某些人觉得不太习惯,但是如果稍微学习下之后,就发现新版的logcat真的比老版本的好多太多。
也许某个人懒,不太愿意去android的官网查看官方介绍,那么本地特别适合你,本文就是对官网介绍的详细说明以及实例的演示。
android官网logcat的相关介绍。
https://developer.android.google.cn/studio/debug/logcat?hl=zh-cn
logcat界面基本介绍
首先介绍下logcat界面上的组成:
1.顶部框
名称 | 说明 |
TAB栏 | 一个TAB栏对应一个logcat显示框,可以配置多个 |
设备 | 当同时连接太多设备时,可以选择不同的设备显示其logcat |
筛选框 | 对输出的logcat按照规则进行筛选,具体筛选的规则第二章来讲 |
配置按钮 | 对logcat显示的区域,位置,大小等等进行配置 |
2.左侧栏
名称 | 说明 |
暂停 | 暂停logcat的日志输出,使其保持在当前状态。 这个功能很适合我们排查bug时发现了一场日志,避免后面的持续输出的日志的影响。 |
重启 | 重启logcat功能。 |
置底按钮 | logc不断输出,使显示的log内容一直是最新的,也就是现实log内容的最底部。 |
往上查找 | 往上查找最近一次的堆栈日志。 |
往下查找 | 往下查找最近一次的堆栈日志。 |
分行显示 | 有时候一个logcat内容输出太多,默认一行展示不下就缩略了。选择多行显示时,会分成多行显示。 |
配置显示内容 | 对内容框中显示的内容进行配置 |
分成多块显示 | 底部框分成两块,分别独立显示logcat |
截屏 | 截屏功能 |
录屏 | 录屏功能 |
3.搜索栏
名称 | 说明 |
搜索内容 | 输入搜索的内容,这里支持区分大小写,单词匹配,转义。 |
向上 | 向上查找 |
向下 | 向下查找 |
搜索范围选择 | 选择搜索的范围,比如所有类型,评论中,字符串中等等 |
4.内容框
名称 | 说明 |
时间 | 日志输出的时间,这里的时间为手机上的时间。 |
进程ID和线程ID | 进程ID和线程ID,这里的线程ID指的是在linux虚拟机中的线程ID。 |
TAG | 我们日志中的tag。 |
进程名 | 进程名,如果是APP应用的话一般为包名。 |
日志优先级 | 共有六种登记,分别为verbose/debug/info/warn/error/assert |
日志内容 | 我们日志中的msg。 |
筛选功能
1.包名
我们可以根据包名来对log的内容进行筛选,如果我们筛选的包名是com.xt.appplugin ,则可以在筛选框输入:package:com.xt.appplugin,这样筛选出来的log就只是com.xt.appplugin这个应用输出的了。
如果当前调试的应用就是com.xt.appplugin的话,我们也可以输入:package:mine,mine代表就是当前应用,如下:
2.进程名
进程名和包名有什么区别呢?因为一个应用可以多进程,如果我们只关心其中某一个进程的日志输出,就可以使用这个功能。
为了方便读者理解,我们举例说明一下,测试代码如下:
//Activity中findViewById(R.id.text1).setOnClickListener(v -> { Log.i("lxltest", "button1 press"); Intent intent = new Intent(this, TestService.class); startService(intent);});//Service中public class TestService extends Service { @Override public void onCreate() { super.onCreate(); Log.i("lxltest", this.getClass().getSimpleName() + ",onCreate"); }}
如果我们输入的筛选内容是:package:com.xt.appplugin
则输出日志内容为:
2023-03-16 10:46:07.059 9333-9333 lxltest com.xt.appplugin I button1 press---------------------------- PROCESS STARTED (9381) for package com.xt.appplugin ----------------------------2023-03-16 10:46:07.215 9381-9381 ziparchive com.xt.appplugin W Unable to open '/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dm': No such file or directory2023-03-16 10:46:07.216 9381-9381 .appplugin:aaaa com.xt.appplugin W ClassLoaderContext classpath size mismatch. expected=0, found=1 (PCL[] | PCL[/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dex*1426120062])2023-03-16 10:46:07.230 9381-9381 GraphicsEnvironment com.xt.appplugin V ANGLE Developer option for 'com.xt.appplugin' set to: 'default'2023-03-16 10:46:07.230 9381-9381 GraphicsEnvironment com.xt.appplugin V ANGLE GameManagerService for com.xt.appplugin: false2023-03-16 10:46:07.231 9381-9381 GraphicsEnvironment com.xt.appplugin V Updatable production driver is not supported on the device.2023-03-16 10:46:07.236 9381-9381 NetworkSecurityConfig com.xt.appplugin D No Network Security Config specified, using platform default2023-03-16 10:46:07.236 9381-9381 NetworkSecurityConfig com.xt.appplugin D No Network Security Config specified, using platform default2023-03-16 10:46:07.239 9381-9381 lxltest com.xt.appplugin
而我们输入的筛选内容如果是:process:com.xt.appplugin:aaaa
则输出内容是:
---------------------------- PROCESS STARTED (9591) for package com.xt.appplugin ----------------------------2023-03-16 10:47:08.735 9591-9591 ziparchive com.xt.appplugin W Unable to open '/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dm': No such file or directory2023-03-16 10:47:08.737 9591-9591 .appplugin:aaaa com.xt.appplugin W ClassLoaderContext classpath size mismatch. expected=0, found=1 (PCL[] | PCL[/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dex*1426120062])2023-03-16 10:47:08.750 9591-9591 GraphicsEnvironment com.xt.appplugin V ANGLE Developer option for 'com.xt.appplugin' set to: 'default'2023-03-16 10:47:08.751 9591-9591 GraphicsEnvironment com.xt.appplugin V ANGLE GameManagerService for com.xt.appplugin: false2023-03-16 10:47:08.751 9591-9591 GraphicsEnvironment com.xt.appplugin V Updatable production driver is not supported on the device.2023-03-16 10:47:08.756 9591-9591 NetworkSecurityConfig com.xt.appplugin D No Network Security Config specified, using platform default2023-03-16 10:47:08.757 9591-9591 NetworkSecurityConfig com.xt.appplugin D No Network Security Config specified, using platform default2023-03-16 10:47:08.760 9591-9591 lxltest com.xt.appplugin I TestService,onCreate2023-03-16 10:47:13.687 9591-9602 System com.xt.appplugin W A resource failed to call close.
区别其实就是少了主进程的下面这条日志:
2023-03-16 10:46:07.059 9333-9333 lxltest com.xt.appplugin I button1 press
3.TAG
TAG就比较容易理解了,根据输入的TAG进行筛选。这里的tag使用的是模糊匹配。
比如下面代码:
Log.i("lxltest", "button press");Log.e("lxl", "button end");
如果我们使用的是:tag:lxl
则最终的输出内容就是,会把所有tag以lxl为前缀的日志全部筛选出来。
2023-03-16 10:49:53.200 9535-9535 lxltest com.xt.appplugin I button press2023-03-16 10:49:53.200 9535-9535 lxl com.xt.appplugin
而如果使用lxltest,则只会筛选出button press这一条了。
4.日志级别
日志级别使用的关键词是level,从低到高分别是:verbose/debug/info/warn/error/assert六种级别。
筛选低级别的日志可以打印高级别的日志,反之则不行。
我们仍然用代码来验证下:
Log.v("lxltest", "level verbose");Log.d("lxltest", "level debug");Log.i("lxltest", "level info");Log.w("lxltest", "level warn");Log.e("lxltest", "level error");//打印assert级别的日志Log.println(Log.ASSERT, "lxltest", "level assert");
如果筛选框输入的是:level:verbose,则日志内容输入如下:
如果筛选框输入的是:level:info,则日志内容输入如下:
如果筛选框输入的是:level:assert,则日志内容输入如下:
5.内容
默认输出全部日志如下:
内容筛选支持模糊搜索,筛选框输入:message:level,因为level对所有的字符串都生效,所以日志全部输出,显示如下:
筛选框输入message:level info,因为只能匹配level info这一项,所以显示内容如下:
内容筛选时,输入也可以输入message:'level info'和也可以输入message:level info的效果是一样的。
6.时间
关键词age,我们可以通过这个关键词对日志以时间纬度进行一定的筛选。
比如我想筛选10分钟内的所有日志,则筛选框输入:age:10m即可,其它时间同理,最大支持到天。
单位 | 介绍 |
s | 秒 |
m | 分钟 |
h | 小时 |
d | 天 |
值得注意的是,这里的筛选时间指的是以电脑时间对日志的时间进行筛选。举例例子,电脑时间为12:30,手机时间为12:00。筛选10m内所有日志,AS会去寻找所有时间范围在12:20到12:30之间的日志,这肯定是找不到的,所以最终的日志显示就是空。所以使用这一筛选项时,务必保证手机和电脑时间是同步的。
7.多选-且
大多数情况下,单一的某一个筛选条件肯定是不够的,所以就需要多个筛选条件组合起来用。
logcat筛选框中,如果同时输入多个条件,默认情况下不同类型的筛选,是且的关系。
比如如下的日志:
Log.v("lxltest", "level verbose");Log.d("lxltest", "level debug");Log.i("lxltest", "xxxxx info");Log.w("lxltest", "level warn");Log.e("lxltest", "level error");Log.println(Log.ASSERT, "lxltest", "level assert");
筛选条件输入两个:message:level level:warn
这时候level verbose的这条日志就会被过滤掉,只显示其余的3条日志,xxxxx info
如果是相同类型的筛选,则默认是或的关系,比如还是上面的那个例子,
我们输入筛选条件:message:level message:info
因为上面六个选项中,使用模糊匹配,全部满足,所以六条日志全部显示出来了
如果相同类型仍然进行且的筛选,则我们需要改一下筛选条件:message:level & message:warn
这时候同时满足message中包含level和warn的只有level warn这一条,所以也就展示了这一条。
8.多选-或
刚才讲过,如果如果同时输入多个不同条件的筛选项,那么是且的关系。如果我们想改成或应该怎么办呢?
还是上面那个例子,我们改一下筛选项:message:level | level:warn
这时候就变成了满足message中包含level或者日志等于大于等于warn的才显示。
9.多选-组合
上面讲了种种筛选的场景,如果仍然无法满足我们的需求怎么办?这时候我们就要使用灵活多样的组合了。
比如来一个实际的场景,我想监控从A应用点击按钮开始,跳转到B应用页面的完整日志流程,其中就包含了多种条件的组合。
进程名为com.xt.appplugin(应用A),system_server(系统应用)或com.xt.client(应用B)
tag为lxltest或者Activity
日志级别为debug
则我们组合上面所列的各种筛选条件,如下:
(process:system_server | process:com.xt.appplugin | process:com.xt.client) & level:debug & (tag:lxltest | tag:Activity)
最终点击按钮(button click),经过系统分发,最终跳转到了应用B。
日志结果如下,我们可以看到跨越三个进程的相关日志。
界面配置
也许有的人会吐槽,新版本的msg太短了,有的吐槽一屏显示的内容太少,别急,通过界面配置,可以打造出我们想要的dream window。
左侧栏功能介绍
首先我们看一下左侧栏有哪些功能
1.日志清空
顾名思义,清空日志内容。
2.日志暂停
我们排查BUG的时候,往往发现问题后还没来得及仔细看,相关的就被后来的日志给挤走了。这时候如果点击了暂停按钮,新的日志就不会继续输出,方面我们排查问题了。
3.logcat重启
顾名思义,重启logcat,如果遇到log不输出等问题可以点击这个按钮。
4.光标置底
选中时,有最新的日志输出时右侧的进度条会自动切换到最底部。
取消选中时,则不会固定在最底部
5.定位上一个/下一个堆栈
当有异常时,点击这个按钮会自动帮我们切换到对应的代码中。
点击下时则帮我们切换到at android.os.Looper.loopOnce(Looper.java:201)这一行所对应的代码。
6.分行显示
不分行显示时:
分行显示时:
7.配置显示内容
目前显示的内容包括时间/进程-线程ID/TAG/进程名/日志级别/MSG内容,是不是觉得太多?如果我只是调试自己的应用,就没必要关心其它进程的日志信息。那么我们就可以进行配置
比如作者删除了进程名和包名,msg可显示的区域一下子就变多了。
8.分屏显示
可以同时显示两块logcat区域,我们可以是上下还是左右的方式显示
9.截屏和录屏
顾名思义,就不过多解释了
顶部框功能集合介绍
顶部功能包括TAB栏,配置按钮
1.TAB栏
tab栏可以配置多个logcat显示框,比如作者就配置了两个logcat框,可以自由切换。
2.配置显示模式
首先我们来讲配置->View Mode,这里可以配置我们期望日志框展示的模式。
比如作者最经常使用的Float模式,一整屏显示日志,超级爽。
3.配置显示区域
接下来讲配置->Move to的功能。这里可以配置日志框显示的区域。
比如改成Left Top
来源地址:https://blog.csdn.net/AA5279AA/article/details/129588390