入门用法

July 31, 2018 · View on GitHub

设置Qt Creator默认编译路径
Qt Creator
Default build directory:
/xxx/xxx/xxx/xxx/c0-buildstation 这是个你电脑上的绝对路径，根据自己把编译根放在哪里设置
/%{CurrentProject:Name}/%{CurrentKit:FileSystemName}/%{Qt:Version}/%{CurrentBuild:Name} 这里是个通配，直接拷贝上去 这是建议值，在Multi-link2.1里面，这个值不再强制。

设置Qt Creator构建套件
设置当前工程的环境变量
链接QQt
QQt内部pri的一点点设置
QQT_BUILD_ROOT = /Users/abel/Develop/c0-buildstation
QQT_SDK_ROOT = /Users/abel/Develop/d1-product
APP_DEPLOY_ROOT = /Users/abel/Develop/d1-product

设置成功显示
如果设置成功，qmake应当显示如上例程的样子

v2.1.6更新链接QQt的方法

链接QQt
QQt内部pri的设置

主要使用思路

  1. 按照文章所说，更改Qt Creator的默认编译路径。只有这样，才能实现多平台目标、中间目标不冲突。
  2. 参照LibQQt/src/qqt_qkit.pri里的SYSNAME变量，在Qt Creator首选项-设置构建和运行-构建套件Kit页面的每个kit的File System Name。（请使用Qt Creator 3.5以上版本，其被佩戴于Qt5.2.）
  3. 打开LibQQt工程，根据qmake输出，在用户配置目录/[.]qmake/app_configure.pri里面设置QQT_BUILD_ROOT QQT_SDK_ROOT APP_DEPLOY_ROOT三个路径变量
  4. 仿照LibQQt的例程，在用户工程.pro里include(.../LibQQt/multi-link/multi-link/add_base_manager.pri)
    • 如果需要跟随发布配置文件，按照图里的设置APP_CONFIG_PWD
  5. 在Qt Creator项目-kit-构建设置页面，配置QKIT环境变量（LibQQt也需要，用户App需要），可以build了。

在LibQQt/app/xxx.pri，用户可以选用，拷贝到自己工程目录。
在这个过程里面，只有QKIT环境变量跟随工程build配置，其他的仅仅初始配置一次。

Qt Kit、Kit File System Name和QKIT、SYSNAME的关系

LibQQt有复杂的环境设置，那么这些设置之间的关系是什么样子的呢？

先说说，每个value在Qt Creator中的位置

  • 首选项-构建和运行-构建套件(Kit)-Every kit (初始化)
    • File system name
  • 项目-Every kit-构建设置-构建环境 （跟随build目标）
    • QKIT
  • LibQQt/src/qqt_qkit.pri（定义之处）
    • QKIT、SYSNAME的定义。
  • 用户配置目录/[.]qmake/app_configure.pri（初始化）
    • QQT_SDK_ROOT 所有SDK的发布根位置
    • QQT_BUILD_ROOT 所有LibQQt应用的编译根位置
    • APP_DEPLOY_ROOT 所有LibQQt应用的发布根目录

再说说，他们之间的对应关系

Qt KitKit File System NameQKITSYSNAME
Windows 32bitWindowsWIN32Windows
Windows 64bitWin64WIN64Win64
Linux 32bitLinuxLINUXLinux
Linux 64bitLinux64LINUX64Linux64
macOS clang 64bitMacOSmacOSMacOS
Arm 32bitArm32ARM32Arm32
Mips 32bitMips32MIPS32Mips32
Embedded 32bitEmbeddedEMBEDDEDEmbedded
iOS clangiOSiOSiOS
iOS SimulatoriOS-simulatoriOSSimulatoriOS-simulator
Android armeabiAndroidANDROIDAndroid
Android x86Android_x86ANDROIDX86Android_x86

最后说说，他们的决定关系和由来

QKIT决定SYSNAME，SYSNAME等于Kit File System Name.
Qt Kit的名字，第一列，就是Qt Creator的构建套件。
它每一个包含一个不同的系统名叫做File System Name，它还包括不同的编译器、调试器等。
有没有感觉他们的关系很逗？明明相同的东西，写了这么多遍。
原因是这样的，
源代码-经过qmake变成-MakeFile-经过make变成-目标。
Qt Creator自己配置了Kit的很多变量，可是！没有全部传给qmake！
qmake拿不到完整的目标信息，只好自己定义一套，就是QKIT和SYSNAME，
而Qt Creator这时就必须配合qmake完成配置。
Qt Creator里的两处配置都是为了配合qmake进行配置的，
无奈之举。
等Qt Creator更新到把目标信息全部传给qmake以后，就可以删除QKIT和SYSNAME这样的设置了。

用户设置的那几个路径属于Multi-link技术，每更换一台电脑才会更换。
目的在于确认用户的开发、工具、编译、产品目录的设置，用于辅助qmake执行多link。

欢迎建筑工程师、机械工程师、电子工程师、软件工程师、美术工程师等技术人员，学习使用。

v2.2.1更新链接LibQQt的方法

磁盘上的和先前的没有变化，只不过用户在工程树里看到的app_configure.pri从app_link_qqt_library.pri里移动到了app_multi_link_config.pri里。
并且Multi-link技术主动依赖qqt_function.pri里的qmake用户自定义函数集。
图上写的比较简单，Windows下在，用户主目录\AppData\Roaming\qmake里。 app_configure.pri移动了

v2.2.2 更新LibQQt Multi-link技术

Windows平台app_configure.pri的位置 C:\Users\Administrator\AppData\qmake，
在Windows下，Qt Creator还是不会在qmake error函数以后依然加载app_configure.pri，
还是需要用户手动去打开这个文件进行编辑。
无奈之举。

app_configure.pri移动了

v2.4支持MSVC2015的一些注意事项

用Qt VS Addin或者Qt VS Tools开发即可。

有一些约束：

  • 源代码必须使用uft-8+bom的格式保存，否则Visual Studio对文本识别会出现混乱。
  • 注意包含一下qqtcore.h，里边有一个针对msvc编译器选项，使exe里文本按照utf-8编码。
  • 终端输出的时候，要用utf-8的代码页。

Visual Studio使用设置：

  • 设置环境变量
    • 我使用Multi-environ Manager工具进行设置，语法不一样，但是思路一样。
    • QTVERSION : 5.8.0
    • QTDIR : ${qt5.8.msvc}
    • BUILDTYPE : Debug
    • QKIT : WIN64
    • QSYS : Win64
    • QQT_STD_PWD : QTVERSION/{QTVERSION}/{QSYS}/${BUILDTYPE}
    • QQT_BUILD_ROOT : C:\Users\Administrator\Develop\c0-buildstation
    • QQT_SDK_ROOT : C:\Users\Administrator\Develop\d1-product
    • 路径
      • ${qt5.8.msvc.bin}
      • QQTSDKROOT/QQt/{QQT_SDK_ROOT}/QQt/{QQT_STD_PWD}/lib 可选
  • 启动Visual Studio 2015
    • cd /d "${msvc2015}""
    • start devenv.exe
    • 注意：Visual Studio 2015的启动环境为上述环境之中。
  • Visual Studio 2015设置
    • 打开QQt.pro之后，sln工程自动生成
    • 设置调试-QQt属性-配置属性-常规 输出目录由bin\改为{QQT_BUILD_ROOT}\(QQT_STD_PWD)\bin\
    • 启动生成，即可，QQt Lib和例程都可以正常生成。这个时候可以去产品输出目录点击运行。如果缺少部分QtLib，手动解决下。
    • App执行调试缺少QQt.dll，
      • 设置调试-App属性-配置属性-调试 环境 Path添加QQTSDKROOT/QQt/{QQT_SDK_ROOT}/QQt/{QQT_STD_PWD}/lib
      • 如果想影响全局App调试，上边那个可选的路径加进环境变量Path里。
      • 这样调试App就可以开始了。
  • 可以开始使用LibQQt编写自己的App了。

还修改了Windows下的app_configure.pri的磁盘保存位置，到用户主目录/.qmake/app_configure.pri，这块完全使用类Unix风格。

LibQQt v3.0

Multi-link技术完成。
在完成的Multi-link技术里，新的QSYS环境变量和Qt Kit的关系
QKIT不再使用，而仅仅使用QSYS。

Qt KitKit File System NameQKITQSYS
Windows 32bitWindows-Windows
Windows 32bitWin32-Win32
Windows 64bitWin64-Win64
Linux 32bitLinux-Linux
Linux 64bitLinux64-Linux64
macOS clang 64bitmacOS-macOS
Arm 32bitArm32-Arm32
Mips 32bitMips32-Mips32
Embedded 32bitEmbedded-Embedded
iOS clangiOS-iOS
iOS SimulatoriOSSimulator-iOSSimulator
Android armeabiAndroid-Android
Android x86AndroidX86-AndroidX86

使用场景截图

使用场景

App和Lib的源代码，一直处于编写之中。
App和Lib的目标，一直从Build位置，持续发布到Deploy位置和SDK位置。
用户再也不必为了管理生成目标、发布目标和链接而劳费手劲。
在2008年的时候还没有这个技术，2018年，这个技术终于变成了现实。
现在，按照GPL发布，
基于qmake。
Multi-link技术的能力

多链接技术创造的生产线

Multi-link会一直处于App/Lib生产线的控制器地位。
Multi-link允许用户自行添加任何依赖项，我把一些常用的依赖项添加用pri放在了app-lib里， 而这些依赖项的SDK我保存在了百度网盘，以方便用户取用，用户只需要下载下来解压到自己的LIB_SDK_ROOT里。
百度网盘地址链接：https://pan.baidu.com/s/1FPPkTUnk2XBL4rpnZsAGmw 密码：hotz
SDK难免有不全，难免不能满足任何用户的需求，请用户自行补齐。 利用Multi-link技术的添加Library模板很容易的。 我计划在LibQQt 3.0的时机将Multi-link合并到master分支进行正式发布。
Multi-link技术的能力

多链接技术的一点设置

Multilink的一点点设置
APP_DEPLOY_ROOT=R:\Develop\d0-product
LIB_SDK_ROOT=R:\Develop\d1-sdk
APP_BUILD_ROOT=R:\Develop\c0-buildstation
Multi-link目录里提供了Multi-linkConfigTool图形配置工具，编译运行就可以设置，非常方便。
在工程里包含multi-link/add_base_manager.pri，在project build config设置环境变量QSYS，就可以使用里面的丰富函数。简单吧！
注意：Multi-link 2 已经不支持Qt4，如果需要Qt第四代，那么使用multi-link 1.0链接QQt。
注意：Multi-link 2 APP_BUILD_ROOT变成了optional，但是依然需要设置一下，以免还有需要的地方。build root是一切开始的地方。
qmake成功
qmake成功

Enjoy it!

返回