GluonFX+GraalVM下JavaFX无装饰Stage最小/最大化动画方案咨询

核心结论先放前面：窗口动画丢失的根本原因是你把Stage设为UNDECORATED/TRANSPARENT后，JavaFX接管了窗口的全部绘制逻辑，不再走Windows系统的标准窗口管理流程，直接调用stage.setIconified()只会瞬时切换窗口状态，不会触发系统动效。以下两个方向都可以解决问题，且完全规避JNA依赖，适配GraalVM native-image编译要求。

方案一（优先推荐，实现成本最低）：保留系统窗口管理能力，扩展自定义标题栏 #

这个方案就是Microsoft Edge、Windows 11媒体播放器所用的标准实现逻辑，100%保留所有原生窗口特性（最小化/最大化动画、窗口阴影、边缘调整大小、Win11贴靠布局、任务栏预览等），不需要模拟任何系统效果。
实现步骤：

• 初始化Stage时不要使用StageStyle.UNDECORATED或StageStyle.TRANSPARENT，保留默认的StageStyle.DECORATED样式，这是原生动效能正常工作的核心前提。
• 给JVM添加两个启动参数，开放JavaFX模块的必要访问权限（Java 17模块系统要求，不属于非法调用受限API）：

--add-exports javafx.graphics/com.sun.javafx.tk=ALL-UNNAMED
--add-exports javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED

• 手写极薄的JNI绑定层（仅需调用2个Windows DWM API，C代码量不超过30行），调用DwmExtendFrameIntoClientArea将窗口顶部的非客户区帧扩展到客户区内，扩展高度设置为你自定义标题栏的高度（通常为32-48px）。
• 调用DwmSetWindowAttribute配置窗口帧为透明模式，此时系统会自动把原生的最小化/最大化/关闭按钮绘制在窗口右上角的最上层，所有原生交互、动效完全保留。
• 你只需要在Scene根布局的顶部放置自己写的标题栏节点（和你设置的帧扩展高度一致），添加自己的应用图标、标题、自定义功能按钮即可，系统控制按钮会自动浮在你的自定义内容上方，不需要你额外处理。
• 如果你不需要系统自带的三个控制按钮，也可以通过DwmSetWindowAttribute隐藏它们，自己在标题栏上绘制按钮，按钮点击时直接调用stage.setIconified(true)/stage.setMaximized(true)就会自动触发原生动画，因为窗口始终处于系统的标准装饰窗口管理下。

方案二：全自定义无装饰窗口，手写JNI触发系统动画 #

如果你需要完全自定义窗口的所有区域（包括右上角控制按钮、窗口圆角等），不想保留任何系统默认绘制的内容，可以用这个方案，同样不依赖JNA。
实现步骤：

• 可以继续使用StageStyle.UNDECORATED/StageStyle.TRANSPARENT样式完成自定义窗口搭建。
• 手写轻量JNI绑定，不需要引入任何第三方库，仅绑定两个核心Win32 API：
  • 获取窗口句柄：可以直接通过JavaFX开放的API拿到HWND，Stage调用show()之后，通过Stage的Peer对象获取原生窗口句柄（long类型），不需要native层遍历查找窗口。
  • 触发窗口状态变更：绑定user32.dll中的ShowWindow函数，最小化时传入SW_MINIMIZE参数，最大化时传入SW_MAXIMIZE参数，恢复时传入SW_RESTORE参数。
• 修改你现有的按钮事件逻辑，不要直接调用stage.setIconified(true)，改为调用你自己绑定的JNIShowWindow方法，系统就会自动播放原生的状态切换动画。
• JNI层编译时直接静态链接Windows系统自带的user32.dll即可，GraalVM native-image可以直接把你编译的native代码和Java代码编译到单个可执行文件中，完全不会出现JNA的JNI版本不兼容问题。

现有代码修改提示 #

你当前的FXML布局和自定义按钮逻辑不需要大改，只需要根据选择的方案调整按钮点击事件的实现即可：

• 如果用方案一：直接保留你现在的stage.setIconified(true)逻辑就能正常触发动画，不需要额外修改。
• 如果用方案二：把MinimizeApp方法里的逻辑替换为调用你自己实现的JNIShowWindow方法即可。

避坑说明 #

• 不要尝试用JavaFX的Timeline、TranslateTransition等动画API自己模拟窗口动效，系统原生动画的运动曲线、时长、最小化时飞向任务栏对应位置的交互逻辑是和系统全局设置绑定的，手动模拟的效果和原生体验差距极大。
• 网上搜索到的老旧方案如果出现JDK内部类访问报错，只需要添加对应的--add-exports启动参数即可在Java 17环境下正常运行，不是完全不可用。
• 自己实现的JNI层不要添加多余逻辑，仅保留必要的API调用即可，整个native编译产物大小通常不到10KB，维护成本极低。

内容的提问来源于stack exchange，提问作者Dang'it