# java-version-manager

**Repository Path**: gitwcx/java-version-manager

## Basic Information

- **Project Name**: java-version-manager
- **Description**: java版本管理工具
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-23
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Java Version Manager

## 介绍

Java Version Manager 是一个跨平台的 Java 版本管理工具，旨在简化在不同 Java 版本之间切换和管理的过程。该工具提供了直观的图形用户界面，支持 Windows 和类 Unix 系统（如 macOS、Linux），帮助开发人员轻松管理多个 Java 版本。

## 软件架构

本工具基于以下技术构建：
- **JavaFX 21**：用于构建现代化的图形用户界面
- **Atlantafx**：提供美观的 UI 主题和组件
- **Hutool-core**：提供实用的工具类，简化开发过程
- **Logback**：用于日志记录
- **jpackage**：用于将应用程序打包为本地可执行文件

## 功能特性

1. **Java 版本管理**：
   - 添加新的 Java 版本到管理器
   - 删除不再需要的 Java 版本
   - 在已安装的 Java 版本之间快速切换

2. **自动检测**：
   - 自动检测系统中已安装的 Java 版本
   - 显示当前正在使用的 Java 版本

3. **跨平台支持**：
   - Windows 平台支持
   - macOS 和 Linux 平台支持

4. **图形用户界面**：
   - 直观易用的图形界面
   - 实时显示 Java 版本列表
   - 操作反馈和日志输出

## 界面展示
![wechat_2025-08-24_153755_448.png](pic/wechat_2025-08-24_153755_448.png)

## 安装教程

### Windows 系统安装

1. 从发布页面下载最新版本的安装包（.exe 文件）
2. 运行安装程序并按照提示完成安装
3. 启动 Java Version Manager 应用程序

### macOS/Linux 系统安装

1. 从发布页面下载对应系统的安装包
2. 解压文件并运行应用程序
3. 根据需要设置执行权限：`chmod +x java-version-manager`

## 使用说明

### 主界面

应用程序启动后，您将看到主界面，包含以下主要组件：
- 当前 Java 版本显示区域
- Java 版本列表表格
- 操作按钮区域（添加、删除、切换等）
- 日志输出区域

### 添加 Java 版本

1. 点击"浏览"按钮选择 Java 安装目录
2. 程序会自动从路径中提取版本名称（您也可以手动修改）
3. 点击"添加"按钮将该版本添加到管理器中

### 切换 Java 版本

1. 在版本列表中选择目标版本，或在输入框中输入版本名称
2. 点击"切换"按钮切换到指定版本
3. 注意：切换后可能需要打开新的终端窗口才能看到更改

### 删除 Java 版本

1. 在版本列表中选择要删除的版本，或在输入框中输入版本名称
2. 点击"删除"按钮
3. 在确认对话框中点击"确认"完成删除操作

### 刷新版本列表

点击"刷新"按钮可以重新加载系统中的 Java 版本列表。

## 技术细节

### 日志存储

应用程序日志默认存储在应用程序所在目录的 `logs` 文件夹中，便于问题排查和审计。

### JEnv 集成

本工具在 Windows 系统上集成了 JEnv，通过 PowerShell 脚本实现 Java 版本管理功能。

## 开发说明

### 构建项目

```bash
# mac
mvn clean compile javapackager:package@bundling-for-mac

```

### 项目结构

- `src/main/java`：Java 源代码
- `src/main/resources`：资源文件
  - `jenv-for-windows`：Windows 平台的 PowerShell 脚本
  - `jenv-mac-linux`：macOS/Linux 平台的脚本
  - `logback.xml`：日志配置文件
- `pom.xml`：Maven 项目配置文件

## 参与贡献

1. Fork 本仓库
2. 新建 `Feat_xxx` 分支
3. 提交代码
4. 新建 Pull Request

## 许可证

[MIT License](LICENSE)