Dirs文件和Sources文件

转载于：http://blog.csdn.net/Kroosafe/archive/2008/12/11/3495679.aspx
感谢作者！

1. Dirs文件

关于Dirs文件，就是指定要编译的路径，这个地球人都知道。还是简单介绍一下。按照文档上面介绍有三种定义：DIRS，DIRS_CE和OPTIONAL_DIRS。

DIRS：就是指定要编译的目录。
DIRS_CE：只有目录下的源代码用于WinCE的映像文件时，才编译该目录。
OPTIONAL_DIRS：指定可以选择编译的目录。比如：OPTIONAL_DIRS=proj1，如果想编译proj1目录，可以设置BUILD_OPTIONS=proj1，然后运行build命令就可以了。
举个例子：

DIRS= common \
            drivers \
            oal \
            bootloader
表示需要编译common，drivers，oal和bootloader目录。

DIRS=*
表示编译当前的所有目录。

2. Sources文件

在WinCE BSP中会看到很多sources文件，一般会和源代码放在同一个目录，当然不是绝对的。这些sources文件里面就是定义了一些宏，主要用于告诉 Build.exe在编译源代码的时候应该如何编译和链接，告诉Nmake.exe如何编译源代码以及最后生成什么类型的文件。
下面具体介绍一下：
TARGETNAME：最后编译完后生成的目标文件的名字，不包括扩展名。

TARGETTYPE：生成的文件的类型。具体值如下：
        LIBRARY，一个.lib文件
        DYNLINK，一个.dll文件
        PROGRAM，一个.exe文件
RELEASETYPE：该宏设置两个环境变量RELEASEDIR和RELEASELIBDIR，就是设置编译后生成文件存放的路径。具体值如下：
        PLATFORM，生成的文件在PLATFORM\<BSP NAME>\<Target>
        LOCAL，生成的文件在当前路径下
        CUSTOM，生成的文件在TARGETPATH指定的位置
        MANAGED，生成的文件在%_PROJECTROOT%\OAK\<Target>\Managed
        OAK, SDK, DDK，生成的文件在%_PROJECTROOT%\Oak\<Target>

TARGETPATH：当上面的RELEASETYPE=CUSTOM的时候，该宏指定路径
SOURCELIBS ：静态链接。函数的实体被链接过来，生成一份拷贝
TARGETLIBS ：动态链接。函数的地址被链接过来，系统执行时会加载该库
INCLUDES：指定额外的要搜索的头文件的路径
SOURCES：指定要被编译的文件
ADEFINES：指定汇编器要使用的参数
CDEFINES：指定编译器要使用的参数，指定传递给逼啊一起的DEFINE开关内容，用户之指定

的内容会追加到makefile.def中指定内容的结尾。
LDEFINES：指定连接器要使用的参数
RDEFINES：指定资源编译器Rc.exe的参数

DEFFILE ：指定DLL的导出名，默认为空（请教：导出名和最终生成的.DLL文件名有什么区别？）[不知道。。。。]

DLLBASE ：如果要生成DLL文件，可以用此宏来指定DLL加载的及地址
DLLENTRY ：指定dll的入口函数
EXEBASE ：指定生成EXE文件加载的及地址，默认为0x00010000
EXEENTRY：指定EXE行文件的入口函数

COPYRES ：如果设置了此变量，则会吧资源文件复制到release目录

RESFILE ：如果指定了COPYRES宏，则可通过RESFILE宏指定.res文件的名字

LDEFSTACK：指定程序中为栈保留的空间的大小，默认为64KB

WINCECOD：编译后生成一个.cod的汇编文件，用于查看汇编代码调试
WINCECPU ：用于说明为指定的CPU编译，这样被编译出来的目标文件会被放在_TGTCPU环境

变量所指定的子目录下面，一般该宏在sources.cmn中定义。
WINCEMAP：编译后生成一个.map文件，用于调试（是否生成MAP文件，默认为1）
WINCEOEM：设置该值表示需要使用WinCE下的一些公用的库和头文件，该值一般在BSP中

的sources.cmn 中定义。

PRECOMPILED_CXX：是否对C++文件使用与编译，构建系统默认对C程序预编译，如果代码是用C++

写的，并且希望预编译，则须指定此项

PRECOMPILED_INCLUDE: 指定预编译头文件名字

PRECOMPILED_OBJ：预编译头文件生成的obj文件

PRECOMPLIED_PCH：指定预编译生成的pch文件的名字

PRECOMPLIED_TAARGET：与PRECOMPILED_OBJ等效

PREPROCESSDEFFILE: 如果DEF里面有条件编译须预处理，则须把此宏设置为1

SKIPBUILD ：不做实际的build操作，直接返回成功(如果此宏设置为1，则对当前目录的

构建被跳过)。
WINCETARGETFILE0：用于告诉编译系统在编译当前路径下的源码文件之前，要先由Build.exe编译

的目标文件(指定在构建当前目录之前须进行的依赖性构建工作).

WINCETARGETFILES：用于告诉编译系统在链接当前路径下所有的目标文件之前，要先由Build.exe

编译的目标文件(指定在构建当前目录之前须进行的依赖性构建工作)。

WINCE_OVERRIDE_CFLAGS：用于定义用户自己的编译器参数取代默认的编译器参数。

其实C/C++编译器包含的开关是远远不止这些宏可以覆盖的。如果需要更复杂的构建操作（例如不要让构建系统除掉exe中的重定位信息)，那么可搜索Makefile.def中的宏定义或编译器开关项来了解更多的宏定义。

如果上述的规则都不能满足要求，那么还可通过制定自己的编译规则来达到目的。通常可在本地目录的Makefile.def中指定自己的规则，如下所示：

!INCLUDE $(_MAKEENVROOT)\makefile.def

# 这里添加自己的规则

同样提醒的是，在Makefile中最好只定义规则，所有的宏都应写到SOURCES文件中。

原文链接: https://www.cnblogs.com/jiegekaoyan/archive/2010/07/28/1787389.html

欢迎关注

微信关注下方公众号，第一时间获取干货硬货；公众号内回复【pdf】免费获取数百本计算机经典书籍

原创文章受到原创版权保护。转载请注明出处：https://www.ccppcoding.com/archives/13169

非原创文章文中已经注明原地址，如有侵权，联系删除

关注公众号【高性能架构探索】，第一时间获取最新文章

转载文章受原作者版权保护。转载请注明原作者出处！

Dirs文件和Sources文件

相关推荐