解决vscode警告

This commit is contained in:
2026-08-20 11:59:03 +08:00
parent 059e662630
commit be6e202229
+53 -65
View File
@@ -6,62 +6,54 @@ project(FancyInputQt
LANGUAGES C CXX
)
# ============ 全局编译设置 ============
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
# ---- 输出目录策略 ----
# build/<preset>:仅存放 CMake 中间产物(编译对象、Makefile、生成的 QML 模块等)
# bin/<config> :最终产物(exe + Qt DLL + 插件),由 windeployqt 部署,开箱即用
# 注意:不能用全局 CMAKE_RUNTIME_OUTPUT_DIRECTORY —— 已验证它会破坏
# qt_add_qml_module 的 QML 模块嵌入,运行时报 "Module FancyInputQt contains no type named Main"。
# 必须用 per-target 属性且放在 qt_add_qml_module 之后设置(见下方 target_link_libraries 后)。
# Qt 6.8.3 MinGW 套件(LGPL v3 动态链接,可免费商用)
# ============ Qt 依赖(6.8.3 MinGW,LGPL v3 动态链接) ============
find_package(Qt6 6.8 REQUIRED COMPONENTS
Core
Gui
Qml
Quick
QuickControls2
Core Gui Qml Quick QuickControls2
)
# QTP0004: QML 文件统一由 qt_add_qml_module 管理,无需额外 qmldir
qt_policy(SET QTP0004 NEW)
# QTP0001: QML 模块资源前缀使用 :/qt/qml/<URI>/(如 :/qt/qml/FancyInputQt/、:/qt/qml/FancyInput/Controls/),
# main.cpp 中已 addImportPath("qrc:/") 使内嵌模块可被发现
# QTP0001: QML 资源前缀为 :/qt/qml/<URI>/
# QTP0004: QML 文件统一由 qt_add_qml_module 管理,无需手写 qmldir
qt_policy(SET QTP0001 NEW)
qt_policy(SET QTP0004 NEW)
# ---- 阶段 0:Hello World 工程骨架 ----
# 后续阶段:输入识别核心 → 通用函数 → 主界面 → 分窗口 → 延后功能
# QML 模块统一输出到 build/<config>/<URI路径>/(qmlls/qmllint 依赖此布局才能找到模块)
# 必须在 qt_add_qml_module 之前设置
set(QT_QML_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}")
# ============ 主程序 ============
qt_add_executable(FancyInputQt
src/main.cpp
)
# ---- 用户控件模块 FancyInput.Controls(独立静态库) ----
# 自定义控件/主题统一放这里,App 主界面通过 `import FancyInput.Controls` 使用,
# 与 Qt 内置模块解耦,后续扩展新控件只需往 src/qml/controls/ 目录加 .qml 文件。
# URI 用点分命名空间(FancyInput.Controls),避免与主模块/第三方库撞名。
# 注意:Theme.qml 用 pragma Singleton,必须通过 QT_QML_SINGLETON_TYPE
# 源文件属性显式声明(qt_add_qml_module 只自动识别 .pragma library,
# 不会自动检测 pragma Singleton —— 见 Qt6QmlMacros.cmake 3292 行)。
qt_add_library(FancyInputControls STATIC)
# ============ QML 模块 1:FancyInput.Controls(用户自定义控件) ============
# 控件文件放在 src/qml/controls/ 目录下,GLOB 自动收集:
# 以后新增控件只需放 .qml 文件,无需修改本文件。
file(GLOB CONTROLS_QML_FILES CONFIGURE_DEPENDS
RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}"
"src/qml/controls/*.qml"
)
# Theme.qml 是 QML 单例(pragma Singleton),需显式声明
set_source_files_properties(
src/qml/controls/Theme.qml
PROPERTIES QT_QML_SINGLETON_TYPE TRUE
)
qt_add_qml_module(FancyInputControls
STATIC # 编译为静态库,链接进 exe,无需额外部署 DLL
URI FancyInput.Controls
VERSION 1.0
QML_FILES
src/qml/controls/Theme.qml
${CONTROLS_QML_FILES}
)
# ---- 主入口 QML 模块(App 自身,URI 与 exe 同名用于内嵌发现) ----
# ============ QML 模块 2:FancyInputQt(App 主界面) ============
qt_add_qml_module(FancyInputQt
URI FancyInputQt
VERSION 1.0
@@ -71,75 +63,71 @@ qt_add_qml_module(FancyInputQt
FancyInputControls
)
# ============ 链接 ============
target_link_libraries(FancyInputQt PRIVATE
FancyInputControls
FancyInputControlsplugin
Qt6::Core
Qt6::Gui
Qt6::Qml
Qt6::Quick
Qt6::QuickControls2
FancyInputControls # 控件模块(含 QML 资源)
FancyInputControlsplugin # 控件模块的静态插件,必须链接,否则运行时找不到模块
Qt6::Core Qt6::Gui Qt6::Qml Qt6::Quick Qt6::QuickControls2
)
# ---- 输出目录:per-target 设置(必须在 qt_add_qml_module 之后) ----
# exe 直接输出到 bin/<config>,build/ 只留中间产物
# ============ 输出目录 ============
# exe 输出到 bin/<config>,build/ 只留中间产物(须在 qt_add_qml_module 之后设置)
set_target_properties(FancyInputQt PROPERTIES
RUNTIME_OUTPUT_DIRECTORY "${CMAKE_SOURCE_DIR}/bin/${CMAKE_BUILD_TYPE}"
)
# ---- 构建后自动部署 Qt DLL 到 bin/<config>(LGPL 动态链接) ----
# 用 Qt 官方 windeployqt 把所需 DLL + 插件 + QML 依赖拷到 exe 旁,
# 保证 bin/ 目录开箱即用(双击即可运行,无需依赖 PATH)。
#
# 体积优化(已验证,Release 从 ~63MB 减到 ~46MB):
# 1. --skip-plugin-types qmltooling -> 跳过 QML 调试插件(仅开发用)
# 2. 部署后删除未使用的 QuickControls2 风格:
# FluentWinUI3(4.8MB)/Material/Universal/Imagine —— 默认只加载 Windows/Basic/Fusion
# 3. 删除未使用模块:tls(OpenSSL)、generic(触摸屏)、多余 imageformats
# 4. 强制删除 Qt6VirtualKeyboard(GPL v3,禁止用于闭源商用!本工程未使用它,
# 只是被 windeployqt 隐式部署进来)—— 见下方裁剪命令
# ============ 部署:windeployqt 拷贝 Qt 运行库 + 裁剪未使用组件 ============
if(WIN32)
find_program(WINDEPLOYQT_EXECUTABLE windeployqt
HINTS "${QT6_INSTALL_PREFIX}/bin"
REQUIRED)
# 1. 拷贝所需 Qt DLL/插件/QML 到 exe 旁
add_custom_command(TARGET FancyInputQt POST_BUILD
COMMAND "${WINDEPLOYQT_EXECUTABLE}"
--no-translations --no-system-d3d-compiler --no-opengl-sw
--skip-plugin-types qmltooling
--qmldir "${CMAKE_SOURCE_DIR}/src/qml"
"$<TARGET_FILE:FancyInputQt>"
COMMENT "windeployqt: 部署 Qt 运行库到 bin/<config>")
# 部署后裁剪未使用的 Qt 模块/插件(体积优化)
COMMENT "部署 Qt 运行库")
# 2. 体积优化:删除未使用的 Qt 组件
set(DEPLOY_DIR "${CMAKE_SOURCE_DIR}/bin/${CMAKE_BUILD_TYPE}")
add_custom_command(TARGET FancyInputQt POST_BUILD
COMMAND ${CMAKE_COMMAND} -E rm -rf
# 2.1 未使用的 QuickControls2 风格(默认只需 Windows/Basic/Fusion)
set(UNUSED_STYLES
"${DEPLOY_DIR}/qml/QtQuick/Controls/FluentWinUI3"
"${DEPLOY_DIR}/qml/QtQuick/Controls/Material"
"${DEPLOY_DIR}/qml/QtQuick/Controls/Universal"
"${DEPLOY_DIR}/qml/QtQuick/Controls/Imagine"
COMMAND ${CMAKE_COMMAND} -E rm -f
"${DEPLOY_DIR}/Qt6QuickControls2FluentWinUI3StyleImpl.dll"
"${DEPLOY_DIR}/Qt6QuickControls2Material.dll"
"${DEPLOY_DIR}/Qt6QuickControls2MaterialStyleImpl.dll"
"${DEPLOY_DIR}/Qt6QuickControls2Universal.dll"
"${DEPLOY_DIR}/Qt6QuickControls2UniversalStyleImpl.dll"
"${DEPLOY_DIR}/Qt6QuickControls2Imagine.dll"
"${DEPLOY_DIR}/Qt6QuickControls2ImagineStyleImpl.dll"
COMMAND ${CMAKE_COMMAND} -E rm -rf
"${DEPLOY_DIR}/Qt6QuickControls2ImagineStyleImpl.dll")
# 2.2 Qt6VirtualKeyboard(GPL v3 禁止闭源商用,本工程未使用)
set(GPL_COMPONENTS
"${DEPLOY_DIR}/qml/QtQuick/VirtualKeyboard"
"${DEPLOY_DIR}/Qt6VirtualKeyboard.dll"
"${DEPLOY_DIR}/platforminputcontexts/qtvirtualkeyboardplugin.dll")
# 2.3 其他未使用组件
set(UNUSED_MISC
"${DEPLOY_DIR}/tls"
"${DEPLOY_DIR}/generic"
# Qt6VirtualKeyboard = GPL v3,禁止闭源商用,且本工程未使用 —— 强制删除
COMMAND ${CMAKE_COMMAND} -E rm -rf
"${DEPLOY_DIR}/qml/QtQuick/VirtualKeyboard"
COMMAND ${CMAKE_COMMAND} -E rm -f
"${DEPLOY_DIR}/Qt6VirtualKeyboard.dll"
"${DEPLOY_DIR}/platforminputcontexts/qtvirtualkeyboardplugin.dll"
COMMAND ${CMAKE_COMMAND} -E rm -f
"${DEPLOY_DIR}/imageformats/qgif.dll"
"${DEPLOY_DIR}/imageformats/qicns.dll"
"${DEPLOY_DIR}/imageformats/qtga.dll"
"${DEPLOY_DIR}/imageformats/qtiff.dll"
"${DEPLOY_DIR}/imageformats/qwbmp.dll"
"${DEPLOY_DIR}/imageformats/qwebp.dll"
COMMENT "体积优化: 删除未使用的 Qt 风格/插件 + GPL 的 VirtualKeyboard")
"${DEPLOY_DIR}/imageformats/qwebp.dll")
add_custom_command(TARGET FancyInputQt POST_BUILD
COMMAND ${CMAKE_COMMAND} -E rm -rf ${UNUSED_STYLES}
COMMAND ${CMAKE_COMMAND} -E rm -rf ${GPL_COMPONENTS}
COMMAND ${CMAKE_COMMAND} -E rm -rf ${UNUSED_MISC}
COMMENT "体积优化: 裁剪未使用的 Qt 组件")
endif()