DSP

Visual C++6.0下的workspace和project结构初探

2019-07-13 18:51发布

 Visual C++6.0下的workspace和project结构初探
-VC6的dsp和dsw文件分析
杨学刚
2009-3-23
xuegangyang@eyou.com
             最近下载Apache的httpd源码进行编译,使用VC6打开Apache.dsw以后进行编译,发现apr.h文件没有包含在下载的源码中,但编译后却发现存在该文件,为弄明白是何处产生arp.h文件,便阅读了Apache.dsp和Makefile.win等文件,整理和总结了apache的project组织结构和VC6下的Project组织结构。我会把文章中用到的apache文件都添加进来,使得大家不用下载apache源码,如果大家对apache编译有兴趣,可以参考我的另一篇文章:http://blog.csdn.net/ftomorrow/archive/2009/03/11/3980143.aspx。
一、Workspace中Projects的组织         用VC6打开Apache.dsw 以后,发现workspace包含许多的Projects:Apache、ApacheMonitor和libapr等。从网上搜到dsw文件的说明:dsw的全称是Developer Studio Workspace,属于最高级别的配置文件,记录了整个Workspace的配置信息,它是一个纯文本文件,通常在VC6创建新项目时自动生成。为弄明白VC中Project如何组织的,用文本编辑器打开Apache.dsw文件,发现其内容如下:      为了分析和研究dsw文件的格式,我用VC6建立新建一个名字为yang的项目,并添加一个main.cpp文件到该工程中,之后VC6自动生成了Project的项目文件 :yang.dsw和yang.dsp文件,打开yang.dsw文件,其内容如下:      对比yang.dsw和apache.dsw格式,便可以发现dsw文件中包含两类Entry:Project和Global。一个dsw文件中可以包含多个Porect Entry(我不知Entry表述是否准确,但我没搜索到dsw文件格式说明,故采用Entry一说),如果包含了多个Project Entry说明该Workspace中含有多个Projects。每一个Project Entry开头为: 其中yang是指project名字,每一个Project包含两个PackagePackage=<5>Package=<4>,如果同一个workspace中的多个Project之间有依赖关系,则会在Package=<4>中进行描述,如Apache.dsw中的Apache project的其中一个依赖关系定义为:     这表示Apache project依赖于libapr project,每一个project可以依赖于多个project,yang.dsw中因为只有yang一个project,所没有依赖关系。VC中可以通过Project->Dependencies菜单来修改和增加Project的依赖关系。
    为验证以上分析是否正确,我把yang.dsp拷贝一份为zhang.dsp,然后把zhang.dsp中所有字符串yang替换成zhang,之后修改yang.dsw,在yang project section之后添
    保存后使用VC6打开yang.dsw文件,便看到yang workspace中包含yang和zhang两个project。 二、Workspace中Project的编译      Apache手册中说:在windows下编译需要设置BuildBin project为Active project,然后进行编译(编译过程可以参考我的另外一篇文章:http://blog.csdn.net/ftomorrow/archive/2009/03/11/3980143.aspx)。既然设置了BuildBin project作为active project进行编译,其关键在于BuildBin.dsw 和BuildBin.dsp文件组织上。从网上搜到的dsp文件说明为:dsp全称是Developer Studio Project,是一个配置文件,它记录的是一个项目的所有配置信息,纯文本文件,主要用于配置编译。打开BuildBin.dsp文件,可以看到:    为了进行对比,给出工程yang的yang.dsp文件内容:      对比yang.dsp 和buildall.dsp两个文件,可以发现其共同之处在于他们都包含了CFG定义、Project section,Project中还包含了Target section,而Target中又包含了source section。其中CFG的值表示编译的版本是Debug还是release,该值可以通过VC的Build->configurations菜单来设置。yang.dsp在Project section中通过以下部分配置来编译源代码和资源文件:     其中CPP=cl.exe,RSC=rc.exe是VC的代码编译器和资源编译器,编译的文件由后续的Source section定义。
    Project section还使用bscmake.exe来进行编译:
    我在网上搜到的bscmake.exe说明为:.BSC格式文件是浏览信息文件,由浏览信息维护工具(BSCMAKE)从原始浏览信息文件(.SBR)中生成,BSC文件可以用来在源代码编辑窗口中进行快速定 位。用于浏览项目信息的,如果用source brower的话就必须有这个文件。可以在project options里去掉Generate Browse Info File,这样可以加快编译进度。
   在定义编译之后还使用link.exe定义链接:
    从以上过程中可以看出,yang.dsp 文件的Project定义了整个workspace的编译过程,包括使用cl.ext 程序进行编译和link.exe进行链接。
    而在apache的Buildall.dsp文件中,Project部分没有使用cl.exe 和link.exe来定义编译和链接方式,而是进行了如下定义:
    该定义将使得VC使用name /f makefile.win 进行编译,而makefile.win 是apapche源码中包含的makefile文件,如此编译的所有操作都由makefile.win 文件进行控制。
    Project中包含Target section,Target section中会定义所有要编译的源代码,它会包含很多Source section,yang.dsp把所有添加到项目中的源程序文件:main.cpp 和资源文件都添加进来,并且还分成了两个group,一个是source code group和 还有一个是Resource Files group,这两个分别是用cl.exe 和rc.exe进行编译。
    而在buildall.dsp文件中,由于已经通过name /f makefile.win 进行编译,我猜测Source section部分的定义已经没有意义了。
在source section部分,还可以编写类似makefile中文件依赖关系在其中,apache中包含一个子project:apr,其对应的apr.dsp文件中部分的source section内容为:
    在以上定义中,"./include/apr.h" : $(SOURCE) "$(INTDIR)" "$(OUTDIR)" 定义了apr.h文件依赖于apr.hw文件,如果apr.hw文件发生了变化,则执行type ./include/apr.hw > ./include/apr.h指令把apr.hw内容拷贝到apr.h文件(type是dos的命令,把文件内容进行输出),这也解释了为何在下载的源码里不包含apr.h文件,但编译后就包含了该文件。 三、Visual C++ workspace组织和Project编译控制小结      VC 通过.dsw 文件来管理和存储workspace中配置和project,它定义了每个Project和他们之间的依赖关系。而.dsp 文件定义了对应project的编译配置信息,VC通过该文件对代码进行编译,我们也可以通过修改该文件而采用nmake的makefile来进行编译。