一、ADB Logcat在Unity开发中的核心作用

Logcat是Android系统提供的日志工具,能够实时捕获设备运行时的日志信息。在Unity开发中,通过集成Android Logcat包(需Unity 2019.4+版本),开发者可以直接在Unity Editor中查看设备日志、堆栈跟踪甚至屏幕录屏,极大提升了移动端调试效率。其核心应用场景包括:
崩溃分析:捕获Native层或脚本层的异常堆栈,定位代码错误;
性能监控:查看内存占用、GC触发情况等关键指标;
日志追踪:自定义日志标签(如Debug.Log输出的信息)用于逻辑调试。


二、环境配置与设备连接

1. 环境准备

模块安装:确保Unity工程已加载Android模块(通过File > Build Settings > Android切换平台)。
插件导入:在Package Manager中安装Android Logcat包,通过Window > Analysis > Android Logcat打开窗口(快捷键Alt+6)。

2. 设备连接方式

USB连接:设备需开启开发者模式USB调试,连接后Unity自动识别设备;
无线连接:首次需通过USB连接设备,在Logcat窗口选择设备选择器 > Connect via WiFi,输入设备IP后断开USB即可;

3.基础功能介绍

1:是设备的选择,当连接多个设备时候,可以通过这里选择。

2:选择应用的报名,选择当前自己的包的信息,防止被信息污染。

3:搜索日志的输入框

4:对应搜索的选项

5:连接设备

6:断开设备

7:清除日志

8:提供的工具


三、基础操作与日志分析

3.1. 日志内容搜索

在Logcat的日常使用中,日志搜索是开发者最频繁使用的核心功能。其搜索框位于界面显眼位置,允许通过输入特定内容快速过滤海量日志数据,从而实现高效问题定位。

首先定位到设备,然后定位到对应的应用,接着在搜索框输入日志内容中的关键字,如下图。

3.2 通过tag搜索

在Android开发中最常使用的Log.e()之类的日志工具函数,在这个插件中也是非常方便。

对应的日志上右击会出现添加TAG,删除也很简单,如下图。

有时候需要验证是否存在日志,可以在程序运行前增加TAG过滤,可以在Tag标题栏点击,接着点击TagControl

会弹出如下图,添加想要过滤的TAG。

3.3 优先级过滤

日志有不同的等级,可以通过优先级对日志进行过滤,插件也提供了这一栏,可以直接点击勾选关注的优先级,如下图。

3.2. 日志保存

有时候需要把日志保存的文件,日志文件可以分享给其他人进行分析,在插件中保存日志很容易。

全选日志(CTRL+A),接着右键选择Save Selection,保存到对应的位置即可

3.3. 屏幕捕获与录屏

实时截屏:通过Logcat工具栏的Screen Capture按钮捕获设备画面;
录屏功能:使用Screen Recorder记录操作流程,用于复现UI动画或交互问题。

3.4 在开发机器上输入内容到设备

选择Tools工具栏的Window,然后勾选Input,会打开键盘界面,如下图

在设备上唤醒输入进入输入状态就可以在pc上进行输入了。

3.5 查看设备内存状态

选择Tools工具栏的Window,然后勾选Memory,会打开内存界面,如下图。

可以通过对设备进行操作观察设备上的内存状态。


四、总结

ADB Logcat 是 Unity 开发中不可或缺的调试工具,可实时捕获 Android 设备日志,帮助开发者分析崩溃、监控性能、追踪日志等。通过 Unity 的 Android Logcat 插件,支持 USB 和无线连接设备,并提供日志搜索、Tag 过滤、优先级筛选等功能。此外,Logcat 还能保存日志、进行屏幕截图与录屏、远程输入设备内容、查看设备内存状态,大幅提升移动端调试效率,使问题定位和优化更加便捷。


求关注我公众号:程序这点事

Logo

苏州本地的技术开发者社区,在这里可以交流本地的好吃好玩的,可以交流技术,可以交流招聘等等,没啥限制。

更多推荐