IOS-源代码管理工具(SVN)

一、使用环境

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

服务器

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

可以在Windows上安装Visual SVN Server

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

 

客户端

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

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

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

 

Visual SVN Server下载地址

http://www.visualsvn.com/server/download/

 

 

二、Visual SVN Server安装

 

 

 

 

 

 

 

 

 

三、SVN 使用

 

1.创建代码仓库

 

 

 

 

2.添加用户

 

3.设置权限

 

4.访问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 ：解锁

 

 

四、命令使用

 

1.检出

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

svn checkout URL  [PATH]

svn co URL  [PATH]

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

示例

svn checkout  https://192.168.1.106/svn/Weibo/ /Users/lnj/Documents/workspace

蓝色代表的是：代码仓库的远程地址

橙色代表的是：将代码下载到本地的哪个路径

如果省略橙色的路径，就下载到命令行当前所在的路径

 

2.提交

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

svn commit  -m "注释"  [PATH]

svn ci  -m "注释"  [PATH]

注意：一定要养成写注释的良好习惯

示例

svn commit  -m “修改了User.m文件” /Users/lnj/Desktop/workspace/Weibo/branches/User.m

橙色代表的是：提交哪个文件到服务器

如果省略橙色的路径，就将命令行所在路径中所有改动过的文件提交到服务器

 

3.添加

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

添加新建的文件到本地的版本控制库中：svn add

提交刚才的添加操作到服务器：svn commit

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

is not a working copy

 

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

svn add PATH

示例

vn add /Users/lnj/Desktop/workspace/Weibo/branches/User.m

p橙色代表的是：添加哪个文件到版本控制库中

 

4.删除

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

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

提交刚才的删除操作到服务器：svn commit

 

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

svn delete PATH

 

示例

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

橙色代表的是：将哪个文件从版本控制库中移除

 

 

5.更新

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

svn update [PATH]

 

示例

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

橙色代表的是：更新哪个文件的内容

如果省略橙色的路径，就更新命令行所在路径的所有内容

 

将文件恢复至某个版本

svn update -r 版本号 [PATH]

 

6.常见问题总结

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

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.Cornerstone添加管理仓库

 

 

2.Xcode5-SVN配置

1>添加SVN地址

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

 

 

 

 

2>Xcode5-下载服务器代码

 

 

 

目录规范

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

trunk：主干，当前开发项目的主目录

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

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

 

 

笔记

 .    源代码管理工具概述(PPT)
 ================================================================================

 * 源代码管理工具的作用：
 # 能追踪一个项目从诞生一直到定案的过程
 # 记录一个项目的所有内容变化
 # 方便地查阅特定版本的修订情况

 * 如果是团队开发，使用源代码管理工具是强制性的！
 * 如果是单人开发，也强烈建议现在就开始使用源代码管理工具

 * 使用源代码管理工具
 # 由于使用简单，不会增加工作量
 # 不会对现有工作造成任何损害（坏的影响）
 # 是一位合格的软件开发人员必须掌握的技术

 .    SVN介绍(PPT)
 ================================================================================

 SVN 是集中式源代码管理工具

 概念：
 > Repository   代码仓库，保存代码的仓库
 > Server       服务器，保存所有版本的代码仓库
 > Client       客户端，只保存当前用户的代码仓库
 > 用户名&密码   访问代码仓库需要使用自己的"用户名和密码"，从而可以区分出不同的人对代码做的修改

 操作：
 > checkout     将服务器上最新的代码仓库下载到本地，"只需要做一次"
 > update       从服务器上将其他人所做的修改下载到本地，"每天上班必须要做的事情"
 > commit       将工作提交到服务器，"每天下班之前至少做一次"

 .    SVN服务器安装 Visual SVN Server
 ================================================================================
 提示：一般程序员是没有机会安装SVN服务器的，以下内容仅供了解服务器上的安装及配置过程

 * Visual SVN Server 是运行在windows操作系统上的，集成了Subversion和Apache
 * 傻瓜式安装一步到位，并提供了图形化界面，安装简单配置方便
 * 下载地址：http://www.visualsvn.com/server/download/

 >  安装
 *   程序目录
 *   代码仓库目录

 >  添加代码仓库"weibo"
 *   暂时不勾选默认结构(trunk, branches, tags)

 >  添加用户
 *   为了方便后续的演练，每个用户的口令不要设置成一样
 #   用户名     口令
 #   manager   jingli
 #   zhangsan  zhang
 #   lisi      li

 >  添加群组，通过群组可以一次性设置多个用户对代码仓库的访问权限，便于管理

 >  设置权限演练
 *   选中项目的代码库，点击右键，选择"Properties"

 >  协议
 *   https   端口
 *   http    端口 

 >  协议的修改
 *   选中"VisualSVN Server"，点击鼠标右键，选择"Properties"
 *   选择"Network"，勾选"Use secure connection"会使用https协议访问服务器的代码仓库

 补充：HTTPS = HTTP + SSL
 注意：有关https的概念暂时不要纠结，有一个印象就可以！后面课程安全部分会讲到！
 --------------------------------------------------------------------------------
 HTTPS(Hyper Text Transfer Protocol over Secure Socket Layer)是以安全为目标的HTTP通道，
 简单讲是HTTP的安全版

 HTTPS提供了身份验证与加密通讯方法，现在被广泛用于互联网上安全敏感的通讯，例如交易支付方面

 HTTPS的证书需要申请认证，这一认证是付费的，认证网站 http://cn.globalsign.com/

 >  使用浏览器浏览代码仓库
 如果使用了https协议，在不同的浏览器中访问，显示效果会不太一样

 .    SVN演练准备
 ================================================================================

 >  显示隐藏文件夹
 # 显示隐藏文件
 $ defaults write com.apple.finder AppleShowAllFiles Yes && killall Finder
 # 不显示隐藏文件
 $ defaults write com.apple.finder AppleShowAllFiles No && killall Finder

 >  在桌面上新建一个文件夹 "svn演练"
 依次建立以下三个目录
 #   经理
 #   张三
 #   李四

 .    命令行准备
 ================================================================================

 熟悉命令行的目的：所有图形工具本质上都是对命令行的封装，理解命令行的操作，更有助于对图形工具的使用

 >  SVN基本命令
 命令行格式：
 svn <subcommand> [options] [args]
 说明
 svn 子命令 [选项] [参数]

 提示：
 #   [中括号]中包含的内容是可选的
 #   (子命令缩写)

 >  查看帮助信息

 $ svn help
 查看svn所有命令的帮助
 $ svn help 子命令

 >  UNIX常用命令介绍(UNIX常用命令.m)

 .    将服务器文件下载到本地
 ================================================================================

 # 切换工作目录
 $ cd 经理的工作目录
 # checkout服务器上的代码仓库
 $ svn co http://10.0.1.15/svn/weibo --username manager --password jingli

 提示：checkout(co)之后，本地代码库中会记录用户名和密码，后续操作不用再另行指定

 .    经理添加文件
 ================================================================================

 * svn 常用命令
 --------------------------------------------------------------------------------
 # 查看本地代码库状态
 $ svn st
 错误提示："is not a working copy"，必须在svn的工作目录下才能正确使用svn的命令
 # 查看svn日志
 $ svn log
 # 查看某一个文件的日志
 $ svn log filename
 # 查看某一个文件某个版本的日志
 $ svn log filename@

 * 创建文件
 --------------------------------------------------------------------------------
 # 切换到工作目录
 $ cd weibo
 # 创建文件
 $ touch main.c
 # 打开并编写文件内容
 $ open main.c

 * 将文件提交到服务器
 --------------------------------------------------------------------------------
 # 查看工作目录状态
 $ svn st
 # 将文件添加到本地版本库中
 $ svn add main.c
 # 将文件提交到服务器的版本库中
 $ svn ci -m "添加了main.c文件"

 "小结" - 添加文件的两个步骤
 --------------------------------------------------------------------------------
 >  将新建的文件添加到本地代码库
 $ svn add main.c
 >  将刚刚添加的文件提交到服务器
 $ svn ci -m "备注信息"

 注意：一定要养成写注释的良好习惯

 .    团队成员加入
 ================================================================================

 >  张三
 $ svn co http://10.0.1.15/svn/weibo --username=zhangsan --password=zhang
 >  李四
 $ svn co http://10.0.1.15/svn/weibo --username=lisi --password=li

 "小结" 至此，一个项目的搭建工作就告一段落了
 > 项目准备工作，通常由项目经理完成
 > 程序员只需要把项目 co 到本地即可

 提示：新入职一家公司后，别忘记让经理分配 svn 的账号和密码

 .    张三添加文件
 ================================================================================

 # 添加文件 Person.h Person.m
 $ touch Person.h Person.m
 # 修改 Person.h Person.m
 $ open Person.h
 $ open Person.m
 # 将 Person.h Person.m 添加到本地代码库
 $ svn add Person.*
 # 将内容提交到服务器
 $ svn ci -m "添加了Person类"

 . 删除文件
 ================================================================================

 # 删除文件
 $ svn rm Person.h
 # 提交删除
 $ svn ci -m "删除了文件"

 注意：不要使用文件管理器直接删除文件

 . 撤销修改
 ================================================================================
 $ svn revert Person.m

 . 恢复到之前的某个版本
 ================================================================================
 $ svn up

 . 冲突解决
 (p) postpone            对比
 (mc) mine-conflict      使用我的
 (tc) theirs-conflict    使用对方的

 svn st 显示的文件状态

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

 .    安装CornerStone
 ================================================================================

 . 具体操作
 ================================================================================
 >  添加远程代码仓库
 >  到处代码库到本地
 >  在本地目录下使用Xcode新建项目
 注意：不要勾选 git，两套源代码管理同时存在会发生冲突

 >  升级SVN版本库
 >  退出Xcode
 >  在CornerStone中忽略个人用户文件"xcuserdata"，否则每次都要提交，非常繁琐！
 提示：xcuserdata目录中为保留用户上次打开的文件，调试设置的断点等信息

 >  在CornerStone中提交项目

 >  其他用户操作

 .    SVN演练
 ================================================================================

 >  修改文件
 >  修改Storyboard
 >  合并冲突（仅在两个人同时修改一行代码时，才会出现冲突）

 

 一次检出：
 》进入经历文件夹
 》输入svn checkout指令
 》输入电脑密码
 》输入用户名
 》输入密码
 》检出成功

 第二次检出：
 》进入小涛文件夹
 》输入svn checkout指令
 》检出成功

 只要输入过一次账号密码后， 终端会自动记录我们的密码

 通过指定的账号密码检出
 svn checkout http://192.168.15.155/svn/weibo/ --username=ls --password=ls

 SVN的本质是通过一个文件夹来管理源代码

 默认情况下， 用于管理源代码的文件夹是隐藏的， 这个隐藏文件夹的名称叫做.svn

 注意： 新建文件或文件夹之后如果直接提交（直接commit）会报如下错误：

 is not under version control

 该错误的含义是： 提示我们提交的文件没有纳入版本控制

 注意： 在提交代码时必须写上注释（认真写）， 否则回报如下错误

 Could not use external editor to fetch log message;

 注意： svn add只会将文件添加到本地， 不会添加到服务器

 注意：如果说利用SVN管理源代码， 就不能直接在项目中删除源文件

 如果修改文件之后， 并且文件没有“提交“（commit） 想反悔，可以使用SVN的 revert指令让文件回到上一次提交时的状态

 update除了可以更新服务器最新的代码以外还可以更新到指定版本。

 每次提交代码之后， SVN的版本号都会自动加1. 正式因为版本每次会自动加1， 也就是说版本号是唯一的。 所以我们可以通过版本号更新到指定版本的代码

 版本控制器中最常见的两个问题：

 .超时

 SVN    使用SVN有一个原则： 先更新再提交

 只有本地的版本号大于等于服务器的版本号时才能提交， 否则会报一个out of data错误；

 ls:R8

 manager :R11

 服务器： R11

 .冲突:

 当多个人修改了同一个文件的同一行代码会导致冲突

 我： main.c  11行  

 其它人： main.c 11行 abc

 其它人先提交了代码

 我再提交代码就会有冲突，

 Conflict discovered in， 提示我们如何解决问题

 (mc) mine-conflict,  代表用我们的代码替换服务器的代码。

 本地的代码只保留我们自己写的

 (tc) theirs-conflict, 代表用服务器代码替换我们的代码

 本地的代码只保留服务器的， 会自动删除我们的

 (p) postpone， 自己手动解决。

 本地文件中会同时保留服务器代码和本地代码

 会在本地创建3个备份

 main.c.mine 备课自己最新的代码

 main.c.r17 本地修改之前的版本

 main.c.r18 服务器最新版本

 <<<<<<<  到 ======中间存放的是我们自己修改的代码

 ======= 到  >>>>>>> 中间存放的是服务器最新的代码

 注意： 手动解决完冲突之后， 需要告诉SVN服务器我们已经解决冲突了， 这样才能保证数据的安全性和SVN的可靠性

 svn resolved 文件名称

 —————————

 注意： 在工具中Repositories中的仓库是服务器的仓库