SVN 命令

   

          svn(subversion)是近年来崛起的版本管理工具，是cvs的接班人。目前绝大多数开源软件都使用svn作为代码版本管理软件。下面介绍一下如何在Xcode上使用SCM配置源代码版本控制SVN的方法与技巧：

     Code内置版本控制客户端SCM，可作为SVN客户端。前两天组里自己搭SVN服务器没有弄成，可能是网络配置问题，索性就申请了googlecode节点，用google提供的SVN服务器了。不过，前提是所有的代码都要开源。还有就是申请之前还需要一个gmail帐号，至于如何申请，搜一下，很多答案。申请完后别忘了把团队成员（都需要有gmail帐号）加入进来。

现在，只剩下客户端配置了。程序员的日常版本控制操作一般是：

import --> checkout --> commit -->update

import :导入工程文件到SVN服务器。在本地建好工程文件后，第一次从客户端上传工程文件至SVN服务器

checkout :签出工程文件到客户机本地。第一次从SVN服务器上下载工程文件到客户机本地。

commit : 提交客户机本地的改动到SVN服务器。客户端本地在对代码进行修改后，将修改提交到服务器。如果服务器的版本被团队里的其他人更新了，那么commit之前会提示需要先update一下。

update: 将SVN服务器上的最新版本同步到客户端。

-----------------

很好理解，import与checkout是一组操作，用在第一次操作时。而commit和update是一组操作，分别对应2个不同方向的操作。

-----------------

1、Checkout 操作

假如SVN上已经有团队里其他人上传的工程项目文件，我们需要checkout到客户端本地。按下列图示操作：

首先用gmail帐号登录申请的googlecode节点，取到SVN服务器的连接串（红字标明的部分）

紧接着我们需要知道与google SVN服务器连接的密码，这个密码并不是gmail帐号的密码，而是由google帮你自动生成的，我们需要在gmail帐号的profile中找到这个随机生成的密码。点击右上角的Profile，然后选中"Setting"

这时页面显示错误，这是乍整的呢？我们打开一个在线代理网页，重新访问我们的googlecode节点（我选择默认S1代理仍然出不来，我换了一个S2就OK）

可以看到GOOGLE为我们生成的SVN服务器访问密码，也可以按“Regenerate”按钮随机生成另一个密码

打开Xcode，无需创建任何项目，直接选择SCM菜单上的"Configure SCM Repositories"
点击左下角的"+"号新建一个SCM配置文件，起个名字“snb”，然后填入刚才我们找到的googlecode节点的SVN服务器连接串，以及连接帐号、密码

接下来我们就可以Checkout代码了

选择代码的本地存放路径，checkout完成后，可以直接打开工程代码了

接下来还需要一步：将该工程与SCM配置文件绑定在一起。首先双击工程名打开工程配置，选择"Configure Roots &SCM..."按钮

指定我们在SCM里设计的配置文件名snb，这样就将该工程与snb配置文件绑定在一起了。

2、Commit操作

首先，我们假如对checkout下来的代码进行了修改，加入了一行注释，然后我们要将更改发布到svn服务器，可以选择SCM菜单的“Commit Entire Project”进行提交

注意，有变更的文件都会出现在SCM分支下，可以显示自上次update以来，本地修改的代码文件

在commit时我们可以添加一些说明，在这一步出现了一个提交错误信息。不知道是什么原因，总之我试着把https连接方式改为了http方式就OK了，而且我发现后面出现的Error:175002 (RA layer request failed) Server sent unexpected return value(405 Method Not Allowed)

错误我也是用这种方式解决的，就是又把http改回https方式，真有意思！

在googlecode站点我们看到已经commit成功

3、Update操作

假如在另一台机器上commit了一个版本，在googlecode上可以看到这个记录，然后我们准备update到客户端本地，选择SCM菜单的“Update Entire Project”就OK了，更新完后我们看到代码添加的部分

4、import操作

也很简单，选择SCM中的Repositories，然后选择Import按提示操作即可（在这个菜单中可以对SVN服务器上文件进行管理，比如创建目录和删除文件操作等等）

import成功！

下面附上一些SVN命令：

 1、将文件checkout到本地目录

svn checkout path（path是服务器上的目录）

例如：svn checkout svn://192.168.1.1/pro/domain 

简写：svn co

 2、往版本库中添加新的文件

svn add file 

例如：svn addtest.php(添加test.php) 

svn add *.php(添加当前目录下所有的php文件)

 3、将改动的文件提交到版本库

svn commit -m “LogMessage“ [-N] [--no-unlock] PATH(如果选择了保持锁，就使用–no-unlock开关)

例如：svn commit -m “add test file for my test“ test.php

简写：svn ci

4、加锁/解锁 

svn lock -m “LockMessage“ [--force] PATH

例如：svn lock -m “lock test file“ test.php

svn unlock PATH

 5、更新到某个版本

svn update -r m path

例如： 

svn update如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。 

svn update -r 200 test.php(将版本库中的文件test.php还原到版本200) 

svn update test.php(更新，于版本库同步。如果在提交的时候提示过期的话，是因为冲突，需要先update，修改文件，然后清除svn resolved，最后再提交commit) 

简写：svn up

6、查看文件或者目录状态

1）svn status path（目录下的文件和子目录的状态，正常状态不显示） 

【?：不在svn的控制中；M：内容被修改；C：发生冲突；A：预定加入到版本库；K：被锁定】

2）svn status -v path(显示文件和子目录状态)

第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。

注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。 

简写：svn st

 7、删除文件

svn delete path -m “delete test fle“

例如：svn delete svn://192.168.1.1/pro/domain/test.php -m “delete test file” 

或者直接svn delete test.php 然后再svn ci -m ‘delete test file‘，推荐使用这种

简写：svn (del, remove, rm)

8、查看日志

 svn log path

例如：svn log test.php 显示这个文件的所有修改记录，及其版本号的变化

9、查看文件详细信息 

svn info path

例如：svn info test.php

 10、比较差异

svn diff path(将修改的文件与基础版本比较)

例如：svn diff test.php 

svn diff -r m:n path(对版本m和版本n比较差异)

例如：svn diff -r 200:201 test.php

简写：svn di

   11、将两个版本之间的差异合并到当前文件

svn merge -r m:n path 

例如：svn merge -r 200:205 test.php（将版本200与205之间的差异合并到当前文件，但是一般都会产生冲突，需要处理一下）

 12、SVN 帮助

svn help

svn help ci

——————————————————————————

 

以上是常用命令，下面写几个不经常用的

 

——————————————————————————

13、版本库下的文件和目录列表

svn list path

显示path目录下的所有属于版本库的文件和目录 

简写：svn ls

 14、创建纳入版本控制下的新目录

svn mkdir: 创建纳入版本控制下的新目录。

用法: 

 1、mkdir PATH…

  2、mkdir URL… 

创建版本控制的目录。

1、每一个以工作副本 PATH 指定的目录，都会创建在本地端，并且加入新增调度，以待下一次的提交。

2、每个以URL指定的目录，都会透过立即提交于仓库中创建。在这两个情况下，所有的中间目录都必须事先存在。

15、恢复本地修改

svn revert: 恢复原始未改变的工作副本文件 (恢复大部份的本地修改)。revert:

用法: revert PATH…

注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录

16、代码库URL变更

svn switch (sw): 更新工作副本至不同的URL。

用法: 1、switch URL [PATH]

 2、switch –relocate FROM TO [PATH...]

 1、更新你的工作副本，映射到一个新的URL，其行为跟“svn update”很像，也会将服务器上文件与本地文件合并。这是将工作副本对应到同一仓库中某个分支或者标记的方法。

2、改写工作副本的URL元数据，以反映单纯的URL上的改变。当仓库的根URL变动(比如方案名或是主机名称变动)，但是工作副本仍旧对映到同一仓库的同一目录时使用这个命令更新工作副本与仓库的对应关系。

17、解决冲突

svn resolved: 移除工作副本的目录或文件的“冲突”状态。 

用法: resolved PATH…

注意: 本子命令不会依语法来解决冲突或是移除冲突标记；它只是移除冲突的相关文件，然后让 PATH 可以再次提交。

18、输出指定文件或URL的内容。

svn cat 目标[@版本]…如果指定了版本，将从指定的版本开始查找。

svn cat -r PREV filename > filename (PREV 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)