• Stars
    star
    115
  • Rank 304,028 (Top 7 %)
  • Language
    C#
  • License
    MIT License
  • Created over 3 years ago
  • Updated over 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

一个跨平台的远程文件浏览器,使用户通过Unity Editor就能操作应用所运行平台上的目录文件。比如当项目打包运行到设备上时,可通过Remote File Explorer直接浏览设备上的目录文件,并进行下载,上传,删除等操作

Remote File Explorer

license release PRs Welcome

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

用武之地

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

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

更详细的用例演示可以查看这篇博文,演示Demo工程可以查看这里

安装

本工具是采用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自定义操作菜单