Git和Repo扫盲――如何取得Android源代码

Git 是 Linux Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的分布式版本控制软件，它不同于Subversion、CVS这样的集中式版本控制系统。在集中式版本控制系统中只有一个仓库（repository），许多个工作目录（working copy），而像Git这样的分布式版本控制系统中（其他主要的分布式版本控制系统还有BitKeeper、Mercurial、GNU Arch、Bazaar、Darcs、SVK、Monotone等），每一个工作目录都包含一个完整仓库，它们可以支持离线工作，本地提交可以稍后提交到服务器上。分布式系统理论上也比集中式的单服务器系统更健壮，单服务器系统一旦服务器出现问题整个系统就不能运行了，分布式系统通常不会因为一两个节点而受到影响。

因为Android是由kernel、Dalvik、Bionic、prebuilt、build等多个Git项目组成，所以Android项目编写了一个名为Repo的Python的脚本来统一管理这些项目的仓库，使得Git的使用更加简单。

这几天William为了拿Android最新的sourcecode，学习了一下git和repo的一些基本操作，整理了一个如何取得Android代码的How-To，今天把他贴上来。

1、Git的安装
在Ubuntu 8.04上安装git只要设定了正确的更新源，然后使用apt-get就可以了，有什么依赖问题，就让它自己解决吧。其中cURL是一个利用URL语法在命令行下工作的文件传输工具，会在后面安装Repo的时候用到。
sudo apt-get install git-core curl

2、安装Repo
首先确保在当前用户的主目录下创建一个/bin目录（如果没有的话），然后把它(~/bin)加到PATH环境变量中
接下来通过cURL来下载Repo脚本，保存到~/bin/repo文件中
curl http://android.git.kernel.org/repo >~/bin/repo

别忘了给repo可执行权限
chmod a+x ~/bin/repo

3、初始化版本库
如果是想把Android当前主线上最新版本的所有的sourcecode拿下来，我们需要repo的帮助。
先建立一个目录，比如~/android，进去以后用repo init命令即可。
repo init -u git://android.git.kernel.org/platform/manifest.git
这个过程会持续很长的时间（至少可以好好睡一觉），具体要多少时间就取决于网络条件了
最后会看到 repo initialized in /android这样的提示，就说明本地的版本库已经初始化完毕，并且包含了当前最新的sourcecode。

如果想拿某个branch而不是主线上的代码，我们需要用-b参数制定branch名字，比如：
repo init -u git://android.git.kernel.org/platform/manifest.git -b cupcake

另一种情况是，我们只需要某一个project的代码，比如kernel/common，就不需要repo了，直接用Git即可。
git clone git://android.git.kernel.org/kernel/common.git
这也需要不少的时间，因为它会把整个Linux Kernel的代码复制下来。

如果需要某个branch的代码，用git checkout即可。比如我们刚刚拿了kernel/common.get的代码，那就先进入到common目录，然后用下面的命令：
git checkout origin/android-goldfish-2.6.27 -b goldfish
这样我们就在本地建立了一个名为goldfish的android-goldfish-2.6.27分支，代码则已经与android-goldgish-2.6.27同步。我们可以通过git branch来列出本地的所有分支。

4、同步版本库
使用epo sync命令，我们把整个Android代码树做同步到本地，同样，我们可以用类似
repo sync project1 project2 … 
这样的命令来同步某几个项目

如果是同步Android中的单个项目，只要在项目目录下执行简单的
git pull
即可。

5、通过GitWeb下载代码
另外，如果只是需要主线上某个项目的代码，也可以通过GitWeb下载，在shortlog利用关键字来搜索特定的版本，或者找几个比较新的tag来下载还是很容易的。

Git最初是为Linux内核开发而设计，所以对其他平台的支持并不好，尤其是Windows平台，必须要有Cygwin才可以。现在，得益于msysgit项目，我们已经可以不需要Cygwin而使用Git了。另外，Git Extensions是一个非常好用的Windows Shell扩展，它能与资源管理器紧密集成，甚至提供了Visual Studio插件。它的官方网站上有一分不错的说明文档，感兴趣的朋友可以看一看。

至于Git的参考文档，我推荐Git Magic，这里还有一个Git Magic的中文版。

seam-gen 增加messages_zh_CN.properties

新建一个Generic Exporter，具体添加的属性如下：
File Pattern : messages_zh_CN.properties
For each : entity
herbernatetool.util.toolclass: org.hibernate.eclipse.launch.SeamUtil
Output directory:/product2/src/model
Template name:messages_en.ftl

在seam-gen目录下新建一个文件：messages_en.ftl，文件内容如下：

<#foreach entity in c2j.getPOJOIterator(cfg.classMappings)>

########## for ${entity.shortName} ##########
<#assign lowerShortName = util.lower(entity.shortName)>
${lowerShortName}=${entity.shortName}
<#foreach field in entity.getAllPropertiesIterator()>
<#assign upperFieldName = util.upper(field.name)>
${lowerShortName}.${field.name}=${upperFieldName}
</#foreach>
</#foreach>

Installing Notes 8.0.1 on Ubuntu 8.04

版本 8 是 Notes 转向 Eclipse 架构后的第二个主发布，单从安装过程来说，确实有很大的进步。记得2006年时我曾经尝试在 Ubuntu 6.10 上安装当时发布不久的 Notes 7.0.1，问题之多以至于我专门写了一篇“攻略”发表在 developerWorks 上（本地）。

正式开始之前做两个小准备：

把 $LANG 环境变量暂时置为 en_US.UTF-8，否则安装向导上全是乱码。
另外，要暂时关闭“视觉特效”。操作位置在系统-首选项-外观。否则启动安装向导后出来的第一屏是空白的。

Step 1. 安装 libstdc++5

如果没有这个包，那么图形界面的安装向导无法启动，你会看到 Locking assertion failure 以及很多其他的错误消息，当然你可以用参数 -console 来启动字符界面的安装向导。不过我想说的是，Notes 的字符安装向导那是相当的差！

$ sudo apt-get install libstdc++5

Step 2. 启动安装向导

因为安装了 libstdc++5 包，所以图形界面的向导可以启动了。
安装需要用到特权用户权限，所以要 sudo 开头。

$ sudo ./setup.sh

然后就是照着屏幕提示，一步一步地来。

Step 3. 两个善后

安装完成后需要修改三个相关目录的拥有者，分别是：

$ sudo chown -R huangys.huangys /opt/ibm/lotus
$ sudo chown -R huangys.huangys /etc/lotus
$ sudo chown -R huangys.huangys /home/huangys/lotus

另一个问题与 Eclipse 有关。当尝试启动 Lotus Notes 时，会看到如下错误：

已经有人报告了这个BUG，创建 ~/.mozilla/eclipse 目录即可解决这个问题：

$ cd /home/huangys/.mozilla
$ mkdir eclipse

OK，准备好你的 ID 文件开始配置吧。

[UPDATE] 3 Nov 2008
我在 Ubuntu 8.10 (Intrepid Ibex) 上安装新发布的 Lotus Notes 8.0.2 已经不需要创建这个 ~/.mozilla/eclipse 目录了，看来这个 BUG 应该是解决了。

This entry was posted on Saturday, June 7th, 2008 at 23:23 and is filed under Linux. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

• catfox Says at 12:16, June 15, 2008
  

  请教一个问题：
  我按照你说的装好了。
  可是双击图标，说。。。。。./notes permission denied.
  用sudo ./notes 运行，这个notes又说不能用ROOT运行。
  请指教

• richard Says at 14:31, June 15, 2008
  

  不能 sudo 为超级用户来运行 notes，应该是 Step 3 中指出的 ~/lotus 目录的权限问题，你可以把这个目录删除，再从菜单中选择 Lotus Notes 8 来启动初始化配置向导。

• 不能打开附件 Says at 8:43, June 25, 2008
  

  我的Notes安装上了 但是附件（Word Excel文档等）在Notes中不能直接打开
  请指教

• richard Says at 9:40, June 25, 2008
  

  可能是需要一些解析器的支持才能直接打开，你还是把附件存下来后再用 openoffice 打开吧。

• 不能打开附件 Says at 8:31, June 26, 2008
  

  谢谢！昨天找了一天的资料终于搞定
  #mv /opt/ibm/lotus/notes/openwith /opt/ibm/lotus/notes/openwith.old
  #ln -s $(which gnome-open/kde-open) /opt/ibm/lotus/openwith
  ubuntu 8.04 才会出现这种情况

• richard Says at 10:08, June 26, 2008
  

  恭喜你 and 谢谢分享这一tips ^o^

• Samba问题 Says at 13:48, June 26, 2008
  

  我做了一个Samba服务器 其他的Ubuntu 8.04客户机要在Samba 服务器上打开Excel文档还要再次输入密码 有办法解决吗？

• richard Says at 17:13, June 26, 2008
  

  Samba 应该是配置在 UNIX/Linux 上、供 Windows 客户机来访问的，你的 Ubuntu 客户机并不需要通过 Samba 去访问那些在 UNIX/Linux 上的资源呀，有很多好方法，比如 FTP/SFTP 都合适。

• jerry Says at 15:08, April 7, 2009
  

  我在ubuntu 8.10上安装notes 8.0.1成功，但当我从菜单上点lotus notes 8时，没有任何反应。后续的两个善后也做了。请问是什么原因，万分感谢！

• richard Says at 16:03, April 7, 2009
  

  @jerry 应该是权限的问题导致的，你试试把 $HOME 下的 lotus 目录删除，然后运行 Lotus Notes，会再次进行初始化动作。

• jerry Says at 11:04, April 8, 2009
  

  richard Says at 16:03, April 7, 2009

  @jerry 应该是权限的问题导致的，你试试把 $HOME 下的 lotus 目录删除，然后运行 Lotus Notes，会再次进行初始化动作。

  十分谢谢richard，已经成功。