# javaToExe

**Repository Path**: wadewt_admin/java-to-exe

## Basic Information

- **Project Name**: javaToExe
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-09
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视觉同步服务端 (VisionSync Server)

## 项目简介

视觉同步服务端是一个基于JavaFX的桌面应用程序，主要功能是将Java应用程序打包成独立的Windows可执行文件。该项目集成了JDK运行环境，用户无需安装Java即可直接运行。

## 主要特性

- 🚀 **内置JDK环境**: 集成JDK 8运行环境，免安装Java
- 📦 **JAR文件管理**: 内置JAR文件自动提取和运行
- 🖥️ **图形化界面**: 基于JavaFX的现代化用户界面
- 📊 **实时监控**: 服务状态和网络信息实时显示
- 🔧 **一键部署**: 生成独立的Windows可执行文件
- 📝 **日志管理**: 完整的运行日志记录和下载功能

## 技术栈

- **Java**: 17
- **UI框架**: JavaFX 17.0.10
- **构建工具**: Maven
- **打包工具**: jpackage-maven-plugin
- **目标平台**: Windows

## 项目结构

```
javaToExe/
├── src/main/
│   ├── java/
│   │   └── com/example/javafxtest/
│   │       ├── MainApp.java              # 应用程序入口
│   │       └── ControlUIController.java  # 主控制器
│   └── resources/
│       ├── app.properties                # 配置文件
│       ├── icon.ico                      # 应用图标
│       └── com/example/javafxtest/
│           └── ControlUI.fxml           # JavaFX界面布局
├── jar/
│   └── myJar.jar                        # 内置JAR文件
└── pom.xml                              # Maven配置文件
```

## 功能说明

### 核心功能

1. **自动环境配置**
   - 首次运行时自动提取内置JDK到用户目录
   - 自动提取和配置内置JAR文件

2. **服务控制**
   - 一键启动/停止内置Java应用
   - 自动端口检测和状态监控
   - 进程生命周期管理

3. **状态监控**
   - 实时显示服务运行状态
   - 网络信息显示（IP地址和端口）
   - 端口占用状态检测

4. **日志管理**
   - 详细的运行日志记录
   - 支持日志文件下载
   - 错误信息自动记录

### 配置说明

应用配置通过 `app.properties` 文件管理：

```properties
app.title=视觉同步服务端
service.port=12123
ui.subtitle=使用内置 JDK 8 环境运行您的 Java 应用程序
```

## 构建和运行

### 环境要求

- JDK 17 或更高版本
- Maven 3.6 或更高版本
- Windows 操作系统（用于生成exe文件）

### 构建步骤

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd javaToExe
   ```

2. **编译项目**
   ```bash
   mvn clean compile
   ```

3. **运行应用**
   ```bash
   mvn javafx:run
   ```

4. **打包成可执行文件**
   ```bash
   mvn clean package
   ```
   
   打包完成后，可执行文件位于 `target/dist/` 目录下。

### 开发模式

在开发过程中，确保 `jar/myJar.jar` 文件存在，这是应用程序需要运行的内置JAR文件。

## 部署说明

### 生成的文件

运行 `mvn package` 后会生成：
- `target/javafx-test-1.0-SNAPSHOT.jar` - 主应用JAR
- `target/dist/VisionSyncServer-1.0.0.exe` - Windows可执行文件

### 安装特性

生成的exe文件具有以下特性：
- 支持Windows开始菜单快捷方式
- 支持桌面快捷方式
- 用户级安装（无需管理员权限）
- 支持安装目录选择
- 自动升级GUID管理

## 运行时行为

### 文件位置

应用运行时会在用户目录创建以下文件结构：
```
%USERPROFILE%/
├── JarStarter/
│   └── jdk1.8.0_202/          # 提取的JDK环境
├── AppData/Local/JarStarter/
│   ├── app/myJar.jar          # 提取的内置JAR
│   └── logs/                  # 工作目录
├── jar_starter_log.txt        # 主日志文件
└── jar_starter_error.log      # 错误日志文件
```

### 服务端口

- 默认端口：12123
- 可通过 `app.properties` 配置
- 支持端口占用检测

## 故障排除

### 常见问题

1. **启动失败**
   - 检查日志文件 `%USERPROFILE%/jar_starter_log.txt`
   - 确认端口12123未被占用
   - 验证内置JAR文件完整性

2. **JDK提取失败**
   - 检查用户目录写入权限
   - 确认磁盘空间充足
   - 查看错误日志详细信息

3. **界面显示异常**
   - 确认JavaFX运行环境正常
   - 检查系统字体支持
   - 验证资源文件完整性

### 日志文件

- **主日志**: `%USERPROFILE%/jar_starter_log.txt`
- **错误日志**: `%USERPROFILE%/jar_starter_error.log`
- **应用日志**: `%USERPROFILE%/AppData/Local/JarStarter/logs/`

## 开发指南

### 添加新功能

1. 修改 `ControlUIController.java` 添加业务逻辑
2. 更新 `ControlUI.fxml` 修改界面布局
3. 在 `app.properties` 中添加新的配置项
4. 测试并更新文档

### 自定义内置JAR

替换 `jar/myJar.jar` 文件为你的应用程序，确保：
- JAR文件可独立运行
- 兼容JDK 8环境
- 正确处理工作目录

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。

## 联系方式

- 项目维护者：My Corp
- 版本：1.0.0