HMCL-dev / HMCL-dev/HMCL

将控件库迁移至 M3FX

Open
#6,614 0 comments 20 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Java
Stars
10.1k
Forks
934
Avg merge
1d 5h
Merged PRs (30d)
82

Description

目前 HMCL 使用 JFoenix 作为控件库,它存在以下问题:

  1. JFoenix 年久失修,上游已经有 6 年没有发布过新的版本了。
  2. 我们使用的 JFoenix 是一个自己的 fork,但这个 fork 的源码已经丢失,我们现在是直接把 JAR 二进制文件嵌入在仓库,维护需要基于反编译出的源码,非常麻烦。
  3. JFoenix 基于老旧的 MD2 设计,不符合很多用户对于现代应用的期待。

为此,我正在开发一个新的控件库 m3fx。这个控件库基于 MD3 规范设计,内化了很多我们所需要的控件,提供更良好的无障碍适配、键盘焦点遍历支持、RTL 布局支持,并且支持运行时切换动画状态。

在 m3fx 完成后,我们可能会迁移到 m3fx 上,并更新 HMCL 很多页面的设计以匹配 MD3 规范。

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files or tests are identified. First review HMCL's current JFoenix usage and confirm that m3fx is complete enough for migration, then define the affected pages and control-library scope. Done means the migration and related MD3 updates provide the stated accessibility, keyboard-focus, RTL-layout, and animation support.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
desktop
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.