4.2 KiB
帮助信息
repo用法详解：从源码的角度解释repo的用法
manifest-format：详细的manifest格式说明
简介
用于管理多个git仓库。其下层调用的是git命令，本身是python脚本。
其设计思想是新建一个仓库来管理要管理的仓库，这个仓库就是manifest仓库，它位于 .repo文件夹里。
所有仓库的信息都放在manifest仓库的xml文件里，其各节点的意义如下：
-
remote：远程仓库地址
name：名字，alias：别名，fetch：仓库地址前缀，revision：默认分支
-
project：子仓库
path：子仓库路径，name：子仓库名称，group：分组，revison：分支名，clone-depth：git克隆的深度
-
copyfile：project的子节点
src：project的相对路径，dest：仓库的相对路径
-
linkfile：project的子节点，类似copyfile，只是把复制文件变为创建链接文件。
-
default：project没有设置时会使用默认配置。
语法
repo [command] [options]
命令
使用repo help <command>获取详细信息。
abandon # 禁止一个开发分支
branch # 查看当前分支
branches # 查看当前分支
checkout # 检查一个分支
cherry-pick # cherry-pick一个分支
diff # 显示commit和工作树之间的区别
diffmanifests # 显示diff工具
download # 下载和检查一个分支
forall # 在每个project运行同样的shell命令
-r, --regex
-i, --inverse-regex
-g GROUPS, --groups=GROUPS
-c, --command # 要执行的命令
-e, --abort-on-errors
gitc-delete # 删除一个GITC客户端
gitc-init # 初始化一个GITC客户端
grep # 打印出若干符合模式的行
help # 打印出关于命令的帮助信息
info # 从显示分支，当前分支或未合并分支获取信息
init # 在当前目录初始化repo
-u URL # 指定manifest仓库的地址
-b REVISION # 指定manifest仓库的分支或版本
manifest # 显示当前使用的manifest信息内容
overview # 显示project未合并分支的概览
prune # 删除已经合并的分支
rebase # 使本地分支以上游分支为基础
selfupdate # 将repo更新到最新的版本
smartsync # 将工作树更新到最新的完善版本
stage # 把文件添加到暂存区中
start # 开始一个新的开发分支
status # 显示工作树的状态
sync # 将工作树更新到最新版本
-f # 即使某些项目同步失败，也会继续同步其它项目
-j JOBS # 同步下载的JOBS个项目，默认下载4个
upload # 把代码提交到gerrit code review中
viersion # 显示repo的版本
使用示例
# 查看所有分支
git --git-dir .repo/manifests/.git branch -a
# 复制别人的仓库
# 只需要把.repo目录复制出来即可，不需要全部都复制
# 然后执行repo sync
# .repo目录
ls .repo # 查看.repo目录
> manifests # repo配置信息的git库
> manifests.git # repo配置信息的git库
> manifest.xml # 到配置信息的软链接
> project.list # 所有仓库的列表
> project-objects # 看起来像各个仓库的git配置，只是普通目录不是git仓库
> projects # 对repo工作目录的备份，只是普通目录不是git仓库
> repo # repo脚本的git库，包含repo命令的所有实现
错误解决
repo sync的错误
错误提示：git prior sync failed; rebase still in progress 解决方法：进到出问题的目录，执行git rebase --abort，提示It looks like git-am is in progress. Cannot rebase.执行git am --abort。再回到原目录执行repo sync即可。 原因分析：由于rebase操作还在进程中，导致sync失败。解决方法就是让rebase退出进程。
错误提示：error.GitError: platform/art rev-list ('4c2be345d6bfc25db87f23749912ae9d98d2ad62', 'HEAD', '--'): fatal: bad object HEAD 解决方法：删除art目录，再进行repo sync 原因分析：可能是art目录进行了一些修改，导致git命令执行失败
错误提示：access denied or repository not exported 解决方法：清空整个工作区，重新reop sync 原因分析：删除出错的仓库都无效，删除整个工作区才有效，无法理解此问题