跳转至

C++

Widnows下编译Qt5.15.8

编译环境

操作系统: Windows 10 Professional 22H2

编译器:Visual Studio 2019 Community CPU:Intel Core i5-8300H @ 2.3GHz

内存:16GB

参考官方文档: https://doc.qt.io/qt-5/windows-building.html https://doc.qt.io/qt-6/qtwebengine-platform-notes.html

准备工作及依赖

编译Qt5.15.8依赖现在基本都包含在源代码里了:

  • 在qtbase\bin和gnuwin32\bin中
  • CMake需要自己另行安装,并加入至path环境变量中
  • 如果需要 Make 本地文档,则需要安装 LLVM WebEngine所需依赖:
  • Python 2.7.5,不支持Python3,此处有坑,不支持2.7.10以上版本,最好就用Python2.7.5,另外,如果path里有python3 ,要去掉。版本正确,还找不到python2的话,copy一份python.exe为python2.exe
  • Bison, Flex,已经在源码自带的gnuwin32\bin中
  • GPerf,需自行安装
  • Node.js version 8 or later (version 12 or later is recommended),就用12.x就好,太新的不要
  • OpenSSL 3.0.x 更高版本的不行
perl Configure VC-WIN64A --prefix=D:\Libraries\OpenSSL\3.0.9
nmake
nmake install

我自己写了个bat把环境变量都设置好,放在解压后的源码目录运行即可:

set _ROOT=%cd%
set PATH=%_ROOT%\qtbase\bin;%_ROOT%\gnuwin32\bin;%PATH%
set PATH=%PATH%;C:\Python27
set PYTHONPATH=C:\Python27\DLLs
set PATH=%PATH%;D:\Tools\win_flex_bison
set PATH=%PATH%;D:\Tools\gperf\bin
set PATH=%PATH%;D:\Tools\nasm
set PATH=%PATH%;D:\Tools\ruby-1.9.3-p551-i386-mingw32\bin
set OPENSSL_PREFIX=D:\Libraries\OpenSSL\3.0.9
set PATH=%PATH%;%OPENSSL_PREFIX%\bin
set INCLUDE=%INCLUDE%;%OPENSSL_PREFIX%\include
set LIB=%LIB%;%OPENSSL_DIR%\lib
SET PATH=%_ROOT%\qtrepotools\bin;%PATH%
set LLVM_INSTALL_DIR=C:\Program Files\LLVM

开始编译

必须使用x64 Native Tools Command Prompt for Visual Studio 2019运行以下命令 运行env.bat设置path后,使用以下配置:

configure -recheck-all -opensource -confirm-license -verbose -debug-and-release -webengine-proprietary-codecs -nomake tests -nomake examples -prefix D:\Libraries\Qt\5.15.9\msvc2019_x64 -mp -opengl dynamic -openssl-linked OPENSSL_PREFIX=D:\Libraries\OpenSSL\3.0.9 -I D:\Libraries\OpenSSL\3.0.9\include -L D:\Libraries\OpenSSL\3.0.9\lib OPENSSL_LIBS="-lUser32 -lAdvapi32 -lGdi32 -llibcrypto -llibssl"

如果之前编译过不支持ssl的版本,需要把文件删掉重新编译 使用jom代替nmake进行并行编译:

jom -j16

整个过程大约10小时,主要花在编译webengine上 在生成文档前,必须先安装,记得将OpenSSL的几个DLL复制到qt安装的路径的bin目录下

jom install

生成文档,此操作需先install后,再将qdoc的路径加入至PATH,可先单独运行一下qdoc看是否报错,如报错,需将libclang.dll复制到qt安装的路径的bin目录下

jom docs

安装文档

jom install_docs

整个过程很长很痛苦,主要是webengine要编译一个完整的chromium,太久了

Windows下编译Qt6.5

编译环境

操作系统: Windows 11 Home 22H2

编译器:Visual Studio 2022 Community

CPU:Intel Core i7-12700 @ 2.10GHz

内存:16GB

参考官方文档: https://wiki.qt.io/Building_Qt_6_from_Git https://doc.qt.io/qt-6.5/qtwebengine-platform-notes.html#windows https://wiki.qt.io/QtWebEngine/Qt6Build

准备工作及依赖

编译Qt6所需依赖:

  • Git (>= 1.6.x)
  • CMake (>= 3.16, >= 3.18.4 for Ninja Multi-Config, >= 3.19 for WebEngine, >= 3.21.1 for static Qt builds in Qt 6.2+, or builds for Apple platforms in Qt 6.6+)
  • Ninja
  • C++ compiler supporting C++ 17
  • Perl (>=5.14, optional for Qt >= 6.5)
  • Python (>=2.6.x)
  • libclang (>=10, optional when QDoc should be built, prebuilt versions for each OS can be downloaded here or installed through the libclang-dev package on Linux)
  • Visual Studio 2022, Visual Studio 2019, MinGW 11.2
  • 如果需要 Make 本地文档,则需要安装 LLVM ,而且需要的是 Qt Company 预构建的 LLVM 。LLVM Qt Prebuilt: https://download.qt.io/development_releases/prebuilt/libclang/qt/ 编译WebEngine所需依赖:
  • CMake 3.19 or newer
  • Python 3 with html5lib library,由于使用了imp库的关系不支持3.12,最高可用3.11
  • Bison, Flex,偷懒的话,可以从qt5的源码中copy,自己下的话记得要手动处理libiconv和libintl的依赖,确保命令行下不报错就行
  • GPerf
  • Node.js version 12 or later,用最后的12.x版本即可
  • OpenSSL,可从源代码安装
perl Configure VC-WIN64A --prefix=D:\Libraries\OpenSSL\3.0.12
nmake
nmake install

我自己写了个bat把环境变量都设置好,放在解压后的源码目录运行即可:

set _ROOT=%cd%
set PATH=%_ROOT%/qtbase/bin;%PATH%
set PATH=%PATH%;D:/Tools/bison-2.4.1-bin/bin
set PATH=%PATH%;D:/Tools/flex-2.5.4a-1-bin/bin
set PATH=%PATH%;D:/Tools/gperf-3.0.1-bin/bin
SET PATH=%_ROOT%/qtrepotools/bin;%PATH%
SET PATH=%PATH%;C:/Strawberry/perl/bin
set LLVM_INSTALL_DIR="C:/Program Files/LLVM/bin"
set OPENSSL_ROOT_DIR=D:/Libraries/OpenSSL/3.0.12

开始编译

必须使用x64 Native Tools Command Prompt for Visual Studio 2012运行以下命令 运行env.bat设置path后,使用以下配置: 注意事项:

  • 需使用chcp 65001切换至utf-8 code page开始编译,否则后续webengine中的python脚本会报错
  • 需提前将OpenSSL的两个DLL复制到qtbase/bin中,后续过程有依赖
  • Qt6无法同时编译debug和release版本,需删除CMakeCache.txt后,再重新configure 编译debug版本:
configure -opensource -confirm-license -verbose -debug -webengine-proprietary-codecs -nomake tests -nomake examples -prefix D:/Libraries/Qt/6.5.3/msvc2022_x64 -mp -opengl dynamic -openssl-linked OPENSSL_PREFIX=D:/Libraries/OpenSSL/3.0.12 -I D:/Libraries/OpenSSL/3.0.12/include -L D:/Libraries/OpenSSL/3.0.12/lib OPENSSL_LIBS="-lUser32 -lAdvapi32 -lGdi32 -llibcrypto -llibssl"

编译release版本:

configure -opensource -confirm-license -verbose -release -webengine-proprietary-codecs -nomake tests -nomake examples -prefix D:/Libraries/Qt/6.5.3/msvc2022_x64 -mp -opengl dynamic -openssl-linked OPENSSL_PREFIX=D:/Libraries/OpenSSL/3.0.12 -I D:/Libraries/OpenSSL/3.0.12/include -L D:/Libraries/OpenSSL/3.0.12/lib OPENSSL_LIBS="-lUser32 -lAdvapi32 -lGdi32 -llibcrypto -llibssl"

如果之前编译过不支持ssl的版本,需要把文件删掉重新编译 使用cmake进行并行编译(实际调用的ninja):

cmake --build . --parallel

时间主要花在编译webengine上 在生成文档前,必须先安装,记得将OpenSSL的几个DLL复制到qt安装的路径的bin目录下

ninja install

或者使用cmake方式安装

cmake --install .

生成文档,此操作需先install后,再将qdoc的路径加入至PATH,可先单独运行一下qdoc看是否报错,如报错,需将libclang.dll复制到qt安装的路径的bin目录下

cmake --build . --target docs

安装文档

cmake --build . --target install_docs

整个过程很长很痛苦,主要是webengine要编译一个完整的chromium,太久了

CPack NSIS示例

#Installation;
if(WIN32)
install(TARGETS ${proj} RUNTIME DESTINATION bin)
install(FILES ${SQLite3_LIBRARIES}/sqlite3.dll DESTINATION bin)
install(DIRECTORY ${CMAKE_SOURCE_DIR}/resources/share DESTINATION bin)
install(FILES ${CMAKE_SOURCE_DIR}/LICENSE.txt DESTINATION .)
#set(CMAKE_INSTALL_SYSTEM_RUNTIME_DESTINATION .)
set(CPACK_NSIS_MUI_ICON ${CMAKE_SOURCE_DIR}/resources/app_icon.ico)
set(CPACK_NSIS_MODIFY_PATH "ON")
set(CPACK_CREATE_DESKTOP_LINKS ${proj})
set(CPACK_PACKAGE_EXECUTABLES ${proj} ${APP_NAME})
endif()
set(CPACK_PACKAGE_NAME ${APP_NAME})
set(CPACK_PACKAGE_VERSION ${APP_VERSION_MAJOR}.${APP_VERSION_MINOR}.${APP_VERSION_FIX})
set(CPACK_DEBIAN_PACKAGE_ARCHITECTURE ${CMAKE_SYSTEM_PROCESSOR})
set(CPACK_RESOURCE_FILE_LICENSE ${CMAKE_SOURCE_DIR}/LICENSE.txt)

include(InstallRequiredSystemLibraries)
include(CPack)

如何将一个QImage对象插入QTextEdit并显示

1. Using html tag

QTextEdit *textEditor = new QTextEdit(0);
QTextDocumentFragment fragment;
fragment = QTextDocumentFragment::fromHtml("");
textEditor->textCursor().insertFragment(fragment);
textEditor->setVisible(true);

2. Using QTextDocument's resource

QString file = QFileDialog::getOpenFileName(this, tr("Select an image"),
".", tr("Bitmap Files (*.bmp)
"
"JPEG (*.jpg *jpeg)
"
"GIF (*.gif)
"
"PNG (*.png)
"));
QUrl Uri ( file );
QImage image = QImageReader ( file ).read();
QTextDocument * textDocument = m_textEdit->document();
textDocument->addResource( QTextDocument::ImageResource, Uri, QVariant ( image ) );
QTextCursor cursor = m_textEdit->textCursor();
QTextImageFormat imageFormat;
imageFormat.setWidth( image.width() );
imageFormat.setHeight( image.height() );
imageFormat.setName( Uri.toString() );
cursor.insertImage(imageFormat);

3. Subclass QTextEdit (The example below also enabled drag & drop)

class TextEdit : public QTextEdit {
public:
    bool canInsertFromMimeData( const QMimeData* source ) const
    {
        return(source->hasImage() );
    }


    void insertFromMimeData( const QMimeData* source )
    {
        if ( source->hasImage() )
        {
            static int  i = 1;
            QUrl        url( QString( "dropped_image_%1" ).arg( i++ ) );
            dropImage( url, qvariant_cast( source->imageData() ) );
        } else if ( source->hasUrls() )
        {
            foreach( QUrl url, source->urls() )
            {
                QFileInfo info( url.toLocalFile() );
                if ( QImageReader::supportedImageFormats().contains( info.suffix().toLower().toLatin1() ) )
                {
                    dropImage( url, QImage( info.filePath() ) );
                }else  {
                    dropTextFile( url );
                }
            }
        }else  {
            QTextEdit::insertFromMimeData( source );
        }
    }
}

private:
void dropImage( const QUrl & url, const QImage & image )
{
    if ( !image.isNull() )
    {
        document()->addResource( QTextDocument::ImageResource, url, image );
        textCursor().insertImage( url.toString() );
    }
}


void dropTextFile( const QUrl & url )
{
    textCursor().insertText( file.readAll() );
}
};

现代cmake使用技巧

不要再用nmake/make了,直接使用—build/—install吧,也不需要特意定义CMAKE_BUILD_TYPE,非常方便

#编译
cmake --build . --config Debug/Release
#安装,将安装到CMAKE_INSTALL_PREFIX下,默认是安装Release配置
cmake --install . --config Debug/Release

环境变量,设定好后就是全局可用,不会因为add_subdirectory而变化,在多级的子项目时尤其好用:

set(ENV{PROJ_BASE_DIR} ${CMAKE_CURRENT_SOURCE_DIR})

带缓存的PATH变量,可让Visual Studio/CMake GUI等工具有一个可选择文件夹路径的变量,并保存在缓存中,非常方便编辑:

set(OPENCV_DIR $ENV{OPENCV_ROOT} CACHE PATH "Root path of opencv")
    if(DEFINED OPENCV_DIR)
        list(APPEND CMAKE_PREFIX_PATH ${OPENCV_DIR})
    endif()

设置exe/dll/pdb文件输出路径:

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY $ENV{PROJ_OUTPUT_DIR}/out)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY $ENV{PROJ_OUTPUT_DIR}/out)
set(CMAKE_PDB_OUTPUT_DIRECTORY $ENV{PROJ_OUTPUT_DIR}/pdbs)

使用file命令的GLOB_RECURSE,子目录下的源文件也能一并扫描出来:

file(GLOB_RECURSE SRC_CPP ${PROJECT_SOURCE_DIR} *cpp)

使用target_compile_definitions给代码定义#define,子项目的DLL和EXE区别对待,其中,PRIVATE只应用于编译本项目时有效,PUBLIC应用于全局(所有子项目共享):

#For DLL
target_compile_definitions(foo PRIVATE API_EXPORT_BUILD)
#For EXE
target_compile_definitions(bar PRIVATE API_EXPORT)

不透明结构体/对象-C/C++隐藏结构体/类成员的方法

纯C实现隐藏结构体(实现不透明结构体)的方法:

假设我们要开发一个库example.so,但又不想把某结构体的内容开放到SDK的头文件中,那么可以这样处理:

  1. 准备三个文件:example.h(SDK的头文件),example_internal.h(不开放,存放了结构体的真实定义),example.c
  2. 各文件内容如下:

example.h:

/* opaque types */
struct example_struct;
/* helper functions */
__declspec( dllexport ) struct example_struct* create_example(const int id,const float rate);
__declspec( dllexport ) const int get_example_id(struct example_struct *example);
__declspec( dllexport ) const float get_example_rate(struct example_struct *example);
__declspec( dllexport ) void free_example(struct example_struct *example);

example_internal.h:

/* The real structure */
struct example_struct {
int id;
float rate;
int hiddenInt;
float hiddenRate;
};

example.c:

#include "example.h"
#include "example_internal.h"
struct example_struct* create_example(const int id,const float rate){
    struct example_struct *example=(struct example_struct*)malloc(sizeof(struct example_struct));
    return example;
}

const int get_example_id(struct example_struct *example){
    if(!example){
        return 0;
    }
    return example->id;
}

/* Ohter helper functions ... */
3. 生成好库后,只需要把example.so和example.h打包进SDK里就可以被用来开发了

C++实现隐藏类成员的方法:

还是以example.so为例:

  1. 在头文件中定义一个不透明结构体/类,实际的内容放在实现文件中,注意:由于编译时,不能明确知道它的构造及析构函孙,因此无法使用智能指针

example.hpp

__declspec( dllexport ) class example {
public:
const int getId() const;
const float getRate() const;
private:
class exampleImpl;
//opaque pointer;
exampleImpl *m_impl;
};

example.cpp

   #include "example.hpp"
   class exampleImpl {
   public:
    int m_id;
    float m_rate;
    int m_hideId;
    float m_hideRate;
   };

   const int example::getId() const{
       return this->m_impl->m_id;
   }
   const float getRate() const{
       return this->m_impl->m_rate;
   }

Qt Model-View学习之手动更新Model数据

在使用基于QAbstractListModel的自定义Model时,遇到数据更新后Model不自动刷新数据的问题。通过手动发送更新信号即可解决。 方法,在更新数据时调用

emit beginResetModel();
emit endResetModel();

注意reset model需要成对使用。

Qt TextDocument内容组织方式

Qt的QTextEdit等控件在存储内容的时候是以QTextDocument & QTextBlock & QTextFragment组织内容的。

包含关系为QTextDocument QTextBlock QTextFragment

一般一个控件(如QTextEdit)只包含一个QTextDocument,文档对象可以很容易的保存为HTML或者ODF文件。

其中,QTextBlock是以换行符分隔的,遇到一个换行符就新建一个QTextBlock,因此,一行内容就是一个QTextBlock。

而QTextBlock中包含了一个或多个QTextFragment,这些fragment可以是文字,图片或其他多媒体元素,fragment以内容的类型区分。

例如如下内容:

[文本][图片][文本]

上面的内容生成了一个block,这个block包含了3个fragment。

而内容:

[文本]

[图片]

[文本]

则生成了3个block,因为一行内容生成一个block。

这个概念在使用网络发送图文混排的内容时尤其重要,如果不能正确理解document/block/fragment的组织方式,则会丢失原始格式。

cmake管理使用了qt的项目的正确使用方法

可将QT5_DIR(包括了bin/inclue/lib等目录的那个基础目录,不是lib/cmake)加到CMAKE_PREFIX_PATH中,防止find_package无法使用

cmake对qt moc有如下几个函数封装:

qt_wrap_ui([输出]MOC后的源文件列表 [输入]MOC前的.ui文件)

qt_wrap_cpp([输出]MOC后的源文件列表 [输入]MOC前的源文件,通常是包含了Q_OBJECT的.hpp)

qt_add_resources([输出]MOC后的源文件列表 [输入]MOC前的.qrc文件)

经过这三步后,就可以将moc后在源文件add_exectuable/add_library了

示例代码:

#让cmake能找到qt,防止find_package无法使用
list(APPEND CMAKE_PREFIX_PATH ${QT5_DIR})

#将使用Designer编辑好的.ui文件处理为C++源文件
file(GLOB UI_SRC ui/*.ui)
qt_wrap_ui(MOC_UI_SRC ${UI_SRC})

#将带有如Q_OBJECT等Meta-Object的头文件处理为moc后的C++头/源文件
file(GLOB FORM_SRC include/ui/*.hpp)
qt_wrap_cpp(MOC_FORM_SRC ${FORM_SRC})

#将Qt资源文件(*.qrc)编译为C++源文件
file(GLOB FORM_QRC ui/*.qrc)
qt_add_resources(MOC_FORM_QRC ${FORM_QRC})

#正确使用find_package
find_package(Qt5 COMPONENTS Core Widgets REQUIRED)

#处理完后的源码作为exe/lib的输入
add_exectuable(example ${MOC_UI_SRC}
${MOC_FORM_SRC}
${FORM_QRC})

#链接Qt库,该命令会自动将Qt5对应的的include目录加入至include directories
target_link_libraries(example PRIVATE Qt5::Widgets)

QTextEdit动态显示gif动画

原理:使用QMovie播放gif并更新当前帧到QTextEdit中Document的Resource。\ 相关信号:QMovie::frameChanged(int frameNo)\ 实例代码: 初始化QMovie对象:

QMovie*movie=newQMovie(this);
movie->setFileName(img_path);
movie->setCacheMode(QMovie::CacheNone);
connect(movie,SIGNAL(frameChanged(int)),this,SLOT(frameChanged(int)));
movie->start();

槽函数:

voidMyObject::frameChanged(intframeNumber)
if(frameNumber==-1)
return;

QMovie*movie=(QMovie*)this->sender();
QStringname=movie->fileName().toUtf8().toBase64();
ui->view->document()->addResource(QTextDocument::ImageResource,
name,
QVariant(movie->currentPixmap()));
ui->view->setLineWrapColumnOrWidth(ui->view->lineWrapColumnOrWidth());

关键点:

QMovie对象在播放gif动画时发送frameChanged信号至槽,此处使用QOjbect::sender()方法来得到具体的对象指针,然后调用document的addResource方法更新当前的帧到其图像资源,最后调用setLineWrapColumnOrWidth来刷新显示。这样就实现了gif图片的不断刷新。