Multi-link Technology (for qmake): 为应用程序和链接库工程开发的,实现链接、发布依赖Library,发布SDK,发布应用,发布语言、配置等工程管理功能的多链接技术,使用qmake开发。致力于全自动构建的工程管理器。

代码拉取完成,页面将自动刷新

扫描微信二维码支付

取消

支付完成

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

9 Star 18 Fork 15

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

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

新建文件新建 Diagram 文件

新建子模块

上传文件

分支 4

标签 3

贡献代码

同步代码

创建 Pull Request

了解更多

对比差异通过 Pull Request 同步

同步更新到分支

通过 Pull Request 同步

将会在向当前分支创建一个 Pull
Request,合入后将完成同步

T.D.R. 支持添加QThread文件类,On Windows 1542022

353 次提交

app-lib

demo/qqtliveplayer

examples

extra

licence

multi-link

screenshot

test

tool

.gitignore

Multi-link.pro

Multi-linkExample.pro

Multi-linkFunctionList.xlsx

Multi-linkTemplate.pro

Multi-linkTest.pro

Multi-linkTool.pro

README.md

add_base_manager.pri

changelog.md

licence.md

screenshot.md

usage.md

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() 为应用程序添加翻译文件,自动添加翻译文件,用户只需要找到文件翻译下就可以了。
1. 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](Multi-linkFunctionList.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也可以。
1. 在用户主目录/.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提供的其他工具就都可以用了。 
2. 在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) 
4. add_version() add_deploy() add_dependent_manager(QQt) add_dependent_manager(XXXLib) ...
5. 如果希望添加自定义模块,如果希望添加自己使用的其他的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)调用. 
3. 如果用户库工程的源代码里没有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大同小异。
 - 静态链接只是提供静态头,动态链接几乎提供动态链接宏控制主体,可复用到静态链接过程。

[详细使用说明](usage.md)

## 使用截图

[屏幕截图](screenshot.md)

## 约束

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

# Multi-link技术使用协议 1. 用户必须基于其开发App才能发布。 2. 用户有必要去Qt官网注册账号。 3. Multi-link制作目的,控制Application Framework层,使App能够简便的使用上所有的这个层次的Library。 4. 所谓的拷贝根本不是拷贝,而是使用新的存储位。 5. 我开发的APP交易规则:按照换取相同能量消耗当量的产品所需要的货币数量进行收费。 7. 为人工作进行收费。 6. 农民种植作物、生产粮食劳动消耗能量最大,价值最高。使用Multi-link,代表权力人接受以上规定。 [返回](.)