HMCL启动器在Linux系统下的HiDPI适配问题解析

问题现象

在Arch Linux等发行版中，当用户调整系统显示缩放比例后（例如从100%调整为150%），HMCL启动器界面未能正确跟随系统缩放设置，导致界面显示过小。该问题主要影响高分辨率屏幕用户的使用体验。

技术背景

Java应用程序在Linux环境下处理HiDPI显示时，需要特殊的配置参数才能正确响应系统缩放设置。这与Java图形子系统（特别是JavaFX）的实现机制有关：

1. JavaFX使用Glass窗口工具包作为底层实现
2. 默认情况下不会自动检测系统的DPI缩放设置
3. 需要通过JVM参数显式指定界面缩放比例

解决方案

对于HMCL启动器，可以通过以下JVM参数解决HiDPI适配问题：

-Dglass.gtk.uiScale=1.5

参数说明：

• glass.gtk.uiScale：JavaFX专用的HiDPI缩放参数
• 数值1.5表示150%的缩放比例（对应系统设置的150%）

配置方法

1. 直接修改启动脚本： 在启动命令中添加上述参数，例如：

   java -Dglass.gtk.uiScale=1.5 -jar HMCL.jar
   

2. 通过桌面环境配置： 对于.desktop快捷方式，可在Exec行中添加参数：

   Exec=java -Dglass.gtk.uiScale=1.5 -jar /path/to/HMCL.jar
   

注意事项

1. 缩放值应与系统设置保持一致，常见值包括：

   • 1.0（100%）
   • 1.25（125%）
   • 1.5（150%）
   • 2.0（200%）

2. 该参数仅影响JavaFX组件，不影响Swing组件

3. 如果同时使用其他Java应用程序，建议在JAVA_OPTS环境变量中统一设置

进阶建议

对于开发者而言，可以考虑以下改进方向：

1. 自动检测系统DPI设置
2. 在应用设置中添加缩放选项
3. 支持动态调整缩放比例

该解决方案不仅适用于HMCL启动器，也适用于其他基于JavaFX的Linux应用程序在HiDPI环境下的显示适配问题。