SVN客户端使用规范V12Word文件下载.docx

1、孙管理2010-11-231.1项目模块的优化2011-1-19对基本信息的整理目 录修订记录 21. 用户的登录 41.1. 登录 41.2. 输入用户名和密码 41.3. 输入信息 52. TortoiseSVN客户端操作 62.1. 启动库 62.2. 检出 82.3. 修改 102.4. 添加 122.4.1. 在本地副本（受版本控制的目录）下添加 122.4.2. 在打开的版本浏览器中添加 132.4.3. 用导入方式 132.5. 删除 142.5.1. 在本地副本（受版本控制的目录）下删除 152.5.2. 在打开的版本浏览器中删除 152.6. 冲突 152.7. Get 16

2、2.8. 锁定文件和解锁文件 17 1. 用户的登录1.1. 登录具体的登录地址由配置管理员提供，如截图：1.2. 输入用户名和密码即如下页面所示：说明：1）这里要申明一下，特别是新来的同事要注意，你将要介入某个项目，请项目负责人与配置管理员联系，给你分配权限，你才能进入某个项目，具体的路径管理员会提供； 2）用户名和密码与配置管理员联系；3）对于具有保密价值的项目，部分用户名和登录密码需要修改的用户可以和配置管理员联系，以保证用户的个人的操作信息。1.3. 输入信息单击【确定】，即可进入你所参加项目的页面：2. TortoiseSVN客户端操作2.1. 启动库所有TortoiseSVN命令都

3、集成在Windows的资源管理器的菜单中。当你在一个文件或文件夹单击鼠标右键时，大多数命令都会直接显示出来。1点击右键选择“TortoiseSVN”，会出现两种情况，如下图：1）第一种情况：（可知此文件处于版本控制之下）2）第二种情况：（单击任意空白处即可弹出）上述两种情况显示出来，依赖于文件或文件夹是否处于版本控制之下。2根据第二种情况，本地设置的工作目录workspace下没有处于版本控制下的文件，在workspace下点击右键，选择“版本库浏览器”，如下图：在URL中填写地址，一般CM会给定。3：点击【确定】后会提示：输入个人的用户名和密码，区分大小写的。保存认证可选可不选。如果想清除认

4、证信息，可选择Tortoise设置已保存数据认证数据，进行清理。2.2. 检出1：选择需要修改的文件夹，注意，检出范围尽量小，无需修改的文件，尽量不要检出，如下图操作：版本库URL是默认写好的，也可以自己重新选择。“检出至目录”可以选择之前我们设置的E:/workspace，注意，选择好后，最好在目录后面添加 “/SMS”，因为那样操作，配置库中SMS目录下的文件会以SMS为文件夹存放在workspace下，而不会零散的分布在workspace下面，大家可以实践操作一下。目前流程，版本可默认选择“最新版本”。点击【确定】即可。2：还有就是新建备份文件夹，这一般是CM完成，这里就不做介绍了。2.

5、3. 修改检出文件或文件夹到本地，我们会看到workspace下的那个文件或文件夹的图标为，并有个.SVN文件，等图标我们称为覆盖图标，根据Subversion状态的不同而显示不同的图标，下面是各覆盖图标的含意：绿色图标表示这是一个最新取出的工作副本，他的Subversion状态是normal。当你开始编辑一个文件，这个文件的状态就会变成modified，图标也会变成红色圆圈带一个感叹号。这样你就可以轻易的知道自从上次更新以来都有修改过哪些文件，需要提交哪些文件。这个黄色三角符号带感叹号，表示在一次update中产生了一个冲突（conflict）。蓝色加号意味着这个文件或文件夹已经被计划加入到

6、版本控制之下。红叉叉表示相应文件或文件夹被计划删除（deleted），或者表示文件缺失。回到修改操作，按自己需要修改过的文件，图标就变为，表明这些文件需要提交，比如修改SMS下的文件，被修改的文件图标变为，SMS这个文件夹的图标也变为，你可以在被修改的文件上点击右键“提交”，也可以点击一级目录提交，比如SMS。本地修改的版本如果与配置管理库的最新版本一致，并且没有冲突，修改后才可以提交，这点很重要。你可以直接作一下“更新”操作，或者操作“检查更新”看看在本地或在服务器上哪些文件修改过。选中你想要提交的文件或文件夹，然后选择在菜单中选择“提交”。一般信息中要求写上描述。提交对话框会显示每一个有修

7、改的文件，包括新增的，删除的，还有没有版本控制的。如果你不想提交某个有修改的文件，只要不勾选那个文件就好了。如果你要提交某个没有做版本控制的文件，只要勾选它就可以提交了。在提交对话框中双击一个有修改的文件，可以启动外挂的比较工具来显示修改细节。在按下【确定】按钮之后，会出来一个显示提交进程的对话框。这个显示进程的窗口中采用了不同颜色的文字来表示不同的提交动作。蓝色Blue，提交一个修改的或新的条目。深红Dark red，提交一个删除或覆盖操作。黑色Black，其它所有条目。2.4. 添加加入新文件和新目录这儿讲三种方式2.4.1. 在本地副本（受版本控制的目录）下添加如果你想把在开发过程中创建

8、了新文件或新的目录加入到版本控制之下，可以这样做：选中文件或目录，然后在菜单中选择“添加”命令。前提是文件或文件夹的上一级目录受版本控制，那样右键菜单才会有“添加”这一项。在把文件或目录加入到控制之下后，这些文件或目录就会显示为一个added覆盖图标的样子，这就意味着你应该赶紧把你的工作副本“提交”一下，以便其他开发人员能够看到这些文件或目录。要把工作副本之外的文件加入进来，可以使用拖拽来搞定：A 选中你要添加的文件。B 按下鼠标右键将文件拖拽到工作副本中的某个地方。C 松开鼠标右键。D 在跳出来的菜单中选择“添加”。这些文件马上就会被复制到工作副本中并且加入到了版本控制。2.4.2. 在打开

9、的版本浏览器中添加选择需要加入的文件即可。2.4.3. 用导入方式在添加的文件或文件夹右键中，如下：此处选择URL地址后，如果想以导入文件夹为目录，需要写上“/XXX”，XXX为导入文件夹的名字，否则XXX下的文件就会零散的分布在配置库中。要获取一份处于版本控制之下的工作副本，你需要对刚导入的版本做一次检出操作。2.5. 删除删除新文件和新目录这儿讲两种方式2.5.1. 在本地副本（受版本控制的目录）下删除选中文件或目录，然后在菜单中选择“删除”命令。前提是在配置库中更新的最新版本。然后按照“提交”的方式，提交上一级目录。2.5.2. 在打开的版本浏览器中删除选择要删除的文件夹和文件。2.6.

10、 冲突有些文件提交时报错，可能版本不是配置库中的最新版本，也许被其他DEV（开发人员）已经先提交了，这时，你可以操作“更新”，前面修改中讲到过。更新文件时会会提示文件冲突，图标变为，两个或更多开发人员对同一个文件的某几行做了修改，就会产生冲突。因为Subversion会把冲突留给开发人员来解决。只要冲突产生了，你就应该打开有问题的文件，然后找到以“ .r72另外，对每一个有冲突的文件，Subversion都会在你的目录中放三个另外的文件：filename.ext.mine，这个文件是更新工作副本之前，冲突文件在你的工作副本中原来的样子，其中没有任何冲突标记。filename.ext.rOLDR

11、EV，这个文件是版本号为OLDREV时的文件。也就是你做修改之前最后一次取出的文件。filename.ext.rNEWREV，这是你更新时Subversion客户端从服务器收到的最新版本的文件，是配置库的最新版本。你可以在菜单中选择“编辑冲突”来打开一个合并工具或冲突编辑器，或者用其他编辑器来解决这个冲突。你必须决定这些代码到底该是什么样子，做一些必要的修改，然后保存文件。然后选择菜单中的“已解决的”命令执行，接着提交修改到配置库。请注意，命令“已解决的”并没有真正的解决冲突，它只不过是把filename.ext.mine 和 filename.ext.r*删除，并允许你提交修改而已。2.7.

12、 Get可以用检出操作，但是检出操作会显示覆盖图标和.SVN文件，如果不需要覆盖图标或.SVN文件，比如，建一个源代码zip压缩包，这时候你可以用“导出”操作，同样，导出的路径最好填写目录名，导出后会统一存放在该目录下。2.8. 锁定文件和解锁文件1）：检出文件后，选择要锁定的版本文件，右键点击“TortoiseSVN【获取锁定】”菜单，如下图所示：2）：输入锁定原因，然后点击【确定】按钮，系统显示如下结果：注意，文件被锁定以后，别人不可以在对版本库中的此文件进行锁定。3）：subvserison在解除锁定的时候，并不会将本地文件更新到版本库，只是释放锁定。操作步骤如下：选择要取消锁定的文件，右键点击“TortoiseSVN解除锁定”菜单，如下图所示：