【远程文件浏览器】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-无需重新打包修改代码逻辑
- 客户端打包,启动后,初始界面如下图所示。其中"Hello, Wlrod"的文本故意拼写错误,用来演示如何不重新打包,通过Remote File Explorer来修复此错误
- 在UnityEditor中,通过"Window > Remote File Explorer"打开Remote File Explorer工具窗口,通过Stats面板可以查看服务端IP
- 在客户端输入正确的服务端IP,然后点击Connect。连接成功后Stats面板的State将显示为"Established"
- 拼写错误是在这个文件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"
- 通过Remote File Explorer工具窗口,GoTo到Application.persistentDataPath目录。这个目录下的Lua文件将会被优先加载(这是工程内的Lua加载机制决定的,详情可参考XLuaManager.cs)
- 拖拽changetextcontent.lua文件上传到该目录。之后重启客户端,"Hello, Wlrod"的拼写错误将会被修复。完整的操作流程如下所示
- 另外,利用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)
- 之后同样的操作,将文件上传到Application.persistentDataPath目录,重启客户端后,文本颜色将改变。完整的操作流程如下所示
用例2-直接拉取手机上的日志文件
- 如果某个固定文件会被频繁拉取,比如日志文件或是性能分析文件。可以通过配置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文件下载到本地
}
}
- 代码添加后,重新打开Remote File Explorer工具窗口将出现"Custom"菜单,点击该菜单后会执行PullLog方法
- 连接建立成功后,通过"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自定义操作菜单
链接
- Remote File Explorer https://github.com/iwiniwin/unity-remote-file-explorer
- Remote File Explorer Demo https://github.com/iwiniwin/RemoteFileExplorerDemo
【远程文件浏览器】Unity+Lua开发调试利器的更多相关文章
- 在cocos code ide的基础上构建自己的lua开发调试环境
对于一种语言,其所谓开发调试环境, 大体有以下两方面的内容: 1.开发, 即代码编写, 主要是代码提示.补齐, 更高级一点的如变量名颜色等. 2.调试, 主要是运行状态下断点.查看变量.堆栈等. 现在 ...
- 手机前端开发调试利器 – vConsole
我们在开发手机版网页的时候,常常会出现下面的情景: (1) 开发时,在自己电脑上运行得好好的,在手机上打开就挂了,但是手机上又看不到error log: (2) 上线后,某用户表示页面失灵,但我们自己 ...
- 手机前端开发调试利器-vConsole
最近因为做抽奖页面,在android上可以使用手机连上电脑后用chrome浏览器chrome://inspect进行页面探测,但是ios中的页面就不能这样探测 在网上搜索后发现此插件,大大解决了问题 ...
- 安卓手机移动端Web开发调试之Chrome远程调试(Remote Debugging)
一.让安卓打debug模式的apk包 二.将电脑中的chrome升级到最新版本,在chrome浏览器地址栏中输入chrome://inspect/#devices: 在智能手机还未普及时,移动设备的调 ...
- 现学现卖】IntelliJ+EmmyLua 开发调试Unity中Xlua
http://blog.csdn.net/u010019717/article/details/77510066?ref=myread http://blog.csdn.NET/u010019717 ...
- pycharm安装,svn使用,远程开发调试,接口测试,连接服务器
磨刀不误砍柴工,配置完美的编辑器,在开发时,能帮助我们节约大量的时间成本,从而是我们的精力放在业务逻辑实现上面! 接下来将介绍 使用pyhcarm如何使用svn,远程开发调试,接口测试,已经连接远程服 ...
- .net 直接输出远程文件到浏览器和下载文件保存到本机
利用了xmlhttp,实现代码比较简单具体实现如下: 首先bin文件引入,com->microsoft xml v3.0 具体代码如下: protected void Button1_Click ...
- [转]javascript console 函数详解 js开发调试的利器
javascript console 函数详解 js开发调试的利器 分步阅读 Console 是用于显示 JS和 DOM 对象信息的单独窗口.并且向 JS 中注入1个 console 对象,使用该 ...
- 远程开发调试与hot-update | (R "think-of-lisper" 'Albertlee)
远程开发调试与hot-update | (R "think-of-lisper" 'Albertlee) 远程开发调试与hot-update
随机推荐
- 数据结构 - 单链表 C++ 实现
单链表 单链表的定义 typedef int ElemType; typedef struct LNode { ElemType data; LNode *next; } LNode, *LinkLi ...
- Where和having都是条件筛选关键字,它们有什么分别?
WHERE是在数据分组前进行条件过滤, HAVING子句是在数据分组后进行条件过滤,WHERE子句中不能使用聚合函数,HAVING子句可以使用聚合函数. 需要注意说明:当同时含有where子句.gro ...
- Spring基于xml注入bean的几种方式?
(1)Set方法注入: (2)构造器注入:①通过index设置参数的位置:②通过type设置参数类型: (3)静态工厂注入: (4)实例工厂:
- mysql8.0时区问题
今天在mysql新增一条数据的时候,发现时间类型的字段比起现在少了8个小时,查了资料才发现,这个是MySQL8.0出现的问题,讲下解决方法. 1.在java项目中application.yml文件中的 ...
- pandas - drop()函数
函数形式:DataFrame.drop(labels=None, axis=0, index=None, columns=None, level=None, inplace=False, errors ...
- 面试题目:手写一个LRU算法实现
一.常见的内存淘汰算法 FIFO 先进先出 在这种淘汰算法中,先进⼊缓存的会先被淘汰 命中率很低 LRU Least recently used,最近最少使⽤get 根据数据的历史访问记录来进⾏淘汰 ...
- 5V转10.5V原理图
- js 关于setTimeout和Promise执行顺序问题
js 关于setTimeout和Promise执行顺序问题 异步 -- Promise和setTimeout 执行顺序 Promise 和 setTimeout 到底谁先执行 定时器的介绍 Jav ...
- 左手Cookie“小甜饼”,右手Web Storage
目录 1. Web Storage 2. Cookie机制 3. 二者的联系与区别 1.Web Storage 1.1 概述 Web Storage是HTML5提供的一种新的浏览器端数据储存机制,它提 ...
- BeeFramework:以极客的方式开发你的应用
BeeFramework 是新一代的应用开发框架,它能使应用开发变得更简单更容易,它是由 Gavin Kwoe 和 QFish 开发并维护的.使用 BeeFramework 能像 html 和 css ...