Dirs文件和Sources文件 详解 (转)

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文件中。