Windows 环境下如何安装repo工具
- 1. 安装前置依赖
- 2. 配置Repo引导脚本
- 方法一:通过Gitee镜像安装(推荐)
- 方法二:通过清华镜像安装
- 3. 解决依赖问题
- 4. 初始化Repo仓库
- 5. 常见问题解决
前言: 在Windows环境下安装Repo工具需要结合Git和Python环境,并配置相应的脚本及依赖。
1. 安装前置依赖
- Git:从官网下载并安装Git for Windows,安装时勾选“Add to PATH”以配置环境变量。
- Python:安装Python 3.9或更高版本Python for Windows,安装时勾选“Add Python to PATH”选项。建议使用Python 3.x版本,Repo对Python 2的支持已逐渐淘汰。
2. 配置Repo引导脚本
方法一:通过Gitee镜像安装(推荐)
- 创建本地目录并配置环境变量: 这一步及非常关键
mkdir ~/bin curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > ~/bin/repo curl https://raw.githubusercontent.com/esrlabs/git-repo/stable/repo.cmd > ~/bin/repo.cmd chmod a+x ~/bin/repo
- 将
~/bin
添加到系统环境变量:- 在系统环境变量
PATH
中添加路径(如C:\Users\用户名\bin
)。 - 验证配置:
repo --version
应显示版本信息。
- 在系统环境变量
方法二:通过清华镜像安装
- 使用Git克隆Repo工具仓库:
git clone https://mirrors.tuna.tsinghua.edu.cn/git/git-repo repo
- 将克隆后的
repo
目录路径(如E:\workspace\.repo\repo
)添加到环境变量PATH
。
3. 解决依赖问题
- 安装requests库:Repo依赖Python的
requests
库,需通过以下命令安装:
若未安装,执行pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
repo init
时会报错。
4. 初始化Repo仓库
- 创建项目目录并初始化:
mkdir myproject && cd myproject repo init -u https://gitee.com/用户名/manifest.git # 替换为你的manifest仓库地址
- 若使用清华AOSP镜像,可指定分支:
-b android-10.0.0_r25
。
- 若使用清华AOSP镜像,可指定分支:
- 同步代码:
repo sync
- 首次同步可能耗时较长,建议使用管理员权限运行Git Bash以避免权限问题。
5. 常见问题解决
- 网络问题:若无法访问Google源,需替换镜像地址:
- 修改
.repo/manifests/default.xml
,将fetch
字段替换为国内镜像(如https://aosp.tuna.tsinghua.edu.cn/
)。
- 修改
- 环境变量未生效:重启终端或执行
source ~/.bashrc
(Git Bash中)。 - Repo版本冲突:通过
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
指定镜像源。