更新3.3

docs/mcguide/30-测试/1-使用调试工具进行手机和电脑端调试.md

@@ -1,7 +1,7 @@
 ---
 front: 	https://nie.res.netease.com/r/pic/20220926/9ef0cb38-6193-48b9-aa7e-d0aef0bda97c.png
 hard: 入门
-time: 10分钟
+time: 20分钟
 selection: true
 ---
 
@@ -20,16 +20,14 @@ selection: true
 
 ## 启动方式
 
-我们可以从两个地方启动调试工具：
+由于现在调试工具已经正式取代了脚本测试日志，现在在PC端进行开发测试时将自动拉起调试工具。
 
-第一个是在工作台的【创作】页，点击【工具箱】按钮，选择【调试工具】启动。
-
-![](./images/A2.png)
-
-第二个是从我们【作品库】中的【基岩版组件】或【基岩版服务器】分页，点击【工具箱】按钮，选择【调试工具】启动。
+此外，如果是使用调试工具进行手机测试端调试，我们可以从【作品库】中的【基岩版组件】或【基岩版服务器】分页，点击【工具箱】按钮，选择【调试工具】启动。
 
 ![](./images/A3.png)
 
+> 如果你仍希望继续使用旧版脚本测试日志，可以点击左下角的【切换到脚本测试日志】按钮。同样，在脚本测试日志窗口也可以切换使用调试工具。
+
 ## 界面介绍
 
 调试工具的界面共分为以下几个部分:
@@ -47,7 +45,9 @@ selection: true
 
 ## 连接客户端
 
-首次打开调试工具后，我们会看到如下界面。由于尚未连接测试客户端，我们只能看到两个连接选项按钮，以及“等待客户端连接”的提示信息。
+如果是在电脑端测试作品，调试工具将被自动拉起并连接到现在正在测试的作品。
+
+**对于连接手机测试客户端的情况：** 打开调试工具后，我们会看到如下界面。由于尚未连接测试客户端，我们只能看到两个连接选项按钮，以及“等待客户端连接”的提示信息。
 
 ![](./images/A5.png)
 
@@ -55,10 +55,10 @@ selection: true
 
 调试工具支持的客户端类型包括：
 1. 安卓手机测试客户端
-2. ModPC开发包
-   
-> 其中，安卓手机测试客户端可以从[开发者平台](https://mcdev.webapp.163.com/#/square)首页顶部①位置点击下载，登录自己的开发者账号后即可在手机上进行组件自测。
-> **调试工具暂不支持iOS测试客户端，请连接安卓端使用。**
+2. iOS手机测试客户端
+3. ModPC开发包
+
+> 其中，手机测试客户端可以从[开发者平台](https://mcdev.webapp.163.com/#/square)首页顶部①位置点击下载，登录自己的开发者账号后即可在手机上进行组件自测。
 >![](./images/A6.png)
 
 我们**首先启动上述的客户端**，然后回到调试工具。我们有两种方式将测试客户端与我们电脑上的调试工具相连。
@@ -124,7 +124,7 @@ selection: true
 
 ![](./images/A12.png)
 
-例如我们调整数量上限为1000，那么当日志消息数超过1000以后，调试工具就会将前1000条日志截取下来，存放至一个单独的txt文件中。如果开发者有查看过往日志的需求，可以点击【显示过往日志】按钮，它将自动帮你打开过往日志存放的文件夹，找到对应的txt文件即可浏览之前被调试工具截下来的日志消息。
+例如我们调整数量上限为1000，那么当日志消息数超过1000以后，调试工具将只会显示最新的1000条日志消息。如果开发者有查看过往日志的需求，可以点击【显示过往日志】按钮，它将自动帮你打开过往日志存放的文件夹，找到对应的txt文件即可浏览之前的日志消息。
 
 ![](./images/A13.png)
 
@@ -141,7 +141,8 @@ selection: true
 - Developer
 - Engine
 - INFO
-  
+
+
 过滤器默认不勾选任何一个标签，代表过滤器未开启，同时按钮显示为灰色。当开发者勾选其中任何一个选项时，则会**仅显示包含该字段的日志**。另外，如果同时勾选了两个或两个以上标签的日志，则会显示**至少包含其中一个标签的日志**。
 
 另外开发者也可以通过在日志中加**自定义标签**。点击【自定义日志标签管理】选项，在上方输入框输入想要被定义为标签的字段，点击【添加】按钮，即可将其添加到日志标签列表中，并默认将其勾选。被添加为自定义标签的字段，将在日志中被显示为亮绿色。
@@ -176,6 +177,18 @@ selection: true
 
 ![](./images/F3.gif)
 
+## 报错信息跳转
+
+报错信息跳转功能可以帮助您通过调试工具快速点击报错信息，直接跳转到对应的代码文件，从而迅速定位并修复问题。
+
+::: danger 注意
+
+需要开发测试或编辑器内启动`ModPC`开发包，直接启动`ModPC`开发包或在开发测试过程切换存档会导致跳转失败。
+
+:::
+
+![redirect](./images/redirect.gif)
+
 ## 指令调试
 
 指令调试是调试工具的另一重要功能，可用于输入游戏脚本层 python 测试代码，例如 import 部分模块用于执行功能，或者打印某些全局变量等。另外开发者还可以使用指令历史记录、读取快捷指令等方式快速复用之前使用过的指令。
@@ -195,7 +208,7 @@ selection: true
 举个例子，当我们手机测试客户端进入游戏后，可以在调试工具的代码输入窗口输入：
 
 ```
-from Preset.Model.SdkInterface import SdkInterface 
+from Preset.Model.SdkInterface import SdkInterface
 import client.extraClientApi as clientApi
 
 a = SdkInterface()
@@ -266,6 +279,11 @@ a.SetPopupNotice(clientApi.GenerateColor("YELLOW") + "消息通知", "消息子
 
 ![](./images/B12.gif)
 
+> **2022.12.15版本更新：直接选择Studio作品进行同步**
+> 现在在进行组件同步时，新增了通过下拉框直接选择Studio作品库作品进行同步的方式
+> ![](./images/A21.png)
+
+
 > **全量同步可差量同步的区别：**
 > - 全量和差量的区别主要在于对脚本目录（Script）中文件的处理方式。
 > - **全量同步**不管脚本目录是否发生变化，都会将脚本文件重新打包并同步
@@ -280,7 +298,7 @@ a.SetPopupNotice(clientApi.GenerateColor("YELLOW") + "消息通知", "消息子
 >   ① 选择的不是一个可识别的作品路径
 >   ② 电脑上尝试同步的组件与测试客户端上选择的组件中manifest文件的uuid无法匹配
 >   则会弹窗提示修改同步失败，需要开发者选择正确的路径再进行同步。
-> ![](./images/A20.png)
+>   ![](./images/A20.png)
 
 ### 3.组件同步示例
 
@@ -295,9 +313,21 @@ a.SetPopupNotice(clientApi.GenerateColor("YELLOW") + "消息通知", "消息子
 客户端退出、网络异常等因素都会导致与调试工具的连接断开。断开后：
 - 日志窗口会保留断连之前的日志记录，开发者依旧可以使用搜索、筛选等功能，只是日志不会继续打印了；
 - 左侧调试窗口将不再可用，下方按钮会全部置灰；
-- 会有【连接失败】弹窗提示。
+- 会有【断开日志连接】消息提示。
 
    ![](./images/A8.png)
 
 重启客户端，会再次自动连接至调试工具，并通过另开分页的形式记录新的日志。
 ![](./images/A9.png)
+
+## 更多菜单
+
+调试工具右上角有一个【更多】菜单，包括以下功能：
+
+1. 工具版本号查看
+2. 官网教程文档跳链
+3. 开发者常见问题汇总
+4. 最新版本手机测试包下载链接
+5. 清除工具缓存
+
+![](./images/A22.png)