【远程文件浏览器】Unity+Lua开发调试利器

Remote File Explorer是一个跨平台的远程文件浏览器,用户通过Unity Editor就能操作运行在手机上的游戏或是应用的的目录文件。比如当项目打包运行到设备上时,可通过Remote File Explorer直接浏览设备上的目录文件,并进行下载,上传,删除等操作。尤其是Unity+Lua开发环境下的调试利器,当然,这里的调试不是指代码的逐行调试,而是泛指定位排查问题

用武之地

在很多场景下利用Remote File Explorer都可以极大的提高开发调试效率。例如:

  • 应用真机上运行时出现异常情况,推测可能是关键资源丢失导致。此时可以通过本工具直接浏览手机上的相关文件,查看关键资源是否存在
  • 通过本工具直接拉取手机上的日志文件或内存分析文件等各类文件,从此告别数据线
  • 如果项目采用了XLua或SLua开发,在真机开发调试时,可通过本工具直接上传修改后的Lua代码,重启应用即可生效。从而避免每修改一次代码就重新构建一次应用的繁琐过程,大大提高调试效率

接下来,将以一些具体的案例,来演示Remote File Explorer工具的使用。下面用例的代码都可以在Remote File Explorer Demo找到

用例1-无需重新打包修改代码逻辑

  1. 客户端打包,启动后,初始界面如下图所示。其中”Hello, Wlrod”的文本故意拼写错误,用来演示如何不重新打包,通过Remote File Explorer来修复此错误

  1. 在UnityEditor中,通过”Window > Remote File Explorer”打开Remote File Explorer工具窗口,通过Stats面板可以查看服务端IP

  1. 在客户端输入正确的服务端IP,然后点击Connect。连接成功后Stats面板的State将显示为”Established”

  1. 拼写错误是在这个文件changetextcontent.lua内写错的,如下所示修改文件内容(主要是将”Hello, Wlrod”拼写修正为”Hello, World”)
local obj = CS.UnityEngine.Object.FindObjectOfType(typeof(CS.Game.ChangeTextColor))
local textComponent = obj:GetComponent(typeof(CS.UnityEngine.UI.Text));
textComponent.text = "Hello, World"
  1. 通过Remote File Explorer工具窗口,GoTo到Application.persistentDataPath目录。这个目录下的Lua文件将会被优先加载(这是工程内的Lua加载机制决定的,详情可参考XLuaManager.cs

  1. 拖拽changetextcontent.lua文件上传到该目录。之后重启客户端,”Hello, Wlrod”的拼写错误将会被修复。完整的操作流程如下所示

  1. 另外,利用xLua的hotfix特性,还可以修改C#代码的逻辑。例如,”Hello, World”文本的颜色是由C#代码设置的红色,可以通过修改changetextcontent.lua文件将文本设置为绿色,内容如下所示
local obj = CS.UnityEngine.Object.FindObjectOfType(typeof(CS.Game.ChangeTextColor))
local textComponent = obj:GetComponent(typeof(CS.UnityEngine.UI.Text));
textComponent.text = "Hello, World"

xlua.hotfix(CS.Game.ChangeTextColor, "Start", function(self)
    self:GetComponent(typeof(CS.UnityEngine.UI.Text)).color = CS.UnityEngine.Color.green
    xlua.hotfix(CS.Game.ChangeTextColor, "Start", nil)
end)
  1. 之后同样的操作,将文件上传到Application.persistentDataPath目录,重启客户端后,文本颜色将改变。完整的操作流程如下所示

用例2-直接拉取手机上的日志文件

  1. 如果某个固定文件会被频繁拉取,比如日志文件或是性能分析文件。可以通过配置CustomMenuAttribute为该文件添加一个自定义拉取操作。以拉取日志文件game.log为例,新增一个CustomMenuAttribute修饰的方法
using UnityEngine;
using RemoteFileExplorer.Editor;

public class TestAttribute
{
    [CustomMenu("pull game log")]
    public static void PullLog(ManipulatorWrapper manipulator)
    {
        string remoteLogPath = manipulator.GetRemotePath("Application.persistentDataPath") + "/Logs/game.log";
        manipulator.Download(remoteLogPath, Application.dataPath.Replace("/Assets", "") + "/Logs/game.log");  // 将log文件下载到本地
    }
}
  1. 代码添加后,重新打开Remote File Explorer工具窗口将出现”Custom”菜单,点击该菜单后会执行PullLog方法

  1. 连接建立成功后,通过”pull game log”操作可以一键拉取game.log文件。完整的操作流程如下所示

安装

本工具是采用Unity的形式,可以通过Unity Package Manager直接安装

这里介绍两种常用方式

  • 打开”Window > Package Manager”窗口后,单击状态栏左侧的”+”按钮,选择”Add package from git URL”,然后在文本框中输入本工具的git地址https://github.com/iwiniwin/unity-remote-file-explorer.git,单击”Add”按钮后完成安装
  • 或直接克隆本工具到项目的”Packages”目录下

详细安装方式可以查看使用文档,更多将本工具作为包进行安装的方式可查看Unity官方文档

使用

安装本工具后,可通过”Window > Analysis > Remote File Explorer”打开本工具窗口,将自动启动服务器

给项目的任意游戏对象添加FileExplorerClient组件

如果是固定连接到某台机器上,可直接通过Inspector面板在”Host”域输入这台机器的IP地址,然后勾选”Connect Automatically”,则会在应用启动时自动连接

如果希望应用启动后能主动选择连接到哪台机器,则可在Debug模式下封装一套简单的UI,使开发人员能够输入想要连接到的IP地址。例如在自己的菜单中添加一个条目或按钮,点击后弹出输入窗口。在成功获取到的IP地址后,将其赋值给FileExplorerClient组件的”Host”属性,然后调用FileExplorerClient组件的”StartConnect”方法开启连接

也可以使用本工具自带的一个简易UI,给项目的任意游戏对象添加FileExplorerWindow组件(此时不用再额外添加FileExplorerClient组件)

游戏启动后将自动打开连接窗口

功能列表

详细的图文功能介绍请查看使用文档

  • 通过状态栏的”GOTO”可直接跳转到Unity预定义的一些路径
  • 通过单击路径栏可打开输入框,以直接输入路径跳转或复制当前路径
  • 右键所选中的文件夹或文件支持下载
  • 右键所选中的文件夹或文件支持删除
  • 右键空白区域支持上传文件夹或文件
  • 右键空白区域支持刷新当前路径的内容
  • 支持直接从Unity Project窗口拖拽文件夹或文件到本工具上传
  • 支持直接从系统文件浏览器拖拽文件夹或文件到本工具上传
  • 通过本工具”status”面板可查看连接状态以及已连接设备的信息,可用于辨别连接的是哪台设备
  • 通过配置BeforeUploadAttribute自定义上传时的额外操作,例如上传lua代码时自动加密
  • 通过配置CustomMenuAttribute自定义操作菜单

链接

页面下部广告