重点 (十九) : 源代码:SVN

源代码管理工具的起源

为什么会出现源代码管理工具?

为了解决在软件开发过程中,由源代码引发的各种蛋疼、繁琐的问题

源代码会引发哪些问题?

无法后悔:做错了一个操作后,没有后悔药可以吃

版本备份:费空间、费时间

版本混乱:因版本备份过多造成混乱,难于找回正确的想要的版本

代码冲突:多人操作同一个文件(团队开发中的常见问题)

权限控制:无法对源代码进行精确的权限控制

追究责任:出现了严重的BUG,无法得知是谁干的,容易耍赖

… …

源代码管理工具就是为了解决上述问题而生的!此乃软件开发的一大福音!

源代码管理工具的作用

概括一下,源代码管理工具的作用是

能追踪一个项目从诞生一直到定案的过程

记录一个项目的所有内容变化

方便地查阅特定版本的修订情况

… …

现在就开始使用源代码管理工具

如果是团队开发,使用源代码管理工具是强制性的!

如果是单人开发,也强烈建议现在就开始使用源代码管理工具

使用源代码管理工具

由于使用简单,不会增加工作量

不会对现有工作造成任何损害(坏的影响)

是一位合格的软件开发人员必须掌握的技术

常见的源代码管理工具

CVS

开启版本控制之门

1990年诞生,“远古时代”的主流源代码管理工具

SVN

全称是Subversion,集中式版本控制之王者

是CVS的接班人,速度比CVS快,功能比CVS多且强大

在国内软件企业中使用最为普遍(70%~90%)

GIT

一款伟大的分布式源代码管理工具

目前被越来越多的开源项目使用

不过在国内企业尚未大范围普及

SVN:

主要内容

基本操作

服务器端按照配置

客户端软件使用

与Xcode的集成

1.png

checkout:是将服务器的代码下载到本地(下载所有文件一般只需要一次操作)

(只提交更改过的,每天下班之前记得commit一次,"可运行版本",这就是大多程序员加班的原因,修改bug)

update:是将服务器上的代码更新到本地(只会更新被修改过的)

commit:是将本地修改之后的文件提交到服务器

注意:终端里面用[]扩住的说明是可选的


2.png
3.png

SVN版本控制策略

版本控制策略核心思想就是:拷贝-修改-合并 方案(svn,cvs采用)


4.png

其他版本控制策略

其他版本控制策略核心锁定-修改-解锁方案(vss)

缺点:不能并行开发

使用环境

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

服务器

用于存储客户端上传的源代码

可以在Windows上安装Visual SVN Server

大部分情况下,公司的开发人员不必亲自搭建SVN服务器

客户端

上传本地的源代码到服务器,或者更新服务器的代码到本地,保持同步

可以在Mac上使用命令行、Versions、Cornerstone

开发人员就属于客户端这个角色

Visual SVN Server下载地址
Visual SVN Server下载地址
http://www.visualsvn.com/server/download/

5.png

6.png

7.png

8.png

9.png

10.png

11.png

12.png

13.png

14.png

15.png

16.png

17.png

18.png

19.png

20.png

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/lnj/Documents/workspace
蓝色代表的是:代码仓库的远程地址
橙色代表的是:将代码下载到本地的哪个路径
如果省略橙色的路径,就下载到命令行当前所在的路径

提交
将改动过的文件提交至服务器
svn commit -m "注释" [PATH]
svn ci -m "注释" [PATH]
注意:一定要养成写注释的良好习惯

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

添加
提交一个新建的文件到服务器,需要2个步骤
添加新建的文件到本地的版本控制库中:svn add
提交刚才的添加操作到服务器:svn commit

如果直接提交一个没有添加到本地版本控制库中的文件,会报下面的错误
is not a working copy

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

示例
svn add /Users/lnj/Desktop/workspace/Weibo/branches/User.m
橙色代表的是:添加哪个文件到版本控制库中

删除
删除服务器上的某个文件,需要做2个步骤
将文件从本地的版本控制库中移除:svn delete 、svn remove
提交刚才的删除操作到服务器:svn commit

将文件从本地的版本控制库中移除
svn delete PATH

示例
svn delete /Users/lnj/Desktop/workspace/Weibo/branches/User.m
橙色代表的是:将哪个文件从版本控制库中移除

更新
将服务器的最新代码更新到本地
svn update [PATH]

示例
svn update /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!

1.png

2.png

3.png

4.png

5.png

6.png

7.png

8.png

9.png

目录规范

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

trunk:主干,当前开发项目的主目录

branches:分支目录,添加非主线功能时使用,开发测试之后,可以合并到主干项目中

tags:标记目录,通常作为重大版本的备份

SVN目录使用-案例

某团队计划开发一款”陌陌”项目

此项目初期已经有部分基础代码

研发团队在此基础代码上经过3个月的努力,开发了一个功能相对完备的V1.0版本上线推广,并取得了良好的效果(备份到Tags)

由于市场反馈良好,团队开始着手V2.0版本的开发工作

就在V2.0版本开发进行中,发现V1.0版本中有一个严重的BUG,如果不及时修改,将造成严重的后果

研发团队收到BUG报告后,立刻安排人员对V1.0版本进行修复,但其他研发人员则继续开发V2.0版本的新功能

修复BUG的人员很快就找到问题原因并对问题进行了修复,并且发布了V1.1版本供用户升级,因此没有造成重大损失

BUG修复后,研发人员将修复后的代码整合到研发主线中来,这样就可以保证今后发布的后续版本中不会再出现此问题

就这样,整个团队在大家的共同努力下,有条不紊地进行着……

1.png

2.png

3.png

4.png

5.png

演练步骤……

项目经理准备初期代码

LNJ和Jonathan合力完成V1.0的开发工作

为完成后的V1.0建立Tags标签,注意文件夹的层次

接收到Bug报告,LNJ停止手头工作并备份

经理负责建立修订分支,并通知LNJ去解决

LNJ从修订分支CheckoutV1.0的版本,并开始修订错误

LNJ修订完成后通知经理

经理确认之后,将修订内容整合到2.0开发主线

经理建立V1.1标签

LNJ继续开发工作...

1.png

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

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

**********************笔记***********************


一. 了解-源代码管理工具概述

  1. 源代码管理工具的作用?

能追踪一个项目从诞生一直到定案的过程
记录一个项目的所有内容变化,无限制返回
查看特定版本的修订情况

  1. 常见的源代码管理工具有哪些?

CVS

  • 开启版本控制之门
  • 1990年诞生,“远古时代”的主流源代码管理工具

SVN

  • 全称是Subversion,集中式版本控制之王者
  • 是CVS的接班人,速度比CVS快,功能比CVS多且强大
  • 在国内软件企业中使用最为普遍(70%-90%)

GIT

  • 一款伟大的分布式源代码管理工具
  • 目前被越来越多的开源项目使用
  • 不过在国内企业尚未大范围普及
  1. 集中式和分布式的区别
  2. 集中式和分布式资料链接
  3. 集中式和分布式资料链接
  4. 集中式和分布式资料链接

二. 掌握-SVN的基本介绍

  1. 工作场景
    进入公司需要做的关于开发的第一件事, 就是向项目经理索要SVN服务器地址+用户名+密码
  2. 角色解释

服务器: 用于存放所有版本的代码,供客户端上传下载更新
客户端: 通过客户端下载上传本地代码
用户名/密码: 验证人员身份,判断是否有操作权限;

  1. 项目开发中的基本操作
  1. 项目经理初始化项目结构并上传到服务器
  2. 苦逼程序猿根据地址+用户名+密码下载一份完整代码到本地
  3. 开始开发,任务完成后,提交任务代码到服务器
  4. 从服务器上更新其他同事的代码到本地
  1. 以上操作对应到SVN操作体现
  1. svn import (项目经理做的)
  2. svn checkout : 将服务器所有代码下载到本地
  3. svn commit : 提交本地最新代码到服务器
  4. svn update : 从服务器更新最新被修改的代码
  1. 版本控制策略(补充)

svn : 更新-修改-合并

  • 弊端:合并时容易产生冲突

其他版本控制策略: 锁定-修改-解锁

  • 弊端:不能并行开发

三. 了解-SVN服务器配置
1.服务器作用

用于存储/备份各个版本的代码
供客户端下载/上传/删除代码

2.服务器环境搭建
Mac 下直接配置(Mac 下安装SVN), (Mac下配置SVN 服务器)
Windows下安装Visual SVN Server(Visual SVN Server下载地址)

因为作为新人进到公司无法接触服务器,而且大部分公司都是使用windows 作为服务器,所以此处只讲第二种,作学习测试使用!

3.安装步骤

全程”下一步”,傻瓜式安装.

4.控制区几个选项的作用

Repository

  • 代码仓库:存放不同版本的代码

Users

  • 用户列表:创建或者删除用户,代码仓库设置访问权限时使用

Groups

  • 分组列表:将用户分组,可以针对每组进行代码仓库访问授权操作
    访问测试

5.> 可以通过浏览器,输入代码仓库地址进行访问

  • 注意:在客户端浏览器访问时,注意地址需要使用对应的IP地址,不能使用计算机名称.
    操作补充

6.在windows下面查看ip 地址
开始 —> 运行 cmd
在命令行里面 运行 ipconfig

四. 掌握-UNIX基本命令

  1. 必学命令
    help [子命令] : 查看某一个具体的子命令的使用方法

  2. 常用命令

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

以 .开头的文件,代表隐藏文件

  • 显示隐藏文件
    defaults write com.apple.finder AppleShowAllFiles Yes && killall Finder
  • 不显示隐藏文件
    defaults write com.apple.finder AppleShowAllFiles No && killall Finder
  1. 使用注意
    1> 命令和参数之间需要添加空格
    2> 如果要使用当前目录中的文件名,输入到一半时,按TAB键能够补全

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

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

  2. 必学命令
    svn [子命令] --help
    svn help [子命令]

  3. 实战演练
    项目经理初始化项目,并上传到SVN服务器

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

方案2:
(1) svn checkout URL [path] --username=用户名 --password=密码 : 初始化本地仓库
(2) 创建项目
(3) 使用 svn add 命令将项目所有文件添加到本地版本控制
(4) 使用 svn commit 提交本地项目到远程服务器
程序猿从服务器下载一份完整代码到本地开始开发

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

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

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

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

6.常用命令补充

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

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

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

六. 掌握-SVN终端演练(多人开发)
1.准备工作
熊大和熊二,分别通过
svn checkout URL [path] --username=用户名 --password=密码
命令初始化本地版本控制库

    2.添加文件同步        
    1. 熊大创建文件并提交到服务器
    svn add fileName
    svn commit -m "新增文件"
    2. 熊二从服务器更新文件
    svn update

    3.修改文件同步
    1. 熊大修改文件并提交到服务器
    svn commit -m "修改文件"
    2. 熊二从服务器更新文件
    svn update
    
    4.删除文件同步
    1. 熊大删除文件并提交到服务器
    svn delete fileName
    svn commit -m "删除文件"
    2. 熊二从服务器更新文件
    svn update

    5.多人合作开发中的常见问题
    * 问题一 : 超时
    问题描述:
    当本地文件版本小于服务器文件版本时, 如果要提交本地文件,就会报 out of date 超时错误
    产生原因:
    SVN通过版本号管理每一个文件,如果一个文件被修改并提交到服务器,那么服务器上的对应文件版本号就会加1, 如果你的   
    版本号小于服务器版本号,就说明,肯定有别人在后来又修改了那个文件
    
    解决方案:
    针对于超时问题,对应的解决方案,就是先从服务器更新下最新版本, 保证本地版本号与服务器版本号一致,这是文件可以
          提交的前提
    
    * 问题二 : 冲突
    问题描述:
    为了解决超时问题,只能更新.而在更新过程中,如果几个人修改了同一文件的同一行代码,此时就会产生冲突
    产生原因:
    版本控制器不会那么智能, 去决定应该使用谁的代码作为最终代码,只能将选择权抛给用户,让用户解决
    解决方案:
    系统提供三种解决方案:
    (p) postpone,
    延迟处理(待会我自己处理), 如果选择这一种, 会自动生成三个文件供用户参考决策. 并将冲突部分代码块合并到一起. 
          而一旦解决完毕, 需要执行 svn resolved fileName 来告诉版本控制器已经解决, 然后版本控制器就会自动删除三   
    个参考文件

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

    (tc) theirs-conflict
    使用他人的(服务器), 如果代码产生冲突, 则以服务器代码为准
    
    
    <<<<<<< .mine
    此处代表是我的代码
    =======
    此处代表服务器代码
    >>>>>>> .r7

七. 了解-SVN终端演练-版本回退
1.版本回退概念以及原因?

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

    2.修改了,但未提交的情况下, 回退代码        
    方案1: (大力推荐)
    svn revert (作用:返回到上次提交后版本对应的最原始的状态)
    
    方案2: (不推荐)
    删除整个项目,重新checkout

    3.修改了,并且提交了的情况反悔        
    方案1: 大力推荐
    - svn update
    (作用: 将本地代码更新到与服务器相同的版本)
    - svn merge 文件名 -r 版本1:版本2
    (作用: 把版本1 -> 版本2 的 diff 作用在当前版本)
    - svn commit -m “本地和服务器都回退到某一指定版本”
    (作用: 让服务器代码也退回到之前某个版本状态)
    
    方案2:
    - svn update -r 指定版本号(此时本地代码已经变化,但是服务器没有改变)
    *--------以下步骤是为了让服务器代码也回滚到以前的版本----------*
    - 修改部分文件
    - svn update (此时会产生冲突, 选择使用自己的代码即可)
    - 再次提交代码
    
    方案3:
    - 手动保存需要回退的文件内容
    - 删除文件,提交到服务器
    - 重新添加文件,上传到服务器

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

    九. 掌握-Xcode管理SVN
    掌握怎样添加远程代码仓库的关联
    掌握怎样checkout, 下载服务器代码, 以及初始化本地版本控制库
    掌握怎样新建文件提交, 修改文件提交, 删除文件提交
    掌握版本日志查看, 以及了解版本回退
    掌握多人开发中的超时问题和冲突问题的解决
    开发经验: 最好忽略没必要提交的文件
    
    ** 过滤不需要上传的文件, 忽略文件(xcuserdata文件夹)**
    > 文件打开状态
    > 断点信息
    > 文件夹关闭打开状态
    ** 注意:projct setting文件不要忽略 **
    > 存放一些文件顺序和文件夹结构,文件引用等信息
    十. 了解-SVN目录规范
    1.文件目录作用?
    
    trunk : 主干,当前开发项目的主目录;
    我们之前更新代码,提交代码都是在这个文件夹进行操作
    brannches:分支目录
    添加非主线功能时使用,开发测试之后,可以合并到主干项目中。修复Bug,研发不确定的新功能都在这里做        
    tags:标记目录,通常作为重大版本的备份;
    如果有发布版本出现Bug,可以快速的找到对应版本的项目备份,然后开一个分支,进行Bug修复,用于与主干区分

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

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

    十一. 了解-SVN 托管平台
    1. svnspot
    http://code.svnspot.com
    2. svnchina
    http://www.svnchina.com

推荐阅读更多精彩内容