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

作者: JonesCxy | 来源:发表于2016-09-28 09:27 被阅读637次

    源代码管理工具的起源

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

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

    源代码会引发哪些问题?

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

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

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

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

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

    追究责任:出现了严重的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
    

    相关文章

      网友评论

        本文标题:重点 (十九) : 源代码:SVN

        本文链接:https://www.haomeiwen.com/subject/keyhyttx.html