SVN的介绍和使用

SVN（subversion）：

是一个开放源代码的版本控制系统，是用于多个人共同开发同一个项目，共用资源的目的。
所谓版本控制，就是记录项目代码文件夹和文件的每一次改动，并为每次改动编上序号，也叫作版本号用于存储、追踪文件夹和文件的修改历史。
通过版本控制软件，我们可以对项目代码的修改历史进行查看，或者直接把代码恢复到以前的一个版本代码。

TortoiseSVN图标介绍：

一个新检出的工作复本使用绿色的对勾重载，表示subversion状态正常。

当文件被修改后，图标重载变成了红色感叹号。

在提交的过程中出现了冲突，图标变成黄色感叹号。

拥有了一个文件的锁，不允许别人提交对该文件的修改。

表示当前文件夹下某些文件或文件夹已经计划被删除或已丢失。

一个文件或目录已经被计划加入版本控制。

有的电脑可能不显示，如果某些文件与项目无关，可以添加到忽略列表。

TortoiseSVN功能介绍：

• 【SVN checkout】SVN检出（可根据需要获取相应的版本，点击显示日志来确认自己需要获取的版本）
  （1）新建或进入目录下，右键->SVN checkout
  （2）URL of repository填写仓库路径即可
  （3）Revision处，“HEAD revision”是指最新版，也可以指定Revision为任意一个版本。
  （4）下载完成后，服务器上所有内容会出现在本地文件夹下。
• 【add】增加（将文件或目录加入SVN库，如果添加的是目录，目录下的所有文件会同时添加）
  （1）选中需要增加的新文件右键选择“Tortoise SVN”的“Add”项。
  （2）选中文件夹右键选择“SVN Commit”，将新文件上传配置库对应文件夹中。
• 【delete】删除（不能直接用Windows的删除命令操作，那样实际并没有删除）
  （1）选中要被删除的文件，右键选择“Tortoise SVN”的“delete”项。
  （2）选中文件夹右键选择“SVN Commit”项进行提交，提交后则将新文件从配置库中删除。
• 【rename】改名（不能直接用Windows的重命名命令来操作）
• 【SVN revert】SVN还原（在未提交之前，需要返回到修改前的状态，则选中文件夹右键选择“Tortoise SVN”的“Revert…”项进行撤销，本地硬盘上的文件将恢复到修改前的内容，修改的内容将被删除）
• 【check for modifications】检查更新（查看你没有提交的修改以及你对文件或目录的操作，点击检查版本库可以看到版本库里的改动）
• 【SVN update】SVN更新（当从配置库迁出相应目录后，他人对服务器上此目录内容进行了修改，则需要再次获取改动内容到本地目录的过程称为更新。更新可以针对一个文件、几个选中的文件或者整个文件目录）
  （1）选中要被更新的文件，右键选择“SVN update”。
  （2）点击“SVN update”后会弹出窗口显示更新的进度，若框中的有文件出现红色，说明来自配置库的内容与你本地修改内容合并时出现了冲突。
• 【SVN commit】SVN提交（将本地最新修改的文件同步到SVN服务端）
  （1）使用之前要先update一下，来确保是最新的，在修改的文件上右键，选择“SVN commit”
• 【show log】显示日志（查询谁，在什么时候，对那个目录下的那些文件进行了哪些操作）
• 【repo-browser】版本库浏览（浏览需要查看的资料库，还能看到哪些文件被谁锁定了）
• 【revision graph】版本分支图
• 【blame】追溯（查看是谁对文件做了修改以及修改了哪一行）
• 【import】导入（在项目导入版本库之前，先删除不需要的文件，组织好目录和子目录内的文件）
• 【export】导出（导出一个版本到本地，不带.svn隐藏目录，因此不受版本系统控制）
• 【get lock】获取锁定（如果你对一个文件获取锁定，其他用户的提交都会被拒绝，只有释放了锁，其他用户才能操作）
• 【release lock】解除锁定（解除文件或文件夹下所有文件的锁定）
• 【Branch/tag】创建分支（有时候我们不想沿着开发主线开发，而是试探性的添加一些新功能，就可以在主线上创建一个分支，在分支上开发，避免损坏原有的稳定版本。将来如果需要，可以将这些分支进行合并）
  （1）选中需要创建分支的文件或文件夹，右键选择“Tortoise SVN”，选择“Branch/tag”.

注意：.svn这个隐藏目录记录着两项关键的信息：工作文件的基准版本和一个本地副本最后更新的时间戳。千万不要手工修改或删除这个.svn隐藏目录里面的文件！！！否则将会导致你本地的工作拷贝被破坏，无法在进行操作。

SVN 的使用细节：

• 版本回退
  （1）查看项目代码的提交历史日志信息：右键->TortoiseSVN->show log
  （2）版本回退：右键->TortoiseSVN->update to revision（可以手动设置版本号：选中Revision，在输入框填写版本号，也可以点击show log选中一个版本，自动填入版本号）设置好要回退的版本号，点击OK进行版本回退。
  注意：版本回退功能仅用于查看历史版本代码或者获取历史版本代码，不能回退到历史版本后直接在历史版本基础上继续开发。版本回退之后，如果在历史版本中修改文件代码，然后提交，会提示错误，文件过期，需要先更新到最新版本再提交。
• 版本冲突（发生冲突之后，一定要解决冲突再提交）
  如果多个人对同一个文件做了修改，然后同时提交，后提交的人会发生代码覆盖的问题，这在SVN中就叫“版本冲突”。本质上是因为后提交的人，在其提交代码时代码的版本不是最新的，也就是其在一个历史版本提交了代码，引起了版本冲突。
  （1）根据需要，处理文件中的代码，保留最终需要留下并提交的代码。
  （2）选中冲突的文件，右键->TortoiseSVN->resolve解决冲突，这个操作是标记文件，表示这个冲突已经被处理，代码可以直接提交了。操作之后会自动把冲突产生的多余文件删除。
  （3）冲突处理完成，进行提交操作。

eclipse在SVN中的使用

• 安装SVN插件
  （1）打开eclipse，在help菜单中找到marketPlace，点击进入。
  （2）在搜索框Find中输入subclipse，点击右边的Go按钮查询；subclipse找到之后，点击右下角的按钮install安装。
  （3）选择需要安装的一些文件，默认全选即可，点击Next进行下一步操作。
  （4）统一许可协议，勾选“I accept the terms of the license agreements”，然后点击Finish完成即可。
  （5）安装过程中可能会出现一些提示，同意即可。
  （6）安装完成之后需要重启eclipse。

• SVN资源库
  （1）subclipse安装完成后，就可以使用SVN了。在Windows菜单中依次执行：show view->other
  （2）在弹出的show view对话框中检索SVN关键字，即可快速找到SVN资源库，选中，确定。
  （3）SVN资源库会出现在“问题视图窗口”。
  （4）在SVN资源库窗口的空白处单击鼠标右键，“新建”一个“资源库位置”。
  （5）添加新的SVN资源库，在位置“location”中输入正确的服务器地址，然后Finish即可。
  
  （6）输入用户名和密码，点击“保存密码”，以便下次更快速登录。

• 上传项目
  （1）选中需要上传的项目，右键选择Team下share project。
  （2）选择SVN资源库，点击next继续下一步。
  
  （3）选择SVN资源库中的文件夹名，或者可以使用指定的模块名，这个是已经在服务器指定好的，finish完成。
  

（4）右键单击项目，选择Team,先进行“更新”，再进行“提交”。
（5）提交地址，可以写入一些操作说明，点击OK。

• 下载项目
  （1）在SVN资源库已创建的服务器地址下，找到要下载的项目。
  （2）选中该项目，右键，选择“检出为…”。
  （3）选择作为工作空间中的项目检出，输入项目名称，为了保持一致性可以直接默认，然后finish。