Skip to content

Remold v0.2.0

Choose a tag to compare

@github-actions github-actions released this 02 Nov 15:45
· 669 commits to main since this release

🚀 Remold v0.2.0 Release Notes

Remold v0.2.0 是一个里程碑式的重要更新版本!本次发布不仅将热重载能力延伸至 Minecraft Fabric (Mixin) 与 Mindustry (Arc 全套资源) 两大游戏模组生态,还在底层架构上补齐了字段类型动态变更、物理内存布局漂移安全门、第三方反射缓存驱逐 SPI、Lambda 单向捕获桥等核心安全防线,提供更加极致、零侵入、零重启的 Java 运行时开发体验。


🌟 核心亮点 (Highlights)

  1. Minecraft Fabric 生态全面就绪 (:plugin-mixin):

    • 深度集成 SpongePowered Mixin 字节码重织入桥;
    • 支持在热重载时动态修改 @Mixin 切入点与注入逻辑,无需重启 Minecraft 客户端;
    • 支持在 Mixin 类中使用 @Unique 配合 @RemoldReinit 注入全新实例字段;
    • 随版本分发开箱即用的 minecraft-fabric-template。
  2. Arc 全套多媒体与界面资源原位直刷 (:plugin-arc):

    • PNG 贴图:Tier 1 原位直刷显存(Gl.texSubImage2D),零重启修改界面与图集像素;支持运行期新增贴图动态注册;
    • 字体 / 语言包 / 音频 / 着色器:字体精确路由 UI 槽位,国际化 Bundle 安全回写内容缓存,音效音乐原位复用重载,内置着色器原位重编;
    • 随版本分发开箱即用的 mindustry-mod-template。
  3. 字段类型变更(Field Type Changed)安全热重载:

    • 当普通字段描述符类型变更(oldDesc != newDesc)且批次外无悬空读者时:无活体实例或标有 @RemoldReinit 时安全放行;
    • 自动清除旧类型指纹缓存,重定义后由 InitFix 引擎安全写入新类型的初始值。
  4. 物理内存布局预测器与漂移安全门 (LayoutPredictor / SuperclassDriftGate):

    • 事前使用抛弃式 ClassLoader 干净预测物理布局(实测与 DCEVM 布局 100% 吻合);
    • 结合堆存活探测,精准阻断父类增删字段引起的子类物理偏移漂移;
    • 协同预注入整条非 JDK 祖先链,彻底防御 package-private 运行时包隔离访问异常。
  5. 第三方实例级反射与序列化缓存驱逐 SPI (ReflectionCacheManager):

    • 内置 Jackson ObjectMapper、Gson Gson 与 Arc Json 实例级驱逐器;
    • 类重定义完成后自动清空解析缓存,防止反序列化错读陈旧字段元数据。
  6. Lambda 表达式增强对齐与单向捕获桥 (LambdaAligner):

    • 新增单向捕获桥,安全支持删除旧捕获变量;
    • 支持新增捕获变量的纯源重放(字面量常量、static final、final 实例字段、可折叠算式、构造器参数回溯);
    • 引入 LVT 形参名定捕获身份,拦截同签名换序的静默错值。

🛠️ 快速上手 (Quick Start)

1. 声明 JitPack 仓库与 API 依赖

在你的 build.gradle / build.gradle.kts 中添加:

repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}

dependencies {
    // 编译期 API 与热更控制注解 (@RemoldReinit, @OnReload)
    compileOnly 'com.github.I-hope1.Remold:api:v0.2.0'
}

2. 引入热重载 Gradle 插件

buildscript {
    repositories { maven { url 'https://jitpack.io' } }
    dependencies { classpath 'com.github.I-Hope1.Remold:gradle-plugin:v0.2.0' }
}
apply plugin: 'io.github.i-hope1.remold'

3. 启动与热重载

  • 执行 ./gradlew runRemold(或在 IntelliJ IDEA 中直接使用自动生成的 Run with Remold 运行配置);
  • 保持进程运行,修改代码后按 Ctrl + Shift + F9,即刻体验秒级原位热更新!

📦 资产列表 (Release Assets)

  • JavaAgent 探针:
    • remold-agent.jar / remold-agent-0.2.0.jar
  • 生态插件:
    • remold-plugin-arc.jar / remold-plugin-arc-0.2.0.jar
    • remold-plugin-mixin.jar / remold-plugin-mixin-0.2.0.jar
  • Gradle 插件:
    • remold-gradle-plugin.jar / remold-gradle-plugin-0.2.0.jar
  • API 与源码:
    • remold-api-0.2.0.jar
  • 模版工程:
    • minecraft-fabric-template.zip
    • mindustry-mod-template.zip
  • Native 动态库:
    • libtool64.so(Linux x86_64)
    • libtoolarm64.so(Android arm64-v8a)

📑 完整变更日志 (Changelog)

详见仓库内 CHANGELOG.md。
Full Git Commits: v0.1.3...v0.2.0