# swingdesktop

**Repository Path**: bikr/swingdesktop

## Basic Information

- **Project Name**: swingdesktop
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: 1.0.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-30
- **Last Updated**: 2025-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Swing 桌面应用

这是一个基于 Java Swing 的桌面应用程序框架，提供了现代的 UI 组件和功能，包括暗色/亮色主题切换、可定制的菜单系统、可关闭的标签页等功能。

## 特性

- **现代 UI 设计**：支持暗色和亮色模式切换。
- **动态菜单系统**：支持多级菜单配置，菜单项可动态加载。
- **可关闭的标签页**：支持添加、切换和关闭标签页。
- **模块化结构**：界面组件模块化，便于扩展和维护。
- **图标支持**：使用 SVG 图标，支持高质量的图形显示。

## 技术栈

- Java Swing
- FlatLaf 主题库
- SVG 图标支持
- Maven 项目管理

## 项目结构

- `src/main/java/com/hano/swing`：核心代码目录
  - `Starter.java`：应用程序入口类
  - `MainFrame.java`：主窗口布局和管理
  - `Menu.java`：菜单组件实现
  - `ClosableTabbedPane.java`：可关闭的标签页组件
  - `LightDarkMode.java`：主题切换功能
  - `ToolBarAccentColor.java`：颜色主题工具栏
  - `Form*.java`：示例表单界面
- `src/main/resources`：资源文件目录
  - `icon/`：图标资源
  - `menu-config.json`：菜单配置文件
  - `application.properties`：应用程序配置
  - `Flat*.properties`：主题配置文件

## 安装与运行

1. 确保已安装 Java 开发环境（JDK 8 或更高版本）
2. 克隆项目：
   ```bash
   git clone https://gitee.com/bikr/swingdesktop.git
   ```
3. 构建项目：
   ```bash
   mvn clean package
   ```
4. 运行应用：
   ```bash
   java -jar target/swingdesktop-*.jar
   ```

## 使用说明

- **菜单系统**：左侧菜单栏支持展开/收起，点击菜单项会在主界面显示相应内容
- **主题切换**：通过界面右上角的按钮切换暗色/亮色模式
- **颜色主题**：可选择不同的强调色
- **标签页**：支持添加多个可关闭的标签页

## 配置

- **菜单配置**：编辑 `src/main/resources/menu-config.json` 文件可自定义菜单项
- **主题配置**：通过 `src/main/java/com/hano/swing/ui/theme/` 目录下的属性文件调整主题样式
- **应用配置**：在 `src/main/resources/application.properties` 中修改应用程序基本设置

## 扩展开发

- **添加新表单**：继承 `JPanel` 创建新的表单类，实现所需功能
- **菜单路由**：使用 `MenuRouter` 注册新菜单项的处理逻辑
- **主题定制**：修改 FlatLaf 属性文件或添加新的主题支持

## 依赖库

- `lib/swing-toast-notifications-1.0.2.jar`：用于显示通知消息
- FlatLaf 主题库（通过 Maven 依赖管理）

## 许可证

本项目采用 MIT 许可证。详情请查看 LICENSE 文件。