以QHexView为例，如何将第三方QT插件源代码包含到QT主项目中（QT6,CMake）-CSDN博客

本文链接：https://blog.csdn.net/allnlei/article/details/147899297

使用CMake 作为构建系统。下面是将 QHexView 嵌入到使用 CMake 的主 Qt 项目中的详细步骤。

步骤概述

克隆或下载 QHexView 源代码
将 QHexView 作为子模块或将其源代码包含到主项目中
配置主项目的 CMakeLists.txt 文件
在代码中使用 QHexView
使用 Qt Designer（可选）

详细步骤

1. 克隆或下载 QHexView 源代码

首先，您需要获取 QHexView 的源代码。您可以通过 Git 克隆仓库或直接下载压缩包。

使用 Git 克隆仓库：

git clone https://github.com/Dax89/QHexView.git external/QHexView

或直接下载压缩包：

访问 QHexView GitHub 页面，点击 “Code” 按钮然后选择 “Download ZIP”，下载并解压到您的项目的 external/QHexView/ 目录中。

2. 将 QHexView 作为子模块（可选）

如果您希望将 QHexView 作为 Git 子模块，可以执行以下命令：

git submodule add https://github.com/Dax89/QHexView.git external/QHexView
git submodule update --init --recursive

3. 配置主项目的 `CMakeLists.txt` 文件

假设您的主项目已经有一个 CMakeLists.txt 文件，下面是如何配置它以包含 QHexView。

a. 添加 QHexView 源代码

假设 QHexView 位于 external/QHexView/ 目录下，您可以将其添加为一个子目录。如果 QHexView 使用自己的 CMake 配置，可以这样做：

add_subdirectory(external/QHexView)

如果 QHexView 没有 CMake 支持，您需要手动添加 QHexView 的源文件到您的项目中：

# 指定 QHexView 的源文件路径
set(QHEXVIEW_SOURCES
    external/QHexView/qhexview.cpp
    external/QHexView/qhexedit.cpp
    # 根据实际文件列表添加其他源文件
)

set(QHEXVIEW_HEADERS
    external/QHexView/qhexview.h
    external/QHexView/qhexedit.h
    # 根据实际文件列表添加其他头文件
)

# 创建一个静态库或直接将源文件添加到您的目标中
add_library(QHexView_LIB STATIC ${QHEXVIEW_SOURCES} ${QHEXVIEW_HEADERS})

# 包含 QHexView 的头文件目录
target_include_directories(QHexView_LIB PUBLIC external/QHexView)

# 链接 Qt 库到 QHexView_LIB
target_link_libraries(QHexView_LIB PUBLIC Qt5::Core Qt5::Gui Qt5::Widgets)

b. 添加您的主应用程序

假设您的主应用程序源文件在 src/ 目录下：

set(SOURCES
    src/main.cpp
    src/MainWindow.cpp
    # 其他源文件
)

set(HEADERS
    src/MainWindow.h
    # 其他头文件
)

add_executable(YourApp ${SOURCES} ${HEADERS})

# 包含 QHexView 的头文件目录
target_include_directories(YourApp PRIVATE external/QHexView/include)


# 链接 Qt 库和 QHexView_LIB 到您的主应用程序
target_link_libraries(YourApp PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets QHexView)

完整的 CMakeLists.txt 示例：

cmake_minimum_required(VERSION 3.14)
project(YourProjectName VERSION 1.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt5 REQUIRED COMPONENTS Core Gui Widgets)

# 添加 QHexView
set(QHEXVIEW_SOURCES
    external/QHexView/qhexview.cpp
    external/QHexView/qhexedit.cpp
    # 根据实际文件列表添加其他源文件
)

set(QHEXVIEW_HEADERS
    external/QHexView/qhexview.h
    external/QHexView/qhexedit.h
    # 根据实际文件列表添加其他头文件
)

add_library(QHexView_LIB STATIC ${QHEXVIEW_SOURCES} ${QHEXVIEW_HEADERS})
target_include_directories(QHexView_LIB PUBLIC external/QHexView)
target_link_libraries(QHexView_LIB PUBLIC Qt5::Core Qt5::Gui Qt5::Widgets)

# 添加您的主应用程序
set(SOURCES
    src/main.cpp
    src/MainWindow.cpp
    # 其他源文件
)

set(HEADERS
    src/MainWindow.h
    # 其他头文件
)

add_executable(YourApp ${SOURCES} ${HEADERS})
target_include_directories(YourApp PRIVATE external/QHexView)
target_link_libraries(YourApp PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets QHexView)

注意：

请确保 external/QHexView/ 目录下包含 QHexView 的所有必要源文件和头文件。
如果 QHexView 有其他依赖，请确保这些依赖也被正确包含和链接。

4. 在代码中使用 QHexView

在需要使用 QHexView 的地方包含相应的头文件并创建 QHexView 实例。

示例代码：

// src/MainWindow.h
#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include "qhexview.h" // 根据实际路径调整

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private:
    Ui::MainWindow *ui;
    QHexView *hexView;
};

#endif // MAINWINDOW_H

// src/MainWindow.cpp
#include "MainWindow.h"
#include "ui_MainWindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 创建 QHexView 实例
    hexView = new QHexView(this);

    // 打开文件（示例路径，请根据需要调整）
    QString filePath = "/path/to/your/file.bin";
    if (!hexView->openFile(filePath)) {
        // 处理文件打开失败的情况
    }

    // 将 hexView 添加到主窗口的布局中
    ui->mainLayout->addWidget(hexView); // 确保在 .ui 文件中有名为 mainLayout 的布局
}

MainWindow::~MainWindow()
{
    delete ui;
}

注意：

确保在您的 .ui 文件中有一个布局（如 QVBoxLayout）并命名为 mainLayout，或根据实际情况调整代码。
根据需要，您可能需要调整 openFile 的参数或调用其他 QHexView 的方法。

5. 使用 Qt Designer（可选）

如果使用 Qt Designer 设计 UI，可以通过以下步骤将 QHexView 添加为自定义 Widget：

a. 在 Qt Designer 中添加自定义 Widget

打开 Qt Designer 并加载您的 .ui 文件。
从左侧的 Widget 工具箱中拖动一个 QWidget 到您的界面。
右键点击该 QWidget，选择 “提升为…（Promote to…）”。
在弹出的对话框中填写以下信息：
- 基类类名（Base class name）: QWidget
- 提升后的类名（Promoted class name）: QHexView
- 头文件（Header file）: qhexview.h （根据实际路径填写）
点击 “添加（Add）”，然后点击 “提升（Promote）”。

b. 在代码中设置 QHexView
确保在相应的窗口类中包含 qhexview.h，并在初始化时进行必要的设置。

6. 处理可能的问题

依赖问题：
- 确保所有 QHexView 依赖的 Qt 模块都已在 find_package 中正确包含，并在 target_link_libraries 中链接。
路径问题：
- 检查 CMakeLists.txt 中的路径是否正确，尤其是 QHexView 的源文件和头文件路径。
兼容性问题：
- 确认 QHexView 与您使用的 Qt 版本兼容。如有需要，可能需要对 QHexView 的源代码进行修改。

示例项目结构

YourProject/
├── CMakeLists.txt
├── external/
│   └── QHexView/
├── src/
│   ├── main.cpp
│   ├── MainWindow.h
│   ├── MainWindow.cpp
└── build/ (构建输出目录)