From 939f958b621b63f8af110f7bf8b1e2dcf2492e45 Mon Sep 17 00:00:00 2001 From: lion187 Date: Tue, 27 Nov 2018 21:29:56 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=BB=BA=E6=96=87=E4=BB=B6=20Software?= =?UTF-8?q?/Application/Repo/Repo=5F=E8=AF=A6=E8=A7=A3.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Software/Application/Repo/Repo_详解.md | 331 +++++++++++++++++++++++++ 1 file changed, 331 insertions(+) create mode 100644 Software/Application/Repo/Repo_详解.md diff --git a/Software/Application/Repo/Repo_详解.md b/Software/Application/Repo/Repo_详解.md new file mode 100644 index 0000000..1d2e855 --- /dev/null +++ b/Software/Application/Repo/Repo_详解.md @@ -0,0 +1,331 @@ +# [Repo 详解](https://blog.csdn.net/winceos/article/details/18667605) + +## 1、repo介绍 + +Android 使用 Git 作为代码管理工具，开发了 Gerrit 进行代码审核以便更好的对代码进行集中式管理，还开发了 Repo 命令行工具，对 Git 部分命令封装，将百多个 Git 库有效的进行组织。 + +## 1.1、清单库文件介绍 + +一个清单库可以包含多个清单文件和多个分支，每个清单文件和分支都有对应的版本。清单文件以xml格式组织的。 + +* remote元素 + 定义了名为korg的远程版本库，其库的基址为 +* default元素 + 设置各个项目默认远程版本库为korg，默认的的分支为gingerbread-exdroid-stable。当然各个项目(project元素)还可以定义自己的remote和revision覆盖默认的配置 +* project元素 + 用于定义一个项目，path属性表示在工作区克隆的位置，name属性表示该项目的远程版本库的相对路径 +* project元素的子元素copyfile + 定义了项目克隆后的一个附件动作，从src拷贝文件到dest + +## 1.2、下载repo代码 + + $mkdir android2.3.4 + $cd android2.3.4 + $git clone git://172.16.1.31/repo.git + +于是在android目录下便有repo文件夹，里面包含了repo的源代码，里面有个repo脚本，用它来执行repo指令。 + +在本地开发的用户需要下载repo代码，在172.16.1.7服务器上开发的用户则不用下载repo代码，因为已经把repo脚本添加到了环境变量，执行repo init 就会附加的下载repo代码。 + +## 2、repo常用指令 + + 备注：“*”表示新添加的指令 + +### 2.1、repo init(下载repo并克隆manifest) + +Usage： + + repo init –u URL [OPTIONS] + Options: + -u 指定一个URL，其连接到一个maniest仓库 + -m 在manifest仓库中选择一个xml文件 + -b 选择一个maniest仓库中的一个特殊的分支 + +命令repo init 要完成如下操作： + +* 完成repo工具的完整下载，执行的repo脚本只是引导程序 +* 克隆清单库manifest.git (地址来自于-u 参数) +* 克隆的清单库位于manifest.git中，克隆到本地.repo/manifests.清单.repo/manifest.xml只是符号链接，它指向.repo/manifests/default.xml +* 如果manifests中有多个xml文件，repo init 可以任意选择其中一个，默认选择是default.xml + +Example: + + $repo init -u git://172.16.1.31/manifest.git + # 选择的是android.xml里面的配置，.repo/manifest.xml便指向.repo/manifests/android.xml + $repo init -u git://172.16.1.31/manifest.git –m android.xml + +### 2.2 repo sync(下载代码) + +Usage: + + repo sync […] + +用于参照清单文件.repo/manifest.xml克隆并同步版本库。如果某个项目版本库尚不存在，则执行repo sync 命令相当于执行git clone，如果项目版本库已经存在，则相当于执行下面的两条指令： + + # 相当于对每一个remote源执行了fetch操作 + $git remote update + # 针对当前分支的跟踪分支执行rebase操作 + $git rebase origin/branch + +Example: + + $repo sync + $repo sync platform/build + +### 2.3、repo start(创建并切换分支) + +Usage: + + repo start [--all | …] + +刚克隆下来的代码是没有分支的,repo start实际是对git checkout –b 命令的封装。为指定的项目或所有项目（若使用—all参数），以清单文件中为设定的分支，创建特性分支。这条指令与git checkout –b 还是有很大的区别的，git checkout –b 是在当前所在的分支的基础上创建特性分支，而repo start是在清单文件设定分支的基础上创建特性分支。 + +Example: + + # 假设清单文件中设定的分支是gingerbread-exdroid-stable，那么执行以下指令就是对所有项目，在gingerbread-exdroid-stable的基础上创建特性分支stable。 + $repo start stable --all + + # 假设清单文件中设定的分支是gingerbread-exdroid-stable，那么执行以下指令就是对platform/build、platform/bionic项目，在gingerbread-exdroid-stable的基础上创建特性分支stable + $repo start stable platform/build platform/bionic + +### 2.4、repo checkout(切换分支) + +Usage: + + repo checkout […] + +实际上是对git checkout 命令的封装，但不能带-b参数，所以不能用此命令来创建特性分支。 + +Example: + + $repo checkout crane-dev + $repo checkout crane-dev platform/build platform/bionic + +### 2.5、repo branches(查看分支) + +Usage: + + repo branches […] + +Example: + + $repo branches + $repo branches platform/build platform/bionic + +### 2.6、repo diff(查看工作区文件差异) + +Usage: + + repo diff […] + +实际是对git diff 命令的封装,用于分别显示各个项目工作区下的文件差异。 + +Example: + + # 查看所有项目 + $repo diff + # 只查看其中两个项目 + $repo diff platform/build platform/bionic + +### 2.7、repo stage(把文件添加到index表中) + +Usage: + + repo stage -i […] + Options: + -i 代表git add --interactive命令中的--interactive，给出个界面供用户选择 + +实际是对git add --interactive命令的封装、用于挑选各个项目工作区中的改动以加入暂存区。 + +### 2.8、repo prune(删除已经合并分支) + +Usage: + + repo prune […] + +实际上是对git branch –d命令的封装，该命令用于扫面项目的各个分支，并删除已经合并的分支。 + +### 2.9、repo abandon(删除指定分支) + +Usage: + + repo abandon […] + +实际上是对git branch –D 命令的封装。 + +### 2.10、repo status(查看文件状态) + +Usage: + + repo status [...] + +实际上是对git diff-index、git diff-filse命令的封装，同时显示暂存区的状态和本地文件修改的状态。 + +Example: + + $repo/repo status platform/bionic + + 以上的实例输出显示了platform/bionic项目分支的修改状态 + +每个小节的首行显示羡慕名称，以及所在分支的名称 +第一个字母表示暂存区的文件修改状态 + +| 字母 | 含义 | 描述 | +| :--- | :----------- | :----------------------------------- | +| - | 无变化 | 没有修改，在 HEAD 和在索引中是一样的 | +| A | 添加 | 不在HEAD中，在暂存区中 | +| M | 修改 | 在HEAD中，在暂存区中，内容不同 | +| D | 删除 | 在HEAD中，不在暂存区 | +| R | 重命名 | 不在HEAD中，在暂存区，路径修改 | +| C | 拷贝 | 不在HEAD中，在暂存区，从其他文件拷贝 | +| T | 文件状态改变 | 在HEAD中，在暂存区，内容相同 | +| U | 未合并 | 需要冲突解决 | + +第二个字母表示工作区文件的更改状态 + +| 字母 | 含义 | 描述 | +|:-----|:--------|:---------------------------| +| - | 新/未知 | 不在暂存区，在工作区 | +| m | 修改 | 在暂存区，在工作区，被修改 | +| d | 删除 | 在暂存区，不在工作区 | + +两个表示状态的字母后面，显示文件名信息。如果有文件重名还会显示改变前后的文件名及文件的相似度。 + +### 2.11、repo remote(设置远程仓库) + +Usage: + + repo remote add […] + repo remote rm […] + +Example: + + $repo remote add org ssh://172.16.1.31/git_repo + +这个指令是根据xml文件添加的远程分支，方便于向服务器提交代码，执行之后的build目录下看到新的远程分支org。 + +删除远程仓库： + + $repo remote rm org + +### 2.12、repo push + +Usage: + + repo push [--all |…] + +repo会自己查询需要向服务器提交的项目并提示用户。 + +Example: + + $repo push org + +这是新添加的指令，用于向服务器提交代码。 + +### 2.13、repo forall + +Usage: + + repo forall […] –c + Options: + -c 后面所带的参数是shell指令，即执行命令和参数。命令是通过 /bin/sh 评估的并且后面的任何参数就如 shell 位置的参数通过。 + -p 在shell指令输出之前列出项目名称，即在指定命令的输出前显示项目标题。这是通过绑定管道到命令的stdin，stdout，和 sterr 流，并且用管道输送所有输出量到一个连续的流，显示在一个单一的页面调度会话中。 + -v 列出执行shell指令输出的错误信息，即显示命令写到 sterr 的信息。 + +附加环境变量： + + REPO_PROJECT:指定项目的名称 + REPO_PATH:指定项目在工作区的相对路径 + REPO_REMOTE:指定项目远程仓库的名称 + REPO_LREV:指定项目最后一次提交服务器仓库对应的哈希值 + REPO_RREV:指定项目在克隆时的指定分支，manifest里的revision属性 + +迭代器，可以在所有指定的项目中执行同一个shell指令。 +另外，如果-c后面所带的shell指令中有上述环境变量，则需要用单引号把shell指令括起来。 + +#### 2.13.1、添加的环境变量 + + $repo forall –c 'echo $REPO_PROJECT' + +#### 2.13.2、merge(合并多个分支) + + $repo forall –p –c git merge topic + +#### 2.13.3、tag(打标签) + +在所有项目下打标签 + + $repo forall –c git tag crane-stable-1.6 + +#### 2.13.4 remote(设置远程仓库) + +引用环境变量REPO_PROJECT添加远程仓库： + + $repo forall –c 'git remote add korg ssh://xiong@172.16.31/$REPO_PROJECT.git' + +删除远程仓库： + + $repo forall –c git remote add korg + +#### 2.13.5 branch(创建特性分支) + + $repo forall –c git branch crane-dev + $repo forall –c git checkout –b crane-dev + +## 3、repo 的额外命令集 + +### 3.1、repo grep + +Usage: + + repo grep {pattern | -e pattern} [...] + +相当于对git grep 的封装，用于在项目文件中进行内容查找。 + +## 3.2、repo manifest + +Usage: + + repo manifest [-o {-|NAME.xml} [-r]] + Options: + -h, –help 显示这个帮助信息后退出 + -r, –revision-as-HEAD 把某版次存为当前的HEAD + -o -|NAME.xml, –output-file=-|NAME.xml 把manifest存为NAME.xml + +相当于对git grep 的封装，用于在项目文件中进行内容查找。 + +Example: + + repo manifest –o android.xml + +### 3.3、repo version + +显示repo的版本号 + +### 3.4、repo upload + +Usage: + + repo upload [--re --cc] {[]… | --replace } + Options: + -h, --help 显示帮助信息 + -t 发送本地分支名称到Gerrit代码审核服务器 + --replace 发送此分支的更新补丁集 + --re=REVIEWERS 要求指定的人员进行审核 + --cc=CC 同时发送通知到如下邮件地址 + +repo upload相当于git push，但是又有很大的不同。它不是将版本库改动推送到克隆时的远程服务器，而是推送到代码审核服务器(Gerrit软件架设)的特殊引用上，使用SSH协议。代码审核服务器会对推送的提交进行特殊处理，将新的提交显示为一个待审核的修改集，并进入代码审查流程，只有当审核通过后，才会合并到官方正式的版本库中。 + +### 3.5、repo download + +Usage: + + repo download {project change [patchset]}… + +主要用于代码审核者下载和评估贡献者提交的修订。 + +### 3.6、repo selfupdate + +用于repo自身的更新 + +参考：