JDK 桌面客户端在 2026：三十年栈上的维护、现代化与交付转型#
1996 年 JDK 1.0 随 java.awt 与 java.applet 一同登场；三十年后，浏览器里的 Applet 已成历史，Swing 与 AWT 仍在企业工具、IDE 插件、工业控制与内部系统中承担 UI。OpenJDK Client Libraries Group 在 2026 年的工作重心不是「再发明一套 UI 框架」，而是在 契约兼容、平台变迁（Wayland、Metal/Vulkan/D3D 图形栈） 与 六个月固定发布节奏 下，让既有应用继续可构建、可部署、可测试。
若你维护的是十年前写的 Swing 面板，真正要盯的是三类变更：符号被删（Applet）、打包与 native 策略（jlink/jpackage、JEP 472）、OS 显示栈（Wakefield）。下文按工程决策拆解；未在 JEP/CSR 中出现的路线图细节会标明为演讲者观点。
java.desktop：一个模块里的分层与「维护优先」#
为什么仍要理解模块边界#
JDK 9 模块化之后，AWT、Java 2D、Swing、javax.sound、Image I/O 等被收进 java.desktop。官方模块说明将其描述为「定义 AWT 与 Swing 的用户界面工具包，以及图像、打印、声音与媒体 API」。对运维与打包而言，这意味着：纯服务端镜像可以在 jlink 时 省略 java.desktop 以缩小体积；对排障而言，Swing 的「轻量组件」仍依赖底层 peer 与 Java 2D 绘制，UI 缺陷往往要同时看 javax.swing 与 java.awt。
机制与约束#
典型分层为：java.awt 负责窗口、事件与桌面集成；Java 2D 提供图形、文本、图像与打印（亦用于 headless 服务端渲染）；javax.swing 构建于二者之上。团队对外表述为：API 大体功能完备，新 API 主要用于补缺或应对生态变化；当前投入在 维护与现代化实现，使旧 Swing 应用能在现代桌面上运行，并与 JavaFX 等栈更好共存——演讲者观点，非 JEP 约束。
java.applet 已划掉并标注 JEP 504
java.awt 与 java.applet 的起点
怎么做#
# 仅桌面应用需要的定制运行时
jlink --add-modules java.desktop --output ./jre-with-desktop
常见误区#
- 误区：Swing 已死，可以忽略 AWT。
实际：L&F、拖拽、剪贴板与多显示器仍走 AWT 通道。 - 误区：删掉
java.desktop只影响 GUI。
实际：部分图像/字体/打印 API 也在该模块内，headless 场景需逐项核对依赖。
JEP 504：Applet 退场与桌面交付范式#
为什么现在彻底移除#
现代浏览器不再运行 Applet；桌面与移动应用通过 安装包 交付。JEP 504（Release: 26，JDK 26 GA 2026-03-17）删除 java.applet 包（含 Applet、AudioClip 等）、javax.swing.JApplet 及 java.beans.AppletInitializer 等关联引用。动机链上与 JEP 486（JDK 24 永久禁用 Security Manager）相连：Applet 沙箱依赖 SM，SM 禁用后相关安全模型已无意义。
渐进时间线（JEP 504 与发行说明）：JDK 9 弃用 Applet API；JDK 11 移除 appletviewer；JDK 17 标记 for removal；JDK 26 正式删除。
机制与约束#
音频是少数有官方替代的角落：JDK 25 引入 javax.sound.SoundClip（createSoundClip、play、loop 等），用于替代 java.applet.AudioClip。其余能力 无一对一替换 API——需改为独立桌面进程 + 安装包分发。
怎么做#
// 旧：java.applet.AudioClip — 随 Applet API 移除
// 新：javax.sound.SoundClip（JDK 25+）
// SoundClip clip = SoundClip.createSoundClip(Path.of("ding.wav"));
// clip.play();
jpackage --type app-image --name MyApp --input dist --main-jar app.jar
常见误区#
- 误区：只要不用
JApplet就不受影响。
实际：间接引用java.applet类型、Applet 时代权限检查的遗留代码都需扫描。 - 误区：用 WebView 嵌 Applet 逻辑即可。
实际：JEP 504 删除的是 类库符号；应规划为本机应用或 Web 前端，而非继续依赖 Applet 生命周期。
jlink + jpackage：自定义运行时与 JavaFX 混合打包#
为什么成为 Applet 之后的默认路径#
jpackage（JDK 16 起随 JDK 提供）将应用 JAR 与（可选）jlink 生成的 runtime image 打成平台安装包：Windows .msi/.exe、macOS .dmg/.pkg、Linux .deb/.rpm。对 Swing + JavaFX 混合应用，需要把 JavaFX jmods 与 JDK jmods 一并链入，并在 JDK 24+ 处理 native access 策略。
机制与约束#
JEP 472（JDK 24）起，对 JNI/FFM 的 native 访问默认警告，需显式启用。官方写法是运行时 java --enable-native-access=...，或在 jlink --add-options=... 中嵌入该参数——不是 jlink --enable-native-access=... 作为独立 jlink 开关（要点草案曾混用，以 JEP 472 为准）。
怎么做#
export JDK_MODS="$JAVA_HOME/jmods"
export JFX_MODS="/path/to/javafx-jmods"
jlink --output ./jdk_jfx_runtime \
--module-path "$JDK_MODS:$JFX_MODS" \
--add-modules java.desktop,javafx.controls \
--add-options=--enable-native-access=javafx.graphics,javafx.media,javafx.web
jpackage --runtime-image ./jdk_jfx_runtime \
--input ./dist --main-jar app.jar --name MyDesktopApp
演示中 run_jpackage.sh 曾因 Invalid Option: [ 失败，现场用 vi !$ 修正脚本后重跑——说明安装包流水线对 引号、方括号与 shell 转义 敏感，宜把 jlink/jpackage 参数写进可版本化的构建脚本（Maven/Gradle 插件或 Makefile），而非一次性手工命令。
常见误区#
- 误区：
jpackage会自动拉全 JDK。
实际：应通过jlink控制模块集，否则安装包体积膨胀。 - 误区：native 警告可忽略。
实际：JDK 24+ 可能限制未声明的 JNI；JavaFX 图形/媒体模块通常需列入--enable-native-access。 - 误区：在 macOS 打好包即可直接用于 Linux CI。
实际：安装包格式与运行时镜像平台相关；跨平台需在对应 OS 上分别执行jpackage（或仅分发不含安装器的app-image再自行封装）。
Project Wakefield：Wayland、X11 兼容与 Robot#
为什么 Linux 桌面是特殊战场#
OpenJDK Project Wakefield 的目标是在 JDK 中支持 Wayland。当前 Linux 上 JDK 仍是 X11 客户端，在默认 Wayland 的发行版上依赖合成器提供的 X11 兼容模式（合成器内嵌 X server，应用仍发起 X 连接）。幻灯片原文：not completely seamless — not everything works and not everything in the same way。
java.awt.Robot（截图、合成输入）在纯 XWayland 路径上曾出现黑屏等问题（JDK-8246305）。后续修复包括 Wayland 下基于 dbus ScreenCast（org.freedesktop.portal.ScreenCast）的截图路径（JDK-8335485，Fix Version 含 8/11/17 updates 池），以及 JDK 21 对 Robot 规范的放宽（JDK-8308012）。不宜简单概括为「仅 JDK 21 GA 一次性交付全部能力」——需按你使用的 具体更新版本 查发行说明。
原生 Wayland 工具包（路线图）#
下一阶段为 Wayland 原生 AWT toolkit：选型 libwayland 而非 GTK（演讲称 GTK 约束过多）；渲染可走软件管线、OpenGL ES 或 Vulkan（JetBrains 参与 Vulkan 加速 Java 2D，演讲者观点）。Wayland 不报告窗口绝对坐标，影响「相对其他窗口布局」的测试与多窗口逻辑——幻灯片称 no solution yet。
怎么做#
Robot robot = new Robot();
BufferedImage shot = robot.createScreenCapture(
new Rectangle(Toolkit.getDefaultToolkit().getScreenSize()));
# 排障时确认会话类型与属性（属性名见 JDK-8335485）
echo "$XDG_SESSION_TYPE"
java -Dawt.robot.screenshotMethod=dbusScreencast -jar your-ui-tests.jar
常见误区#
- 误区：装了 Wayland 就等于 JDK 原生 Wayland。
实际：生产路径仍以 XWayland 为主；原生分支在独立仓库 pure Wayland 试验（演讲者观点，具体分支名以 Wakefield 项目页 为准）。 - 误区：
Robot行为与十年前规范完全一致。
实际：CSR 已放宽以反映权限、合成器与门户 API 限制；CI 需缓存屏幕录制权限，否则自动化会被弹窗打断（演讲者观点）。
Swing JDatePicker：补缺型 API 与试用边界#
为什么现在提案日期控件#
多年未增核心 Swing 控件后，官方提案 JDatePicker（显示所选日期 + 打开日历）与 JCalendarPanel（月视图），返回 java.time.LocalDate，并遵循 L&F、MVC、I18N、A11Y。目标还包括日期范围、可选范围约束、周数显示等。截至 2026 年 5 月，公开 JEP 列表中尚无对应 JEP 编号——属 未验证 GA 时间表 的预览 API。
怎么做（sandbox 试用）#
演讲者观点：在 JDK sandbox 的 datepicker-preview 分支构建运行；包名与 API 在 GA 前可能变动。
// GA 前示例 — 包名以 sandbox 为准
// JDatePicker picker = new JDatePicker();
// panel.add(picker);
// picker.addPropertyChangeListener("value", e ->
// label.setText(String.valueOf(picker.getValue())));
常见误区#
- 误区：可立即替换生产环境中的 SwingX 日期控件。
实际：预览分支 API 不稳定；迁移应等 JEP/CSR 冻结。 - 误区：仍应使用
java.util.Date。
实际：新控件以LocalDate为值类型，与java.time生态一致。
Java 2D 管线：Metal、Vulkan 与跨栈复用#
为什么图形栈牵动整个桌面#
操作系统厂商正在弃用旧图形 API：macOS 上 OpenGL 已不推荐，JDK 侧已切到 Metal；Linux 上 OpenGL 同样式微，Wakefield 路线把 Vulkan 作为硬件加速选项（可能先于完整 Wayland 工具包合入主线，演讲者观点）；Windows 上 JavaFX 正从 D3D9 迁向 D3D12，演讲称希望将成果复用到 JDK Java 2D，但 JDK 侧 D3D12 尚未开始（演讲者观点，无对应公开 JEP 在本次核实中）。Linux 生产路径仍以 X11 + XRender 为主，与 Wayland 窗口集成可并行推进。
对应用开发者，这意味着性能与像素级一致性更多取决于 JRE 更新 与 GPU 驱动，而非改几行 Swing 业务代码。升级 JDK 大版本时，应把 字体渲染、半透明、大画布刷新 列入回归清单。
常见误区#
- 误区：换管线对 Java 代码透明且无回归。
实际：应在目标 OS/GPU 上做 Java2D 微基准与视觉回归；驱动差异仍会导致缺陷。 - 误区：Vulkan 合入等于 Wayland 完成。
实际：二者可解耦推进——管线现代化 ≠ 窗口系统集成完成。
Panama FFM 与 ScopedValue：JNI 之外的试点#
为什么桌面模块谨慎拥抱 FFM#
java.desktop 含大量 JNI（演讲称 1500+ 方法，未在公开文档中逐条核实计数）。全量重写不现实；试点用 JEP 454 Foreign Function & Memory API 读取 OpenType 字表。经验结论（演讲者观点，基于内部原型）：upcall 绑定 Java 对象句柄开销极大；用 JEP 446 ScopedValue 在 downcall/upcall 间传递上下文，并部分替代 sun.misc.Unsafe；jextract 因需回调 Java IO 读字表而犹豫采用。
// 概念示意 — 非 OpenJDK 源码摘录
private static final ScopedValue<ByteBuffer> FONT_SLICE =
ScopedValue.newInstance();
ScopedValue.where(FONT_SLICE, buffer).run(() ->
OpenTypeLib.readTablesNative());
常见误区#
- 误区：FFM 可零成本替换所有 JNI。
实际：热路径 upcall + 对象绑定需专门设计，减少跨边界次数。 - 误区：
ScopedValue等同ThreadLocal。
实际：语义面向结构化并发与作用域生命周期；误用会导致可见性/生命周期 bug。
技术债：Security Manager、AppContext 与去 finalization#
JEP 486 之后，桌面代码中大量 Applet 沙箱与权限检查成为死代码并已删除。AppContext 仍计划移除但进度更慢——演讲称需先彻底理解其语义，影响线程分组与旧库假设。去 finalization 为全 JDK 项目：桌面在 macOS CF retained、Java Sound 等仍有残留（演讲者观点）。新代码应使用 try-with-resources / Cleaner，勿再依赖 Object.finalize()。
桌面 UI 测试与六个月发布节奏#
桌面 API 拥有 成千上万 自动化回归测试（幻灯片 OCR 原文：JDK has many thousands of functional / regression tests for the desktop APIs）。历史上 Known Failure List 与 SQE 全量滞后，导致回归可能 6–12 个月 才暴露——对「硬截止日期、每六个月一发」的 JDK 节奏 Not so good（幻灯片原话）。新策略是减少「与本次变更无关」的红灯：不稳定测试、陈旧断言、未维护用例，以及因桌面环境（弹窗、小组件、分辨率）导致的偶发失败。
六个月固定发布则要求 Mach5 级 CI（Oracle 内部系统名，演讲者观点）近乎全绿，并倾向 物理机 以避免 VM 与厂商桌面噪声。开发者本地应只跑 相关子集（jtreg/make 目标依 JDK 源码树而定）；自备流水线时常用 xvfb 或无头配置隔离显示，但无法完全替代真机上的焦点与门户权限行为。
常见误区#
- 误区：本地全红可归咎于本次 diff。
实际：不稳定、过时或未维护的测试长期存在；应先隔离环境再判因。 - 误区：headless VM 与真机桌面等价。
实际：焦点、合成器与权限对话框在 CI 设计中是一等公民。
优先级与未来管线（边界分明）#
仍在推进的事项包括：契约兼容、关键缺陷、新平台适配、第三方库升级；管线含 OpenType font variations、Wayland 原生、更多 FFM、JDK D3D12（演讲者观点：尚未开始）。Vector API 因 java.desktop 不能依赖 incubator 模块 而暂无法用于桌面实现（演讲关联 Valhalla，无公开 JEP 证实具体合入时间）。Q&A 中提到未来 Leyden/AOT 产物或可由 jpackage 打包，但宜在 目标平台 生成/profile（演讲者观点）。
参考与延伸阅读#
- JEP 504：移除 Applet API
- JDK 26 项目与 GA 日期
- JEP 486：永久禁用 Security Manager
- javax.sound.SoundClip API（Java SE 25）
- jpackage 命令参考（Java SE 24）
- jlink 命令参考
- JEP 472：限制 JNI 使用（准备阶段）
- java.desktop 模块概要
- OpenJDK Project Wakefield
- JDK-8335485：Wayland 下 Robot 截图
- JDK-8308012：放宽 java.awt.Robot 规范
- JEP 454：Foreign Function & Memory API
- JEP 446：Scoped Values
- OpenJDK client-libs-dev 邮件列表
- Java SE 26 发行说明（随 GA 更新）
