UnityResolve.hpp 技术文档

UnityResolve.hpp 技术文档

---

安装指南

为了使用 UnityResolve.hpp，请按照以下步骤操作：

1. 克隆项目： 使用Git克隆此项目到本地环境。

   git clone https://github.com/issuimo/UnityResolvehpp.git
   

2. 环境准备：

   • 确保您的开发环境已配置好C++编译器（如GCC、Clang或MSVC）。
   • 对于Windows，确保启用SEH（结构化异常处理）选项，尤其是在使用MSVC时。

3. 平台适应性调整： 编辑源码中相关平台定义，设置正确的平台模式。例如，在Windows环境下，您需要确保定义WINDOWS_MODE为1，并相应地关闭其他平台模式。

项目的使用说明

初始化

在使用任何功能之前，首先初始化库，指定游戏引擎的DLL名称与模式：

// 对于Windows，假设使用的是Mono运行时
UnityResolve::Init(GetModuleHandle(L"GameAssembly.dll"), UnityResolve::Mode::Mono);

// 若在Linux或Android环境中
UnityResolve::Init(dlopen("GameAssembly.so", RTLD_NOW), UnityResolve::Mode::Mono);

功能示例

• 线程管理：进行C#垃圾回收器的附着与脱离。

  UnityResolve::ThreadAttach(); // 开始一个新线程的交互
  UnityResolve::ThreadDetach(); // 结束当前线程的交互
  

• 调用方法与访问字段：

  假设我们要获取并调用某方法或修改字段值，比如修改一个名为Player的类中的health字段。

  auto assembly = UnityResolve::Get("GameAssembly.dll");
  auto pClass   = assembly->Get("Player");
  int healthValue = pClass->GetValue<int>(playerInstance, "health"); // 获取值
  pClass->SetValue<int>(playerInstance, "health", 100); // 设置值至100
  
  // 调用方法
  auto method = pClass->Get<UnityResolve::Method>("Heal");
  method->Invoke<void>(playerInstance, 50); // 假定Heal接受一个参数，代表治疗量
  

创建C#类型对象

创建C#字符串和数组等，用于与Unity环境内的对象互动：

auto str = UnityResolve::UnityType::String::New("Hello, Unity!");
std::string cppStr = str.ToString();

const auto array = UnityResolve::UnityType::Array<int>::New(size);
array.Set(index, value); // 设置数组元素

其他高级用法

如进行对象查找、转换类型、坐标转换等功能，参考提供的API文档和示例代码进行实现。

API使用文档

详细API文档涵盖所有列出的功能，如获取对象实例、组件操作以及更复杂的动态调用等，均在项目源码和Readme中有详细的注释和说明。确保仔细阅读以理解每个方法的参数和返回类型，这至关重要。

项目安装方式

• 直接集成：将项目源码添加到您的工程中，作为库依赖。
• 构建动态库：对于跨项目使用，可构建UnityResolve.hpp为动态库(DLL/SO)，然后在目标项目中链接。

以上就是UnityResolve.hpp的基本使用和安装指导。请注意，使用此类库应遵守相应的游戏和平台政策，避免违规行为。