基于Repo和Git的版本管理

基于Repo和Git的版本管理

git branch upload 工具 android merge

     涉及Android源代码的工作需要用到的Git和Repo工具。多数情况下我们可以用Git工具代替Repo，或者两者混用组合成更复杂的命令。而Repo工具可以使Android的网络操作更加简洁。
     Git是一个开源版本管理系统，旨在处理各种知识库发布的大型项目。一般来说，我们可以使用Git进行本地操作，比如本地分支化、提交、对比和编辑。Android项目中一个挑战是如何支持外部的群体（爱好者社区以及大型OEM厂商）。如果想让组件可替代、延长生命周期，我们必须选择一个发布式版本管理系统，所有我们选择Git工具。
     Repo是基于Git工具的知识库管理系统工具，该工具可以统一管理Git知识库并提交源码到版本管理系统，使得Android项目的开发流程自动化。Repo并不意味着替代Git工具，它仅使得工作更加简单。Repo命令是Python脚本，可以放到任何路径下。涉及到网络操作时可以使用该工具，比如使用单个Repo命令可以下载多个知识库到本地。
     Gerrit是给予web的代码review系统，集中支持了Git众多的应用。该系统允许授权用户提交代码更改，通过review后自动merge到版本管理系统。Gerrit支持差异展现和在线评论，使review比较简单。
一、版本管理基本流程
     与知识库交互的基本流程如下：
     1、建立新的分支——repo start
     2、编辑代码文件
     3、stage文件更改——git add
     4、提交更改——git commit
     5、提交更改到review服务器——repo upload

                                            

二、任务处理

     下面详细介绍了如何使用Repo和Git命令。

     1、同步本地客户端

      同步所有的工程文件——repo sync

      同步特定的工程文件——repo sync PROJECT0 PROJECT1 PROJECT2 ...

     2、创建分支

     每当开始编辑文件比如开始修改bug和添加新的功能，需要在本地创建特定的分支。分支并不是原始文件的拷贝，它作为特定提交的标示，该标示创建本地分支并在分支间进行轻量级切换，分支可以隔绝一个方面的更改。

     创建分支——repo start BRANCH_NAME

     验证新分支的有效性——repo status

    3、分支使用

     分配分支到特定工程——repo start BRANCH_NAME PROJECT

     本地环境中切换分支——git checkout BRANCH_NAME

     列出所有分支——git branch or repo branches

   4、staging文件

     默认情况下，git工具提示但并不跟踪工程的更改，为了通知git保存代码的变化，我们必须commit代码，即“staging”。

    stage文件更改——git add

    该命令可以接受任何文件和工程目录，git添加文件到git知识库，并且stage文件更改、删除的记录。

   5、浏览客户端状态

    展示文件状态——repo status

    展示未提交的文件编辑——repo diff

   6、提交更改

    git中commit是版本管理的基本单元，包含了工程的目录结构和文件内容。

    创建commit——git commit

    执行该命令后editor中弹出commit提示信息，最好能够提供有益的帮助信息。如果没有添加log信息，该次commit提交会被遗弃。

   7、提交更改到Gerrit

    upload之前更新最新的版本——repo sync

    接着提交代码——repo upload

    之后呈现我们提交的更改，并提示我们选择分支。

   8、处理代码冲突

    提交代码时如果遇到冲突，需要执行以下操作：进入相关的工程目录，针对冲突的文件运行git add和git commit命令，恢复更改。如下：

     git add .

     git commit 

     git rebase --continue

    恢复更改后再次重复整个更新：

     repo sync PROJECT0 PROJECT1 ... PROJECTN

    如果本地又对刚刚提交的代码进行了修改，提交时可以直接覆盖上次的提交，执行如下命令：

    git add files

    git commit  --amend

    repo upload

   9、清除客户端文件

    merge代码到Gerrit之后，更新本地的工作目录：

    repo sync

   安全清除陈旧的分支执行以下命令：

    repo prune

   想恢复代码到以前的分支，可以执行以下命令：

    git log

    git reset hard

  10、删除客户端代码

   由于代码所有的代码信息存储在本地，我们仅需要删除目录即可完成：

    rm -rf WORKING_DIRECTORY

   删除本地代码后将会永久的删除所有提交的更改。

三、Git和Repo流程表

原文参考：http://source.android.com/source/version-control.html