跳转至

编程

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() );
}
};

Java Runtime.exec取stderr阻塞的解决办法

原因:

Because some native platforms only provide limited buffer size for standard input and output streams, failure to promptly write the input stream or read the output stream of the subprocess may cause the subprocess to block, and even deadlock.\ 翻译:\ 一些平台只为标准输入输出提供有限的缓存。错误的写子进程的输入流或者错误的都子进程的输出流都有可能造成子进程的阻塞,甚至是死锁。

解决方法:

把读取stderr及stdout的操用放到单独的线程中,示例代码:

```java

Process process = Runtime.getRuntime().exec(this.command, envs); //System.out.println("-------------------------------------"); BufferedReader ebr = new BufferedReader(new InputStreamReader(process.getErrorStream())); Thread eThread = new Thread(() -> try String eline; while (null != (eline = ebr.readLine())) System.out.println("[Error]" + eline);

ebr.close(); catch (Exception e) e.printStackTrace();

); eThread.start(); //System.out.println("-------------------------------------"); BufferedReader br = new BufferedReader(new InputStreamReader(process.getInputStream())); Thread oThread = new Thread(() -> try String line; while (null != (line = br.readLine())) System.out.println(line);

br.close(); br.close(); catch (Exception e) e.printStackTrace();

); oThread.start(); process.waitFor();

```

现代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)