01.源代码管理之SVN命令的使用,Cornerstone基本使

@(〓〓 iOS-实用技术)[代码管理 Git/SVN]

• 作者: Liwx
• 邮箱: 1032282633@qq.com

---

目录

• 01.源代码管理之SVN命令的使用,Cornerstone基本使用,Xcode Svn的使用
• 1.UNIX基本命令
  • 1.1 必学命令
  • 1.2 常用命令
  • 1.3 UNIX基本知识
  • 1.4 使用注意
• 2.掌握-SVN终端演练(个人开发)
  • 2.1 命令格式
  • 2.2 必学命令
• 3. SVN命令的使用
  • 3.1 项目经理初始化项目,并上传到SVN服务器
  • 3.2 程序猿从服务器下载一份完整代码到本地开始开发
  • 3.3 修改文件提交
  • 3.4 新建文件提交
  • 3.5 删除文件提交
  • 3.6 常用命令补充
  • 3.7 版本控制中,各个文件状态参考
  • 3.8 注意事项
• 4.SVN终端演练(多人开发)
  • 4.0 准备工作
  • 4.1 添加文件同步
  • 4.2 修改文件同步
  • 4.3 删除文件同步
  • 4.4 多人合作开发中的常见问题
• 5.版本回退
  • 5.1 版本回退概念以及原因?
  • 5.2 修改了,但未提交的情况下, 回退代码
  • 5.3 修改了,并且提交了的情况反悔
• 6.Cornerstone基本使用
  • 6.1 Cornerstone功能介绍
  • 6.2 Cornerstone checkout远程仓库远程仓库区域
  • 6.3 Cornerstone checkout远程仓库本地仓库区域
  • 6.4 忽略没必要提交的文件
• 7.Xcode管理SVN
  • 7.1 基本操作
  • 7.2 版本回退
  • 7.3 超时和冲突
    • 解决超时和冲突的问题
• 8.SVN目录规范
• 9.SVN 托管平台
  • 9.1 svnspot
  • 9.2 svnchina

---

1.UNIX基本命令

1.1 必学命令

• help [子命令] : 查看某一个具体的子命令的使用方法

1.2 常用命令

• cd path : 将当前路径切换到path路径
• pwd ：查看当前所在路径
• ls (-a / -l / -G) : 查看当前文件夹下所有文件及文件夹
• touch filename1 filename2 ： 创建一个或者多个文件
• rm filename : 删除文件
• open filename ：打开文件
• cat filename ：查看文件内容
• more filename ：分页查看文件内容
• mkdir 文件夹名称 ：创建一个文件夹
• mv oldFilePath newFilePath ：移动文件(可借助此命令给文件重命名)

1.3 UNIX基本知识

. 代表当前文件路径
.. 代表上级目录
以 .开头的文件,代表隐藏文件

• 显示隐藏文件
  defaults write com.apple.finder AppleShowAllFiles Yes && killall Finder
• 不显示隐藏文件
  defaults write com.apple.finder AppleShowAllFiles No && killall Finder

1.4 使用注意

• 命令和参数之间需要添加空格
• 如果要使用当前目录中的文件名，输入到一半时，按TAB键能够补全.

---

2.掌握-SVN终端演练(个人开发)

2.1 命令格式

• SVN命令格式

  命令行格式：
  svn <subcommand> [options] [args]
  svn 子命令 [选项] [参数]
  其中中括号里面的内容可以省略

2.2 必学命令

• SVN查询命令help

  svn [子命令] --help
  svn help [子命令]

---

3. SVN命令的使用

3.1 项目经理初始化项目,并上传到SVN服务器

• 1.1 方案1

- (1) 创建项目
- (2) `svn import [path] URL --username=用户名 --password=密码 -m "注释"`

• 1.2 方案2(推荐)

- (1) `svn checkout URL [path] --username=用户名 --password=密码` : 初始化本地仓库
- (2) 创建项目
- (3) 使用 `svn add` 命令将项目所有文件添加到本地版本控制
- (4) 使用 `svn commit` 提交本地项目到远程服务器

3.2 程序猿从服务器下载一份完整代码到本地开始开发

svn checkout URL [path] --username=用户名 --password=密码

3.3 修改文件提交

(1) 修改文件

(2) 使用svn commit -m "注释" : 提交本地文件到服务器

3.4 新建文件提交

(1) 新建文件
(2) 使用 svn add 命令将项目所有文件添加到本地版本控制
(3) 使用 svn commit -m "注释" : 提交本地项目到远程服务器

3.5 删除文件提交

一定不要手动删除文件
(1) svn remove filename 或者 svn delete filename 从本地版本控制以及对应文件删除
(2) svn commit -m "注释" : 提交本地操作到服务器, 使服务器也删除对应的文件

3.6 常用命令补充

1. svn status
   查看当前工作空间内, 所有 有变化的文件 的状态
   如果执行此命令什么都没输出, 代表本地没有东西要提交
2. svn log
   查看当前版本的操作日志(什么人, 什么时间, 做了什么操作)

3.7 版本控制中,各个文件状态参考

' ' 没有修改
'A' 被添加到本地版本控制
'C' 冲突
'D' 被删除(通过svn命令删除的文件）
'I' 被忽略
'M' 被修改
'R' 被替换
‘G’ 被合并
‘U’ 已经更新
‘E’ 已经存在
'X' 外部定义创建的版本目录
'?' 文件没有被添加到本地版本控制
'!' 文件丢失或者不完整（不是通过svn命令删除的文件）
'' 受控文件被其他文件阻隔

3.8 注意事项

• 任何本地的操作, 如果想让服务器也做同样的操作, 就直接通过 commit操作 提交到服务器
• 任何向服务器提交的操作,都要加注释 添加 -m参数

---

4.SVN终端演练(多人开发)

4.0 准备工作

CoderOne代表程序猿一,CoderTwo代表程序猿二

CoderOne和CoderTwo,分别使用svn checkout URL [path] --username=用户名 --password=密码命令初始化本地版本控制库

4.1 添加文件同步

• 1.CoderOne创建文件并提交到服务器

svn add fileName
svn commit -m "新增文件"

• 2.CoderTwo从服务器更新文件

svn update

4.2 修改文件同步

• 1.CoderOne修改文件并提交到服务器

svn commit -m "修改文件"

• 2.CoderTwo从服务器更新文件

svn update

4.3 删除文件同步

• 1.CoderOne删除文件并提交到服务器

svn delete fileName
svn commit -m "删除文件"

• 2.CoderTwo从服务器更新文件

svn update

4.4 多人合作开发中的常见问题

---

• 1.问题一 : 超时

  • 问题描述:

  当本地文件版本小于服务器文件版本时, 如果要提交本地文件,就会报 out of date 超时错误

  • 产生原因:

  SVN通过版本号管理每一个文件,如果一个文件被修改并提交到服务器,那么服务器上的对应文件版本号就会加1, 如果你的版本号小于服务器版本号,就说明,肯定有别人在后来又修改了那个文件

  • 解决方案:

  针对于超时问题,对应的解决方案,就是先从服务器更新下最新版本, 保证本地版本号与服务器版本号一致,这是文件可以提交的前提

---

• 2.问题二 : 冲突

  • 问题描述:

  为了解决超时问题,只能更新.而在更新过程中,如果几个人修改了同一文件的同一行代码,此时就会产生冲突

  • 产生原因:

  版本控制器不会那么智能, 去决定应该使用谁的代码作为最终代码,只能将选择权抛给用户,让用户解决

  • 解决方案:

  系统提供三种解决方案:
  (p) postpone,
  延迟处理(待会我自己处理), 如果选择这一种, 会自动生成三个文件供用户参考决策. 并将冲突部分代码块合并到一起. 而一旦解决完毕, 需要执行 svn resolved fileName 来告诉版本控制器已经解决, 然后版本控制器就会自动删除三个参考文件

  (mc) mine-conflict
  使用我的(本地的), 如果代码产生冲突, 则以本地代码为准

  (tc) theirs-conflict
  使用他人的(服务器), 如果代码产生冲突, 则以服务器代码为准

<<<<<<< .mine
    此处代表是我的代码
=======
    此处代表服务器代码
>>>>>>> .r7

---

5.版本回退

5.1 版本回退概念以及原因?

概念: 是指将代码(本地代码或者服务器代码), 回退到之前记录的某一特定版本
原因: 如果代码做错了, 想返回之前某个状态重做;

---

5.2 修改了,但未提交的情况下, 回退代码

方案1: (大力推荐)
svn revert (作用:返回到上次提交后版本对应的最原始的状态)

方案2: (不推荐)
删除整个项目,重新checkout

---

5.3 修改了,并且提交了的情况反悔

• 方案1: 大力推荐

  • svn update
    (作用: 将本地代码更新到与服务器相同的版本)
  • svn merge 文件名 -r 版本1:版本2
    (作用: 把版本1 -> 版本2 的 diff 作用在当前版本)
  • svn commit -m “本地和服务器都回退到某一指定版本”
    (作用: 让服务器代码也退回到之前某个版本状态)

• 方案2:

  • svn update -r 指定版本号(此时本地代码已经变化,但是服务器没有改变)
    --------以下步骤是为了让服务器代码也回滚到以前的版本----------
  • 修改部分文件
  • svn update (此时会产生冲突, 选择使用自己的代码即可)
  • 再次提交代码

• 方案3:

  • 手动保存需要回退的文件内容
  • 删除文件,提交到服务器
  • 重新添加文件,上传到服务器

---

6.Cornerstone基本使用

• 1.掌握如何添加远程代码仓库的关联
• 2.掌握如何checkout, 下载服务器代码, 以及初始化本地版本控制库
• 3.掌握如何新建文件提交, 修改文件提交, 删除文件提交
• 4.掌握版本日志查看, 以及了解版本回退
• 5.掌握多人开发中的超时问题和冲突问题的解决

6.1 Cornerstone功能介绍

• 1.Cornerstone界面区域
  • 1.顶部工具条区域
    • 对应svn命令: checkout(检出),tag(重要版本备份),branch(分支),revert(重置),update(更新),commit(提交),merge(合并),import(导入),export(导出)
  • 2.本地仓库区域
  • 3.远程仓库区域
  • 4.选中仓库区域
  • 5.底部工具条区域
    • 对应svn命令: add(添加),resolved(解决冲突),log(查看日志)
    • Timeline: 各版本的内容比较

01.Cornerstone功能介绍.png

---

• 2.顶部工具条

02.顶部工具条.png

---

• 3.底部工具条

03.底部工具条.png

---

6.2 Cornerstone checkout远程仓库远程仓库区域

• checkout远程仓库到远程仓库区域

04.checkout远程仓库远程仓库区域.png

---

6.3 Cornerstone checkout远程仓库本地仓库区域

• checkout远程仓库到本地仓库区域

05.checkout远程仓库本地仓库区域.png

6.4 忽略没必要提交的文件

• 开发经验: 最好忽略没必要提交的文件

  • 过滤不需要上传的文件, 忽略文件(xcuserdata文件夹)

  文件打开状态
  断点信息
  文件夹关闭打开状态

  • 注意:projct setting文件不要忽略

  存放一些文件顺序和文件夹结构,文件引用等信息

---

• 忽略或删除文件操作

06.忽略或删除文件操作.png

---

7.Xcode管理SVN

• 1.掌握怎样添加远程代码仓库的关联
• 2.掌握怎样checkout, 下载服务器代码, 以及初始化本地版本控制库
• 3.掌握怎样新建文件提交, 修改文件提交, 删除文件提交
• 4.掌握版本日志查看, 以及了解版本回退
• 5.掌握多人开发中的超时问题和冲突问题的解决

---

7.1 基本操作

• 1.管理帐号
  • command + ,选中Account

07.管理帐号.png

---

• 2.Xcode checkout项目操作
  • 打开Xcode选中Source Control/Check out,选中以上配置项目
  • 根据提示保存到本地文件夹中

08.Xcode checkout项目操作.png

---

• 3.Xcode版本比较,责任追究,日志查看

09.Xcode版本比较,责任追究,日志查看.png

• 4.XCode SVN提交

10.XCode SVN提交.png

• 5.Xcode中的Source Control介绍

11.Source Control介绍.png

---

7.2 版本回退

---

• 1.单个文件版本回退

12.单个文件版本回退.gif

---

7.3 超时和冲突

解决超时和冲突的问题

• 超时提示: 当修改完文件,使用Xcode中的Source Control/Commit提交时弹出以下提示表示超时up to date

13.超时提示.png

• 解决超时方案

1.先更新Update

14.更新操作.png

2.更新完后,弹出冲突提示

15.冲突提示.png

3.根据实际情况选择对应的冲突解决方案

16.冲突解决方案.png

4.最后修改完冲突后,点击Update提交到服务器,必须填写提交信息,否则无法提交.

---

8.SVN目录规范

• 1.文件目录作用?

  • trunk : 主干，当前开发项目的主目录;
    我们之前更新代码，提交代码都是在这个文件夹进行操作
  • brannches:分支目录
    添加非主线功能时使用，开发测试之后，可以合并到主干项目中。修复Bug，研发不确定的新功能都在这里做
  • tags:标记目录，通常作为重大版本的备份；
    如果有发布版本出现Bug，可以快速的找到对应版本的项目备份，然后开一个分支，进行Bug修复，用于与主干区分

• 2.掌握利用图形客户端版本备份流程

• 3.了解已发布版本bug解决流程

---

9.SVN 托管平台

9.1 svnspot

链接: http://code.svnspot.com

9.2 svnchina

链接: http://www.svnchina.com