在配置好msvc命令行環境后（見《配置msvc命令行環境》）， 就可以使用命令行編譯一些小的示例程序了。
如果需要把編譯腳本發布給其他人， 或者需要測試多個VC版本， 還需要一些小技巧。

先回憶下需求：
1. 要將編譯腳本發布給其他人
需要盡可能減少對客戶機器配置（主要是環境變量）的依賴。

2. 要測試多個VC版本
需要盡可能避免使用本機上的全局（系統或當前用戶）環境變量，因為切換不方便。

3. 編寫腳本對自己也應當比較方便
因為使用命令行的目的就是為了方便。

如果不夠方便， 還不如使用IDE，它比較保險
——正確編寫的工作空間文件、解決方案文件、工程文件、項目文件對安裝了VC的客戶肯定是可以使用的。
（正確也是指沒有依賴本機上的任何設置，如全局搜索路徑。）

---

一、 對VC8、VC9

如下編寫腳本：

"call %VSXXCOMNTOOLS%vsvars32.bat"。
rem 執行相應的cl命令。

這樣， 就能滿足上面的3點要求：
1. 客戶機上有肯定有正確的VSXXCOMNTOOLS變量——除非他沒有安裝相應的VC版本。
2. 可以執行cl的命令單獨放在一個腳本中（假設叫cpl.bat），執行VC8、9相同的編譯過程。

對不同的VC版本， 只要能在執行cpl.bat前， 執行"call %VSXXCOMNTOOLS%vsvars32.bat"即可，如：
-------- vc8.bat --------
call "%VS80COMNTOOLS%vsvars32.bat"
call cpl.bat

-------- vc9.bat --------
call "%VS90COMNTOOLS%vsvars32.bat"
call cpl.bat

3. 編譯過程都在單獨的cpl.bat中， 管理維護也比較方便。

 

---

二、 對VC6

        二.1、 使用dsw和dsp文件

也就是使用IDE提供的工作空間文件與工程文件。
這是最保險的—— 只要客戶安裝了VC6， 無論是否有設置環境變量， 都可以使用。

        二.2、假設客戶擁有正確的系統或當前用戶的環境變量

那么就不用設置其他東西， 直接使用和VC8、9相同的編譯腳本， 如：
-------- vc6.bat --------
call cpl.bat


當假設不成立時：
1. 客戶重新安裝VC6
2. 客戶手動添加環境變量， 見《配置msvc命令行環境》。


還有一個缺陷，如果：
二.2.1. 客戶也安裝了多個VC版本
二.2.2. 并且為非VC6的某個版本設置了系統的或者當前用戶的環境變量
二.2.3. 或者VC6的環境變量存在并且是在另一個VC版本的環境變量之后

那么vc6.bat實際上并不是使用VC6去編譯， 而是另一個VC版本。


         二.3、使用VCVARS32.BAT（for VC6）

                二.3.1 使用MSDevDir變量

VC6安裝時選擇“注冊環境變量”后，除了設置相應的Path、include、lib還會設置MSDevDir。
可以如下使用它：
-------- vc6.bat --------
call "%MSDevDir%\..\..\VC98\bin\vcvars32.bat"
call cpl.bat

有2點需要注意：
1. 依然依賴客戶機上的有正確的供VC6使用的環境變量。
與“二.2.2”不同的是，不會出現“二.2.3”的缺陷。

2. MSDevDir與vcvars32.bat的相對位置，并不一定如上面所寫！
安裝VC6時，會讓用戶先選擇一個Common文件夾位置。
安裝完畢后，它與MSDevDir的關系是：
Common\MSDev98

然后還會讓用戶選擇VC的位置。可以和上面不同。



                二.3.2 直接使用VCVARS32.BAT

如：
call VCVARS32.BAT
call cpl.bat

與“二.2”對比：
1. 當客戶安裝VC6時選擇了“注冊環境變量”
那么Path中會加入“prefix\Microsoft Visual Studio\VC98\Bin”這個值。
而VCVARS32.BAT也恰好在這個目錄中，執行成功。

同時， 即使在這種情況下（客戶有必要的環境變量），再調用一次 VCVARS32.BAT也不一定就是多余的。
因為這樣可以避免“二.2”中提到的缺陷， 最后一定是使用VC6而不是其他版本的VC進行編譯。

2. 當客戶安裝VC6時沒有選擇“注冊環境變量”
相對于“二.2”， 客戶需要做的工作會比較少： 將“prefix\Microsoft Visual Studio\VC98\Bin”加入“Path”即可。
無須加入另外的2到5個變量。


這是應該是最理想的不使用IDE的方式了。

---

三、 總結

1. 將總編譯邏輯寫在一個單獨腳本如cpl.bat中。

2. 對于VC8、9， 利用VSXCOMNTOOLS變量， 如下：
-------- vc8.bat --------
call "%VS80COMNTOOLS%vsvars32.bat"
call cpl.bat

-------- vc9.bat --------
call "%VS90COMNTOOLS%vsvars32.bat"
call cpl.bat

注意：是上面是VS而不是VC。


3. 對于VC6

        3.1 使用dsw和dsp文件

這是最保險的方式。
但是不能利用已經寫好的cpl.bat文件， 需要單獨維護。

        3.2 先直接使用VCVARS32.BAT

-------- vc6.bat --------
call VCVARS32.BAT
call cpl.bat

這樣的好處是，可以僅維護單獨的cpl.bat， 客戶上有多個VC版本也能正確編譯——如果他VC6的環境變量正確。
如果不正確， 客戶需要做的工作很少， 加入一個環境變量而已。

---

四、 示例

以下使用《預定義_MSC_VER宏》中的示例， 為其編寫一份使用多VC版本的編輯腳本。點此下載打包代碼。

1. 源代碼
-------- _MSC_VER\_MSC_VER.cpp --------
內容見《預定義_MSC_VER宏》或者打包代碼中。

2. 總編譯邏輯
-------- _MSC_VER\vc\cpl.bat --------
cl ../_MSC_VER.cpp /W4
pause

3. 為不同VC版本編寫一個簡單的調用腳本
-------- _MSC_VER\vc6\vc6.bat --------
call vcvars32.bat
call ../vc/cpl.bat

-------- _MSC_VER\vc8\vc8.bat --------
call "%VS80COMNTOOLS%vsvars32.bat"
call ../vc/cpl.bat

-------- _MSC_VER\vc9\vc9.bat --------
call "%VS90COMNTOOLS%vsvars32.bat"
call ../vc/cpl.bat

---

補充：

——關于腳本和批處理。
文章里提到的腳本，都是dos下的bat批處理文件， 功能很弱。
這里只是說明一種方便的使用多個VC版本的機制而已——就是“三、總結”中的 vc6.bat、vc8.bat、vc9.bat。
它們先使用相應的VCVARS32.bat注冊局部于進程的環境， 然后調用cpl.bat。

實際上， cpl.bat才是編譯的邏輯， 如果dos的bat批處理不能完成其功能， 同樣可以使用其他的工具，如makefile。
所以本文總是說“編譯腳本”， 而不是“編譯批處理”， 雖然本文的編譯腳本就是簡單（不含一點邏輯的）的批處理文件。

---

相關鏈接：

——示例下載
http://immature.googlecode.com/svn/trunk/iMmature/sample/predefined_macro/extension/_MSC_VER/
http://www.shnenglu.com/Files/ownwaterloo/_MSC_VER.zip

——《配置msvc命令行環境》
http://www.shnenglu.com/ownwaterloo/archive/2009/04/15/environment_for_using_cl_from_command_line.html

——《預定義_MSC_VER宏》
http://www.shnenglu.com/ownwaterloo/archive/2009/04/15/predefined_macro__MSC_VER.html

 

---

本作品采用知識共享署名-非商業性使用-相同方式共享 2.5 中國大陸許可協議進行許可。

轉載請注明 ：
文章作者 - OwnWaterloo
發表時間 - 2009年04月16日
原文鏈接 - http://www.shnenglu.com/ownwaterloo/archive/2009/04/16/write_compile_script_for_msvc.html