Monday, 18 September 2006

Getting Started with Subversion - TortoiseSVN

Subversion无痛起步 --- TortoiseSVN 1.4.0

TortoiseSVN,是目前我所使用过的最好的Subversion客户端软件。Subversion无痛起步从TortoiseSVN开始,是最为合适的。

首先,当然是下载、安装TortoiseSVN。TortoiseSVN安装后需要重起系统,这样TortoiseSVN就会在系统的弹出式菜单中了。

0. Download TortoiseSVN 1.4.0 from http://tortoisesvn.net/downloads
and install, restart;

建立Subversion代码库目录,初始化项目demosvn。

1. mkdir C:\svnroot
2. mkdir C:\svnroot\demosvn
3. In C:\svnroot\demosvn, right click,
go TortoiseSVN -> Create Repository Here...
4. Select Native filesystem (FSFS), click OK

以后,如果需要增加新的项目foo,重复step 2 - step 4即可。C:\svnroot就是Subversion项目的Parent Path,这个概念将会以后使用到。必须注意的是,绝对不要修改任何SVN项目中的任何一个文件。

建立项目的初始路径结构,对于Subversion来讲,习惯上会包括branches、tags和trunk这三个子目录。通常的操作是在trunk下进行。

5. mkdir C:\svntemp
6. mkdir C:\svntemp\branches
7. mkdir C:\svntemp\tags
8. mkdir C:\svntemp\trunk

Import项目的初始路径到demosvn的代码库中。

9. In C:\svntemp, right click, go TortoiseSVN -> Import
URL of repository: file:///D:/svnroot/demosvn
Import message: Initial the basic folders
10. Click OK, then get the 'Finished' message, and the revision is 1.
11. Delete the folder C:\svntemp

这里,也可以连带一些正常的文件一起导入到代码库中。但通常来讲,第一次import的时候,只导入这三个空的子目录。

至此,完成了Subversion代码库的建立和初始化。现在,可以进入正常的使用阶段了。

建立工作目录,从代码库中导出代码。现在demosvn项目中除了import的子目录,什么也没有。

12. mkdir C:\svnwork
13. In C:\svnwork, right click, go TortoiseSVN -> SVN Checkout...
URL of repository: file:///D:/svnroot/demosvn/trunk
Checkout directory: C:\svnwork
Revision: HEAD revision
14. Click OK.

注意,这里是从trunk子目录中,导出代码。

开始在工作目录下的编码工作。例如,写个readme.txt文件。

15. That's all. Please start your programming under this place.
16. Create a file, 'readme.txt', in C:\svnwork.

现在提交文件readme.txt,到代码库;

17. Right click the file, 'readme.txt', go TortoiseSVN -> Add...
18. In C:\svnwork, right click, go TortoiseSVN -> SVN Commit...
19. Write down the message
This the first scratch.
20. Click OK
21. Get the 'Finished' message, click OK
22. The file icon is coming with the green tick now.

绿色的勾号,表明提交成功,此文件的工作副本已经和代码库中的存档同步。在提交新代码的时候,一定要记得书写Log Message,对所作的修改进行说明。将对以后的Version Review有很大的帮助。否则,就和不用Version Control系统没什么区别。

再次修改readme.txt,保存之后,绿色的勾号变成红色的叉号。说明工作副本已有修改,再次提交。

23. Modify this file and save. Should get an red cross.
24. Right click this file, go TortoiseSVN -> Diff
25. In C:\svnwork, right click, go TortoiseSVN -> SVN Commit...

继续书写新的编码,然后提交,...,周而复始。

26. Write down the new code, then commit, 
27. Then coding, then commit... It's a circle.

0 Comments:

Post a Comment

<< Home