# ohos_download

**Repository Path**: itopen/ohos_download

## Basic Information

- **Project Name**: ohos_download
- **Description**: 一键下载openharmony代码
- **Primary Language**: Shell
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 10
- **Created**: 2024-05-08
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ohos_download

# 一、脚本介绍

## 1.1 概述

本仓脚本是为了方便所有开源爱好者能更加方便的下载鸿蒙源码。通过可视化一键下载，省去开发者每次需要记录各种每个分支和tag下载命令的烦恼。

本脚本支持以下功能

- 支持所有通过repo命令下载的代码配置
- 支持常用的`gitee、gitcode`等代码服务器配置介绍及下载失败提醒处理方法
- 支持智能化代码路径配置
- 支持代码下载成功后产品简介输出，方便实操和记忆

## 1.2 脚本配置

### 1.2.1 新增产品配置

当有新增产品时，只需要在`config/product.list`里按照介绍说明添加一列对应产品信息即可，关于字段如何添加`product.list`中有详细介绍。

如果产品有相关简介，将对应的简介放入`docs/products`目录下即可，注意简介是在终端输出，因此只支持文本文件。简介一般最好按照模板进行分支介绍、分支编译、结果文件以及详细文档路径即可，可适当增加条目，但不宜多。

### 1.2.2 路径配置

当第一次使用该脚本下载代码的时候会提示设置代码下载的路径，然后会将该路径保存在本地的`.config`文件中，后面再次下载则不再提示，默认保存在`~/OpenHarmony`里面。

如果同一套代码多次下载时，第二次默认保存的路径为第一次路劲加`_tmp`，如果是第三次下载，则会提示默认路径和加`_tmp`的路径都存在，让重新设置路径。

![icon-danger.gif](./img/icon/icon-danger.gif) **警告： 此时设置的路径如果存在会被删除的！！！**

**运行效果如下：**

![image-20260118130615404](./img/save_base_path.png)

![image-20260118132515931](./img/replace_path.png)

# 二、脚本使用介绍

## 2.1 脚本下载

``` shell
git clone https://gitee.com/itopen/ohos_download.git
cd ohos_download
./ohos_download.sh
```

## 2.2 脚本运行

脚本运行分为三种模式

```shell
# 默认运行, 只显示支持过xts的代码分支
./ohos_download.sh

# release参数, 显示的分支比默认多一些
./ohos_download.sh release

# all参数, 显示所有release分支代码, 从1.x开始到现在的
./ohos_download.sh all
```

## 2.3 运行效果展示

- 设置默认代码保存路径

  ![image-20260118130615404](./img/save_base_path.png)

- 主界面显示

  ![image-20260118133536754](./img/main_menu.png)

- 配置提醒显示

  ![image-20260118133857909](./img/config.png)

- 产品简介展示

  ![image-20260118133940665](./img/product.png)

- 下载命令展示

  ![image-20260118134218277](./img/download_cmd.png)

- 目录重置界面

  ![image-20260118132515931](./img/replace_path.png)

- 下载失败提醒界面

  ![image-20260118135249507](./img/notify.png)