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 :指定编译器要使用的参数
LDEFINES :指定连接器要使用的参数
RDEFINES :指定资源编译器 Rc.exe 的参数
DLLENTRY :指定 dll 的入口函数
DEFFILE :指定该模块的 .def 文件
EXEENTRY :指定可执行文件的入口函数
SKIPBUILD :不做实际的 build 操作,直接返回成功
WINCECOD :编译后生成一个 .cod 的汇编文件,用于查看汇编代码调试
WINCECPU :用于说明为指定的 CPU 编译,这样被编译出来的目标文件会被放在 _TGTCPU 环境变量所指定的子目录下面,一般该宏在 sources.cmn 中定义。
WINCEMAP :编译后生成一个 .map 文件,用于调试
WINCEOEM :设置该值表示需要使用 WinCE 下的一些公用的库和头文件,该值一般在 BSP 中的 sources.cmn 中定义。
WINCETARGETFILE0 :用于告诉编译系统在编译当前路径下的源码文件之前,要先由 Build.exe 编译的目标文件。
WINCETARGETFILES :用于告诉编译系统在链接当前路径下所有的目标文件之前,要先由 Build.exe 编译的目标文件。
WINCE_OVERRIDE_CFLAGS :用于定义用户自己的编译器参数取代默认的编译器参数。
举个例子:
TARGETNAME=serial_smdk2410
TARGETTYPE=DYNLINK
RELEASETYPE=PLATFORM
TARGETLIBS=$(_COMMONSDKROOT)\lib\$(_CPUINDPATH)\coredll.lib \
$(_SYSGENOAKROOT)\lib\$(_CPUINDPATH)\ceddk.lib
SOURCELIBS=$(_SYSGENOAKROOT)\lib\$(_CPUINDPATH)\serpddcm.lib \
$(_SYSGENOAKROOT)\lib\$(_CPUINDPATH)\com_mdd2.lib
DEFFILE=serial.def
DLLENTRY=_DllEntryCRTStartup
SOURCES= ser_smdk2410.cpp \
pdds3c2410_ser.cpp
需要编译的文件为 ser_smdk2410.cpp 和 pdds3c2410_ser.cpp , DEF 文件为 serial.def , DLL 的入口函数是 _DllEntryCRTStartup ,静态连接 serpddcm.lib 和 com_mdd2.lib 两个库,动态链接 coredll.lib 和 ceddk.lib 两个库,最终编译为 dll 文件,文件名为 serial_smdk2410.dll 。
最后总结一下, Dirs 文件会和 Sources 文件配合使用,但是他们不可能存在同一个目录下面。 Dirs 文件指定编译目录, Sources 文件指定如何编译。