# openharmony_oneclick_env_init

**Repository Path**: shann-wen/openharmony_oneclick_env_init

## Basic Information

- **Project Name**: openharmony_oneclick_env_init
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 24
- **Created**: 2022-05-11
- **Last Updated**: 2023-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一键初始化OpenHarmony环境

OpenHarmony编译环境配置

### 当前支持操作系统(lsb_release -a 可以查看版本,脚本有强制判断):
| 发行版 | 版本号 | 要求 | 备注 |
| ----- | ----- | ----- | ----- |
| Ubuntu| 18.04、20.04 | | 已验证,且支持WSL同版本 |
| Debian| 9.04 | 必须安装sudo:`apt-get install sudo` | 待验证|

### 在终端命令行执行以下命令
- 下载脚本仓库:
    - 外网环境:`git clone git@gitee.com:landwind/openharmony_oneclick_env_init`.(注意,需要注册码云公钥,详见[SSH 公钥设置 - Gitee.com](https://gitee.com/help/articles/4191))
    - HW内网环境:`git config --global http.sslVerify false;git clone https://codehub-y.huawei.com/m00296829/openharmony_oneclick_env_init`
- 切换到初始化脚本目录:`cd  openharmony_oneclick_env_init`
- 编辑`init.sh`,按实际情况选择需要执行的脚本,重点关注:`source.sh`,如果需要修改apt、pip安装源需要关注`apt_get.sh`、`pip.sh`

- 执行初始化脚本:`apt-get install dos2unix;dos2unix *.sh;bash init.sh;source /etc/profile`
- init.sh当前支持两个参数:
    - `--skip-code`: 默认下载代码,使用--skip-code参数后,默认不下载代码,请注意,如果不下载代码 hb prebuilts脚本等均不会执行; 当指定--skip-code, --with-build参数无效
    - `--with-build`: 默认不编译,使用--with-build后,代码下载完成后自动开始编译

#### 无代理-无脑一键命令(复制粘贴回车,根据提示操作,默认不使用代理,默认将代码下载到当前执行命令目录)
```
git clone git@gitee.com:landwind/openharmony_oneclick_env_init;cd openharmony_oneclick_env_init;apt-get install dos2unix;dos2unix *.sh;bash init.sh;source /etc/profile
```

#### 有代理-无脑一键命令(复制粘贴回车,根据提示操作,中间会编辑source.sh,请按照实际需求维护work_dir,代理信息)
```
git clone git@gitee.com:landwind/openharmony_oneclick_env_init;cd openharmony_oneclick_env_init;apt-get install dos2unix;dos2unix *.sh;vim source.sh;bash init.sh;source /etc/profile
```
#### 各个脚本说明

| ID   | 脚本名                      | 简介                                                         | 备注                                                         |
| ---- | --------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 1    | init.sh                     | 初始化入口脚本,可以实现从环境配置到源码下载所有过程          |                                                              |
| 2    | source.sh                   | 用到的公共内容初始化脚本, 拿到脚本后需要**编辑后**使用       | 编辑后使用,不编辑默认使用脚本所在目录为根目录初始化环境      |
| 3    | apt_get.sh                  | 软件源设置,预置阿里云,如有需要请自行修改                     |                                                              |
| 4    | apt_get_install.sh          | apt-get install相关依赖                                      | 可以单独反复执行,如遇失败/冲突,请自行百度解决; 如有更好的安装建议,欢迎提交issue & PR |
| 5    | check.sh                    | 一些必要检查:发行版本检查,git必要配置检查,ssh连通性检查等    |                                                              |
| 6    | download_code.sh            | 下载源码脚本,含repo引导脚本初始化                            | 请注意,脚本默认执行git reset --hard; git clean -fd, 如果反复执行脚本,请务必注意保存好本地修改 |
| 7    | install_gcc_riscv32.sh      | 安装gcc,默认安装到~/下面,如已存在会重命名                    |                                                              |
| 8    | install_git_with_openssl.sh | 重新使用openssl编译安装git,防止因为gnutls导致的RPC failed; curl 56 GnuTLS recv error(-9) | 按需选择,可以不执行                                          |
| 9    | install_gn.sh               | 安装gn,默认安装到~/,如已存在会重命名                         |                                                              |
| 10   | install_hb.sh               | 安装hb,默认安装到~/.local, 安装hb必须在源码目录执行安装, 如果没有下载源码,脚本执行失败 |                                                              |
| 11   | install_llvm.sh             | 安装llvm,默认安装到~/, 如已存在会重命名                      |                                                              |
| 12   | install_ninja.sh            | 安装ninja,默认安装到~/, 如已存在会重命名                     |                                                              |
| 13   | install_python.sh           | 安装python3.8, 为保持环境一致,当前默认安装3.8                | 注意,会将系统python3默认修改为python3.8                      |
| 14   | notice.sh                   | 用户须知                                                     |                                                              |
| 15   | pip.sh                      | pip安装源配置,预置阿里云,如有需要请自行修改                  |                                                              |
| 16   | pip_install.sh              | pip相关依赖安装,安装前请执行pip.sh配置pip安装源(如已配置可忽略) |                                                              |
| 17   | proxy.sh                    | 代理相关配置, 默认不启用,如果要使用请修改proxy.sh            | 启用后默认配置http_proxy,https_proxy,git proxy               |
| 18   | wsl.sh                      | Windows10 WSL系统特殊脚本, 执行后可以防止因为WSL权限导致的权限不足问题 | 按需执行,如果需要回退修改,重命名/etc/wsl.conf即可            |




# [常见问题](./FAQ.md)