CMake生成版本号

CMake生成版本号

（金庆的专栏）

原来的CMake需要用shell脚本生成SVN版本号，再作为cmake参数传入。

CMake调用脚本示例：

#!/bin/sh
# cmake.sh

ServerCodeRoot=~/Code/Server
CodeRevNum=`svn info ${ServerCodeRoot} | grep Revision | awk -F' ' '{ print $2 }'`
cmake S{ServerCodeRoot} -DCMAKE_BUILD_TYPE=Release -DVERSION_REVISION=S{CodeRevNum}

CMakeLists.txt中如下配置：
configure_file(
  "Version.h.in"
  "Version.h"
)

configure_file: 将一份文件拷贝到另一个位置并修改它的内容。 configure_file(<input> <output>

[COPYONLY] [ESCAPE_QUOTES] [@ONLY])

　　将文件<input>拷贝到<output>然后替换文件内容中引用到的变量值。如果<input>是相对路径，它被评估的基础路径是当前源码路径。<input>必须是一个文件，而不是个路径。如果<output>是一个相对路径，它被评估的基础路径是当前二进制文件路径。如果<output>是一个已有的路径，那么输入文件将会以它原来的名字放到那个路径下。

　　该命令替换掉在输入文件中，以${VAR}格式或@VAR@格式引用的任意变量，如同它们的值是由CMake确定的一样。 如果一个变量还未定义，它会被替换为空。

Version.h.in如下：

#include <string>
const std::string VERSION_MAJOY("1");
const std::string VERSION_MINOR("0");
const std::string VERSION_REVISION("@VERSION_REVISION@");

Linux下执行cmake.sh会自动替换SVN版本号。

现改为用FIND_PACKAGE(Subversion)方式，不必用shell脚本生成SVN版本号，
并且在Windows上也可以生成版本号, cmake调用时不必传VERSION_REVISION参数。

CMakeLists.txt改为（参考了开源网游ryzom的CMake）：

SET(ROOT_DIR ${PROJECT_SOURCE_DIR})
IF(EXISTS "${ROOT_DIR}/.svn/")
  FIND_PACKAGE(Subversion)

  IF(SUBVERSION_FOUND)
    Subversion_WC_INFO(${ROOT_DIR} Project)
    SET(VERSION_REVISION ${Project_WC_REVISION})
  ENDIF(SUBVERSION_FOUND)
ENDIF(EXISTS "${ROOT_DIR}/.svn/")

CONFIGURE_FILE(
  "Version.h.in"
  "Version.h"
)

如果不是SVN, 而是用Hg, 可用如下脚本：
IF(EXISTS "${ROOT_DIR}/.hg/")
  FIND_PACKAGE(Mercurial)

  IF(MERCURIAL_FOUND)
    Mercurial_WC_INFO(${ROOT_DIR} ER)
    SET(REVISION ${ER_WC_REVISION})
    SET(CHANGESET ${ER_WC_CHANGESET})
    SET(BRANCH ${ER_WC_BRANCH})
  ENDIF(MERCURIAL_FOUND)
ENDIF(EXISTS "${ROOT_DIR}/.hg/")