PS: 如果不知道 SVN 是什么, 可见此文: 浅谈版本控制系统 , 里面连结档案看完, 应该就很清楚了 :)
• 先来看 SVN Trunk/Tags/Branches 目录 的 结构 和 用途:(英文说明转载自 SubTrain PPT)
• trunk: Main line of development(主干, 主要开发都由在 trunk)
• tags: Releases (想要 Release 的时后, 就标个 Tag, 以后可以依 Tag 来找回之前版本的资料)
branches: Preparation of release, bug fixing(分支, 可以将某些功能切出来, 或者 bug fix 等切成分支, 等做完后再用 Merge 合并回来)
SVN 基本功能:
• Import: 将整个 project_directory 的资料 import 进 svn 里面
• svn import project_directory http://DOMAIN/svn_project
svn import project_directory file:///SVN_PATH/svn_project
• Checkout: (checkout 可简写成 co), 将资料 checkout 回来
• svn co http://SVN_PATH/svn_project
• svn co file:///SVN_PATH/svn_project
svn co -r 12 file:///var/lib/svn/dev/projects # 出第12版的 projcets code
• List: (list 可简写成 ls), 看上面有哪些档案/资料
• svn ls http://SVN_PATH/svn_project
svn ls file:///SVN_PATH/svn_project
• Update: (update 可简写成 up), 将目前信息更新成 SVN 联机最新版本.
SVN_CHECKOUT_DIR$ svn up
• Commit: (commit 可简写成 ci), 将目前所做的修改 commit 回 svn
SVN_CHECKOUT_DIR$ svn ci
• Status: (status 可简写成 st), 看目前档案/结构 跟 SVN 联机的版本有哪些不同
SVN_CHECKOUT_DIR$ svn st
• Add: 将此 档案/目录 新增进 svn
SVN_CHECKOUT_DIR$ svn add filename 或 svn add directory
• MV: 改档名, 并且此档案之前纪录还要继续留下
SVN_CHECKOUT_DIR$ svn mv filename new_filename
• Revert: 还原这次的修改, 回到前一版的档案状态(未 commit 前可用)
• SVN_CHECKOUT_DIR$ svn revert [file | directory]
• SVN 档案状态信息:
• ?: 此档案不存在 SVN 里面
• A: 此次新增的档案
• C: 此档案已经有人改过, 合并不成功, 需要人工介入
• D: 此次移除的档案
• M: 此档案有修改过
U: 此档案有被更新过
再来是比较进阶一点点, 下述范例转载自 SubTrain 的教学 PPT:
• 建立一个 branch
• svn copy http://svnserver/calc/trunk http://svnserver/calc/branches/my-calc-branch -m 'create a branch'
• 建立 Release Tags:
svn copy http://svnserver/calc/trunk http://svnserver/calc/tags/Release-1.0.0 -m 'create Release tags for Release 1.0.0'
• 合并两个版本的档案 # 参考自: 用 Subversion 的 Merge 来 Undo
• svn merge -r REV1:REV2 {path/to/workingcopy}
• (UNDO) svn merge -r 1234:1233 ...
• (MERGE )svn merge -r 1233:1234 ...
svn merge --dry-run -r 343:344 http://svn.example.com/repos/calc/trunk
有 "C" 状态处理完后, 用 resolved 将自动产生的档案删除, 才能正常 commit:
svn resolved filename # 这样子下就会把自动产生 diff 等的档案删除
遇到冲突的时候，以下是解决办法。
A.(p) postone 延迟解决
B.(df) diff-full 显示所有冲突的内容
C.(e) edit 启动编辑器解决冲突
D.(r) resolve 标识冲突已经解决
E.(mf) mine-full 用我的版本覆盖他人的修改
F.(tf) theirs-full 用他人的版本覆盖我的修改
G.(l) lanuch 启动其他工具来解决冲突
H.(h) help 启动帮助信息
虽然SVN提供了比较差异和解决冲突的方法，但避免冲突的最好方法永远只有一个：明确的分工和良好的沟通，尽量避免多个人同时修改同一份文件。如果不能避免，那么最好指定一个人在提交前负责合并各人的更新，然后一次性提交。
• 找版本间有什么不同 diff:
• svn diff # 自动以现在档案跟 SVN 内最新版做 diff
svn diff -r9237:9238
• Info: 列出现在路径, 版本编号, 最后一次修改日期 ... 等信息
svn info
• Log: 如果没输入参数, 预设会把所有 commit log 都列出来
• svn log
• svn log -l 10 # 显示 10 笔(最新 10笔 Log)
• svn log -c 100 # 显示 revision 100 的 Log
• svn log -v -c 100 # 显示 revision 100 的详细 Log
1. Propset (propset, pset, ps): 版本控制都有些特殊 Keyword 设定, 如 Id 就是最常用的, 设定方法如下:
2. 在档案内找地方加入 $Id$
3. 设定此档案要能吃 Id 的 Keyword: svn ps svn:keywords 'Id' filename (只需设一次即可, 之后就不用再设)
4. svn ci 后, $Id$ 会自动代换成 $Id:filename 编号 年月日时分秒 username $ 的信息
svn help ps 可以看到有哪些 Keyword 可以用, 即 Keyword 的说明.(ex: URL, Author, Date, Rev, Id 等.)
• 其它 SVN Client:
• Windows Client: TortoiseSVN
SVK: The SVK version control system
• SVK 相关介绍:
• svk 分散式版本控制之道
• 使用 svk 建立开发分支
Version Control with SVK
• 其它相关网页
• Subversion 版本控制系统的基础观念 - 此篇有讲版本系统该如何使用 等等的基本观念, 建议阅读.
• Subversion post-commit 的解说以及注意事项
post-commit 如果没有这行会无法自动 post-commit - post-commit 前, 建议先跑 export LANG=zh_TW.UTF-8(看系统语系编码设定)