Repo 命令记录

Repo 可以用来整合 Git 代码库,代码上传到 Gerrit 修订版本控制系统。Repo 只是为了在 Android 环境中更轻松地使用 Git。

repo 安装和配置

# Debian/Ubuntu.
$ sudo apt-get install repo

$ mkdir -p ~/.bin
$ PATH="${HOME}/.bin:${PATH}"
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
$ chmod a+rx ~/.bin/repo

1、repo命令的使用方法

$ repo [command] [options]

$ repo help //帮助

$ repo help

2、repo init

该命令创建一个 .repo/ 目录,其中包含用于 Repo 源代码和标准 Android 清单文件的 Git 代码库。

$ repo init -u [] //在当前目录中安装 Repo

参数:
-u:指定要从中检索清单代码库的地址。
-m:在代码库中选择清单文件。如果未选择任何清单名称,则会默认选择 default.xml。
-b:指定分支。

#注意:对于其余的所有 Repo 命令,当前工作目录必须是 .repo/ 的父目录或相应父目录的子目录

3、repo sync

$ repo sync [] //同步代码

选项:
-d:将指定项目切换回指定分支。
-f:即使某个项目同步失败,系统也会继续同步其他项目。

repo sync 运行成功后,指定项目中的代码会与远程代码库中的代码保持同步。

* 如果目标项目从未同步过,则 repo sync 相当于 git clone。
* 如果目标项目已同步过,则 repo sync 相当于以下命令:

git remote update
git rebase origin/

如果 git rebase 操作导致合并冲突,那么您需要使用普通 Git 命令(例如 git rebase --continue)来解决冲突。

4、repo upload

repo upload [] //上传代码

您选择一个或多个分支后,所选分支上的所有提交都会通过 HTTPS 连接传输到 Gerrit.

如果您在未使用任何参数的情况下运行 repo upload,则该操作会搜索所有项目中的更改以进行上传。

要在更改上传之后对其进行修改,应使用 git rebase -i 或 git commit --amend

5、repo diff

repo diff []

显示提交的代码和当前工作目录代码之间的差异。

6、repo download

下载特定的修改版本到本地

repo download

例如:$ repo download platform/build 23823

repo sync 应该可以有效移除通过 repo download 检索到的任何提交
7、repo forall

这个命令会遍历所有的git仓库,并在每个仓库执行-c所指定的命令

repo forall [] -c

选项:
-c:要运行的命令和参数。
-p:可以在遍历到每个仓库的时候先打印出当前的pwd 
-v:显示该命令向 stderr 写入的消息。

在每个项目中运行指定的 shell 命令。通过 repo forall 可使用下列额外的环境变量:

REPO_PROJECT 可设为项目的具有唯一性的名称。
REPO_PATH 是客户端根目录的相对路径。
REPO_REMOTE 是清单中远程系统的名称。
REPO_LREV 是清单中修订版本的名称,已转换为本地跟踪分支。如果您需要将清单修订版本传递到某个本地运行的 Git 命令,则可使用此变量。
REPO_RREV 是清单中修订版本的名称,与清单中显示的名称完全一致。
8、repo prune

删除已经merge的分支

repo prune []

9、repo start

创建分支

repo start []

 参数应简要说明您尝试对项目进行的更改。如果您不知道,则不妨考虑使用默认名称。

 指定了将参与此分支的项目。

#注意:“.”是一个非常实用的简写形式,用来代表当前工作目录中的项目。

10、repo status

repo status []

显示 project 中每个仓库的状态,并打印仓库名称

要仅查看当前分支的状态,请运行 repo status。系统会按项目列出状态信息。

在第一列中,大写字母表示暂存区与上次提交状态之间的不同之处。

字母  含义  说明
-   无更改 HEAD 与索引中相同
A   已添加 不存在于 HEAD 中,但存在于索引中
M   已修改 存在于 HEAD 中,但索引中的文件已修改
D   已删除 存在于 HEAD 中,但不存在于索引中
R   已重命名    不存在于 HEAD 中,但索引中的文件的路径已更改
C   已复制 不存在于 HEAD 中,已从索引中的另一个文件复制
T   模式已更改   HEAD 与索引中的内容相同,但模式已更改
U   未合并 HEAD 与索引之间存在冲突;需要解决方案

在第二列中,小写字母表示工作区与索引之间的不同之处。

字母  含义  说明
-   新/未知    不存在于索引中,但存在于工作区中
m   已修改 存在于索引中,也存在于工作区中(但已修改)
d   已删除 存在于索引中,不存在于工作区中
11、repo foreach [ project-lists] -c command

对每一个 project 运行 command 命令

===============================================================

资料:

  • Homepage: https://gerrit.googlesource.com/git-repo/
  • Mailing list: repo-discuss on Google Groups
  • Bug reports: https://bugs.chromium.org/p/gerrit/issues/list?q=component:repo
  • Source: https://gerrit.googlesource.com/git-repo/
  • Overview: https://source.android.com/source/developing.html
  • Docs: https://source.android.com/source/using-repo.html
  • repo Manifest Format: https://gerrit.googlesource.com/git-repo/+/refs/heads/master/docs/manifest-format.md
  • repo Hooks: https://gerrit.googlesource.com/git-repo/+/refs/heads/master/docs/repo-hooks.md
  • Submitting patches: https://gerrit.googlesource.com/git-repo/+/refs/heads/master/SUBMITTING_PATCHES.md
  • Running Repo in Microsoft Windows: https://gerrit.googlesource.com/git-repo/+/refs/heads/master/docs/windows.md
  • GitHub mirror: https://github.com/GerritCodeReview/git-repo
  • Postsubmit tests: https://github.com/GerritCodeReview/git-repo/actions

你可能感兴趣的:(Repo 命令记录)