版 本 控 制
| 版本號(hào) | 日期 | 修改者 | 說(shuō)明 | 備注 |
| 0.1 | 2010.07.13 | phoenix | | |
| 0.2 | 2011.01.12 | phoenix | | |
| | | | | |
| | | | | |
| | | | | |
目 錄
1. 引言... 1
1.1. 編寫(xiě)目的.. 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
當(dāng)開(kāi)發(fā)人員開(kāi)始進(jìn)行編碼工作以及編碼工作的過(guò)程中，都需要根據(jù)工程的需要配置各種工作路徑，如引入第三方庫(kù)、輸出生成的頭文件和庫(kù)文件等。以前部分開(kāi)發(fā)人員對(duì)工程路徑的定義比較隨意，相當(dāng)一部分使用的是絕對(duì)路徑。如果只是單個(gè)開(kāi)發(fā)人員完成一個(gè)單一的功能，這種做法看起來(lái)沒(méi)有什么明顯的缺點(diǎn)。但是，如果是數(shù)個(gè)開(kāi)發(fā)人員來(lái)合作共同完成一個(gè)功能和結(jié)構(gòu)都很復(fù)雜的工程時(shí)，這種做法的弊端就凸顯出來(lái)。一個(gè)非常明顯的問(wèn)題就是：開(kāi)發(fā)人員A將他的工程交給開(kāi)發(fā)人員B編譯時(shí)，如工程定義使用了絕對(duì)路徑，除非開(kāi)發(fā)人員B的計(jì)算機(jī)與A的計(jì)算機(jī)具有完全相同的文件組織結(jié)構(gòu)，否則一次性編譯通過(guò)是不可能。另外，當(dāng)開(kāi)發(fā)人員在一長(zhǎng)串的“Can’t find …”或者“XXX undefined”的錯(cuò)誤與警告中焦頭爛額時(shí)，也許只是因?yàn)橐粋€(gè)不起眼的地方使用了絕對(duì)路徑，或者是大小寫(xiě)的差異。
因此，規(guī)范開(kāi)發(fā)人員的工程配置是很有必要的。通過(guò)規(guī)范的工程配置，所有開(kāi)發(fā)人員之間的工程是無(wú)縫銜接的，即任何一個(gè)開(kāi)發(fā)人員的工程拿到其他人的工程時(shí)，無(wú)須修改任何一個(gè)配置便可以一次性的編譯成功。這樣的規(guī)范操作無(wú)異可以大大減少團(tuán)隊(duì)成員通過(guò)代碼交流時(shí)的不必要成本。另外，規(guī)范的工程配置也便于SubVersion版本控制系統(tǒng)的引入，通過(guò)引入SubVersion版本控制系統(tǒng)，可以協(xié)調(diào)整個(gè)研發(fā)團(tuán)隊(duì)的工程進(jìn)度，控制產(chǎn)品的里程碑發(fā)布。這一切，都從規(guī)范的工程配置開(kāi)始。
1. 《OpenSource SubVersion規(guī)范》
2. 《Visual Studio 2005編程指南》
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是開(kāi)發(fā)工程的根目錄
2. Bin目錄存放所有動(dòng)態(tài)鏈接庫(kù)和可執(zhí)行程序，包括自己的產(chǎn)出和第三方庫(kù)，按編譯配置名稱(chēng)包括對(duì)應(yīng)的子目錄，如Debug、Release。另外，程序運(yùn)行過(guò)程中需要外部的數(shù)據(jù)文件和啟動(dòng)時(shí)需要的配置文件等等都可放于該目錄
3. MySDK存放產(chǎn)品項(xiàng)目依賴(lài)、產(chǎn)出的.h文件和.lib文件。其中Lib目錄下根據(jù)配置名稱(chēng)和第三方庫(kù)名稱(chēng)對(duì)lib文件進(jìn)行管理。如某項(xiàng)目使用BCG作為界面庫(kù)，則BCG的頭文件放置于“Include\BCG”下，不同版本的庫(kù)文件置于“Lib\配置名\BCG”下；項(xiàng)目輸出的lib文件直接位于“Lib\配置名”下。這樣產(chǎn)品依賴(lài)的不同開(kāi)發(fā)庫(kù)所使用頭文件與庫(kù)文件和輸出的頭文件與庫(kù)文件相互之間是獨(dú)立、彼此不干涉的。
4. Project是工程目錄，用于存放代碼，按模塊名組織次級(jí)目錄。功能庫(kù)工程一般的以“Lib”開(kāi)頭，以便與其它動(dòng)態(tài)庫(kù)區(qū)別。每個(gè)工程模塊目錄應(yīng)包含“Document”子目錄，該目錄下按需要增加“DBM”、“DOC”、“UML”三個(gè)子目錄。“DBM”用于存放與該模塊相關(guān)的數(shù)據(jù)庫(kù)設(shè)計(jì)文檔，通常是PowerDesigner文檔；“DOC”用于存放與該模塊相關(guān)的一般性說(shuō)明文檔；“UML”用于存放與該模塊相關(guān)的UML設(shè)計(jì)文檔，通常是Rational Rose文檔。
5. Solution是解決方案目錄，用于存放產(chǎn)品的完整解決方案。通常使用解決方案可以生成該產(chǎn)品的所有版本。
6. Temp是用于編譯生成的中間目錄，主要存放編譯過(guò)程中生成的各種中間文件。
根據(jù)調(diào)試信息與字符集的不同，一般的工程配置有六類(lèi)，如下表所示
| 名稱(chēng) | 字符集 | 是否包含調(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 |
輸出目錄： ..\..\Temp\Link\$(ProjectName)\$(ConfigurationName)
中間目錄：..\..\Temp\Compile\$(ProjectName)\$(ConfigurationName)
如果需要啟動(dòng)本模塊進(jìn)行調(diào)試，則“命令”為：..\..\Bin\$(ConfigurationName)\$(TargetFileName)
1) “附加包含目錄”：..\..\MineSDK\Include ，如有其它目錄請(qǐng)用“;”間隔，注意使用相對(duì)路徑，嚴(yán)禁使用絕對(duì)路徑。
2) 動(dòng)態(tài)庫(kù)使用導(dǎo)出宏導(dǎo)出/導(dǎo)入時(shí)，應(yīng)在“預(yù)處理器”中定義導(dǎo)出宏，不得在代碼文件中定義。導(dǎo)出宏的一般格式為“LIB_XXXXX”。
3) 一般情況下不推薦使用預(yù)編譯頭。
1) “輸出文件”：
a) 若為Debug版時(shí)：$(OutDir)\$(ProjectName)D.dll；
b) 若為Release版時(shí)：$(OutDir)\$(ProjectName).dll。
2) “附加庫(kù)目錄”：..\..\Bin\$(ConfigurationName);..\..\MySDK\Lib，如有其它目錄請(qǐng)用“;”間隔，注意使用相對(duì)路徑，嚴(yán)格禁止使用本地絕對(duì)路徑。
3) “模塊定義文件”：一般不使用模塊定義.def文件，本項(xiàng)可選擇“從默認(rèn)配置…”。
一般需要配置的是“生成后事件”。任何一個(gè)工程模塊的生成后事件都應(yīng)包括以下內(nèi)容：
1) copy $(TargetPath) ..\..\Bin\$(ConfigurationName)
2) 若有導(dǎo)出的Lib庫(kù)文件，需要增加：copy $(TargetDir)$(TargetName).lib ..\..\MySDK\Lib
3) 若有導(dǎo)出的頭文件，需要增加： copy myhead.h ..\..\MySDK\Include
具體文件名與路徑視情況而定，但是嚴(yán)禁使用絕對(duì)路徑。
| ConfigurationName | 配置名字，通常是Debug或者Release |
| IntDir | 編譯器使用的中間目錄，產(chǎn)出obj文件 |
| OutDir | 鏈接器使用的輸出目錄 |
| ProjectDir | 項(xiàng)目目錄 |
| ProjectName | 項(xiàng)目名字 |
| SolutionDir | 解決方案目錄 |
| TargetDir | 目標(biāo)輸出文件所在的目錄 |
| TargetExt | 目標(biāo)輸出的擴(kuò)展名 |
| TargetFileName | 目標(biāo)輸出文件名，包括擴(kuò)展名 |
| TargetName | 目標(biāo)輸出名，不包括擴(kuò)展名 |
| TargetPath | 目標(biāo)輸出文件的全路徑名 |