在Google Code上用 Mercurial 取代 Subversion 管理你的项目

之前，我一直都是用的SVN作为我日常的版本控制工具，诸如代码啊文档啊之类的东西。至于CVS 这么复古的版本控制工具更是没有机会去尝试。说到SVN控制版本的话，作为托管服务商比较好的就有google code，本人也一直在使用。最近，由于一些项目的原因，了解到了另外一个版本控制工具Hg，当然Hg不是它的原名，原名叫Mercurial ，都是水银的意思，所以通常称呼为Hg。

与集中式版本控制工具SVN不同的是，Hg是一种分布式版本控制工具。除了Hg，还有大名鼎鼎的Git 也是分布式版本控制工具。想要更具体的了解版本控制工具的，推荐阅读胡凯《为什么我们要放弃Subversion 》，
风云《分 布式的版本控制工具 》，猛禽《分 布式版本控制（一） 》 《分 布式版本控制（二） 》，Sparkle《我 与Mercurial 系列等几篇文章 》等。只是想了解Mercurial(Hg)的话，Mercurial官方wiki 已经有很详尽的资料和帮助文档了。

接下来回到本文的正题。本文的起因是Google Code在早前除了支持SVN托管代码外，更支持了分布式版本控制Mercurial(Hg)来管理你托管在Google Code上的项目。至于Google为什么在这么多种的分布式版本控制工具中选择了Mercurial而不是Git，这里有一篇文章，推荐阅读一下《Git 与 Mercurial 的分析》 ，原文《Analysis of Git and Mercurial》 。

下面，就教大家怎么让Google Code用Mercurial替代Subversion来管理你的项目。 原文 http://code.google.com/p/support/wiki/ConvertingSvnToHg。

在Google Code里设置由Mercurial来管理项目

1. 访问你已经存在的google code项目页面，选择 “Administer” 选项页,然后选择下级分类选项页 “Source”。
2. 改变第一项Repository type为Mercurial。
3. 参照下文介绍的“如何转换Google Code里Subversion的历史记录到Mercurial中”，导入你的代码到 Hg 代码库中
4. 以同样的导入代码的方式，导入你的wiki到Hg wiki库中。确认你使用的subversion代码库的wiki路径(例如 http://projectname.googlecode.com/svn/wiki) 以及 Hg 代码库的wiki路径(http://wiki.projectname.googlecode.com/hg/)

在你切换你的项目使用Mercurial管理后，你的旧Subversion项目仍然可以访问，所以在你切换之前你不需要备份你的代码库。你的Subversion版本库将会保持访问: https://projectname.googlecode.com/svn/

如何转换Google Code里Subversion的历史记录到Mercurial中

第一种方式：简要截取
如果你不在乎你原来项目的历史记录，那么你可以简单地从Subversion里的主干代码或者wiki中提取最新的代码然后放到你的Mercurial中。假设你googlecode里的 Mercurial代码库是空的，那么可以这样操作：

 $ hg clone https://

projectname.googlecode.com/

hg hg-client
 $ cd

 hg-client
 $ svn

 export

 --force

 http://

projectname.googlecode.com/

svn/

trunk .
 $ hg add .
 $ hg commit -m

 "Initial import of source."


 $ hg push

接着转换你的wiki：

 $ hg clone https://

wiki.projectname.googlecode.com/

hg hg-client-wiki
 $ cd

 hg-client-wiki
 $ svn

 export

 --force

 http://

projectname.googlecode.com/

svn/

wiki .
 $ hg add .
 $ hg commit -m

 "Initial import of wiki."


 $ hg push

第二种方式：完整历史记录转换
如果你要迁移你整个的历史记录，整个过程可能要你更多的参与了。你将会需要先安装一些特殊的工具程序。
安装工具

• ‘hg convert’扩展模块。最新版本的Mercurial已经包含这个模块，请确保你的hg版本为1.1 或者 1.2 或者更高版本。 (可用”hg –version”命令查看) 然后在你的.hgrc里面添加如下代码启用该扩展模块:

  [
  
  extensions]
  
  
  hgext.convert
  
  =
  
  

• Subversion的swig-python绑定。请确保您有最近的Subversion安装（1.5或1.6）。绝大部分的 Subversion衍生版本都有与python的绑定，或者提供他们额外的二进制包。你可以运行如下代码检查你的svn – python的绑定是否正常：

  $ python -c
  
   "import svn.core; print svn.core.SVN_VER_MINOR"
  
  
          5
  
  

  如果失败，或返回的版本低于5，则肯定是不对的。如果你没有二进制软件包，你可以从Subversion自己的源代码树中建立：

  $ svn
  
   checkout http://
  
  svn.collab.net/
  
  repos/
  
  svn/
  
  tags/
  
  1.6.0 svn
  
  
  $ cd
  
   svn
  
  
  $ ./
  
  autogen.sh &&
  
   ./
  
  configure
  $ make
  
  
  $ sudo
  
   make
  
   install
  
  
  $ make
  
   swig-py  # make sure you have swig 1.3 installed already
  
  
  $ make
  
   check-swig-py
  $ sudo
  
   make
  
   install-swig-py

  如果你在Ubuntu的Hardy版本，你可以在hardy-backports里找到1.5版的python-subversion: http://packages.ubuntu.com/hardy-backports/python-subversion
  这可能还需要安装backports里的libsvn1, subversion, mercurial-common, 和mercurial 包。

开始转换
现在我们开始转换– branches(分支), tags(标签)以及其他全部:

$ mkdir

 hg-client
$ hg convert http://

projectname.googlecode.com/

svn

 hg-client

一旦完成转换，你就可以push你最新的历史记录到你的Google Code项目中(前提是你有了一个空的Mercurial版本库):

$ cd

 hg-client
$ hg push https://

projectname.googlecode.com/

hg

至此，大功告成。

 

 

原址：http://leeiio.me/googlecode-converting-svn-to-hg/