diff options
| author | 2026-02-05 08:06:36 +0800 | |
|---|---|---|
| committer | 2026-02-05 08:06:36 +0800 | |
| commit | 0e61d6bf86af5aca9dac85ae61d4f077984e26a8 (patch) | |
| tree | 3ea00660c676895cb20453d8afa351a9180711ec /packages/docs/app/lib/layout.shared.tsx | |
| parent | b92e7afe9f6e262b67056c238c0ca7d2b53b470e (diff) | |
| parent | 68b20f1b43e081ede86c789ed7f6dd3e6f724c58 (diff) | |
| download | DropOut-0e61d6bf86af5aca9dac85ae61d4f077984e26a8.tar.gz DropOut-0e61d6bf86af5aca9dac85ae61d4f077984e26a8.zip | |
feat(java): add mise version manager support and refactor detection (#84)
# 描述
此 PR 为 Java 检测模块添加了 mise 版本管理器支持,并重构了 SDKMAN 检测逻辑,使其更加健壮。同时更新了
TypeScript 类型绑定的格式。
## 更改类型
- [ ] Bug 修复(修复问题的非破坏性更改)
- [x] 新功能(添加功能的非破坏性更改)
- [ ] 破坏性更改(会导致现有功能无法正常工作的修复或功能)
- [ ] 文档更新
- [ ] UI/UX 改进
- [ ] 性能优化
- [x] 代码重构(无功能性更改)
- [ ] 配置更改
- [ ] 测试添加或更新
## LLM 生成代码声明
- [x] 此 PR 包含 LLM 生成的代码,我**提供**质量担保
- [ ] 此 PR 包含 LLM 生成的代码,我**不提供**质量担保
- [ ] 此 PR 不包含 LLM 生成的代码
**模型**: Claude Sonnet 4.5
## 相关 Issue
相关 #(如有)
## 更改内容
### 后端 (Rust)
#### Java 检测模块重构
1. **新增 mise 版本管理器支持**
- 添加 `find_mise_java()` 函数扫描 `~/.local/share/mise/installs/java/`
- 在 Linux 和 macOS 平台的候选列表中集成 mise 检测
2. **重构 SDKMAN 检测逻辑**
- 将 `find_sdkman_java()` 从检查 `current` 符号链接改为扫描整个 candidates 目录
- 避免符号链接导致的重复检测问题
3. **添加通用扫描辅助函数**
- 实现 `scan_java_dir<F>()` 泛型函数,支持自定义过滤条件
- 自动过滤符号链接,只返回真实的目录安装
- 为 mise 和 SDKMAN 提供统一的扫描逻辑
4. **修复模块导入路径**
- 将相对导入 `super::` 改为绝对导入 `crate::core::java::`
- 提高代码可维护性和清晰度
5. **改进文档注释**
- 为新函数添加详细的 Rustdoc 注释
- 说明参数、返回值和功能
### 前端 (React)
- 无前端更改
### 配置
- 重新生成 TypeScript 类型绑定(ts-rs),采用更紧凑的单行格式
- 新增类型:`account_storage.ts`、`java/*` 模块类型
- 更新所有现有绑定文件的格式
## 测试
### 测试环境
- **操作系统**:Windows 11
- **DropOut 版本**:0.1.24
- **测试的 Minecraft 版本**:N/A(Java 检测功能)
- **Mod 加载器**:N/A
### 测试用例
- [x] 已在 Windows 上测试(编译通过)
- [ ] 已在 macOS 上测试
- [ ] 已在 Linux 上测试
- [ ] 已测试原版 Minecraft
- [ ] 已测试 Fabric
- [ ] 已测试 Forge
- [ ] 已测试游戏启动
- [ ] 已测试登录流程
- [x] 已测试 Java 检测/下载
### 测试步骤
1. 运行 `cargo tauri dev` 确保编译通过
2. 运行 `cargo check` 和 `cargo clippy` 确保无警告
3. Pre-commit hooks 全部通过(fmt, check, clippy)
**注意**:此 PR 主要是代码重构和新增功能,建议在具有 mise/SDKMAN 环境的 Linux/macOS 系统上进行实际功能测试。
## 检查清单
### 代码质量
- [x] 我的代码遵循项目的代码风格指南
- [x] 我已对自己的代码进行了自审
- [x] 我已对难以理解的区域添加了注释
- [x] 我的更改没有产生新的警告或错误
### 测试验证
- [x] 我已在本地测试了我的更改
- [ ] 我已添加测试来证明我的修复有效或功能正常工作
- [ ] 新的和现有的单元测试在本地通过
- [x] 我至少在一个目标平台上进行了测试(Windows 编译测试)
### 文档更新
- [x] 我已相应地更新了文档(代码注释)
- [ ] 如有需要,我已更新 README
- [x] 我已在必要处添加/更新代码注释
### 依赖项
- [x] 我已检查没有添加不必要的依赖项
- [x] 所有新依赖项都已正确记录
- [x] `Cargo.lock` 和/或 `pnpm-lock.yaml` 已更新(如果依赖项有变化)
## 截图 / 视频
N/A(后端功能,无 UI 变更)
## 附加说明
### 技术细节
**为什么添加 mise 支持?**
mise (前身 rtx) 是一个现代的版本管理工具,越来越多的开发者使用它来管理 Java 等运行时。添加此支持可以提高启动器的兼容性。
**符号链接过滤的重要性**
版本管理器(mise/SDKMAN)通常会创建符号链接作为版本别名(如 `21`、`lts`、`current`),过滤这些链接可以:
- 避免重复检测同一个 Java 安装
- 减少检测开销
- 提供更清晰的检测结果
**代码重构的影响**
- 导入路径的更改不影响功能,仅提高代码组织性
- TypeScript 绑定的格式更改由 ts-rs 自动生成,不影响类型定义的正确性
### 后续工作建议
- 在 CI 中添加 Linux/macOS 环境的 Java 检测集成测试
- 考虑为其他版本管理器(如 jenv、jabba)添加支持
- 优化检测性能(可能需要并行扫描或缓存机制)
## 破坏性更改说明
无破坏性更改。此 PR 完全向后兼容。
---
**维护者专用:**
- [ ] 代码审查已完成
- [ ] CI 检查通过
- [ ] 准备合并
---
**提交记录:**
- 50de089 feat(java): add mise version manager support and refactor
detection logic
- c075dd8 chore(types): regenerate typescript bindings with compact
formatting
**Reviewed-by**: Claude Sonnet 4.5
Diffstat (limited to 'packages/docs/app/lib/layout.shared.tsx')
0 files changed, 0 insertions, 0 deletions