• Stars
    star
    172
  • Rank 220,136 (Top 5 %)
  • Language
    C#
  • Created over 2 years ago
  • Updated about 2 years ago

Reviews

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

Repository Details

Assemblies hotfix with unity addressable , for windows and android , both mono and IL2CPP scripting backend,IL2CPP hotfix powered by wolong(HybridCLR)

Assemblies-Hotfix-Toolkit-Unity

这个工具为实现基于 Addressables 的无感知逻辑热更而作! 本工具实现对用户指定的需要热更的程序集实施校验、转存以及打包过滤。 有了本工具,留给用户只的操作只剩下:

  1. 拖入程序集
  2. 解决校验出来的错误
  3. 首次 force build 程序集

预览

Editor Rumtime Some Errors
热更程序集配置页面 运行时加载顺序排序与预览 编辑器下一些常见错误预览

功能

下面简要的说明本工具功能:

  1. 对指定的热更程序集进行校验:

    a. 引用框为空则警示

    b. 识别编辑器程序集并警示

    c. 识别被默认程序集引用并警示(默认程序集:Assembly-CSharp.dll,Assembly-CSharp-firstpass.dll)

    d. 如果热更程序集被引用,则展示被引用的程序集并提示需要修复

  2. 热更程序集在 Addressables 打包时自动转存为 .bytes 文件并打包到 ab 中

  3. 将 .bytes 文件及其配置文件 自动加入 Addressables Group

  4. 对加载的程序集自动进行拓扑排序,保证程序集按正确的引用顺序加载

演示

Editor 工作流演示

安装

通过 git 链接安装: 将url https://github.com/Bian-Sh/Assemblies-Hotfix-Toolkit-Unity.git?path=Packages/com.bshsf.hotfix-toolkit 拷贝并添加到 Package Manager

支持 Unity 版本:Unity 2020 及以上.

国内用户使用需要一些技巧,或者多试几次。

使用

  1. 本工具依赖 Addressable,使用前请初始化 Addressables
  2. scripting backend : mono 默认支持逻辑热更,适用于 PC 和 安卓
  3. scripting backend : il2cpp 请先安装 huatuo 以支持全平台的逻辑热更。
  4. 拿本项目测试的同学请先清除 aa 相关缓存。
  5. 热更程序集处理流程:

对需要热更的模块添加 assembly definition file

👉 拖入此 .asmdef(assembly definition file)文件到本工具 Editor 页面

👉 解决可能出现的异常

👉 新增 .asmdef 文件后需要点击下方“Assembly Force Build”按钮

👉 其余为工具自动操作:打 AA(Addressabls)自动转存 .bytes 文件,打app 自动剔除热更逻辑

  1. 热更测试流程:

👉 使用 Addressables Group 窗口打个首 AB 包

👉 使用 Build Settings 窗口打个首包,譬如:aa.exe

👉 修改热更程序集种的逻辑为自己想要输出的

👉 使用 Addressables Group 窗口打 Update a previous build 打 ab 的更新包

👉 重启打包的应用即可看到修改的逻辑生效,至此热更演示完成!

  1. 友情提示:

    a. il2cpp 逻辑热更需要深度学习一下相关的限制及应对措施(主要围绕类型裁剪)!

    b. mono 逻辑热更,Serializable Type 即便通过 inspector 赋值了,也无法在 ab 中正常使用,👉 更多

    c. 由于风云聚变,目前huatuo已经转变为 wolong ,且安装流程发生了变化,本工具判定 huatuo 安装与否的逻辑已经不适用 wolong ,注释掉逻辑即可 (后期我会将 wolong 安装也内嵌到本工具)。 d. hybridclr(wolong) 目前正在积极的开发一键部署工具,后面使用方式会更加简单,届时这个仓库也会同步更新、集成官方相关工作流。

More Repositories

1

UniJoystick

It is a powerful joystick and touchpad component for UGUI.
C#
197
star
2

Security-Camera-Toolkit-For-Unity

一个在 Unity 中播放国内头部监控厂商实时监控的框架 A toolkit for playing security camera in unity
C#
58
star
3

Unity-MecanimEventSystem

This is a chain programming style callback System for Animator of Unity
C#
48
star
4

ET-Network-Module

从 ET6.0 中精简出来的网络模块(TCP ),可以与 ET Server 通信。
C#
45
star
5

Unity-async-await-tcp

This is an async/await tcp communication (client and server inside) in unity.simple yet powerful!
C#
44
star
6

Script-Encoding-Converter

unity 编辑器扩展,可以检测代码编码并自动转码到 UTF8 丧心病狂的好用,你值得拥有.Editor extension for converting script encoding from gb2312 to utf8 that you must have.
C#
32
star
7

RTSP-Player-For-Unity-WebGL

测试网页居中弹窗播放 RTSP 视频,可用于接 rtsp 监控,同时演示怎么接入到 webgl 上
JavaScript
23
star
8

Timer-For-Unity

这是一个很酷的链式编程风格的定时器,而且它还支持在非主线程中使用并正常的使用Unity组件,为Unity更好的多线程编程体验带来一点点暖意
C#
23
star
9

UniCoroutineManager

Coroutine Manager For Unity 3d
C#
20
star
10

UniEventSystem

This is a generic Event-Bus for Unity
C#
19
star
11

Dotween-Animation-Provider

Dotween Extension for better preview experience
C#
14
star
12

Unity-Application-Auto-Builder

Unity 一键打包工具,适用于 频繁切换打包场景的情景,一劳永逸,一键打多个app
C#
13
star
13

FileSystem4UnityStandaloneApp

File system For “exe” SoftWare those made with Unity.
C#
9
star
14

UniFileOpenDialog

FileOpenDialog/ FileSaveDialog For Unity . With Topmost Function.
C#
9
star
15

ScriptableObject-Asset-Creator

通用的 ScriptableObject .asset 文件生成工具/Generic ScriptableObject ".asset" file generation tool.
C#
8
star
16

System-Tray-Icon-For-Unity

为 Unity 打包的Standalone App 提供 system tray
C#
7
star
17

SmartRectTransformSizeHandler

Smart RectTransform size and Pose handler with Anchors Max/Min considered
C#
6
star
18

Simple-Customize-ERP-System

this is a pretty simple customized erp system ,very niche.
C#
5
star
19

JsonUsingInUnity

C#
5
star
20

Enemy-Position-Indicator

敌人位置指示器
C#
4
star
21

Addressabls-Test

测试基于 Addressabls 的资源增量更新与资源版本管理
ShaderLab
4
star
22

UniMP3RuntimeLoader

With this Repo. you can use WWW as well as UnityWebRequest to download MP3 and play it at runtime/unityeditor .
C#
4
star
23

No-Component-File-Uploader-For-Unity

This is a no component file uploader (pure asp uploader) for unity
C#
3
star
24

Unity-Editor-Coroutine

Edtor Coroutine For Unity
C#
3
star
25

UniVRMViewer

This is a vrm viewer unity project.
C#
3
star
26

MiniMap-For-Unity-UGUI

Simple Interactive MiniMap for Unity UGUI
C#
3
star
27

unity-drones-multiplayer-tinyrpc

这是一个为 TinyRPC 准备的简易多人游戏示例,仅仅演示了简单的位置同步!This is a simple multiplayer game example prepared for TinyRPC, only demonstrating basic pose synchronization!
C#
3
star
28

UGUI-Hover-Light-Effect

使用 UGUI + Shader 做一个 Windows10 日历悬浮高亮效果 Create a Windows 10 calendar floating highlight effect using UGUI + Shader.
ShaderLab
2
star
29

Verification-Code-Generator

This is a repo for generating a simple verification code in unity made application (windows only)
C#
1
star
30

DragFile4unityRT

C#
1
star
31

SQLite-Test

SQLite - Net 的测试项目
C#
1
star
32

MeshBoundViewer

一个简单网格包围盒查看器,a mesh bound viewer for simple meshs.
C#
1
star
33

CsvUtility-For-Unity

This tool is a compact single file co-created by me and AI for CSV read/write. It is user-friendly, customizable, and supports bilingual usage.此工具是我与 AI 共同打造的小巧单文件,可用于 CSV 读写。本工具易于使用,支持自定义。
C#
1
star
34

MiraikomachiUnity

这是一个 Windows 10 多点触控的 Demo,测试了简单的单指拖拽相机旋转,双指挤压缩放视野,当然,亮点就是里面跳舞的小姐姐啦,超有爱!(Unity2018.2.16f1)
C#
1
star
35

TinyWebServer

Simple WebServer for hosting WebGL in editor,为编辑下托管 webgl 应用而生
C#
1
star