当前位置：首页 > news >正文

CMake实战：qmake转cmake神器 - pro2cmake.py

news 来源：原创 2025/6/16 13:41:06

1.概述

2.详细用法

3.转换规则

4.处理复杂情况

4.1.子项目转换

4.2.条件逻辑转换

4.3.自定义构建步骤

4.4.第三方库依赖

5.转换后手动调整

5.1.检查生成的 CMakeLists.txt

5.2.添加缺失的配置

5.3.优化 CMake 结构

6.常见示例

7.常见问题及解决方法

8.调试技巧

1.概述

pro2cmake.py 是一个将 Qt .pro 项目文件转换为 CMakeLists.txt 文件的实用工具。它能自动解析 Qt 项目配置并生成等效的 CMake 构建脚本，简化从 qmake 到 CMake 的迁移过程。

该脚本通常位于 Qt 安装目录的 libexec 或 bin 子目录下，例如：

# Linux/macOS
/path/to/Qt/6.x.x/libexec/pro2cmake.py# Windows
C:\Qt\6.x.x\msvc2019_64\libexec\pro2cmake.py

好像是Qt6之后的版本才有这个。如果找不到，可以下面地址获取最新版本：

https://code.qt.io/cgit/qt/qtbase.git/tree/util/cmake/pro2cmake.py?h=wip/cmake

最基本的使用方式是直接指定输入的 .pro 文件：

python pro2cmake.py [options] input.pro output_dir

常见选项：

选项	描述
`output_dir`	指定输出的 CMakeLists.txt 文件路径
input.pro	输入的 `.pro` 或 `.pri` 文件路径
`-p`, `--project`	设置 CMake 项目名称（默认使用 `.pro` 文件的 basename）
`--qt-version`	指定 Qt 版本（如 5 或 6，默认自动检测）
`--qt-path`	指定 Qt 安装路径
`--verbose`	启用详细输出模式
`--force`	强制覆盖已存在的输出文件
--cmake-minimum	指定 CMake 最低版本（如 `3.16`），默认 `3.5`
--recursive	递归处理子目录中的 `.pro` 文件

示例如下：

# 转换单个 .pro 文件
python pro2cmake.py myproject.pro ./build# 递归转换整个项目目录
python pro2cmake.py --recursive ./src ./build

2.详细用法

1.指定输出路径

python pro2cmake.py input.pro -o /path/to/CMakeLists.txt

2.设置项目名称

python pro2cmake.py input.pro --project MyQtProject

3.明确指定 Qt 版本

python pro2cmake.py input.pro --qt-version 6

4.自定义 Qt 安装路径‘

python pro2cmake.py input.pro --qt-path /opt/Qt/6.5.0/gcc_64

5.详细输出模式

python pro2cmake.py input.pro --verbose

3.转换规则

工具会自动处理以下 .pro 文件内容：

1.项目类型

TEMPLATE = app → add_executable()
TEMPLATE = lib → add_library()

2.源文件和头文件

SOURCES → CMake 的 add_executable/add_library 源文件列表
HEADERS → CMake 的头文件列表

3.链接库

LIBS → target_link_libraries()

4.Qt 模块

QT += core gui → find_package(Qt6 COMPONENTS Core Gui REQUIRED)
自动添加对应的 Qt 模块依赖

5.定义和编译选项

DEFINES → add_definitions()
CFLAGS/CXXFLAGS → add_compile_options()

4.处理复杂情况

4.1.子项目转换

如果 .pro 文件使用 SUBDIRS 模板管理多个子项目：

1.逐个转换：为每个子项目单独运行 pro2cmake.py。

2.手动整合：在根目录的 CMakeLists.txt 中使用 add_subdirectory() 包含子项目。

# 根目录 CMakeLists.txt
add_subdirectory(src/core)
add_subdirectory(src/gui)
add_subdirectory(src/plugins)

4.2.条件逻辑转换

.pro 文件中的条件配置（如平台特定代码）需要手动转换为 CMake 的 if() 语句：

.pro 文件示例：

win32 {SOURCES += win_specific.cpp
} else {SOURCES += unix_specific.cpp
}

转换为 CMake：

if(WIN32)target_sources(myapp PRIVATE win_specific.cpp)
else()target_sources(myapp PRIVATE unix_specific.cpp)
endif()

4.3.自定义构建步骤

如果 .pro 文件包含自定义脚本（如预处理、代码生成），需要在 CMake 中使用 add_custom_command() 或 add_custom_target()：

# 示例：生成代码文件
add_custom_command(OUTPUT generated_code.cppCOMMAND python generate_code.pyDEPENDS generate_code.pyWORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
)add_executable(myapp main.cpp generated_code.cpp)

4.4.第三方库依赖

如果项目依赖非 Qt 库（如 OpenCV、Boost）：

1.在 .pro 文件中找到 LIBS 和 INCLUDEPATH 配置。

2.在 CMake 中使用 find_package() 或 add_library() 添加依赖。

# 示例：添加 OpenCV 依赖
find_package(OpenCV REQUIRED)
target_link_libraries(myapp PRIVATE ${OpenCV_LIBS})
target_include_directories(myapp PRIVATE ${OpenCV_INCLUDE_DIRS})

5.转换后手动调整

5.1.检查生成的 CMakeLists.txt

重点检查：

源文件路径是否正确（特别是相对路径）。
Qt 模块依赖是否完整（如 Qt6::Network、Qt6::Xml）。
编译选项和定义（add_compile_options()、add_definitions()）。

5.2.添加缺失的配置

1.资源文件（.qrc）

qt_add_resources(myapp "resources" RESOURCES resources.qrc)

2.UI 文件（.ui）

qt_wrap_ui(UI_HEADERS mainwindow.ui)

3.MOC 文件（如果自动生成失败）

set(CMAKE_AUTOMOC ON)

5.3.优化 CMake 结构

建议将复杂逻辑拆分为模块：

project/
├── CMakeLists.txt       # 根配置
├── cmake/               # 自定义模块
│   ├── FindQt6.cmake
│   └── MyUtils.cmake
└── src/├── CMakeLists.txt   # 子项目配置

6.常见示例

一般项目片段：

# 转换项目
python pro2cmake.py myproject.pro -o CMakeLists.txt --qt-version 6 --verbose# 检查生成的文件
vim CMakeLists.txt# 使用 CMake 构建
mkdir build && cd build
cmake ..
cmake --build .

复杂项目转换片段：

假设 .pro 文件包含：

# 条件编译
contains(DEFINES, DEBUG) {DEFINES += ENABLE_LOGGING
}# 第三方库
INCLUDEPATH += $$PWD/thirdparty/include
LIBS += -L$$PWD/thirdparty/lib -lmylib# 自定义构建步骤
system(scripts/gen_version.py $$VERSION_FILE)

转换为 CMake：

# CMakeLists.txt
if(DEFINED DEBUG)target_compile_definitions(myapp PRIVATE ENABLE_LOGGING)
endif()# 第三方库
include_directories(${CMAKE_SOURCE_DIR}/thirdparty/include)
link_directories(${CMAKE_SOURCE_DIR}/thirdparty/lib)
target_link_libraries(myapp PRIVATE mylib)# 自定义构建步骤
add_custom_target(generate_versionCOMMAND python ${CMAKE_SOURCE_DIR}/scripts/gen_version.py ${VERSION_FILE}WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
)
add_dependencies(myapp generate_version)

7.常见问题及解决方法

找不到 Qt 模块：检查 CMAKE_PREFIX_PATH 是否指向 Qt 安装目录。
编译错误：检查源文件路径和依赖项是否正确。
缺失定义：在 CMake 中添加 add_definitions(-DMY_DEFINE)。

8.调试技巧

保留原始配置：在生成的 CMakeLists.txt 中添加注释，标记对应的 .pro 配置。
使用 CMake 工具链：为跨平台构建配置 toolchain.cmake。
自动化测试：编写测试脚本验证转换后的项目能否正常编译运行。

通过以上步骤，你可以系统性地将复杂 Qt 项目从 .pro 转换为 CMake。转换后建议进行全面测试，确保功能与原项目一致。

CMake实战：qmake转cmake神器 - pro2cmake.py

1.概述

2.详细用法

3.转换规则

4.处理复杂情况

4.1.子项目转换

4.2.条件逻辑转换

4.3.自定义构建步骤

4.4.第三方库依赖

5.转换后手动调整

5.1.检查生成的 CMakeLists.txt

5.2.添加缺失的配置

5.3.优化 CMake 结构

6.常见示例

7.常见问题及解决方法

8.调试技巧

相关链接

相关文章：