1. 必要环境Python3及Python2.7(已安装则忽略)
安装python3
brew install python3
安装python2.7
2. 安装repo
根据自身情况二选一
/** 有梯子 */
mkdir -p ~/.bin
PATH="${HOME}/.bin:${PATH}"
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
chmod a+rx ~/.bin/repo
/** 无梯子(清华源) */
mkdir -p ~/.bin
PATH="${HOME}/.bin:${PATH}"
curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/.bin/repo
chmod a+rx ~/.bin/repo
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
报错解决办法请查看：详细版
3. 初始化项目
-
第一步:manifest部分
- 创建default.xml文件,内容如下:
<?xml version="1.0" encoding="UTF-8" ?>
<manifest>
<remote
name="origin" // 仓库名,依照自己git仓库填写,这里只做示例,下同
fetch="ssh://git@gitlab.com/lyuxuming" // 仓库地址,建议使用ssh链接(也可使用https)
revision="master" // 默认分支(默认从该分支上获取代码)
/>
<default
revision="master" // revision的默认值,下面project中没有配置revision时,使用此值
remote="origin" // remote的默认值,下面project中没有配置remote时,使用此值
sync-j="4"
/>
// 单独配置仓库中各项目参数,这里对单独一个做出注释
<project
path="XHMain" // 拉取代码后的相对路径
name="XHMain" // 项目名,与remote.fetch做拼接即是完整项目地址,示例ssh://git@gitlab.com/lyuxuming/XHMain
remote="origin" // 仓库名
revision="master" // 默认拉取的分支名
/>
<project
path="XHBusiness/XHAuthbusiness"
name="XHAuthbusiness"
remote="origin"
revision="master"
/>
</manifest>
- 在gitlab(或github、gitee等等仓库工具)创建空项目,将default.xml丢到根目录下
-
第二步:repo init部分
终端执行:
// 这里链接地址为default.xml所在的项目地址
repo init -u ssh://git@gitlab.com/lyuxuming/manifest.git
报错解决办法请查看：详细版
-
第三步:repo sync部分
终端执行:
repo sync
若成功执行,各仓库项目此时已经按配置下载到本地各文件夹下,demo结构如下图:
demo结构图(pod组件化是另一件事了,这里不讨论)
注:若default.xml(manifest清单)中的配置没错,此时代码应该已经按照其指定分支全部拉取下来了,若报错,报错信息可读性很高,一般可以定位到哪里配置错误.
分割线：至此repo项目创建完成,当然也可以继续做进一步操作
4. 项目操作
-
repo status
执行以检查各组件(各git项目)状态
repo status
-
repo branch
执行以检查各组件(各git项目)所在分支
repo branch
-
repo forall -c <git指令>
执行以一并操纵git仓库
// 所有仓库同时切换到某一分支
repo forall -c git checkout <branchName>
/** 这里不一一列举git命令了,fetch pull push add branch reset等等均与原有git命令相同,若想统一操作,则使用repo forall -c 接 git指令即可. */
