安装与配置

安装 git-repo

依赖

git-repo 依赖Git，在安装 git-repo 之前，需要确保已经安装了Git。

下载和安装 git-repo

1. 访问 git-repo 的下载页面：https://git-repo.info/zh_cn/。根据您的平台类型（Linux、Mac、或是 Windows），CPU 类型（amd64 或 386）下载合适的软件包。

2. 如果是 Linux 或者 Mac OS X 平台，为下载文件设置可执行权限。例如：

   $ chmod a+x git-repo

3. 将下载的可执行文件复制到可执行目录。对于 Linux 和 Mac OS X 平台，这个目录可以是/usr/local/bin 或者其他目录。对于 Windows 平台，这个目录可能是C:\Windows\system32。

   $ git repo --version

运行 git-repo

安装完毕，尝试执行下面命令。注意下面命令中 Git 和 repo 之间可以不再需要短线，因为repo 命令已经自动注册为 Git 的一个子命令。

$ git repo --version

运行后，可以查看 git-repo 帮助

$ git repo -h

或者

$ git repo

git repo 有很多子命令。可以用如下命令查看子命令的帮助：

$ git repo help sync

配置 git-repo

在用户主目录下的.git-repo/config.yml 文件，可以修改 git-repo 默认设置。如：

• verbose: 1 1: 显示 Info 级别日志；2: 显示 Debug 级别数据。

• loglevel: warning 设置打印到日志时的日志级别

• logrotate: <size>日志回滚大小，默认 20MB

• logfile:<file> 设置日志文件名称

软件升级

运行下面命令升级 git-repo：

$ git repo upgrade

从升级服务器自动下载相应平台的 git-repo 升级包，完成应用的替换和升级。

如果由于文件权限或者其它原因导致升级失败，会给出错误提示。例如：

$ git repo upgrade
    Download git-repo: ############################################################ 100%
    +--------------------------------------------------------------------------------+
    | Fail to upgrade. Please copy                                                   |
    |         /var/folders/5d/21v9l2z12j/T/git-repo-0.2.0-619707833                  |
    | to                                                                             |
    |         /usr/bin/git-repo                                                      |
    | by hands                                                                       |
    +--------------------------------------------------------------------------------+
    Error: upgrade failed

遇到类似上面的错误提示，手工完成文件复制。例如：

sudo cp /var/folders/5d/21v9l2z12j/T/git-repo-0.2.0-619707833 /usr/bin/git-repo

命令格式

git repo upgrade [options...]

选项

主要的选项如下：

• --url <URL>：使用指定的升级服务器地址。默认使用https://github.com/alibaba/git-repo-go/releases作为升级服务器地址。

• --test：升级到测试版本。测试版本是由升级服务器的 version.yml 的 test 字段定义的。