8 Star 18 Fork 15

LibQQt应用程序开发组织 / Multi-link Technology (for qmake)

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

Multi-link Technology

项目介绍

为应用程序和链接库工程开发的,实现链接、发布依赖Library,发布SDK,发布应用,发布语言、配置等工程管理功能的多链接技术。
Multi-link技术使用众多的pri进行函数定义,提供给用户丰富的App/Lib生产线操作函数,省却手动拷贝App、Lib、依赖令手痛的问题。
我编写的Multi-link技术使用内置支持Library的方式支持众多的Library,方便共享对Library的支持,并且方便准确及时地同步到工程中进行使用,基本上编写一次,便不必再修改。
用户有使用方便的Library可以给我发邮件,tianduanrui@163.com.把add_library_XXX.pri发给我。我会把它提交到Multi-link工程里。
Multi-link技术位于全自动化构建技术的最关键的位置,即源代码工程全自动化构建、生产。

功能清单

  1. 跨windows、macOS、linux(笔者使用ubuntu kylin x64)三个平台,功能已经全面完成。
  2. 这些功能,就是在qmake阶段设置好所有的用户过去需要手动做的工作,通过QMAKE_POST_LINK自动完成。
  3. add_function.pri add_project.pri里面提供了丰富的基本功能,用户可以用其扩展技术外功能。
  4. add_deploy() 发布app到app发布目录 用于app工程。
  5. add_sdk() 发布sdk到sdk目录 用于library工程。
  6. add_dependent_manager() 为工程添加依赖的SDK,它会到SDK目录查找具体的SDK,输入参数,sdk包名,sdk包内子模块名。比如:Qt, Widgets.这里吆告诉读者,把Qt SDK放到SDK目录里也有效果。通常这一个函数链接库的SDK就够用了,里面包含了add_include() 包含头文件路径 add_library() 链接库 add_defines() 添加library的宏定义 add_deploy_library() 把库跟随app发布到app发布目录。
  7. add_deploy_config() 将指定路径的配置文件发布到build路径和product发布路径。
  8. add_icons() 为应用程序添加logo,尤其windows和macOS下。
  9. add_language() 为应用程序添加翻译文件,自动添加翻译文件,用户只需要找到文件翻译下就可以了。
  10. add_version() 为应用程序添加版本信息。

提供的工具

经过发布的App直接点击就可以运行,*大的省去了用户手动发布App的劳烦过程。
Multi-link提供ProductExecTool,可以对产品集中查看、调用运行。
Multi-link提供AddLibraryTool,方便用户通过准备好的SDK自动生成add_library_xxx.pri链接环。
Multi-link提供AddLibraryTool-Multiple,可以同时对多套SDK进行生成链接环。
Multi-link提供Multi-linkConfigTool,方便用户配置Multi-link v2必需的三大路径,build/sdk/deploy root。
Multi-link提供SdkListTool,方便用户查看已经准备好的SDK在各个平台准备情况的表格。

软件架构

多链接技术的工程结构.xlsx
由于Qt第四代编译比较困难,Qt4内置的qmake版本2.01a版本太低,对函数的支持不足,对嵌套函数的支持也不足,
所以,Multi-link2.0不支持Qt4。
Multi-link1.0绑定QQt,也不会继续开发与QQt脱离的纯粹使用pri的版本,Qt4 qmake版本太低,不便于开发。

安装教程

  1. Windows平台,拷贝extra里的md5.exe和touch.exe到C:\Windows里
    • 如果用户自备有touch.exe也可以。
  2. 在用户主目录/.qmake/app_configure.pri里面配置三个变量(Only Once)
    • LIB_SDK_ROOT = /home/abel/Develop/b1-sdk
    • APP_BUILD_ROOT = /home/abel/Develop/c0-buildstation
    • APP_DEPLOY_ROOT = /home/abel/Develop/b0-product
    • 可以编译运行Multi-linkConfigTool,实现一次图形化的配置,配置好了还会兼容Multi-link 1.0.
    • 配置一次就可以了,Multi-link提供的其他工具就都可以用了。
  3. 在project build configure页面配置构建环境变量,QSYS=Windows等指示平台变量(参见add_platform.pri)。
    • 这个是每次每个build都需要配置的,这个有Qt Creator的开发历史原因。

使用说明

  1. 一个可以拷贝multi-link到自己工程目录,
    • 一个可以clone multi-link到公共位置
    • 一个可以clone multi-link到工程目录作为submodule。这个是推荐方式,我对链接库们的支持容易使用到自己的工程里,我一般使用这个方式。
  2. include (.../multi-link/add_base_manager.pri)
  3. add_version() add_deploy() add_dependent_manager(QQt) add_dependent_manager(XXXLib) ...
  4. 如果希望添加自定义模块,如果希望添加自己使用的其他的app-lib没支持的库,
    • 那么从multi-link/app-lib里拷贝add_custom_manager.pri到工程目录(optional,Multi-link 1.0)。
    • 使用AddLibraryTool写自定义的add_library_XXX.pri(Multi-link 2.0),然后拷贝这个pri到工程目录,或者到Multi-link的app-lib目录,使用add_custom_dependent_manager(XXX)/add_dependent_manager(XXX)调用.
  5. 如果用户库工程的源代码里没有global.h文件,multi-link可以提供支持。
    • 编译库时,没有global文件。
      • 在库工程的header.pri里,defines函数里添加DEFINES+=TEMPLATESHARED_EXPORT=Q_DECL_EXPORT
      • 在static defines函数里添加DEFINES+=TEMPLATESHARED_EXPORT=
      • 这样,没有global.h,也可以为源代码提供符号导出宏,并且能够任意在动态、静态之间转换。
    • 链接库时,add_defines_Template 还有一个作用。
      • add_defines_Template 添加 contains(DEFINES, TEMPLATE_LIBRARY):DEFINES+=TEMPLATESHARED_EXPORT=Q_DECL_EXPORT
      • add_defines_Template 添加 else:contains(DEFINES, TEMPLATE_STATIC_LIBRARY):DEFINES+=TEMPLATESHARED_EXPORT=
      • add_defines_Template 添加 else:!contains(DEFINES, TEMPLATE_LIBRARY):DEFINES+=TEMPLATESHARED_EXPORT=Q_DECL_IMPORT
      • 这样便可以兼容没有global文件的库工程的动态、静态链接
    • unix,全部定义为空即可。
    • 这个步骤太麻烦,我提供一个函数,输入动态宏、静态宏、API宏,API宏在代码里就可以用了。
      • 编译环,全局用、add_defines里用都可以,影响较大。
      • 链接环,建议不全局用,影响较大,建议add_defines里用。
  6. 用户在使用Multi-link编译、链接库的时候,应该注意到Multi-link提供了编译环和链接环
    • 编译环,libname_header.pri
    • 链接环,add_library_libname.pri
    • 这两个环,第一个环,受到LIB_LIBRARY LIB_STATIC_LIBRARY控制动态、静态编译。
    • 第二个环,库的动态、静态链接受到专用宏的控制。
  7. Multi-link管理库工程的动态、静态编译要点
    • 编译时
      • 可以强制动态、静态工程切换
      • 动态宏为主、为默认,分布在工程各处,静态宏主要在header.pri里,有所体现。
    • 链接时
      • 链接环的配置和链接库的header.pri大同小异。
      • 静态链接只是提供静态头,动态链接几乎提供动态链接宏控制主体,可复用到静态链接过程。

详细使用说明

使用截图

屏幕截图

约束

  1. 源代码目录里multi-link目录有必要和代码目录平级。不应当把multi-link文件夹放到src目录里。
  2. macOS下,一切被依赖的Library不可以和依赖者App或者Library共同编译。免于触发first-time bug。
    • 已经修复。修改了搬运软件的时机。
  3. macOS下,工程的CONFIG,从+lib_bundle变化到-lib_bundle,需要手动删除工程编译目录里的所有framework。
    • cp命令的行为,我至今不明确。

总结

看起来挺巨大的?工程量的确不小。
初学者注意看:

  1. 第一次使用,拿到Multi-link技术的仓库,使用Multi-link.pro编译Multi-linkConfigTool。
    • 配置三个主要路径,BUILDROOT是optional,SDKROOT、PRODUCTROOT是必要配置。
    • 在这台电脑上,Multi-link Technology(qmake)开始正常使用。
  2. 顺便配置好Qt Creator吧,这两步只需要配置一次,这一步还是optional,配置下比较美观,反正就一次。
    • 菜单栏-工具-选项-构建和运行
      • 概要,设置你喜欢的,我建议的默认编译路径。
      • 构建套件,对每个Kit设置你喜欢,我建议的File system name。SDK路径、Deploy路径下面,肯定是使用我的建议的File system name。
    • 项目-Build&Run-构建设置
      • Multi-link可以自动判定多个目标环境。
      • 不常用环境无法预测,在这里设置,QSYS=目标环境名称

初学者,可以拿依赖Multi-link技术的LIB工程和APP工程。

  1. 用Qt Creator打开工程.pro。
    • 选择几个目标configure project。(.pro.user)。这是最开始。
    • 左侧菜单-项目-Build&Run-Build-构建设置-构建环境-详情
      • 批量编辑,添加QSYS=Windows/macOS/Linux64/Android/Armhf32/iOS等选一,targetName就是上边我建议的File system name,在add_platform.pri里边能找到。
  2. 用Qt Creator编译源代码工程
    • 工程树-工程名-鼠标右键
      • 执行qmake。 =qmake
      • 构建。 =make
    • 到SDK仓,产品库看看吧,有产品了。
      • SDKListTool,可以帮助查看SDK仓。
      • ProductExecTool,可以帮助运行产品库里的软件。
  3. 用Qt Creator编辑源代码工程
    • 这个没什么可说的,按照常规使用Qt Creator编辑源代码的习惯编辑即可。
    • 切记,使用Multi-link技术,只要使用其提供的qmake函数,千万不要去手动触碰SDK,甚至App。这是Multi-link技术的初衷。

联系我

邮箱: tianduarnui@163.com
QQ: 2657635903

空文件

简介

为应用程序和链接库工程开发的,实现链接、发布依赖Library,发布SDK,发布应用,发布语言、配置等工程管理功能的多链接技术,使用qmake开发。致力于全自动构建的工程管理器。 展开 收起
取消

贡献者

全部

近期动态

加载更多
不能加载更多了
C/C++
1
https://gitee.com/drabel/multi-link.git
git@gitee.com:drabel/multi-link.git
drabel
multi-link
Multi-link Technology (for qmake)
master

搜索帮助

14c37bed 8189591 565d56ea 8189591