转载：https://blog.csdn.net/salmon_zhang/article/details/79180075

1. repo简介

repo是Google开发的用于管理Android版本库的一个工具，repo是使用Python对git进行了一定的封装，并不是用于取代git，它简化了对多个Git版本库的管理。用repo管理的版本库都需要使用git命令来进行操作。

1.1 介绍清单库文件

清单文件是以xml的格式组织的，一个清单库可以包含多个清单文件和多个分支，每个清单文件和分支都有对应的版本。

  • remote元素

    定义了名为korg的远程版本库，库的基址为git://172.16.1.31

  • project元素

    用于定义一个项目，path属性表示在工作区clone的位置，name属性表示该项目的远程版本库的相对路径。

  • default元素

    设置各个项目默认远程版本库为Korg，默认的分支为gingerbread-exdroid-stable。各个项目还可以定义自己的remote和revision覆盖默认的配置。

  • project元素下的子元素copyfile

    定义了项目clone后的一个附件动作，从src拷贝文件到dest

1.2 下载repo代码

  • 新建项目存放的文件夹

    mkdir mstar648

  • 进入到项目文件夹

    cd mstar648

  • 执行代码拉取的命令

    repo init -u ssh://ppgerrit.com/Mstar648/manifest.git -b 648_cultraview -m ppos4.5.0_cultraview.xml
    • 1
1.3 探究repo文件夹

  • 通过如下命令查看mstar648目录下

    ls -a
    • 1

可以看到目录下有个.repo文件夹，说明mstar648项目是一个用repo管理的版本库。

  • 进入到.repo，并查看目录内容

可以看到.repo目录下有manifest、project、repo文件夹等信息。

如果想查看Python封装的脚本，可到.repo/repo下看到：

如果想查看某个模块当前是在哪个分支，可以进入到manifests中去：

因为我们刚拉取代码的时候是ppos4.5.0_cultraview.xml，所以通过vim打开ppos4.5.0_cultraview.xml，然后可以通过

/模块名
  • 1

查看到模块的分支信息。例如我们要看到PposTv的分支信息，就可以搜索/PposTv

2. repo常用命令

2.1 解析拉取代码的命令

例如我们拉取代码的时候的命令如下：

repo init -u ssh://ppgerrit.com/Mstar648/manifest.git -b 648_cultraview -m ppos4.5.0_cultraview.xml
  • 1

其中：

  • -u：指定一个URL，其连接到一个manifest仓库

  • -b：选择manifest仓库中的一个特殊分支

  • -m：在manifest仓库中选择一个xml文件

repo init要完成如下操作：

  • 完成repo工具的完整下载，执行的repo脚本只是引导程序

  • clone清单库manifest.git （地址是-u后面的参数）

  • clone的清单库位于manifest.git中，clone到本地.repo/manifest中，.repo/manifest.xml只是符号链接，它指向的是.repo/manifests/default.xml

  • 如果manifest中有多个xml文件，repo init可以任意选择其中一个，默认选择的是default.xml。

上面的拉取代码示例选择的是ppos4.5.0_cultraview.xml里面的配置，那么.repo/manifest.xml指向的是.repo/manifests/ppos4.5.0_cultraview.xml

2.2 同步代码（repo sync）

执行了repo init 命令后，我们需要执行如下命令同步代码：

repo sync
  • 1

参照清单文件.repo/manifest.xml克隆并同步版本库。如果项目版本库不存在，则执行repo sync命令相当于执行git clone；如果项目版本库存在，则相当于执行下面两条指令：

  • git remote update

    相当于对每一个remote源执行了fetch操作

  • git rebase origin/branch

    对当前分支的跟踪分支执行rebase操作

2.3 创建并切换分支（repo start）

刚clone下来的代码是没有分支的，例如：

repo start 的实质就是对git checkout -b 的封装，可以为单个项目或所有项目以清单文件中已设定的分支为基础，在本地创建新的分支。

repo start 与 git checkout -b 的区别：

  • repo start 是在清单文件设定的分支基础上创建新的分支

  • git checkout -b 是在当前所在分支的基础上创建新的分支

如果清单文件中设定的分支是remoteBranchName，创建新的分支localBranchName。

  • 为单个项目创建localBranchName分支的命令如下：

    repo start localBranchName 项目绝对路径
    • 1

  • 为所有项目创建localBranchName分支的命令如下：

    repo start localBranchName --all
    • 1
2.4 查看分支（repo branches）

本文下面所有的命令都是在单个项目中运行！！！

例如查看上面拉取的mstar648项目下各模块的分支信息

在mstar648项目下运行如下命令：

    repo branches
  • 1

2.5 切换分支（repo checkout）

切换分支语法：

repo checkout brancnName
  • 1

2.6 查看工作区文件的差异（repo diff）

查看文件差异语法：

    repo diff
  • 1
2.7 查看文件状态（repo status）

该命令实际上是对git diff-index 和git diff-filse命令的封装，同时显示暂存区的状态和本地文件修改的状态

查看文件状态语法：

    repo status
  • 1

其中：

  • 每个小节的第一行显示的是项目名称和所在的分支名称

  • 每个小节的第二行的第一个字母表示暂存区文件修改的状态

    • -：没有改变

    • A:添加（不在HEAD中，在暂存区中）

    • M：修改（在HEAD中，在暂存区中，内容不同）

    • D:删除（在HEAD中，不在暂存区）

    • R：重命名（不在HEAD中，在暂存区，路径修改）

    • C：拷贝（不在HEAD中，在暂存区，从其他文件拷贝）

    • T：文件状态改变（在HEAD中，在暂存区，内容相同）

    • U：未合并，需要冲突解决

  • 每个小节的第二行的第二个字母表示工作区文件的更改状态

    • -：新/未知（不在暂存区，在工作区）

    • m：修改（在暂存区，在工作区，被修改）

    • d：删除（在暂存区，不在工作区

2.8 删除指定分支（repo abandon）

该命令实质是对git branch -D的封装，语法如下：

    repo abandon branchName
  • 1
2.9 删除已经合并分支（repo prune）

该命令实质是对git branch -d的封装，用于扫描项目的各个分支，并删除已经合并的分支，语法如下：

    repo prune
  • 1
2.10 将文件添加到index表中（repo stage）

该命令实质是对git add –interactive命令的封装，用于将项目工作区中的改动添加到暂存区，语法如下：

    repo stage -i
  • 1

其中，-i表示 –interactive，给出个界面让用户选择

2.11 设置远程仓库（repo remote）

语法如下：

    repo remote addd remoteName url
  • 1

例如：

    repo remote add org ssh://172.16.1.31/git_repo
  • 1

该命令是根据xml文件添加的远程分支，方便于向服务器提交代码，执行后的build目录下看到新的远程分支是org

2.12 遍历当前项目下的所有git仓库（repo forall）

该命令相当于一个迭代器，会遍历当前项目下所有的git仓库，在所有指定的项目中执行同一个shell命令。

语法如下：

    repo forall -c 命令
  • 1

其中，参数有：

  • -c：后面可以带的任何可以被系统支持的shell命令（ls,cp,pwd等）

  • -p：在shell命令输出之前列出项目名称

  • -v：列出执行shell指令输出的错误信息

该命令还可以添加环境变量：

环境变量的参数有如下几种：

  • REPO_PROJECT:指定项目的名称

  • REPO_PATH:指定项目在工作区的相对路径

  • REPO_REMOTE:指定项目远程仓库的名称

  • REPO_LREV:指定项目最后一次提交服务器仓库对应的哈希值

  • REPO_RREV:指定项目在克隆时的指定分支，manifest里的revision属性

如果-c后面的shell指令是上述的环境变量，则需要用单引号把shell指令括起来。

语法如下：

repo forall –c ‘echo $REPO_PROJECT’
  • 1
2.13 合并多个分支（merge）

例如将所有项目都切换到master分支。

repo forall -p -c git merge local
  • 1

上面的命令就是将local分支合并到master分支上

2.14 打标签（tag）

在所有项目下打标签的命令如下：

repo forall -c git tag 标签名
  • 1
2.15 显示版本号（repo version）

repo安装后，可以通过repo version命令查看版本号。

2.16 帮助文档

repo安装后，可以找到总结所有命令的文档，在终端运行如下命令：

repo help
  • 1

如果想查看具体的某条命令的详细信息，可以通过如下命令:

repo help 命令名称
  • 1

例如想看start指令的具体信息：

最新文章

  1. JAVAWEB项目如何实现验证码
  2. XE3随笔15：使用 IXMLHTTPRequest 简单获取网页源代码
  3. 前端工程化开发之yeoman、bower、grunt
  4. 缓慢变化维 (Slowly changing dimension)
  5. Python实现LR(逻辑回归)
  6. 使用Ant发布hadoop代码到服务器
  7. Java基础知识强化之IO流笔记41：字符流缓冲流之复制文本文件案例02（使用 [ newLine() / readLine() ] ）（重要）
  8. oracle 经典语句集合
  9. SSHD配置
  10. Android数据库专家秘籍(七)经验LitePal查询艺术
  11. Android全屏截图的方法，返回Bitmap并且保存在SD卡上
  12. navicat连接Oracle数据库
  13. mysql大表设计以及优化
  14. flask 压缩json
  15. javascript获取DOM对象三种方法
  16. ubuntu ftp服务
  17. TP图片上传
  18. k8s mongodb 集群配置
  19. WPF 带CheckBox、图标的TreeView（转）
  20. node websocket学习研究

热门文章

  1. Java-枚举(Enum)
  2. Sentry 监控 - Dashboards 事件数据可视化大屏
  3. windows环境下永久修改pip镜像源的方法
  4. [CSP-J2020] 优秀的拆分
  5. 【OI】C++STL 不定长数组 vector
  6. node 在centos 6.5 上 安装过程中出现/usr/lib64/libstdc++.so.6: version 'GLIBCXX_3.4.19' not found问题的解决
  7. Dockers（29）- 网络连通
  8. css定位，class属性之间有空格与无空格的区别
  9. django 常用教程网址
  10. 鸿蒙内核源码分析(Shell编辑篇) | 两个任务,三个阶段 | 百篇博客分析OpenHarmony源码 | v71.01