跳转至

2026

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)

FreeBSD作为VirtualBox虚拟机时鼠标滚轮有问题时的处理方法

1、屏蔽掉按键8的mapping(不同人可能按键不一样)

先查看mapping(0表示屏蔽):

xmodmap -pp
There are 12 pointer buttons defined.

    Physical        Button
     Button          Code
        1              1
        2              2
        3              3
        4              4
        5              5
        6              6
        7              7
        8              0
        9              9
       10             10
       11             11
       12             12

例子中有12个按键

使用以下代码屏蔽掉按键8

xmodmap -e "pointer = 1 2 3 4 5 6 7 0 9 10 11 12"

然后再开启一个pcmanfm之类的窗口测试滚动,如果不行,换别的按键

测试成功后,将以下内容保存至~/.xmodmap

pointer = 1 2 3 4 5 6 7 0 9 10 11 12

更新.profile,加入xmodmap命令,确保每次登陆时,都会执行该动作

/usr/local/bin/xmodmap -e "pointer = 1 2 3 4 5 6 7 0 0 0 11 12"

2、Firefox滚动有问题的处理方法

输入about:config,查找mousebutton,找到mousebutton.4th.enabled,双击改为false即可

3、使用xinput和xev调整按键mapping

先通过xinput list找到对应鼠标的device Id

然后使用xinput get-button-map [devide_id]取到对应设备的mapping(0表示屏蔽),如:

1 2 3 4 5 6 7 8 9 10 11 12

使用xev打开一个窗口,在该窗口点击鼠标各按键,确认所需按键

使用xinput set-button-map [device id] [按键mapping]设置mapping,如:

xinput set-button-map 7 1 2 3 4 5 0 0 0 0 0 0 0

该操作可加入至.profile中以免下次登陆失效

4、终级方式,禁用Host/Guest鼠标平滑切换(禁用后,需使用Right Ctrl切换鼠标)

使用xinput list查看设备,找到nonamed或virtualbox相关的设备

通过xinput get-button-map [device id]查看mapping,确认为如下mapping:

1 0

使用xinput disable [device id]将该设备禁用即可

Glad使用总结

和传统的GLEW不同,GLAD类似springboot starter,是一个开源的按需生成OpenGL函数Loader的WEB服务,GLAD2的官方地址为https://gen.glad.sh/,GLAD1的生成地址是https://glad.dav1d.de/,二者的API差异很大,本文以GLAD2的使用为例

使用WEB服务生成代码:

进入GLAD2的WEB页面后,可按Generator(编程语言),OpenGL各API版本,如OpenGL, OpenGL ES, GLX,WGL等,选了API版本后,Extensions可按需选择,或使用ADD ALL一键加入所有扩展(推荐)

Options中有几个重要选项:

alias - 默认情况下,glad的OpenGL函数带glad_前缀,例如glEnable,需使用glad_glEnable,选中这个选项后,可直接使用glEnable,不需要带前缀

loader - 生成gladLoadXXX()这种不带参数的loader,如果不选,则需使用自己传入如glfwgetprocaddress这样的load function的版本,尤其是WGL,有大坑,这个选项非常推荐选上

点击generate后,会进入一个页面,包含include,src和glad.zip(下载后加入到项目中的代码),官方推荐的使用方式是将其中的*.h,*.c文件直接加入到自己项目中的源代码中,比如在add_execution/add_library时,如果需要编译成so/dll这样的动态链接库,需有以下几点要注意:

编译成动态链接库时,glad需定义GLAD_API_CALL_EXPORT_BUILD,否则不会导出函数,可使用target_add_definitions在CMakeLists.txt加入

使用glad动态链接库的程序,需定义GLAD_API_CALL_EXPORT,否则会链接失败,另外#include <glad/gl.h>需放在所有其它有#include <gl.h>之类包含了OpenGL的头文件之前的位置,否则会编译失败

动态链接时,程序中所有模块只需调用一次loader即可初始化OpenGL函数地址,可通过判断glad_glEnable函数指针是否为nullptr来判断是否需调用loader,WGL可通过判断相应的glad_wglXXX是否为nullptr来按需调用loader

如何将一个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();

```

Kate编辑器如何格式化markdown文件

背景

由于Kate自带的format插件不支持markdown,而format插件又不能通过配置的方式加入markdown支持,因此,需通过“外部工具”的方式实现需求

所需工具

Prettier,需用npm安装

npm install -g prettier

配置方法

"工具"->"外部工具"->"配置",新增一个外部工具,分类可自行定义,个人是将它放在“格式化”分类中

  • 名称:格式化Markdown
  • 可执行文件:prettier或其完整路径
  • 使用文件路径方式避免中文乱码参数:--write %{Document:FilePath}
  • 输入:留空即可
  • 工作目录:留空即可
  • MIME类型:text/markdown
  • 保存:无
  • 保存时自动格式化触发器:保存后
  • 重要钩选“执行后重新加载当前文档”
  • 输出:忽略
  • 编辑器命令:留空即可

WSL环境下,编译llama.cpp+CUDA,在老Nvidia显卡下实现CUDA加速

硬件环境

  • 硬件情况
硬件类型 说明
CPU Intel Core i5-8300H @ 2.30G Hz
GPU Nvidia Quadro P600, 4G显存
内存 16G
  • Host系统:Windows 10 22H2 专业版
  • WSL系统:CentOS 10 Stream x86_64
  • CUDA版本:12.4

软件环境

  • WSL中,运行nvidia-smi必须能正常显示出显卡信息
  • 由于CentOS 10自带的是gcc 14,而CUDA 12.4最高仅支持到gcc 13,因此我从官方网下载载了13.5.0版本的gcc源码手动编译安装到/usr/local/gcc-13,并将/bin/gcc和/bin/g++替换为/usr/local/gcc-13/bin下的软链接,否则cuda 12无法正常安装
  • cuda 12.4下载下来是单个很大的run文件,直接运行时,在解压/环境检测的过程中遇到问题导致卡住,实际使用./cuda_12.4.1_550.54.15_linux.run --tar mxvf手动解压缩到一个目录后,运行里面的cuda-installer进行安装

编译过程

  • 解压好源码后,先不着急编译,先从https://github.com/ggml-org/llama.cpp/releases下载官方预先生成的UI文件,解压到源码目录下的tools/ui内,并重命名为dist,否则编译时,由于无法直接从hf下载UI文件会导致无WEB UI
  • 编译Rlease版本文件命令如下:
cmake -B build -DGGML_CUDA=ON -DCMAKE_INSTALL_PREFIX=/usr/local/llama.cpp -DCMAKE_BUILD_TYPE=Release
  • 经过漫长的等待后,安装好编译后的文件:
sudo cmake --install build

运行&验证

  • 由于llama.cpp的二进制文件依赖自己的lib,因此需要将安装路径下的lib64目录加入至LD_LIBRARY_PATH(或运行时设置也可以):
export LD_LIBRARY_PATH=/usr/local/llama.cpp/lib64
  • 运行以下命令验证是否取到了可用的CUDA役备:
LD_LIBRARY_PATH=/usr/local/llama.cpp/lib64 /usr/local/llama.cpp/bin/llama-server --list-devices

这里输出,表示取到了可用于CUDA运行的设备:

Available devices:
  CUDA0: Quadro P600 (4095 MiB, 3374 MiB free)
  • 实际运行时,推荐用models-dir的方式运行,并针对模型提供量化参数(不同类型模型不一样,我这里用的QWen系):
LD_LIBRARY_PATH=/usr/local/llama.cpp/lib64 /usr/local/llama.cpp/bin/llama-server --models-dir /home/llama/models --host 0.0.0.0 --port 11434 --no-models-autoload -ngl 999 --jinja --api-key 12345678 --ctx-size 32768 -ctk q8_0 -ctv q8_0 --tools all

Tips

关于Vulkan

  • 官方编译的版本就能很好的支持Vulkan设备,如果需要自己编译,需安装好对应的依赖:
sudo dnf install git cmake gcc-c++ vulkan-devel glslc glslang
  • 安装好后,运行以下命令确认vulkan环境是否达到llama.cpp要求(apiVersion需要大于等于1.2):
vulkaninfo|grep apiVersion
  • 编译时,用GGML_VULKAN=ON开启vulkan:
cmake -B build -DGGML_VULKAN=ON -DCMAKE_INSTALL_PREFIX=/usr/local/llama.cpp

内置工具

可以使用--tools all启用内部工具,在自带的WEB UI中进行文件读写等功能

模型目录

使用--no-models-autoload参数时,是不会自动载入model的,需要手动调一下接口(WEB UI也能操作),写了个小脚本(BAT)

set "model_name=qwen2.5-coder-1.5b-instruct-q4_k_m"
if not "%~1"=="" set model_name=%~1"

curl -X POST http://127.0.0.1:11434/models/load -H "Content-Type: application/json" -H "Authorization: Bearer 12345678" -d "{\"model\": \"%model_name%\"}"

设置共享链接库路径,简化启动命令

将/usr/local/llama.cpp/lib64加入至ldconfig中,以后就不用每次指定LD_LIBRARY_PATH了

# 创建配置文件并写入路径
echo "/usr/local/llama.cpp/lib64“ | sudo tee /etc/ld.so.conf.d/llama.cpp.conf
# 更新动态链接库缓存
sudo ldconfig