Skip to content

ZeroUltra/UnityManuallyReload

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Unity 手动编译 Reload 脚本

这是一个自定义reload domain工具,加快工作流,减少等待.测试版本是Unity2021,理论上来说2020以上都可.

Unity2021(2020还好)不知是哪个版本,明显感觉编译reload时间冗长🥱😪😯

在Unity中遇到的问题

在unity工作流中,修改脚本->编译脚本->reload domain(重载域)->进入play

通过区分assembly能加快编译,但是reload domain 却很慢,每次编译之后都要reload domain,且进入play模式也会reload domain

示例:

0

写程序经常会Ctrl+s,一旦保存,就会重新编译,继而触发reload. 有时候会返回Unity编辑器,只是查看场景,并不想reload,会让我们漫长等待.

Unity有个Enter Play Mode Setting 可配置的进入运行模式 - Unity 手册

禁用Reload Domain 可以快速进入播放模式.但是每次修改完脚本还是会重新reload. 还有就是对于静态数据如果没有重新reload 还是会保持之前的数据(建议不要禁用,真的很坑) 具体查看:https://docs.unity.cn/cn/2021.3/Manual/DomainReloading.html

当然有些通过禁用Auto refresh,使用ctrl+r,来手动刷新也可以,但如果导入的是图片等其他资源,也要刷新,就比较麻烦

如何解决频繁Reload

需要做的就是,添加新脚本或者修改脚本后,经过确认无误之后,我们才reload,而且在进入 play模式,如果已经reload,不会二次reload

unity 提供了两个API EditorApplication.LockReloadAssemblies(); EditorApplication.UnlockReloadAssemblies();一个加锁,一个解锁.

配合 Enter Play Mode Setting 就可以大大减少时间.

效果图:

111

安装方法

两种安装方法

  1. 直接下载脚本代码,然后放到Editor文件夹中
  2. 使用Unity PackageManager,add git地址

使用方法

  1. Unity中Edit->ProjectSetting->Manually Reload Domain (参考v1.0.4版本图),勾选上Enable Manually Reload
  2. 开启之后,新建脚本,修改脚本或者导入插件的时候,只会编译而不会reload。通过Ctrl+T或者菜单Tools/Reload Domain/Unlock Reload,手动reload
  3. 记住,Unity必须reload之后,才能调用相关域。例如新建mono脚本如果不reload是挂不到gameobject上的。
  4. 当刚进入Play模式如果已经reload,则直接进入;如果没有reload则会强制reload(主要是为了重置static数据)
  5. 如遇到锁住问题(unity右下角一直出现🔒的情况) 按下Ctrl+Alt+T强制重载。
  6. 完全手动模式下,不会执行相关自动reload,需要手动reload

需要注意的一点:

​ 当勾选Enable Manually Reload的时候会自动设置Enter play mode setting,如果由于其他操作重新设置了 enter play mode setting,请手动设置成下图正确选项,或者重新勾选Enable Manually Reload进行自动设置.

image-20240228000722436

更新日志

v1.0.1

  • 每次进入play模式之前,会检查是否需要reload,已经reload就不用了,没有的话自动reload,这样能保证每次数据的正确性

v1.0.2

  • 添加了Unity Package
  • 避免了可能不小心手动多次reload情况
  • 修改了数据保存代码逻辑
  • 修复新建脚本或者assembly的时候没有刷新的问题

v1.0.3

  • 修复设置未保存的问题 (原来使用了UnityScriptableSingleton<T>,使用过程中发现保存了数据但是加载的时候不会反序列化)

v1.0.4

  • 将设置移到ProjectSetting中

  • 新增功能编辑器代码是否手动Reload

    image-20231102201502323

v1.0.5

  • 修复当取消EnableManuallyReload勾选时,不会正确reload的bug

v1.0.6

  • 添加说明
  • 如遇到锁住问题 按下Ctrl+Alt+T强制重载

image-20231227195442245

v1.0.7

  • 添加完全手动模式。开启此模式后,需要完全手动reload。

有什么问题,欢迎提Issues

推荐

handzlikchris/FastScriptReload

Misaka-Mikoto-Tech/UnityScriptHotReload:

【Unity】引擎编译时间优化 - 知乎 (zhihu.com)

About

unity manually reload domain 减少等待时间

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages