[环境搭建篇] Windows 环境下如何安装repo工具

Windows 环境下如何安装repo工具

• [1. 安装前置依赖](#1. 安装前置依赖)
• [2. 配置Repo引导脚本](#2. 配置Repo引导脚本)
• • 方法一：通过Gitee镜像安装（推荐）
  • 方法二：通过清华镜像安装
• [3. 解决依赖问题](#3. 解决依赖问题)
• [4. 初始化Repo仓库](#4. 初始化Repo仓库)
• [5. 常见问题解决](#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镜像安装（推荐）

1. 创建本地目录并配置环境变量： 这一步及非常关键

   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

2. 将~/bin添加到系统环境变量：

   • 在系统环境变量PATH中添加路径（如C:\Users\用户名\bin）。
   • 验证配置：repo --version应显示版本信息。

方法二：通过清华镜像安装

1. 使用Git克隆Repo工具仓库：

   git clone https://mirrors.tuna.tsinghua.edu.cn/git/git-repo repo

2. 将克隆后的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仓库

1. 创建项目目录并初始化：

   mkdir myproject && cd myproject
   repo init -u https://gitee.com/用户名/manifest.git  # 替换为你的manifest仓库地址

   • 若使用清华AOSP镜像，可指定分支：-b android-10.0.0_r25。

2. 同步代码：

   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'指定镜像源。

---