# Union-2D

**Repository Path**: uthelei/Union-2D

## Basic Information

- **Project Name**: Union-2D
- **Description**: Union-2D是基于QML开发的一整套简单且实用的通用开发框架平台，有助于开发者快速进行项目开发，可以进行换肤，窗口阴影，各种特效等
- **Primary Language**: QML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2023-06-07
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: desktop-ui

**Tags**: None

## README

# Union-2D

#### 介绍
Union-2D 是基于 QML 开发的一套 高效、灵活、现代化 的通用开发框架平台，专为开发者打造，助力 快速构建 高质量项目。它不仅提供了 丰富的 UI 组件 和 强大的功能模块，还支持以下特性：

✨ 核心亮点

一键换肤：支持动态切换主题，轻松适配不同风格（如深色/浅色模式、企业定制色等），提升用户体验。

优雅窗口特效：内置 阴影、圆角、模糊背景 等效果，让应用界面更具质感与层次感。

流畅动画引擎：集成多种预置动画（如渐显、滑动、弹性效果等），让交互更生动。

跨平台兼容：基于 QML 的强大跨平台能力，可无缝部署到桌面、嵌入式等场景。

🛠 开发者友好

低代码集成：通过声明式语法快速搭建界面，减少冗余逻辑。

模块化设计：按需调用组件，灵活扩展功能，提升开发效率。

详尽的文档与示例：提供完整 API 文档和实战案例，降低学习成本。

🌟 适用场景

无论是企业级应用、多媒体工具，还是物联网控制界面，Union-2D 都能为您提供 稳定、美观、高性能 的解决方案，让开发事半功倍！

让创意无界，让开发更简单！ 🚀

![输入图片说明](image/theme.png)
![输入图片说明](image/1722172577706.jpg)

#### 软件架构
软件架构说明
cmake 3.10 + Qt 5.15.2

#### 安装教程

1.  xxxx
2.  xxxx
3.  xxxx

#### 使用说明

1. qml/controls目录下包含基础控件，必须以U开头大驼峰命名；
2. 图标规范：深色图标放置目录:icon/dark/；亮色图标放置目录：icon/light/；添加图标文件后，在程序中使用 "qrc:/icon/" + UTheme.themeName + "/xxx.svg" 获取当前主题对应的图标，“xxx” 为图标文件名称；
3. 翻译文件放置在translations目录下且只上传ts文件；
4. 代码中使用颜色首选qml/controls/UTheme.qml文件中的颜色变量，例如：UTheme.text，禁止直接用色值；
5. qml/example目录下包含应用程序的代码；
6. 开发过程中需要图标可以到阿里巴巴矢量图标库下载；

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)