repo使用指南

目录

---

一. repo简介

repo是对分布式版本控制系统Git中部分命令的封装，是一个命令行工具。它可以管理多个git项目（例如，在Android 4.2中，就包含了329个项目，每一个项目都是一个独立的Git仓库。这意味着，如果我们要创建一个分支来做feature开发，那么就需要到每一个子项目去创建对应的分支。这显然不能手动地使用git到每一个子项目里面去创建分支，必须要采用一种自动化的方式来处理。这些自动化处理工作就是由repo工具来完成的，这也是repo出现的原因之一)。对于所有repo管理的项目，例如myrepoproject，其中myrepoproject/.repo是repo的目录，myrepoproject/中除了.repo之外的内容为repo工作目录，来自相应repo目录的某个版本。

repo工具分为两个部分，一部分是repo引导脚本，另一部分是repo代码。repo引导脚本里面设置有一个指向repo代码的地址，通过执行repo init -u URL [OPTIONS] (如repo init -u http://gerrit.allwinnertech.com:8081/product/tina/manifest.git)，把repo工具本身的代码和tina源码仓库的一个清单版本库下载到当前工作目录下；repo init指令repo工具的每个指令都用一个python脚本来定义的，每执行一条指令，都通过repo引导将本找到相应的指令，然后执行。

这里有一个概念，是清单版本库，简称清单库；伴随着还有另一个名词—清单文件。一个清单库可以包含多个清单文件和分支，每个清单文件和分支都有对应的版本，清单文件以xml格式组织。举个例子：

• remote元素，定义了名为txxxxxa的远程仓库，其库的基址为git：//gerrit.xxxxxx.com:80
• default元素，设置各个项目默认远程版本库为txxxxxa，默认的的分支为txxxxxa-dev。当然各个项目(project元素)还可以定义自己的remote和revision覆盖默认的配置
• project元素，用于定义一个项目，path属性表示在工作区克隆的位置，name属性表示该项目的远程版本库的相对路径
• project元素的子元素copyfile，定义了项目克隆后的一个附件动作，从src拷贝文件到dest

清单文件的作用：

• 根据清单文件指定的地址一一克隆清单文件中的项目
• 通过清单文件对所有的git仓库进行统一管理

---

二. repo使用流程

repo start 开始一个新的工作分支Use to start a new topic branch.
git commit 提交修改Use git add to stage changes.
repo upload 上传修改

---

三. repo常用命令

3.1 repo init

• 命令格式： $repo init -u URL [OPTIONS]
• 选项：
  • -u : 制定一个URL，其链接到一个清单库
  • -m : 在清单库中选择一个xml清单文件
  • -b : 选在一个清单库中的一个分支
• 说明： repo init命令主要完成两个操作：
  • 利用repo引导脚本完成repo工具的完整下载
  • 克隆清单库manifest.git（地址来自-u参数）到本地.repo/manifests，克隆清单文件到本地.repo/manifest.xml，它只是一个符号链接