# EvolveUI-QML

**Repository Path**: kid-kid/evolve-ui-qml

## Basic Information

- **Project Name**: EvolveUI-QML
- **Description**: 开源的EvolveUI qml项目移植，版本1.3.8
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 开源的QtQuickQMl项目EvolveUI

## README

# Evolve UI QML 控件库使用指南

---

移植第三方Evolve QML控件库

[1.现代化 Qt6 QML 组件库移植以及控件库文档](https://evolveui.top/)

[2.Github地址https://github.com/sudoevolve/EvolveUI.git](https://github.com/sudoevolve/EvolveUI.git)

![1768985650589](image/readme/1768985650589.png)

![1768985661939](image/readme/1768985661939.png)

![1768985672356](image/readme/1768985672356.png)

---

## 1. 导入项目到Qt Creator

### 步骤说明

1. **打开项目**

   - 启动 Qt Creator
   - 选择 `File > Open File or Project`
   - 导航到项目根目录
   - 选择 `CMakeLists.txt` 文件

## 2. 构建与运行

1. 在Qt Creator左下角选择 `Debug` 模式
2. 点击左下角构建套件选择器，确认使用 `Desktop Qt 6.8.3 MSVC2022 64bit`
3. 按 `Ctrl+B` 构建项目，按 `Ctrl+R` 运行


### 关键目录说明

| 目录            | 用途                               |
| --------------- | ---------------------------------- |
| `components/` | 存放基础QML组件（按钮、输入框等）  |
| `pages/`      | 存放页面级QML文件                  |
| src.qrc         | 静态资源（在CMakeLists中引用资源） |



如果是新建的Qt项目只需要三步：

1、新建Qt Quick Application项目

2、将上述三个文件拷贝到自己的项目中

3、修改CMakeLists.txt 增加对上述文件的引用


```cmake
cmake_minimum_required(VERSION 3.16)

project(EvolveUITest VERSION 0.1 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 REQUIRED COMPONENTS Quick Multimedia Network)

qt_standard_project_setup(REQUIRES 6.8)

qt_add_executable(appEvolveUITest
    main.cpp
)



# ==========================
# QML 模块
# ==========================
file(GLOB QML_COMPONENTS CONFIGURE_DEPENDS RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} "components/*.qml")
file(GLOB QML_PAGES CONFIGURE_DEPENDS RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} "pages/*.qml")


qt_add_qml_module(appEvolveUITest
    URI EvolveUITest
    VERSION 1.0
    QML_FILES
        Main.qml
        ${QML_COMPONENTS}
        ${QML_PAGES}
)


# ==========================
# Qt 资源文件
# ==========================
qt_add_resources(APP_RESOURCES
    src.qrc
)

target_sources(appEvolveUITest PRIVATE ${APP_RESOURCES})

# Qt for iOS sets MACOSX_BUNDLE_GUI_IDENTIFIER automatically since Qt 6.1.
# If you are developing for iOS or macOS you should consider setting an
# explicit, fixed bundle identifier manually though.
set_target_properties(appEvolveUITest PROPERTIES
#    MACOSX_BUNDLE_GUI_IDENTIFIER com.example.appEvolveUITest
    MACOSX_BUNDLE_BUNDLE_VERSION ${PROJECT_VERSION}
    MACOSX_BUNDLE_SHORT_VERSION_STRING ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}
    MACOSX_BUNDLE TRUE
    WIN32_EXECUTABLE TRUE
)

target_link_libraries(appEvolveUITest
    PRIVATE Qt6::Quick Qt6::Multimedia Qt6::Network
)

include(GNUInstallDirs)
install(TARGETS appEvolveUITest
    BUNDLE DESTINATION .
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

```


---

---

## 🚀 如果想使用最新的库可以按照下面官方步骤来移植到自己的项目中。

### 1. 安装依赖

```
# 确保已安装 Qt 6.5 及以上版本
# 克隆项目
git clone https://github.com/sudoevolve/EvolveUI.git

# 进入项目目录
cd EvolveUI
```

### 2. 创建新项目

使用提供的脚手架脚本快速创建项目：

```
# 运行脚手架脚本
tools\New-EvolveUIProject.bat
```

### 3. 引入组件

在 QML 文件中引入 EvolveUI 组件：

```
import "components" as Components

// 导入主题
Components.ETheme {
    id: theme
}

// 使用组件
Components.EButton {
    text: "提交"
    iconCharacter: "\uf1d8"
    onClicked: console.log("Clicked!")
}
```