LibQQt/usage.md

# 入门用法

![设置Qt Creator默认编译路径](screenshot/1.png "这是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构建套件](screenshot/2.png "这是Qt Creator的设置，设置File System Name")  
![设置当前工程的环境变量](screenshot/3.png "这是工程的环境变量设置，注意那几点")  
![链接QQt](screenshot/4.png "这是链接QQt的方法，pri都在LibQQt目录里")  
![QQt内部pri的一点点设置](screenshot/5.png "这是LibQQt需要设置的几个路径，编译路径，Sdk路径，发布路径")  
QQT_BUILD_ROOT = /Users/abel/Develop/c0-buildstation  
QQT_SDK_ROOT = /Users/abel/Develop/d1-product  
APP_DEPLOY_ROOT = /Users/abel/Develop/d1-product  

![设置成功显示](screenshot/6.png)  
如果设置成功，qmake应当显示如上例程的样子  

# v2.1.6更新链接QQt的方法  

![链接QQt](screenshot/7.png "这是链接QQt的方法，pri都在LibQQt目录里")  
![QQt内部pri的设置](screenshot/8.png "这是LibQQt需要设置的几个路径，这是新的版本，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 Kit | Kit File System Name | QKIT | SYSNAME |   
| ---- | ---- | :---- | :---- |  
| Windows 32bit | Windows | WIN32 | Windows |  
| Windows 64bit | Win64 | WIN64 | Win64 |  
| Linux 32bit | Linux | LINUX | Linux |  
| Linux 64bit | Linux64 | LINUX64 | Linux64 |  
| macOS clang 64bit | MacOS | macOS | MacOS |  
| Arm 32bit | Arm32 | ARM32 | Arm32 |  
| Mips 32bit | Mips32 | MIPS32 | Mips32 |  
| Embedded 32bit | Embedded | EMBEDDED | Embedded |  
| iOS clang | iOS | iOS | iOS |  
| iOS Simulator |iOS-simulator | iOSSimulator | iOS-simulator |  
| Android armeabi |Android | ANDROID |Android |  
| Android x86 |Android_x86 | ANDROIDX86 |Android_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移动了](screenshot/9.png "这是LibQQt需要设置的几个路径，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移动了](screenshot/10.png "这是LibQQt需要设置的几个路径，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}/${QSYS}/${BUILDTYPE}  
    - QQT_BUILD_ROOT : C:\Users\Administrator\Develop\c0-buildstation
    - QQT_SDK_ROOT : C:\Users\Administrator\Develop\d1-product
    - 路径
        - ${qt5.8.msvc.bin}  
        - ${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添加${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 Kit | Kit File System Name | QKIT | QSYS |   
| ---- | ---- | :---- | :---- |  
| Windows 32bit | Windows | - | Windows |  
| Windows 32bit | Win32 | - | Win32 |  
| Windows 64bit | Win64 | - | Win64 |  
| Linux 32bit | Linux | - | Linux |  
| Linux 64bit | Linux64 | - | Linux64 |  
| macOS clang 64bit | macOS | - | macOS |  
| Arm 32bit | Arm32 | - | Arm32 |  
| Mips 32bit | Mips32 | - | Mips32 |  
| Embedded 32bit | Embedded | - | Embedded |  
| iOS clang | iOS | - | iOS |  
| iOS Simulator |iOSSimulator | - | iOSSimulator |  
| Android armeabi |Android | - |Android |  
| Android x86 |AndroidX86 | - |AndroidX86 |  

####使用场景截图  

![使用场景](screenshot/11.png "这是Multi-link技术的使用方式截图")  

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

![Multi-link技术的能力](screenshot/12.png "这是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技术的能力](screenshot/13.png "这是Multi-link技术的能力")  


####多链接技术的一点设置  
![Multilink的一点点设置](screenshot/14.png "这是LibQQt使用的Multi-link需要设置的几个路径，编译路径，Sdk路径，发布路径")  
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成功](screenshot/15.png "这是LibQQt qmake成功的样子。")  
![qmake成功](screenshot/16.png "这是Example app qmake成功的样子。")  

Enjoy it!  


[返回](.)