【Unity插件】Editor Console Pro 控制台插件 官方文档翻译

发表于2017-11-04
评论0 6.7k浏览
Editor Console Pro插件Unity商店地址:https://www.assetstore.unity3d.com/cn/#!/content/11889

Editor Console Pro,这款插件对Unity自带的shi一样的控制台做了扩展。
而且这款插件长期霸占Unity付费排行榜的前3名。
从286条评论(我感觉Unity商店里,基本上有50条评论的插件,就算是很火爆的插件了!)就可以看出,大家对这款插件的喜爱,以及对Unity自带的控制台的不满意哈哈哈哈。
很难告诉大家这款插件有多么好,他有一些功能,比如:
可以输出的时候指定特点的标签
可以只看某个标签的输出内容
可以看到输出内容的相关代码块
但是这些说出来也感觉也就那样吧,所以感觉很难安利。
只能说,我用了这款插件之后,debug效率提高了80%左右,以及我再也没看过Unity自带的控制台一眼!!!!



Editor Console Pro 控制台插件 官方文档


Editor Console Pro编辑控制台插件


GENERAL 概括

Opening Editor Console Pro 打开编辑器控制台

您可以使用热键COMMAND + \ 或在菜单Window / Console Pro 3中打开ECP窗口

Opening Preferences 打开首选项

有几种打开首选项的方法:

右键单击工具栏的空白区域,然后单击首选项 Preferences

单击窗口右上角的图标,然后单击首选项Preferences


单击窗口右上角的图标,然后单击首选项Preferences

打开主菜单

右键单击工具栏的任何空白区域以显示ECP的主菜单。


右键单击工具栏的任何空白区域以显示ECP的主菜单。


TOOLBAR BUTTONS 工具按钮

Toolbar Buttons 工具栏按钮

可以通过右键单击工具栏(toolbar)按钮并单击自定义(Customize),或转到首选项/工具栏(Preferences/Toolbar)来定制工具栏按钮布局。


工具栏按钮布局-可自定义

Filter Buttons 过滤器按钮

Standard, Custom, and Temporary filters all show on the right side of the toolbar.

标准,自定义和临时过滤器都显示在工具栏的右侧。

单击一个过滤器来显示/隐藏(show/hide)其匹配的日志

Ctrl +单击(Ctrl+Click )一个过滤器来隐藏每个过滤器,但是只能一个

Shift +单击(Shift+Click)一个过滤器来显示所有的过滤

右键点击一个过滤器来定制它


过滤器


SEARCHING 正在搜索

Search Field 搜索字段

搜索字段允许您通过键入搜索字符串来筛选当前的可见日志。


搜索!

Search Count 搜索计数

搜索计数显示与搜索匹配的日志数量

Search Options 搜索选项

点击放大镜显示搜索选项。 它们如下:

Search - 只显示包含此搜索字词的日志

Ignore - 隐藏包含此搜索字词的日志

Exact/Exact Case Insensitive - 搜索字词必须完全相符

Fuzzy - 更宽容的搜索,允许一些打字错误

Regex - 匹配正则表达式

剩余的选项定义您要搜索的列


搜索选项多种多样


LOGS 日志

Colorized 彩色

日志背景可以通过匹配的过滤器进行着色,因此它们更易于查看。 您可以在首选项/日志(Preferences/Logs)中禁用此选项。

Word Wrap 词包裹

日志文本可以被包装,这使日志更高的内容。 您可以在首选项/日志(Preferences/Logs)中禁用此选项。

Multiline 多行

日志将显示多行(\ n),使日志更高的内容。 当这被禁用时,日志将在最后显示返回字符,以显示它们是多行的。 您可以在首选项/日志(Preferences/Logs)中禁用此选项。

Show Class And File Under Log Text 在日志文本下显示类和文件

此选项使日志看起来类似于Unity默认日志。 您可以在首选项/日志(Preferences/Logs)中禁用此选项。

Copy 复制

右键单击日志条目以获取复制到剪贴板的各种选项。

Multi Select 多选

按住shift或命令,然后单击多个日志,将其全部选择进行复制操作。

Ignore 忽视

如果您希望始终忽略日志,例如“音频源太多(Too many audio sources)”,可以在“忽略日志Ignore Logs”类别的“首选项/忽略Preferences/Ignore”中添加搜索字词。


STACK 堆


可以看到输出的代码(可视化!这点特别好!)

Source Code Preview 源代码预览

ECP将向您显示围绕堆栈每行的源代码。 您可以在“首选项/源预览(Preferences/Source)”中进行设置。

Jump To Line 跳到线

单击堆栈中的任何行以将代码编辑器打开到该行,包括源代码行。

Ignore Wrapper Functions 忽略包装器功能

右键单击堆栈行,然后单击“忽略此堆栈条目(Ignore This Stack Entry)”以忽略包装器函数,例如MyDebug.MyLog。

ECP现在不会显示任何调用此函数的堆栈行,双击日志也将略过。 这可以在首选项/忽略(Preferences/Ignore)中配置。 如果您想忽略整个类,只需从“忽略堆栈条目”中的条目中删除该函数名称(因此上述示例将只是MyDebug)。

Copy 复制

右键单击堆叠行,您可以使用各种选项将其复制到剪贴板,例如使用周围的源代码或整个堆栈。


CUSTOM FILTERS 自定义过滤器


过滤器的名字、图标、是否显示等等,都可以自定义!

Custom Filters 自定义过滤器

您可以使用搜索字词创建自己的文件夹,其按钮显示在标准文件旁边(日志,警告,错误等(Log, Warning, Error, etc))旁边。 它们可以在首选项/自定义过滤器中自定义。 您可以通过在搜索字段中输入搜索字词,然后点击旁边的“+”按钮,快速进行。

Options 选项

首选项/自定义(Preferences/Custom Filters)过滤器中的选项如下所示:

Swallow Standard Filter -启用后,该过滤器中匹配的日志将不再显示在日志/错误/警告(Log/Error/Warning)文件中

Use Colors In Log - 启用(enabled)时,过滤器颜色将是着色日志的背景颜色。 否则他们将使用标准过滤器颜色

Use Advanced Colors - 覆盖文本和背景颜色。

Show Button In Toolbar - 这允许您着色并给图标记录条目,但没有工具栏按钮

Hide Button If No Matches - 当没有日志与此过滤器匹配时,按钮将消失

Hide Button Label - 不要在此特定按钮上显示标签。

Use Icon In Log - 启用时,这将覆盖日志条目中的图标与工具栏图标相同

Icon Options - 您可以使用颜色,预制图标,文本字符和自定义纹理为过滤器设置自己的图标

Searches - 搜索条件以将日志与该过滤器相匹配


Temporary Filters 临时过滤器

临时过滤器是当发生具有触发字符的日志时动态创建的定制过滤器。

例如:

Debug.Log("#Player# Instantiated")

这将创建一个标题为“Player”的过滤器按钮,该按钮仅在日志存在时才存在。 颜色是基于标题动态生成的,只要标题相同,它总是相同的。

触发角色和外观可以在Preferences/Temporary Filters(偏好设置/临时过滤器)中定制


COLUMNS 列


没怎么用过……所以不好介绍~

Columns 列

在首选项/列(Preferences/Columns)中,您可以显示多个列中日志的文件,类,方法,时间戳等事件。 可以通过在列的分隔线上拖动来调整大小。

Column Header 列标题

右键单击列标题,如果不想让其可见,请单击“隐藏列标题(Hide Column Header)”。 它可以在主菜单(Main Menu)中重新启用(reenabled)。


SHARED SETTINGS 共享设置

Shared Settings 共享设置

在“首选项/共享设置(Preferences/Shared Settings)”中,您可以创建一个可以通过“源代码管理(Source Control)”共享的某些设置的文件。 如果项目中的多个人想要共享自定义过滤器(Custom Filters),忽略堆栈条目(Ignored Stack Entries)等,这很有用。


FONTS AND COLORS 字体与色彩

Fonts 字体

在Preferences/Fonts And Colors(首选项/字体和颜色)中,您可以将日志或堆栈的字体更改为“资产”文件夹中的任何字体。

Colors 颜色

在您可以使用Preferences/Fonts And Colors(首选项/字体和颜色)来更改颜色,如交替日志背景和所选日志条目。


REMOTE 远程


没怎么用过……

Remote Mode 远程模式

远程模式允许您连接到运行ConsoleProRemoteServer的设备,并在编辑器中接收日志,就像Unity的Pro文件。

Using Remote 使用远程

要使用远程功能,请按照下列步骤操作:

1. 在您的场景中添加一个GameObject,并向其添加控制台ProRemoteServer组件。

2. 使用“开发构建(Development Build)”检查构建您的设备

(控制台ProRemoteServer将仅在使用DEBUG定义的构建中处于活动状态,以防止Release应用程序要求网络权限)。

3. 使用Unity将您的设备连接到与计算机相同的网络。 他们需要在同一个子网掩码上。

4. 启动应用程序,应该在您的设备日志中告诉您“ConsoleProRemoteServer从端口*开始”。

5. 通过右键单击工具栏的空白区域并选中显示远程,在Console Pro中显示远程工具栏。

6. 按“遥控开(Remote On)”按钮激活远程模式。 如果一切设置正确,您将开始接收日志。

Troubleshooting Remote 远程故障排除

Make sure your device is connected to the same network and the same subnet maskas your computer

Make sure your app is a development build or you have manually defined DEBUG

Some devices do not support Remote Server yet, such as Windows Phone 8.1 Check

for any logs at the start of your app concerning ConsoleProRemoteServer Try a different port, and make sure your firewall isn't blocking the port you are using

确保您的设备连接到与计算机相同的网络和相同的子网掩码

确保您的应用程序是开发版本或手动定义DEBUG某些设备还不支持远程服务器,例如

Windows Phone 8.1检查应用程序开始时有关ConsoleProRemoteServer的任何日志尝试使用其他端口,并确保您的网络 不阻止您正在使用的端口


CONSOLE PRO API

Console Pro API

日志可以通过Console Pro API将命令传递给Console Pro。 要传递命令,您只需将其添加到您的日志中:

"\nCPAPI:{"cmd":"Command" "ParamName":"ParamValue"}

Console Pro Debug Class 控制台Pro调试类

ConsoleProDebug.cs包含API命令的易于使用的功能。

Watch Command 观看命令

这将只生成一个日志条目,无论记录多少次,允许您跟踪没有垃圾邮件的变量。

Command: Watch 命令: 看

Param参数: name - watch名称,带有此名称的所有条目将替换以前的日志

例:

Debug.Log("Player X Position:" + transform.position.x.ToString() + "\nCPAPI:

{"cmd":"Watch" "name":"" + "PXPos" + ""}");

ConsoleProDebug function ConsoleProDebug方法:

ConsoleProDebug.Watch("Player X Position", transform.position.x);

Filter Command 过滤器命令

无论内容如何,这将结束日志到特定的过滤器

Command: Filter 命令: 过滤

Param参数: name - 将此日志发送给的过滤器的名称。

例:

Debug.Log("Hi" + "\nCPAPI:{"cmd":"Filter" "name":"" + "CustomFilter" + ""}");

ConsoleProDebug function ConsoleProDebug方法:

ConsoleProDebug.LogToFilter("Hi", "CustomFilter");


SUPPORT 支持

Support Email 支持电子邮件

如果您有任何错误或功能请求,请不要犹豫,写电子邮件给我们!

Support@FlyingWorm.com


翻译絮酱酱

如社区发表内容存在侵权行为,您可以点击这里查看侵权投诉指引

标签: