feat: 实现启动界面的“小提示”文字 2.0 by hmr-BH · Pull Request #4383 · HMCL-dev/HMCL

hmr-BH · 2025-09-03T05:42:39Z

删除了原有的换行算法，优化“小提示”布局，使下载速度计数与之对齐。

目前实现了繁体中文和英文的翻译（由Kimi翻译）如果有不准确的地方，敬请指出。

hmr-BH · 2025-09-03T05:51:02Z

#3683

zkitefly · 2025-09-03T08:59:33Z

可以增加自定义功能吗

hmr-BH · 2025-09-03T09:08:31Z

可以增加自定义功能吗

可以

burningtnt

应当使用 JavaFX 在图形化界面上完成文本居中，可尝试实现依一定时间间隔动态变更 tip。此外，请将文本配置放入独立的 JSON 文件中，避免代码和 I18N 耦合提示的个数。

hmr-BH · 2025-09-03T11:28:31Z

应当使用 JavaFX 在图形化界面上完成文本居中，可尝试实现依一定时间间隔动态变更 tip。此外，请将文本配置放入独立的 JSON 文件中，避免代码和 I18N 耦合提示的个数。
那么是要为每种语言都创建一个JSON文件吗？还是要怎么做？

burningtnt · 2025-09-03T11:38:37Z

+    }
+
+    private static int getRandomTipIndex() {
+        return ThreadLocalRandom.current().nextInt(tips.size());


应当自行设计带有“保底”伪随机生成逻辑

应当自行设计带有“保底”伪随机生成逻辑

让我思考一下（大脑过载

应当自行设计带有“保底”伪随机生成逻辑

我大概是想复杂了

burningtnt · 2025-09-03T11:51:57Z

那么是要为每种语言都创建一个JSON文件吗？还是要怎么做？

请使用 I18N.getLocale().getName() 作为 key，在同一个 json 文件中使用 key -> string[] 数据结构存储小提示

hmr-BH · 2025-09-03T11:53:04Z

那么是要为每种语言都创建一个JSON文件吗？还是要怎么做？

请使用 I18N.getLocale().getName() 作为 key，在同一个 json 文件中使用 key -> string[] 数据结构存储小提示

了解

Glavo · 2025-09-03T12:06:54Z

请使用 I18N.getLocale().getName() 作为 key，在同一个 json 文件中使用 key -> string[] 数据结构存储小提示

放到一个文件里的话，后期做更多语言的 i18n 支持就会比较麻烦，还是每个语言独立文件比较合适。

现在不着急改，我们在研究 #4373，做完之后本地化一些资源文件会更轻松。

Glavo · 2025-09-03T14:15:16Z

6ab216d

现在你可以使用 I18n.getLocale().findBuiltinResource("xxx", "json") 来加载内置的本地化资源。

举个例子：如果当前语言环境为 zh-CN，调用 findBuiltinResource("assets.lang.foo", "json") 会尝试从 HMCL 内部依次查找以下资源：

assets/lang/foo_zh_Hans_CN.json
assets/lang/foo_zh_Hans.json
assets/lang/foo_zh_CN.json
assets/lang/foo_zh.json
assets/lang/foo.json

hmr-BH · 2025-09-03T14:28:18Z

6ab216d

现在你可以使用 I18n.getLocale().findBuiltinResource("xxx", "json") 来加载内置的本地化资源。

举个例子：如果当前语言环境为 zh-CN，调用 findBuiltinResource("assets.lang.foo", "json") 会尝试从 HMCL 内部依次查找以下资源：

assets/lang/foo_zh_Hans_CN.json

assets/lang/foo_zh_Hans.json

assets/lang/foo_zh_CN.json

assets/lang/foo_zh.json

assets/lang/foo.json

明白

那我在I18N这些properties文件的同级目录创建一个launch_tips文件夹，里面专门放置翻译文件吧

zkitefly · 2025-09-04T02:31:19Z

希望可以在设置提供开关，因为可能会有人不喜欢这个提示

zkitefly · 2025-09-04T02:33:13Z


        onEscPressed(this, btnCancel::fire);
+
+        tipTimeline = new Timeline(new KeyFrame(Duration.seconds(2), e -> nextTip()));


我觉得 2 秒太短了，还没看完就跳了

burningtnt · 2025-09-29T13:12:21Z

+        return formatTip(tip);
+    }
+
+    private static String formatTip(String tip) {


我不太理解为什么你依然在使用手动换行。JavaFX 的 TextFlow 控件可以非常方便的实现显示多行文本，可考虑迁移到 TextFlow

burningtnt · 2025-09-29T13:13:37Z

+        }
+
+        private void shuffle() {
+            for (int i = indices.size() - 1; i > 0; i--) {


java.util.Collections#shuffle(java.util.List<?>)

burningtnt · 2025-09-29T13:15:15Z

+
+public final class RandomTip {
+
+    private static final List<String> tips;


这里的数据结构完全可以修改为：
`

private static final List<String> tips; private static int index;

在 index 不断自增到 tips.length() 后，使用 Collections.shuffle 打乱 tips，然后重置 index 到 0

burningtnt · 2025-09-29T14:44:41Z

+
+        getChildren().add(tfwBottomTip);
+
+        tipTimeline = new Timeline(new KeyFrame(Duration.seconds(2), e -> nextTip()));


这里 e -> nextTip 隐式捕获了 this。在 JavaFX 上，这是否会导致潜在的内存泄漏？

@Glavo

burningtnt · 2025-09-29T14:45:14Z

+    private final Text bottomTipText;
+    private final TextFlow tfwBottomTip;
+    private final Timeline tipTimeline;
+    private static final List<String> tips;


你可以就地打乱 tips，而不需要保存一份原本的，每次从原本顺序打乱。

burningtnt · 2025-09-29T14:45:36Z

+    private final Timeline tipTimeline;
+    private static final List<String> tips;
+    private static final List<String> shuffledTips;
+    private static final Random random = new Random();


ThreadLocalRandom::current()

burningtnt · 2025-09-29T14:45:50Z

+        tfwBottomTip.setTextAlignment(TextAlignment.CENTER);
+        tfwBottomTip.setStyle("-fx-text-fill: rgba(100, 100, 100, 0.9)");
+        tfwBottomTip.setPadding(new Insets(0, 8, 0, 0));
+        tfwBottomTip.setMaxWidth(300);


为什么需要限制最大宽度？

因为会非常非常长，导致文字和下载计数怼在一起，不好看
用户手动放大HMCL界面后启动面板的大小并不会改变，因此这里的使用应当是安全的

那你应当设置 padding，而不是硬编码一个 width 进去。

那你应当设置 padding，而不是硬编码一个 width 进去。

好的

feat: 实现启动界面的“小提示”内容

95458af

hmr-BH mentioned this pull request Sep 3, 2025

更新 UI 设计规范 #3683

Open

hmr-BH mentioned this pull request Sep 3, 2025

添加启动窗口“你知道吗？”提示 #4378

Closed

hmr-BH added 2 commits September 3, 2025 14:49

修改占位的默认值的格式

4d8e756

优化英文翻译的标点符号的使用

b70ca5d

burningtnt mentioned this pull request Sep 3, 2025

PR Collection 开发进展 burningtnt/HMCL#9

Closed

hmr-BH changed the title ~~feat: 实现启动界面的“小提示”内容 2.0~~ feat: 实现启动界面的“小提示”文字 2.0 Sep 3, 2025

hmr-BH marked this pull request as draft September 3, 2025 09:09

burningtnt suggested changes Sep 3, 2025

View reviewed changes

每隔两秒更换”小提示“。优化换行算法

b7d538c

burningtnt suggested changes Sep 3, 2025

View reviewed changes

带有”保底“机制的随机”小贴士“生成算法

864f38f

hmr-BH added 2 commits September 3, 2025 19:55

修改随机类命名

9595378

删除旧的方法封装

b727b67

对齐启动面板底部组件

74ed377

zkitefly reviewed Sep 4, 2025

View reviewed changes

按照新版规范添加翻译文件占位

fc82cfc

burningtnt suggested changes Sep 29, 2025

View reviewed changes

hmr-BH added 2 commits September 29, 2025 22:12

重构并优化代码逻辑

5ceb561

将i18n文本迁移到json文件

59a4d04

burningtnt suggested changes Sep 29, 2025

View reviewed changes

Update LaunchTipLabel.java

3ace3a2

hmr-BH marked this pull request as ready for review September 29, 2025 15:10

hmr-BH marked this pull request as draft September 29, 2025 15:10

hmr-BH added 3 commits September 29, 2025 23:12

Merge branch 'HMCL-dev:main' into tips

d060af8

修复不一致的命名

1f48055

让用户可以自主选择是否在启动时显示小提示

7701948

hmr-BH marked this pull request as ready for review September 29, 2025 15:32

hmr-BH added 2 commits September 29, 2025 23:35

延长每一个小提示展示的时长到3s

806c474

Update LaunchTipLabel.java

e1650ce

github-actions Bot added the 100+ label Jul 17, 2026


		onEscPressed(this, btnCancel::fire);

		tipTimeline = new Timeline(new KeyFrame(Duration.seconds(2), e -> nextTip()));


		public final class RandomTip {

		private static final List<String> tips;


		getChildren().add(tfwBottomTip);

		tipTimeline = new Timeline(new KeyFrame(Duration.seconds(2), e -> nextTip()));

Uh oh!

Conversation

hmr-BH commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

hmr-BH commented Sep 3, 2025

Uh oh!

zkitefly commented Sep 3, 2025

Uh oh!

hmr-BH commented Sep 3, 2025

Uh oh!

burningtnt left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

hmr-BH commented Sep 3, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

hmr-BH Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

burningtnt commented Sep 3, 2025

Uh oh!

hmr-BH commented Sep 3, 2025

Uh oh!

Glavo commented Sep 3, 2025

Uh oh!

Glavo commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

hmr-BH commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

zkitefly commented Sep 4, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

hmr-BH commented Sep 3, 2025 •

edited

Loading

burningtnt left a comment •

edited

Loading

hmr-BH Sep 3, 2025 •

edited

Loading

Glavo commented Sep 3, 2025 •

edited

Loading

hmr-BH commented Sep 3, 2025 •

edited

Loading