# JTimer

**Repository Path**: guest_1013/jtimer

## Basic Information

- **Project Name**: JTimer
- **Description**: 2021年用swing写的一个小时钟
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JTimer - Java 桌面计时器应用

JTimer是一个使用Java Swing开发的桌面计时器应用程序，具有简洁的界面和实用的功能。

## 功能特性

- **实时时钟显示** - 显示当前时间，包括小时、分钟和秒
- **半透明窗口** - 窗口具有半透明效果，可以设置在其他应用之上
- **倒计时功能** - 提供倒计时功能按钮
- **无边框设计** - 简洁的无边框界面设计
- **可拖动窗口** - 支持鼠标拖动窗口位置

## 项目结构

```
JTimer/
├── src/
│   └── JTimer/
│       ├── Launch.java              # 主启动类
│       ├── DefaultClock.java        # 默认时钟面板实现
│       ├── ClockPanel.java          # 时钟面板基类
│       ├── AboutButtonActionListener.java    # 关于按钮监听器
│       └── CountDownButtonActionListener.java # 倒计时按钮监听器
├── bin/
│   └── JTimer/                      # 编译后的.class文件
├── JTimer/                          # jpackage打包生成的应用程序
│   ├── app/
│   │   ├── JTimer/                  # 应用程序文件
│   │   ├── JTimer.jar               # 主JAR文件
│   │   └── JTimer.cfg               # 配置文件
│   ├── runtime/                     # Java运行时环境
│   └── JTimer.exe                   # 可执行文件
└── README.md                        # 项目说明文档
```

## 快速开始

### 运行已打包的可执行文件

如果您已经使用jpackage打包了应用程序，可以直接运行：

```bash
# 双击运行
JTimer/JTimer.exe
```

或者通过命令行：

```bash
cd JTimer
JTimer.exe
```

### 从源代码运行
0. （可选）通过Python脚本自动构建
    ```bash
    python make.py
    ```
或者：
1. **编译项目**
   ```bash
   javac -d bin src/JTimer/*.java
   ```

2. **运行应用程序**
   ```bash
   cd bin
   java JTimer.Launch
   ```

## 构建和打包

### 使用jpackage打包为可执行文件

1. **首先创建JAR文件**
   ```bash
   cd bin
   jar cf JTimer.jar JTimer/*.class
   ```

2. **使用jpackage打包**
   ```bash
   cd ..
   jpackage --name JTimer --input bin --main-jar JTimer.jar --main-class JTimer.Launch --type app-image
   ```

这将生成一个包含完整Java运行时环境的独立可执行文件，用户无需安装Java即可运行。

## 使用说明

1. **启动应用**：运行后会出现一个半透明的时钟窗口
2. **移动窗口**：点击并拖动窗口任意位置可以移动
3. **倒计时功能**：点击"倒计时"按钮使用倒计时功能
4. **窗口置顶**：窗口默认设置为置顶显示

## 技术栈

- **编程语言**: Java
- **GUI框架**: Swing
- **构建工具**: jpackage (Java 14+)
- **目标平台**: Windows

## 系统要求

- **最低Java版本**: Java 8 (运行已打包应用无需Java)
- **操作系统**: Windows 7及以上
- **内存**: 至少128MB可用内存

## 开发环境设置

1. 安装Java Development Kit (JDK) 8或更高版本（开发者使用Zulu JDK 21）
2. 配置Java环境变量
3. 使用任何Java IDE或文本编辑器进行开发

## 许可证

本项目仅供学习和参考使用。


## 更新日志

### v1.0
- 初始版本发布
- 基本时钟显示功能
- 倒计时功能
- 无边框半透明窗口设计