# antrcp-template

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

## Basic Information

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

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2026-04-11

## 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>


---

### antrcp-template 介绍
antrcp-template 是antrcp-系列项目的基础模板工程，旨在为开发者提供一个结构清晰、模块化设计的本地化应用的开发起点。本模板保留了核心架构、模块划分与基础功能实现，方便开发者理解项目组织方式，并可用于二次开发或自定义工具构建。

**成品展示**  
![默认主页](_images/01home.png)  

## 🌐 相关资源

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

| 名称 | 说明 |
|------|------|
| [Eclipse Orbit](https://download.eclipse.org/tools/orbit/downloads/drops) | 为Eclipse生态系统提供经过"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/) | 补充自定义小部件。Nebula 是不同的 Eclipse 项目和独立开发人员协作构建自定义 SWT 小部件和可重用的 UI 组件的地方，这些组件可用于使用 SWT 和 JFace 构建的 UI 应用程序。 |

## 📦 模块详细说明

| 模块 | 作用 | 内容 | 特点/用途/重要性 |
|------|------|------|------------------|
| **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` | 包含具体的测试项目 |

---
## 其他说明
- [视频展示](https://zhuanlan.zhihu.com/p/1966948250415247638)
- [模板展示](UI.md)
- [功能列表](FEATURE.md)

---

## 🚀 快速开始

### 环境要求
- JDK 21+
- Maven 3.9.9+
- Eclipse IDE（eclipse-jee-2024-12-R推荐）

### 构建命令
```bash
# 清理项目
mvn clean

# 运行测试
mvn verify 

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

### 代码托管
- Gitee：[https://gitee.com/antzou/antrcp-template](https://gitee.com/antzou/antrcp-template)

## e3实践
- [[ antrcp-assistant ]](https://gitee.com/antzou/antrcp-assistant)：办公助手
- [[ antrcp-ai ]](https://gitee.com/antzou/antrcp-ai)：ai助手
- [[ antrcp-dev ]](https://gitee.com/antzou/antrcp-dev)：开发者工具