2020-02-22更新!我发现谷歌在最近几天发布了git-repo 2.4版本,并更新了 Microsoft Windows Details 文档,直接解决了此文问题,比本文以前的三方解决办法简单很多很多。

最新官方解决方案

一、基础设施

  • 安装最新的Git for Windows(参考下面的旧文即可),目前版本是2.25.1
  • 安装Python 3 ,目前版本是3.8.1,不要安装Python 2,这是和旧办法的不同之处
  • 配置各种环境变量(参照旧文即可),Python 3在安装的时候勾选Add path那项就能自动配置

二、搞起最新的repo工具

和旧文的安装Repo步骤类似,只不过所有都替换成谷歌官方的:

1
2
3
mkdir ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+rx ~/bin/repo

然后注意,先下载最新的repo工具源码,再进行init操作:

1
2
3
4
5
6
7
8
9
10
11
# 先随便新建源码目录
mkdir -p ~/AOSP/.repo
cd ~/AOSP/.repo
# clone工具集
git clone https://gerrit.googlesource.com/git-repo
# 一定要改文件夹名
mv git-repo repo
# 回到AOSP源码目录
cd ..
# 保证你成功
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-10.0.0_r25 --worktree

这里的 --worktree 参数非常重要,不加的话会出现 error.GitError: Cannot initialize work tree for manifests 错误。这个功能也是谷歌在这个月底才更新的。
在这里插入图片描述
最终我也试了下repo sync,repo upload等命令均无问题。


以下是旧文,强烈推荐分隔线以上的最新官方解决方案。

背景

2020真是魔幻的一年,受疫情影响,大家年后一段时间都远程办公了。奈何很多同事在家没有Linux开发环境,想在Windows上通过repo工具下载Android源码简直比登天还难。

网上搜来受去没几个讲透彻的,今天给大家整活。按下面步骤来,保证OK,我们最终以 repo init 执行成功为目标。

走起

一、安装Git for Windows

先到官网(https://git-scm.com/download/win)下载 64-bit Git for Windows Setup 然后安装,基本上一路下一步,但需要注意几点:

  • 第一步第一项有个Add icons什么的,即添加桌面图标,默认没勾,最好勾上。
  • 最后一步有3个Enable xxx,默认第3个(和symbollink相关)没勾,请把它勾上。

二、安装Python 2.7

先到官网(https://www.python.org/downloads/release/python-2717/)下载 Windows x86-64 MSI installer ,这貌似是Python 2时代的最后一个版本了。安装一路下一步即可。

三、配置系统环境变量

上述俩基础组件装完了,检查一下环境变量,Path路径该加的加上,Windows如何查看并添加系统环境变量请大家自行搜索。需要添加如下:

1
2
3
4
5
6
7
C:\Program Files\Git\cmd
C:\Program Files\Git\bin
C:\Program Files\Git\usr\bin
C:\Python27\
C:\Python27\Scripts\
# 这一项不要忘了,先提前配置好,为repo做准备
C:\Users\你的用户名\bin

路径和你安装时的选择相关,切勿直接照抄。还是给大家整个图吧。
在这里插入图片描述

四、安装repo

repo原本是谷歌搞的一个方便下载AOSP的工具,基于git,但由于种种原因,不能直接在Windows上使用。但好心的基佬Hub网友开发了一套改良版的repo,适用于Windows,解决各种Error问题。

首先要把repo命令脚本搞定。在任意处打开 Git Bash (点桌面的快捷方式也可以),然后:

1
2
3
4
mkdir ~/bin
curl https://raw.githubusercontent.com/esrlabs/git-repo/stable/repo > ~/bin/repo
curl https://raw.githubusercontent.com/esrlabs/git-repo/stable/repo.cmd > ~/bin/repo.cmd
chmod a+rx ~/bin/repo

接下来,基本上就和Linux上的操作差不多了。但在repo init时,需要增加或修改 repo-url 参数,具体如下:

1
2
3
4
5
# 先随便新建源码目录
mkdir ~/AOSP
cd ~/AOSP
# 初始化
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-10.0.0_r25 --repo-url=https://github.com/esrlabs/git-repo.git

注意点:

  • 上述命令关键就在 --repo-url=https://github.com/esrlabs/git-repo.git ,替换掉原生的repo工具链,就能成功初始化了。
  • 这里用的是清华镜像源AOSP作示例,一般做ROM开发的公司会有自己的仓库地址,请自行修改init链接。
  • 不要忘了生成ssh的public key,在Windows下也一样:在Git Bash中执行 ssh-keygen 然后复制 ~/.ssh/id_rsa.pub 文件中的内容添加到Gerrit等源码平台上即可。
    在这里插入图片描述
  • 如果发现上面下载速度太慢,可以把 https://github.com/esrlabs/git-repo 项目直接下载下来并解压,复制解压后文件夹中的所有文件到源码目录的的 .repo/repo 子目录下面,然后再重新执行repo init命令,当然这次就不要带 repo-url 参数了。
    在这里插入图片描述
    大功告成!
    在这里插入图片描述

参考