VC命令行编译开源代码的常用做法

作者：朱金灿

来源：http://blog.csdn.net/clever101

        一般开源代码为了支持多种编译器，一般并不针对VC编译器提供解决方案文件或工程文件。因此要使用VC编译器编译开源代码，需要了解VC命令行的常用用法以及开源代码编译方面的知识。

       开源代码一般采用两种做法来支持VC编译器，一是用CMake导出VC++项目文件，如OpenCV和OSG这类库是采用这种做法。这类做法比较傻瓜式，一般使用CMake的图形工具就行，可以参考这篇文章OpenCV之一安装和环境变量配置，这里就不做详述。

       开源代码更多是采用第二种方式——makefile文件的方式来支持VC编译器。下面我以编译著名的gdal库来说明如何使用简单的makefile来编译开源代码。

        首先我们下载gdal的最新源码gdal-1.9.1，解压后在其根目录下找到makefile文件——makefile.vc，使用文本文件编辑器打开看看。现摘录其中一部分作一个简单解释：

[plain] view plaincopyprint?

1. GDAL_ROOT = . 
2.   
3. !INCLUDE nmake.opt 
4.  
5. ############################################################################## 
6. # We need to add vb6 support if STDCALL is defined.  
7. !IF DEFINED(STDCALL) && $(MSVC_VER) < 1500 
8. VB6_OBJ = vb6\vb6_support.obj 
9. VB6_TARGET = vb6_dir 
10. !ENDIF 

GDAL_ROOT = . !INCLUDE nmake.opt############################################################################### We need to add vb6 support if STDCALL is defined. !IF DEFINED(STDCALL) && $(MSVC_VER) < 1500VB6_OBJ = vb6\vb6_support.objVB6_TARGET = vb6_dir!ENDIF

  现简单解释下：

GDAL_ROOT = . 是说当前目录（就是makefile.vc所在的目录）是gdal的根目录，你还记得dos命令吗？.表示当前目录，..表示上一级目录

!INCLUDE nmake.opt就是说包含nmake.opt这个编译选项文件。nmake.opt文件下面会详述。

# 开头的表示后面的是注释内容。

!IF DEFINED(STDCALL) && $(MSVC_VER) < 1500

VB6_OBJ = vb6\vb6_support.obj

VB6_TARGET = vb6_dir

!ENDIF

就是说假如定义了STDCALL和VC的版本低于VC9.0 ($(MSVC_VER) < 1500), VB6_OBJ指向的路径为vb6\vb6_support.obj，VB6_TARGET指向的路径为vb6_dir。

    我们再看看makefile的命令分支部分：

[plain] view plaincopyprint?

1. clean:   
2.     cd port 
3.     $(MAKE) /f makefile.vc clean 
4.     cd .. 
5.     cd gcore 
6.     $(MAKE) /f makefile.vc clean 
7.     cd .. 
8.     cd alg 
9.     $(MAKE) /f makefile.vc clean 
10.     cd .. 
11.     cd frmts 
12.     $(MAKE) /f makefile.vc clean 
13.     cd .. 
14.     cd ogr 
15.     $(MAKE) /f makefile.vc allclean 
16.     cd .. 
17.     cd apps 
18.     $(MAKE) /f makefile.vc clean 
19.     cd .. 
20.     cd swig 
21.     $(MAKE) /f makefile.vc clean 
22.     cd .. 
23.     cd vb6 
24.     $(MAKE) /f makefile.vc clean 
25.     cd .. 
26.     if exist gdal.lib del gdal.lib 
27.     if exist $(GDAL_DLL) del $(GDAL_DLL) 
28.     if exist $(GDAL_DLL).manifest del $(GDAL_DLL).manifest 
29.     if exist gdal_i.lib del gdal_i.* 
30.     -del *.ilk 
31.     -del *.pdb 

clean:cd port$(MAKE) /f makefile.vc cleancd ..cd gcore$(MAKE) /f makefile.vc cleancd ..cd alg$(MAKE) /f makefile.vc cleancd ..cd frmts$(MAKE) /f makefile.vc cleancd ..cd ogr$(MAKE) /f makefile.vc allcleancd ..cd apps$(MAKE) /f makefile.vc cleancd ..cd swig$(MAKE) /f makefile.vc cleancd ..cd vb6$(MAKE) /f makefile.vc cleancd ..if exist gdal.lib del gdal.libif exist $(GDAL_DLL) del $(GDAL_DLL)if exist $(GDAL_DLL).manifest del $(GDAL_DLL).manifestif exist gdal_i.lib del gdal_i.*-del *.ilk-del *.pdb

      这一部分看似很复杂，实际上其作用只有一个，就是删除所有编译生成的中间文件和目标文件。

       你看，makefile并不像想象中那么难，只要你愿意，它是可以理解的。!IF和!ENDIF是不是挺像C++的预编译指令呢？在我看来，makefile的主要语法就是C++的预编译指令和dos命令的混合体。

      下面我们再详细了解下nmake.opt文件。打开gdal根目录下的nmake.opt文件,我们找到其中比较典型的部分进行分析。比如我们可以修改nmake.opt文件来使得gdal库集成prj4库。于是我们找到相应的部分：

[plain] view plaincopyprint?

1. # PROJ.4 stuff 
2. # Uncomment the following lines to link PROJ.4 library statically. Otherwise 
3. # it will be linked dynamically during runtime. 
4. #PROJ_FLAGS = -DPROJ_STATIC 
5. #PROJ_INCLUDE = -Id:\projects\proj.4\src 
6. #PROJ_LIBRARY = d:\projects\proj.4\src\proj_i.lib 

# PROJ.4 stuff# Uncomment the following lines to link PROJ.4 library statically. Otherwise# it will be linked dynamically during runtime.#PROJ_FLAGS = -DPROJ_STATIC#PROJ_INCLUDE = -Id:\projects\proj.4\src#PROJ_LIBRARY = d:\projects\proj.4\src\proj_i.lib

        PROJ_FLAGS = -DPROJ_STATIC 是指打开该标记，就以静态链接的方式链接proj4库，不打开的话就以动态链接的方式来链接。PROJ_INCLUDE是指包含的prj4库的头文件，PROJ_LIBRARY是指包含的prj4库的库文件。注意包含头文件是-I+路径。这里的路径可以是绝对路径，也可以是相对路径，也支持环境变量，比如-I$(ORACLE_HOME)\oci\include。

      讲了这么多，最后部分就是讲VC命令行使用makefile文件编译的最常用的命名吧（nmake都知道怎么打开吧，不是cmd哦）：

[plain] view plaincopyprint?

1. // 编译release版本的库 
2. nmake -f makefile.vc   
3. //删除所有编译生成的中间文件和目标文件 
4. nmake -f makefile.vc clean 
5. //编译debug版本的库 
6. nmake -f makefile.vc DEBUG=1 

// 编译release版本的库nmake -f makefile.vc  //删除所有编译生成的中间文件和目标文件nmake -f makefile.vc clean//编译debug版本的库nmake -f makefile.vc DEBUG=1

     

        当然，如果你装有多个VisualStudio，还可以指定哪一个编译器编译：

[plain] view plaincopyprint?

1. // 指定VS 2005编译 
2. nmake -f makefile.vc MSVC_VER=1400 

// 指定VS 2005编译nmake -f makefile.vc MSVC_VER=1400

     

          MSVC_VER对应的VS版本为：

  

       开源库的命名规则有个惯例，就是库名.lib一般是静态库，库名_i.lib一般是导入库，如gdal对应编译出来的静态库和导入库分别是gdal.lib和gdal_i.lib。

        好了，希望下次当你打开一个开源代码，发现里面有makefile.vc文件，你就知道怎么编译了。