浅谈 qmake 之 shadow build

shadow build

shadow build 是什么东西？就是将源码路径和构建路径分开（也就是生成的makefile文件和其他产物都不放到源码路径），以此来保证源码路径的清洁。

这不是qmake独创的东西，cmake中早就使用这个东西了

cmake

qmake

备注

in-source

cmake .

qmake project.pro

在源码路径下执行

out-of-source
(shadow-build)

mkdir build

cd build
cmake ../project

mkdir build

cd build
qmake ../project/project.pro

创建目录，在其他路径下执行(参数指向源码路径)

注意:
qmake 的shadow build还是很不完善，与cmake尚不可同日而语
qmake 的shadow build目录不可以是源码目录的子目录

之前

在shadow-build之前，为了将生成物和源码尽可能的分开，我们一般都会设置很多qmake的变量，比如：

DESTDIR = $$PWD/bin	目标文件放置位置
DLLDESTDIR = $$`[QT_INSTALL_BINS]`	win下拷贝动态库到qt安装路径
MOC_DIR = $$PWD/temp	moc的产物放置何处
RCC_DIR = $$PWD/temp	rcc的产物放置何处
UI_DIR = $$PWD/temp	uic的产物放置何处
OBJECTS_DIR = PWD/temp/ TARGET	编译器生成的.o（.obj）等文件放置

这样一来，我们将Qt的扩展部分(moc/rcc/uic)以及编译器的中间产物都放置到了一个 temp 子目录中。源码还算比较清洁，可是和out-of-source比较的话，还是不太爽:

生成的 makefile 依然在源码路径下
如果一套源码要分别用msvc2008、msvc2008、mingw分别编译又不互相干扰呢？

创建一个构建目录，然后在该目录下调用合适的qmake，并指向源码下的工程文件即可

qmake ../project-sources/project.pro

本人的一个例子：

假设项目存于huang/下面叫xxx

shadow目录与huang位于同一级叫huangbuild

我们想在huangbuild下建立xxx-Debug与xxx-Release用来标示是xxx的debug与release

我们需要进入huangbuild目录下，如果是debug就进debug目录下，这个时qmake ../../huang/xxx.pro

release与此类似

有用的变量

前面提到的了，qmake的shadow-build功能尚不完善

PWD	使用该变量的文件(.pro 或 .pri)所在目录，注意对比下一个
`_PRO_FILE_PWD_`	pro文件所在目录(注意：即使它用在pri文件内，也是指代的包含它的pro文件所在的目录)
`_PRO_FILE_`	pro文件的全路径
OUT_PWD	生成的makefile文件所在路径，和`_PRO_FILE_PWD_`对应

当不使用shadow build构建时，OUT_PWD 和 _PRO_FILE_PWD_ 是相同的，据此，我们可以判断采用了何种构建方式，进而采用不同的动作：

!contains(_PRO_FILE_PWD_, $${OUT_PWD}) {

#do something when using shadow build

}

#直接使用equals更好一些，但是manual对此没有任何说明(所以我不清楚你的qmake对此是否支持，至少Qt4.5以后都是支持的)

!equals(_PRO_FILE_PWD_, OUT_PWD) {

#do something when using shadow build

}

比如说，采用out-of-source构建时，我们可能需要将一些文件从源码目录拷贝到构建目录下，用cmake时，这个很容易做到，但在qmake下，似乎缺少通用的方式，一个简单的demo如下：

注意：所有要拷贝的文件只能用相对路径指定(你可以帮着改进一下，我没找到合适的函数)
这段代码需要放到pro文件内，或者同目录的pri文件内

FILES_COPY_SRC = $$SOURCES /

                 dbzhang800.txt /

                 images/abc.png /

                 i18n/abcd.qm

win32{

    COPY = copy /y

    MKDIR = mkdir

}else{

    COPY = cp

    MKDIR = mkdir -p

}

!equals(_PRO_FILE_PWD_, OUT_PWD) {

    for(f, FILES_COPY_SRC){

        dist_file = $$OUT_PWD/$$f

        dist = $$dirname(dist_file)

        win32:dist = $$replace(dist, /, //)

        !exists($$dist):system($$MKDIR $$dist)

        !exists($$dist_file):system($$COPY $$f $$dist)

    }

}

还是写一点解释吧，可能对大家有帮助，也防止自己时间长了会忘记。

windows下，必须先将路径分割符由“/”替换成 “/”
目标目录不存在，创建目录。
目标文件不存在，拷贝文件。

本人的一些操作，