注意: 以下说明中包含{*}的内容均代表变量
在名为manifest的仓库中创建一个default.xml文件作为repo初始化的依据
以下为repo init初始化命令, 需要用 -u参数 来指定manifest的git仓库
repo init -u [email protected]:{namespace}/manifest.git
default.xml文件用例
<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote name="gitee"
fetch="[email protected]:{namespace}"
autodotgit="true" /> <!--fetch=".." 代表使用 repo init -u 指定的相对路径 也可用完整路径，example:https://gitee.com/MarineJ/manifest_example/blob/master/default.xml-->
<default revision="master"
remote="gitee" /><!--revision为默认的拉取分支，后续提pr也以revision为默认目标分支-->
<project path="repo_test1" name="repo_test1" /> <[email protected]:{namespace}/{name}.git name项与clone的url相关-->
<project path="repo_test2" name="repo_test2" />
</manifest>
1、需要注意的是default 的 revision 属性代表着之后提交PR的目标分支
2、不同的项目也可以有不同的 revision ，也就是说之后提交PR的目标分支也可不同， revision 的优先级由低到高
3、fetch当前只支持gitee的ssh
# python3版本 向下兼容
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo
# 赋予脚本可执行权限
chmod a+x /usr/local/bin/repo
# 安装requests依赖，或在执行命令时依据提示自动安装
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
# 如果安装成功但是还是提示错误，建议使用 PyEnv 进行 Python 环境的管理
https://gitee.com/mirrors/pyenv
mkdir your_project && cd your_project
repo init -u [email protected]:{namespace}/manifest.git
repo sync
repo start {branch} --all # 切换开发分支，当对部分仓库进行指定时，会触发仓库的预先fork
分支开发.........
repo forall -c git add ./git add/repo stage # 批量加入暂存区或者单独加入
repo forall -c git commit/git commit # 批量进行提交或者单独提交
repo config --global repo.token {TOKEN} # 进行gitee access_token配置, access_token获取连接 https://gitee.com/profile/personal_access_tokens
repo config repo.pullrequest {True/False} # 对是否触发PR进行配置
repo push --br={BRANCH} --d={DEST_BRANCH} # 进行推送并生成PR和审查，执行后会展示出可进行推送的项目，去掉注释的分支会进行后续推送
repo gitee-pr --br={BRANCH} # 获取项目推送后的指定分支的PR列表
repo push 参数介绍
1、其中值得注意的是 --dest_branch 和 --br 参数，如果不填写对应的分支的话会基于默认分支进行操作， --br 默认会以当前分支进行提交， --dest_branch 会以manifest.xml中的default revision 作为默认目标分支
2、当repo push对仓库进行推送时，会默认向与token相关的用户个人namespace下的仓库推送，在切换分支时没有预先fork成功，则在repo push失败时会再次以token关联的用户对上游仓库进行fork，fork成功后再次push即可
3、repo push默认会以ssh方式向token关联的用户的namespace下进行仓库推送，若需要改为https，则可根据repo config repo.pushurl {用户域名空间地址如:https://gitee.com/xxxx}
repo 结果详情
repo gitee-pr 参数介绍
在 --br={BRANCH} 参数情况下直接返回指定分支下，在gitee平台上已经提交过的PR