平凡的世界

版 本 控 制

版本號	日期	修改者	說明	備注
0.1	2010.07.13	phoenix
0.2	2011.01.12	phoenix

目 錄

1. 引言... 1

1.1. 編寫目的.. 1

1.2. 參考資料.. 1

2. 目錄結(jié)構(gòu)... 1

3. 工程配置... 2

4. 屬性配置... 2

4.1. “常規(guī)”配置.. 2

4.2. “調(diào)試”配置.. 2

4.3. “C/C++”配置.. 3

4.4. “鏈接器”配置.. 3

4.5. “生成事件”配置.. 3

5. 附錄：VC2005中可以使用的宏... 3

1.引言

1.1.編寫目的

當(dāng)開發(fā)人員開始進(jìn)行編碼工作以及編碼工作的過程中，都需要根據(jù)工程的需要配置各種工作路徑，如引入第三方庫、輸出生成的頭文件和庫文件等。以前部分開發(fā)人員對工程路徑的定義比較隨意，相當(dāng)一部分使用的是絕對路徑。如果只是單個(gè)開發(fā)人員完成一個(gè)單一的功能，這種做法看起來沒有什么明顯的缺點(diǎn)。但是，如果是數(shù)個(gè)開發(fā)人員來合作共同完成一個(gè)功能和結(jié)構(gòu)都很復(fù)雜的工程時(shí)，這種做法的弊端就凸顯出來。一個(gè)非常明顯的問題就是：開發(fā)人員A將他的工程交給開發(fā)人員B編譯時(shí)，如工程定義使用了絕對路徑，除非開發(fā)人員B的計(jì)算機(jī)與A的計(jì)算機(jī)具有完全相同的文件組織結(jié)構(gòu)，否則一次性編譯通過是不可能。另外，當(dāng)開發(fā)人員在一長串的“Can’t find …”或者“XXX undefined”的錯(cuò)誤與警告中焦頭爛額時(shí)，也許只是因?yàn)橐粋€(gè)不起眼的地方使用了絕對路徑，或者是大小寫的差異。

因此，規(guī)范開發(fā)人員的工程配置是很有必要的。通過規(guī)范的工程配置，所有開發(fā)人員之間的工程是無縫銜接的，即任何一個(gè)開發(fā)人員的工程拿到其他人的工程時(shí)，無須修改任何一個(gè)配置便可以一次性的編譯成功。這樣的規(guī)范操作無異可以大大減少團(tuán)隊(duì)成員通過代碼交流時(shí)的不必要成本。另外，規(guī)范的工程配置也便于SubVersion版本控制系統(tǒng)的引入，通過引入SubVersion版本控制系統(tǒng)，可以協(xié)調(diào)整個(gè)研發(fā)團(tuán)隊(duì)的工程進(jìn)度，控制產(chǎn)品的里程碑發(fā)布。這一切，都從規(guī)范的工程配置開始。

1.2.參考資料

1. 《OpenSource SubVersion規(guī)范》

2. 《Visual Studio 2005編程指南》

2.目錄結(jié)構(gòu)

MyDevelopeFolder

├─Bin

│ ├─Debug

│ ├─Program

│ ├─Release

│ ├─UnicodeDebug

│ ├─UnicodeProgram

│ └─UnicodeRelease

├─MySDK

│ ├─Include

│ │ ├─BCG

│ │ └─Boost

│ └─Lib

│ ├─Debug

│ │ ├─BCG

│ │ └─Boost

│ ├─Program

│ │ ├─BCG

│ │ └─Boost

│ ├─Release

│ │ ├─BCG

│ │ └─Boost

│ ├─UnicodeDebug

│ │ ├─BCG

│ │ └─Boost

│ ├─UnicodeProgram

│ │ ├─BCG

│ │ └─Boost

│ └─UnicodeRelease

│ ├─BCG

│ └─Boost

├─Project

│ ├─LibMyExample

│ │ └─Document

│ └─MyExampleApp

│ └─Document

├─Solution

└─Temp

├─Compile

└─Link

1. MyDevelopeFolder是開發(fā)工程的根目錄

2. Bin目錄存放所有動(dòng)態(tài)鏈接庫和可執(zhí)行程序，包括自己的產(chǎn)出和第三方庫，按編譯配置名稱包括對應(yīng)的子目錄，如Debug、Release。另外，程序運(yùn)行過程中需要外部的數(shù)據(jù)文件和啟動(dòng)時(shí)需要的配置文件等等都可放于該目錄

3. MySDK存放產(chǎn)品項(xiàng)目依賴、產(chǎn)出的.h文件和.lib文件。其中Lib目錄下根據(jù)配置名稱和第三方庫名稱對lib文件進(jìn)行管理。如某項(xiàng)目使用BCG作為界面庫，則BCG的頭文件放置于“Include\BCG”下，不同版本的庫文件置于“Lib\配置名\BCG”下；項(xiàng)目輸出的lib文件直接位于“Lib\配置名”下。這樣產(chǎn)品依賴的不同開發(fā)庫所使用頭文件與庫文件和輸出的頭文件與庫文件相互之間是獨(dú)立、彼此不干涉的。

4. Project是工程目錄，用于存放代碼，按模塊名組織次級目錄。功能庫工程一般的以“Lib”開頭，以便與其它動(dòng)態(tài)庫區(qū)別。每個(gè)工程模塊目錄應(yīng)包含“Document”子目錄，該目錄下按需要增加“DBM”、“DOC”、“UML”三個(gè)子目錄。“DBM”用于存放與該模塊相關(guān)的數(shù)據(jù)庫設(shè)計(jì)文檔，通常是PowerDesigner文檔；“DOC”用于存放與該模塊相關(guān)的一般性說明文檔；“UML”用于存放與該模塊相關(guān)的UML設(shè)計(jì)文檔，通常是Rational Rose文檔。

5. Solution是解決方案目錄，用于存放產(chǎn)品的完整解決方案。通常使用解決方案可以生成該產(chǎn)品的所有版本。

6. Temp是用于編譯生成的中間目錄，主要存放編譯過程中生成的各種中間文件。

3.工程配置

根據(jù)調(diào)試信息與字符集的不同，一般的工程配置有六類，如下表所示

名稱	字符集	是否包含調(diào)試信息	是否包含代碼優(yōu)化
Debug	ANSI	YES	NO
Release	ANSI	YES	YES
Program	ANSI	NO	YES
UnicodeDebug	UNICODE	YES	NO
UnicodeRelease	UNICODE	YES	YES
UnicodeProgram	UNICODE	NO	YES

4.屬性配置

4.1.“常規(guī)”配置

輸出目錄： ..\..\Temp\Link\$(ProjectName)\$(ConfigurationName)

中間目錄：..\..\Temp\Compile\$(ProjectName)\$(ConfigurationName)

4.2.“調(diào)試”配置

如果需要啟動(dòng)本模塊進(jìn)行調(diào)試，則“命令”為：..\..\Bin\$(ConfigurationName)\$(TargetFileName)

4.3.“C/C++”配置

1) “附加包含目錄”：..\..\MineSDK\Include ，如有其它目錄請用“;”間隔，注意使用相對路徑，嚴(yán)禁使用絕對路徑。

2) 動(dòng)態(tài)庫使用導(dǎo)出宏導(dǎo)出/導(dǎo)入時(shí)，應(yīng)在“預(yù)處理器”中定義導(dǎo)出宏，不得在代碼文件中定義。導(dǎo)出宏的一般格式為“LIB_XXXXX”。

3) 一般情況下不推薦使用預(yù)編譯頭。

4.4.“鏈接器”配置

1) “輸出文件”：

a) 若為Debug版時(shí)：$(OutDir)\$(ProjectName)D.dll；

b) 若為Release版時(shí)：$(OutDir)\$(ProjectName).dll。

2) “附加庫目錄”：..\..\Bin\$(ConfigurationName);..\..\MySDK\Lib，如有其它目錄請用“;”間隔，注意使用相對路徑，嚴(yán)格禁止使用本地絕對路徑。

3) “模塊定義文件”：一般不使用模塊定義.def文件，本項(xiàng)可選擇“從默認(rèn)配置…”。

4.5.“生成事件”配置

一般需要配置的是“生成后事件”。任何一個(gè)工程模塊的生成后事件都應(yīng)包括以下內(nèi)容：

1) copy $(TargetPath) ..\..\Bin\$(ConfigurationName)

2) 若有導(dǎo)出的Lib庫文件，需要增加：copy $(TargetDir)$(TargetName).lib ..\..\MySDK\Lib

3) 若有導(dǎo)出的頭文件，需要增加： copy myhead.h ..\..\MySDK\Include

具體文件名與路徑視情況而定，但是嚴(yán)禁使用絕對路徑。

5.附錄：VC2005中可以使用的宏