# antrcp-template

**Repository Path**: antzou/antrcp-template

## Basic Information

- **Project Name**: antrcp-template
- **Description**: antrcp-template 是 antrcp 系列的基础模板工程，基于 Maven Tycho 构建 Eclipse RCP 应用程序，集成 Eclipse E4 架构、Nebula 控件与 SWTBot 自动化测试框架。它旨在为开发者提供一个结构清晰、模块化设计的本地化应用开发起点，并保留核心架构、模块划分与基础功能实现，便于快速理解项目组织方式，也可直接用于二次开发或自定义工具构建。
- **Primary Language**: Java
- **License**: EPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-10-27
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Tycho, SWTBot, Eclipse, e4, rcp

## README

<p align="center">
	<img alt="logo" src="bundles/antzou.template.application/splash.bmp" width="400" height="200">
</p>
<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">antrcp-template</h1>
<h4 align="center">构建 Eclipse RCP 应用的模板，让 Eclipse 应用程序构建变得简单、优雅！</h4>
<p align="center">
	<a href="https://www.oracle.com/technetwork/java/javase/downloads/index.html"><img src="https://img.shields.io/badge/JDK-21+-green.svg"></a>
	<a href="https://maven.apache.org"><img src="https://img.shields.io/badge/maven-v3.9.9-blue"></a>
	<a href="https://download.eclipse.org/releases/2024-12/202412041000/"><img src="https://img.shields.io/badge/TargetPlatform-202512-blue"></a>
	<a href="https://www.eclipse.org/downloads"><img src="https://img.shields.io/badge/Eclipse%20IDE-提供支持-blue.svg"></a>
	<a href=""><img src="https://img.shields.io/badge/系统-win%20%7C%20mac%20%7C%20linux-007EC6"></a>
	<a href="https://gitee.com/antzou/antrcp-template/blob/master/LICENSE"><img src="https://img.shields.io/:license-epl2.0-green.svg"></a>
</p>

---

## 🚀 模板速览

| 模块 | 作用 | 关键内容 |
| :--- | :--- | :--- |
| 📦 **bundles** | 所有 OSGi bundle（插件） | 核心业务逻辑、UI 组件、服务实现、扩展点实现 |
| 🧩 **features** | 功能特性聚合与管理 | 组合相关 bundles、定义产品功能、管理依赖与版本 |
| 🚀 **releng** | Release Engineering（发布工程） | 产品构建配置、目标平台、产品配置、更新站点、打包分发 |
| 🧪 **tests** | 测试代码 | 单元测试、集成测试、UI 测试（SWTBot） |

> 👉 [查看模板 UI](UI.md) · [查看功能列表](FEATURE.md)

<p align="center">
    <img alt="默认主页" src="_images/01home.png" width="80%">
</p>

---

## 📦 模块详细说明

| 模块 | 作用 | 内容 | 特点 / 用途 / 重要性 |
| :--- | :--- | :--- | :--- |
| **bundles 模块** | 包含所有的 OSGi bundle（插件） | • 核心业务逻辑代码<br>• UI 组件<br>• 服务实现<br>• 扩展点实现 | • 每个 bundle 都是独立模块<br>• 可单独开发、测试和部署<br>• 遵循 OSGi 规范 |
| **features 模块** | 功能特性聚合和管理 | • 将相关 bundles 组合成完整特性<br>• 定义产品包含哪些功能<br>• 管理依赖关系和版本 | • 用户可安装特定 feature，而非单个 bundle<br>• 便于功能模块化管理 |
| **releng 模块** | Release Engineering（发布工程） | • 产品构建配置<br>• 目标平台定义<br>• 产品配置文件<br>• 更新站点配置<br>• 打包和分发配置 | 负责整个产品的最终组装和发布 |
| **tests 模块** | 测试代码 | • 单元测试<br>• 集成测试<br>• UI 测试（如 SWTBot 测试）<br>• 具体位置：`tests/antzou.template.tests` | 包含具体的测试项目 |

---

## 🌐 相关资源

### Eclipse 生态系统重要资源

| 名称 | 说明 |
| :--- | :--- |
| [Eclipse Orbit](https://download.eclipse.org/tools/orbit/downloads/drops) | 为 Eclipse 生态系统提供经过“Eclipse 化”的第三方库版本，简化第三方库集成和使用。 |
| [SWTBot](https://download.eclipse.org/technology/swtbot/releases/latest) | 基于 Eclipse SWT 的自动化测试框架，用于测试 Eclipse 插件、RCP 应用和 IDE 功能。 |
| [Eclipse Releases](https://download.eclipse.org/releases) | Eclipse 官方发布的集成版本，提供开发和使用 Eclipse 所需的核心平台和工具。 |
| [Maven Tycho](https://www.vogella.com/tutorials/EclipseTycho/article.html) | 用于通过命令行构建 Eclipse 插件、OSGi bundle 和 Eclipse 应用程序。 |
| [Nebula](https://eclipse.dev/nebula/) | 补充自定义小部件，用于构建自定义 SWT 小部件和可复用 UI 组件。 |

---

## 🚀 快速开始

### 环境要求

| 项目 | 要求 |
| :--- | :--- |
| JDK | JDK 21+ |
| Maven | Maven 3.9.9+ |
| Eclipse IDE | eclipse-jee-2024-12-R（推荐） |

### 获取源码

```bash
git clone https://gitee.com/antzou/antrcp-template.git
```

### 构建命令

```bash
# 清理项目
mvn clean

# 运行测试
mvn verify

# 打包产品
mvn clean verify -Dskip.ui-tests=false
```

---

## 📢 动态与演示

- **视频演示**：[B站视频](https://www.bilibili.com/video/BV1gGySBeEtD/)
- **模板 UI**：[UI.md](UI.md)
- **功能列表**：[FEATURE.md](FEATURE.md)

---

## 🧩 产品生态矩阵

antrcp 系列提供 **整体打包的母舰平台** 与 **单一职责的独立组件**。  
每个组件均为独立可执行程序，不依赖任何母舰；母舰平台本身也是独立应用，已内置相应功能。  
`antrcp-template` 则是 antrcp 系列统一 UI 组件与脚手架模板，用于二次开发与定制。

### 🚢 母舰平台总览

| 母舰平台 | 适用角色 | 核心能力 | 仓库地址 |
| :--- | :--- | :--- | :--- |
| **antrcp-assistant**（办公助手） | 文员 / 行政 / 财务 | 发票、文档、音视频、水印、图像、OCR 等日常办公工具 | [→ 前往](https://gitee.com/antzou/antrcp-assistant) |
| **antrcp-dev**（开发者助手） | 开发 / 运维 | 文件枢纽、API 调试、Redis 监控、消息队列运维 | [→ 前往](https://gitee.com/antzou/antrcp-dev) |
| **antrcp-ai**（AI 助手） | AI 创作者 / 算法工程师 / 内容运营 | 语音识别 · TTS · 智能字幕 · NLP 注音 · 图像修复 · OCR | [→ 前往](https://gitee.com/antzou/antrcp-ai) |

### 🧩 独立功能组件

| 类别 | 组件名称 | 描述 | 对应母舰 | 仓库 |
| :--- | :--- | :--- | :--- | :--- |
| **办公** | 发票助手 | PDF/OFD 发票合并、结构化信息提取 | assistant | [antrcp-invoice](https://gitee.com/antzou/antrcp-invoice) |
| **办公** | 图像助手 | 图像修复（去水印/杂物）、尺寸修改、批量压缩与重命名 | assistant / ai | [antrcp-image](https://gitee.com/antzou/antrcp-image) |
| **办公** | 批量文档 | Word 模板 + Excel 数据，一键批量生成合同/证书 | assistant | [antrcp-doc](https://gitee.com/antzou/antrcp-doc) |
| **办公** | 影音助手 | 音频格式互转、PCM 互转、视频水印、视频压缩（2-Pass） | assistant | [antrcp-media](https://gitee.com/antzou/antrcp-media) |
| **办公** | 水印助手 | 为图片、PDF、视频添加文字/图片水印，支持描边与边距 | assistant | [antrcp-watermark](https://gitee.com/antzou/antrcp-watermark) |
| **办公** | 文档识别（OCR） | 基于 PaddleOCR V6 的离线识别引擎，模板化字段提取 | assistant / ai | [antrcp-ocr](https://gitee.com/antzou/antrcp-ocr) |
| **办公** | PDF 助手 | 页面管理、合并、拆分、水印、签名 | assistant | [antrcp-pdf](https://gitee.com/antzou/antrcp-pdf) |
| **开发** | 文件枢纽 | 跨平台文件传输、同步与管理中枢 | dev | [antrcp-filehub](https://gitee.com/antzou/antrcp-filehub) |
| **开发** | API 助手 | RESTful / WebSocket 接口调试与自动化测试 | dev | [antrcp-api](https://gitee.com/antzou/antrcp-api) |
| **开发** | Redis 助手 | Redis 服务与可视化数据管理 | dev | [antrcp-redis](https://gitee.com/antzou/antrcp-redis) |
| **开发** | 消息枢纽 | MQ（Artemis）消息查询与运维工具 | dev | [antrcp-mq](https://gitee.com/antzou/antrcp-mq) |
| **AI** | 语音助手 | 离线语音识别（ASR）、TTS、智能字幕生成、中文文本注音 | ai | [antrcp-voice](https://gitee.com/antzou/antrcp-voice) |

### 🧩 框架源码

| 框架 / 模板 | 说明 | 仓库 |
| :--- | :--- | :--- |
| **antrcp-template** | antrcp 系列统一 UI 组件与脚手架模板，用于二次开发与定制 | [→ 前往](https://gitee.com/antzou/antrcp-template) |

---

## 📄 开源协议

本项目采用 **Eclipse Public License 2.0（EPL-2.0）** 开源协议。  
完整协议内容见：[LICENSE](https://gitee.com/antzou/antrcp-template/blob/master/LICENSE)。

---

**antrcp-Template** – 将 Eclipse 生态的复杂留给自己，将构建应用的纯粹优雅留给开发者! 🐜