Unity HybridCLR 笔记

🛠️ 准备工作

  1. 确保Unity 安装开发模块 :

    Windows Build Support (IL2CPP) 或 Mac Build Support (IL2CPP)。

  2. Windows :需要安装 Visual Studio 2019或更高版本 ,并确保包含了"使用Unity的游戏开发"和"使用C++的游戏开发"两个组件。同时需要安装 Git。

  3. Mac :需要安装 Xcode (版本13或以上)和 Git。


一、安装与配置HybridCLR

1、安装 HybridCLR包

包管理 - 使用 Git地址 (https://gitee.com/focus-creative-games/hybridclr_unity.git )安装HybridCLR包

2、初始化 HybridCLR:

菜单栏 HybridCLR - Installer - 控制台输出 Installation Successful

3、项目设置:

① Scripting Backend :必须设置为 IL2CPP。

② Api Compatibility Level :设置为 .Net 4.x (Unity 2019-2020)或 .Net Framework(Unity 2021及以上版本)。

二、编写与测试热更新代码

环境配置完毕,接下来通过一个简单测试来验证效果。

  1. 创建热更新模块:

    • 在 Assets 目录下创建一个新文件夹,例如 HotUpdate。

    • 在 HotUpdate 文件夹上右键,选择 Create -> Assembly Definition,创建一个名为 HotUpdate 的程序集定义文件。

  2. 编写测试脚本:

    • 在 HotUpdate 文件夹中创建 Hello.cs 脚本,写入以下简单代码:

      cs 复制代码
      // Assets/HotUpdate/Hello.cs
      using UnityEngine;
      
      public class Hello
      {
          public static void Run()
          {
              Debug.Log("Hello, HybridCLR");
          }
      }
  3. 加载热更新程序集:

    • 在主场景中创建一个挂载了 LoadDll.cs 脚本的游戏物体,该脚本负责加载 HotUpdate.dll 并通过反射调用其中的代码。

    • 核心加载逻辑示例如下:

      cs 复制代码
      // 在非编辑器环境下,从文件加载热更新DLL
      Assembly hotUpdateAss = Assembly.Load(File.ReadAllBytes($"{Application.streamingAssetsPath}/HotUpdate.dll.bytes"));
      // 通过反射执行热更新代码
      Type type = hotUpdateAss.GetType("Hello");
      type.GetMethod("Run").Invoke(null, null);
  4. 构建与测试 :
    HybridCLR -> Settings,将热更新的程序集(Assembly)HotUpdate 添加到列表中。

    • 运行 HybridCLR/Generate/All 菜单进行必要的生成操作。

    • 将项目 HybridCLRData / HotUpdateDlls 下的生成的 HotUpdate.dll 文件再加个.bytes后缀名,并放入 StreamingAssets 文件夹。

    • 进行打包构建,如果控制台成功打印出 Hello, HybridCLR,则说明整个环境搭建成功。

相关推荐
yiangL_9 小时前
Python 学习笔记:递归、turtle绘图、字符串与函数
笔记·python·学习
人生!?11 小时前
Linux 从入门到进阶 | 基础语法
linux·笔记·教程
ellis197015 小时前
Claude Code[二] 上下文相关的机制
unity·ai编程
β添砖java16 小时前
Transformer大白话学习笔记
笔记·学习·transformer
希和202717 小时前
代码小白笔记:蓝桥杯彩灯控制代码逐段讲解
笔记·mongodb·蓝桥杯
希和202717 小时前
江科大 51 单片机课程笔记:XPT2046 触摸/AD 采集与 LCD1602 显示
笔记·单片机·mongodb
小七在进步1 天前
string的实现(1)
c++·笔记·visual studio
保利威视频SaaS小张2 天前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
lcj25112 天前
[C++] C++11
开发语言·c++·笔记
zdr尽职尽责2 天前
Unity 3C 动画系统:从「蜘蛛网」到可维护的动画架构
unity·架构·游戏引擎