Google Code 使用初步
读者要求:有一定的开发经验,熟悉版本控制的基本概念,熟悉 SVN 的简单使用。
说明:由于学校实训要做一个实验性的物流系统,考虑到团队合作时难免要使用版本控制工具。 SVN 现在的势头明显超过 CVS ,所以想用 SVN 来管理,但用 SVN 要用到公网 IP ,无奈我们这帮穷学生哪里来得公网 IP 。所以我只能诉诸开源组织来提供 SVN 空间了,以前只知道开源鼻祖 Sourceforge 提供这种服务,尝试之后深感其流程之繁琐,要求之严格。于是想到 Google 也提供了类似的服务,于是 Google 之,发现是 Google Code 。在网络上搜集了一些资料,比较之后发现像我们这种小的实验性的项目,放到 Sourceforge 简直是笑话, Google Code 显然更适合,而且 Google Code 也更快捷方便。虽然 Google Code 有 100M 的空间上限,不过考虑到项目小,这并不是一个障碍。
接下来是我申请并开通 Google Code 的 SVN 空间的一个流程,供后来者做个参考,也替 Google 做个广告。 Google Code 确实是个好的服务,而我现在依然受到它的惠顾,给它做个广告我也乐意。
1. Google 账号
首先,要求你有一个 Google 的账号,如果没有的话可以申请一个 Gmail 的账号,有了这个账号, Google 的所有非收费的服务都可以获得,更何况一个区区的 SVN 空间。
这里是链接,手懒的话可以直接点击: http://www.gmail.com 。
2. 登录邮箱并开始申请
先登录邮箱,在页面左上角的服 务列表中选择【更多 】, 找到【 Code 】,点击进入即可。
进入 Google Code 首页,选择左下角的【开源计划 】,在接下来的页面中有一个【如何入门? 】,点击【创建新的开源项目 】, 在接下来的页面中选择【 Create a new project 】。
3. 创建项目
接下来会出现一个页面用来创建 一个新的项目,这个就要慎重填写了。
Project name 用来填写项目名,要求必须是英 文小写开头,后边可以跟上小写字母,数字和中划线,但不允许有空格。这个项目名字会组成你的项目的 URL 地址,而且一旦确定就无法修改,请慎重填写。
Project summary 用来填写项目的简要描 述,别人在浏览开源项目列表的时候,这个简要描述也会显示出来,如果你的项目要从外面招兵买马,就可以利用这个来做广告,说不定哪个能人会看上你的创意, 愿意帮你一马。
Project description 就是对你的项目 的详细描述,请如实描述你的项目的具体属性。
Version control system 用来选择 VCS (注意不是 CVS ,这里指的是版本控制系统),有两个选项可供选择,除了 SVN 之外还有 Mercurial ,这是是一个轻量级的 VCS ,采用 Python 实现,感兴趣的读者可以试一下, 作者本人没有用过,这里我就选 Subversion 了。
Source code license 要求你选择一个开源协议,对于初学者来说这些开源组织的协议似乎都差不多,但仔细研读的话还是有差别 的。选一个就可以了,这里我选择 Apache2.0 的,因为我对它最熟悉。这里要注意一下,源码和文档可以采用不同的协议管理,需要分别管理的可以自 行考虑,这里我也就不讲究那么多了。
Project labels 相当于你的项目的关键字。我推荐的做法就是把你的 project description 的内容精简一下,取出几个关键字填入。
最后点击【 Create project 】,项目创建成功。
4. 项目的 SVN 基本管理
项目创建成功之后,就可以使用 客户端进行项目的管理。目前人气最足的就是 TortoiseSVN 了,用小乌龟 来管理 SVN 空间是大部分的选择。如果你使用 Eclipse 的话也可以使用 Subversion 的插件,在安全插件时推荐使用 link 的方式,严重建议不要使用在线更新,因为根据我和从网上获知的大多数同仁的亲身体验,这种更新的速度 慢得让人吐血(注意:这跟你自己的网速没多大关系,它就是这么慢!!!)。
在这里我使用小乌龟来管理,这 个工具可以从下面的网站中获取:
http://tortoisesvn.tigris.org/
Eclipse 的插件可以从下面的网 站获取:
a. 客户端管理——使用 TortoiseSVN 管理 Google Code 的 SVN 空间
首先下载并安装 TortoiseSVN ,安装完成之后它会要求你重启机器,其实可以不重启,直接进行操作。找一个空的文件夹,建议不要使用 带有中文的目录,然后点击右键选择【 SVN Checkout 】。在接下来的对话框中,填入你的 SVN 仓库的 URL ,格式默认为: https://bjtu-delivery.googlecode.com/svn/trunk/
然后就可以 checkout 下你的仓库了,不过此时的仓库的是空的。这时你选的文件夹上会有一个带有对勾儿的小绿圆,表明该文 件已经被 TortoiseSVN 进行管理了。这时的这个空文件夹就被称为 workspace 或这 client view ,还有另外一种称呼,叫做 sandbox ,不过各人觉得这种说法不是很形象,没有前两种那么见名知意。
向仓库中提交文件
这时,新建一个文件,如 HelloWorld.java ,然后点击右键选择【 add 】,发现文 件上有一个加号,再次点击该文件,右键点击选择【 SVN commit 】,填写好提交日志之后, 点击【 OK 】,这时弹出一个窗口要求你输入用户名和密码。用户名就是你的 Google Account ,密码呢就不要填写你的 Google Account 密码了。 Google 的 SVN 空间中的密码是随机生成的,这时你要登录 Google Code 中你的项目的页面,选择【 settings 】。 如果你已经登录了你的 Google Account 的话这里会显示一个生成的密码,输入即 可。这个密码可以根据需要再次生成,在你需要对你的 SVN 空间进行管理时,这个密码是必须的。
b. 服务器端管理——使用 Google Code 的管理页面对 SVN 空间的属性进 行管理
登录你的 Google Account ,进入 Code 之后选择你的项目后,会在页面中管理你的 SVN 空间属性。在这里你可以修改处理项目名之外的几乎说有属性,如果你是刚开始使用 Google 的 SVN 空间,管理你的队员是首先需要做的。在【 Administer 】下的【 Project Members 】里可以配置你的队员了。不过这里填写的都是 Gmail 的账号,所以你的队员必须要有一个 Gmail 的账号,设置 owners 、 committers 、 contributors ,只要填入对应的 Gmail 密码就可以了,可以使用逗号或者换行。