SVN

使用环境

• 要想利用SVN管理源代码，必须得有2套环境

  服务器 用于存储客户端上传的源代码 可以在Windows上安装Visual SVN Server

• 客户端

  上传本地的源代码到服务器，或者更新服务器的代码到本地，保持同步 可以在Mac上使用命令行、Versions、Cornerstone、Xcode 开发人员就属于客户端这个角色

Visual SVN Server安装

创建代码仓库

添加用户

设置权限

访问SVN服务器

SVN客户端命令

• svn checkout ：下载服务器的代码到本地 （简写svn co）
• svn commit ：将改动的文件提交到服务器（简写svn ci）
• svn update ：更新服务器的代码到本地 （简写svn up）
• svn add ：向本地的版本控制库中添加新文件
• svn delete、svn remove ：从本地的版本控制库中删除文件（简写svn del、svn rm）
• svn move ：移动文件或者目录或文件更名
• svn mkdir ：创建纳入版本控制下的新目录
• svn revert ：撤销之前的一切修改
• svn merge ：将两个版本之间的差异合并到当前文件
• svn info ：查看文件的详细信息
• svn diff ：查看不同版本的区别
• svn log ：查看日志信息
• svn list ：列出版本库下的文件和目录列表
• svn status ：查看文件状态（简写svn st）
• svn help ：获取帮助信息（比如svn help ci）
• svn lock ：加锁
• svn unlock ：解锁

检出

• 将项目检出（下载） 至本地

    svn checkout URL  [PATH]
    svn co URL  [PATH]
    注意：这里的中括号[ ]代表可选（可以省略）
  

• 示例

    svn checkout  https://192.168.1.106/svn/Weibo/ /Users/Documents/workspace
    192.168.1.106/svn/Weibo/代表的是：代码仓库的远程地址
    /Users/Documents/workspace代表的是：将代码下载到本地的哪个路径
    如果省略目的的路径，就下载到命令行当前所在的路径
  

查看文件状态

svn status

svn st 显示的文件状态

第1列状态说明：描述文件被添加、删除或其他修改
--------------------------------------------------------------------------------
' ' 没有修改
'A' 被添加到本地代码仓库
'C' 冲突
'D' 被删除
'I' 被忽略
'M' 被修改
'R' 被替换
'X' 外部定义创建的版本目录
'?' 文件没有被添加到本地版本库内
'!' 文件丢失或者不完整（不是通过svn命令删除的文件）
'~' 受控文件被其他文件阻隔

提交

• 将改动过的文件提交至服务器

   svn commit  -m "注释"  [PATH]
   svn ci  -m "注释"  [PATH]
   注意：一定要养成写注释的良好习惯
  

• 示例

  svn commit  -m “修改了User.m文件” /Users/Desktop/workspace/Weibo/branches/User.m
  /Users/Desktop/workspace/Weibo/branches/User.m代表的是：提交哪个文件到服务器
  如果省略目的的路径，就将命令行所在路径中所有改动过的文件提交到服务器
  

添加

• 提交一个新建的文件到服务器，需要2个步骤

  • 添加新建的文件到本地的版本控制库中：svn add
  • 提交刚才的添加操作到服务器：svn commit

• 如果直接提交一个没有添加到本地版本控制库中的文件，会报下面的错误

   is not a working copy
  

• 向本地的版本控制库中添加一个新文件

  svn add PATH
  

示例

 svn add /Users/Desktop/workspace/Weibo/branches/User.m

/Users/Desktop/workspace/Weibo/branches/User.m代表的是：添加哪个文件到版本控制库中

删除

• 删除服务器上的某个文件，需要做2个步骤

  • 将文件从本地的版本控制库中移除：svn delete 、svn remove
  • 提交刚才的删除操作到服务器：svn commit

• 将文件从本地的版本控制库中移除

  svn delete PATH
  

示例

svn delete /Users/Desktop/workspace/Weibo/branches/User.m

/Users/Desktop/workspace/Weibo/branches/User.m代表的是：将哪个文件从版本控制库中移除

更新

• 将服务器的最新代码更新到本地

  svn update [PATH]
  

示例

  svn update /Users/lnj/Desktop/workspace/Weibo/branches/User.m

/Users/lnj/Desktop/workspace/Weibo/branches/User.m代表的是：更新哪个文件的内容 如果省略目的路径，就更新命令行所在路径的所有内容

• 将文件恢复至某个版本

  svn update -r 版本号 [PATH]
  

常见问题总结

• 去到公司的第一天，下载公司的代码到电脑上

  svn checkout
  

• 修改了某个早已存在的旧文件，然后提交到服务器

  svn commit
  

• 提交一个自己新建的文件到服务器

  svn add -> svn commit
  

• 删除一个早已存在的旧文件，然后同步到服务器上

  svn delete -> svn commit
  

• 将其他同事提交的新代码更新到自己电脑上

  svn update
  

• 不小心写错了很多东西，想撤销所写的东西（还未把修改提交到服务器）

  svn revert
  

• 不小心删错了文件，想把文件恢复回来（还未把删除提交到服务器）

  svn revert
  

• 不小心写错了很多东西，想撤销所写的东西（已经把修改提交到服务器）

  svn update -r 版本号
  

• 不小心删错了文件，想把文件恢复回来（已经把删除提交到服务器）

  svn update -r 版本号
  

注意！！！

• .svn这个隐藏目录记录着非常关键的信息
• 千万不要手工修改或删除这个 .svn隐藏目录和里面的文件！ 否则将会导致本地的工作副本被破坏，无法再进行操作

图形界面工具

• 在Mac上，也可以利用SVN图形界面工具来管理源代码，可以大大减小使用命令行的痛苦（有些操作使用命令行会比较繁琐，比如解决冲突）

  Cornerstone / Versions / Xcode
  

• 大部分工作在Xcode中都可以完成

  • Xcode对SVN的支持并不是非常友好,尤其新建文件夹时，在Xcode中非常容易出问题

• 使用Xcode工作：先更新，再提交!

  • Xcode中，最好不要多人同时修改一个Storyboard!

Cornerstone添加管理仓库

Xcode5-SVN配置

• 添加SVN地址

  Xcode 6 is in Xcode > Preferences > Accounts > Repositories (menu on the left) > (+) Add Repository
  

  

  Xcode6-SVN配置-添加SVN地址

  

  Xcode5-SVN配置-设置SVN账号

  

  Xcode5-下载服务器代码

  

目录规范

• 正规项目的SVN目录结构一般有3个文件夹

  • trunk：主干，当前开发项目的主目录
  • branches：分支目录，添加非主线功能时使用，开发测试之后，可以合并到主干项目中
  • tags：标记目录，通常作为重大版本的备份

使用SVN我们应该

• 经常更新：降低冲突的可能性
• 提交前需在本机测试通过：降低将问题代码传到版本库
• 提交时一定写备注(注释)：方便其他员工查看和自己以后回顾
• 对于不需要提交的文件不要提交到版本库

提示

每次修改之前最好先更新
每天下班前提交当天运行通过的代码
每天上班第一件事情更新前一天的代码

SVN

一：项目经理初始化项目 1.将服务器已经有的内容下载到本地

- svn checkout 服务器地址  （也可用svn checkout 服务器地址 --username=用户名 --password=密码   这样可以省去后面的输入操作）
- 输入电脑密码
- 输入用户名
- 输入账号

2.初始化项目

- 进入到工作目录
- 初始化项目
- 将初始化的项目提交到服务器

3.查看文件的状态 svn status

- ？：表示svn不识别该文件，或者该文件删除过，或者该文件是新添加的文件，还没有被本地代码仓库进行管理
- A ：表示文件已经被添加到本地仓库管理中，但是还未添加到服务器中（服务器仓库还未管理该文件）
- M：表示文件已经被管理，并且服务器也有该文件，修改的内容没有提交到服务器
- D：表示该文件已经在本地删除了，但是还没有将删除操作共享到服务器

4.将新的文件添加到代码仓库中

- svn add 文件名

5.将文件提交到服务器

- svn commit -m “注释”

6.个人的基本操作

- 修改
- 创建新的内容，将新的内容提交到服务器
- 删除一些文件（不可以直接删除，需要用命令行）
- 回退版本（会有很多冲突）

二：多人开发 1.张三将服务器的代码下载到本地 2.张三添加新的文件，将添加的内容更新到服务器 3.张三修改文件，提交到服务器 4.李四加入开发（新人）

- 拿到svn服务器的地址，和svn账号和密码

5.张三和李四的多人开发

三：命令

- svn checkout 将服务器完整的代码下载到本地（这个操作只会执行一次）
- svn add 文件 将文件交给svn本地仓库管理（xcode创建的文件会自动add到svn中）
- svn log 打印版本更新日志
- svn update -r 9（表示回退到第9个版本）

- svn commit -m “注释”
- svn update 更新

四：代码冲突

- 当张三修改了文件，并上传到服务器，但是李四这时候并没有更新代码，同时也修改同一个文件然后上传，这时候就会上传失败（因为版本号小于服务器版本号）
- 这时候我们需要svn update  当我更新之后救护出现Conflict冲突
    冲突之后会有一些选择（较为常见的解决冲突办法）
    -  (p) postpone（这里参照冲突代码示例）
                -  (mc) mine-conflict（当发生代码冲突的时候选择使用我的代码，会覆盖服务器的代码）直接打mc
    - (tc) theirs-conflict（当发生代码冲突的时候，使用服务器的代码，覆盖本地代码）直接打tc

五：冲突代码示例 <<<<<<< .mine

这里是我的代码
=======
这里是服务器的代码
>>>>>>> .r13（.r13表示仓库的版本）

解决办法：将<<<<<<< .mine，=======，>>>>>>> .r13全部删掉就可以了。
但是这时候我们的仓库还是有许多生成的代码冲突的个版本的文件，需要删除，必须要在命令行删除     (svn resolved 手动解决冲突后的文件)

什么时候不能提交代码：当本地的版本号小于服务器的版本号的时候不能提交

六：版本回退

- svn update -r 9（表示本地代码仓库回退到第9个版本）
- 但是这里本地回退，不能直接svn commit 到服务器，这里我们需要打开任意一个文件进行修改，修改之后才可以commit
- 因为版本比服务器版本低，所以还是不能上传，会产生冲突

七：图形化界面工具

- 初次添加之后会有不识别，将图形化界面强退之后就可以
- 图形化界面提交之后会有一些需要忽略的文件

图形化界面

• 安装

• 配置

HTTP地址配置

• checkout代码

初始化仓库

• 新建项目之后需要更新

• 新建项目需要添加到本地管理仓库

• 添加到本地仓库需要使用终端

• 终端代码

• 初次更新会出现不识别，这时候需要关闭SVN之后再重新打开就行

• 提交，可以再图形化界面，也可以在Xcode中提交

可在Xcode提交的过程中发现需要忽略的文档