Note：下面包含操作过程和问题解决（首次安装Ubuntu，环境未完善），没有遇到问题可以直接跳过问题part了，小白也能完成配置下载。

前置准备（Git环境账号）

（一）安装git客户端

本地虚拟机用Ubuntu（其他Linux命令不同）

# 基于 Debian 的发行版上，如 Ubuntu，使用 apt 下载
$ sudo apt install git-all

输入y确认安装，

安装完成

（二）安装git-lfs

Git LFS is a command line extension and specification for managing large files with Git.

The client is written in Go, with pre-compiled binaries available for Mac, Windows, Linux, and FreeBSD. Check out the website for an overview of features.

Git LFS 是Git的一个扩展，旨在更有效地处理大型文件。

• Linux users. Debian and RPM packages are available from PackageCloud.

• Binary packages. In addition, binary packages are available for Linux, macOS, Windows, and FreeBSD.

GitHub比较难访问上。

sudo apt-get install git-lfs

（三）配置Gitee码云用户信息

查看当前git账户信息，不配置时是没有任何信息的，

git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store

（四）安装码云repo工具

创建目录并在此路径下安装

# 创建“~/bin”目录（可自定义，如下bin目录创建在与desktop同级）
mkdir ~/bin

# 安装码云repo工具
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o ~/bin/repo 

# 修改repo权限
chmod a+x ~/bin/repo

# 安装包（可通过pip3 install --help 查看指令使用手册）
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

 创建目录及正常安装过程

1、创建bin文件夹并查看。终端路径默认是Desktop，因此“~/”会在与Desktop同一目录。

2、安装repo工具（前提是安装好curl，若未完成所需工具安装，下文有报错解决，终端也一样有解决提示）

3、授权

Note：pip3使用手册介绍 

环境问题：安装时curl等报错解决

报错提示：

Command 'curl' not found, but can be installed with:

sudo snap install curl  # version 8.1.2, or
sudo apt  install curl  # version 7.68.0-1ubuntu2.20

See 'snap info curl' for additional versions.

根据提示Ubuntu使用以下命令，输入密码并y确认安装

sudo apt  install curl # version 7.68.0-1ubuntu2.20

问题：安装报错了

问题：如下使用apt-get也是同样的错误，应该要先更新

解决方案：应该要先执行下面命令更新

sudo apt-get update #先更新，后安装

然后curl安装成功了：

（五）将repo添加到环境变量

vim ~/.bashrc               # 编辑环境变量
export PATH=~/bin:$PATH     # 在环境变量的最后添加一行repo路径信息
source ~/.bashrc            # 应用环境变量

1、输入“vim ~/.bashrc”进入配置文件编辑

2、在环境变量的最后添加一行repo路径信息：export PATH=~/bin:$PATH

3、应用环境变量，使配置生效

环境问题：缺少vim

安装完成，可以编辑了，

※下载步骤

 说明：

• 发布版本代码相对比较稳定，开发者可基于发布版本代码进行商用功能开发。
• Master主干为开发分支，开发者可通过Master主干获取最新特性。

（一）OpenHarmony发布版本代码获取

方式请参考Release Notes，当前已更新到4。

（二）OpenHarmony主干代码获取

方式一（推荐）：通过repo + ssh下载

（需注册公钥，请参考码云帮助中心）。

repo init -u git@gitee.com:openharmony/manifest.git -b master --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

 repo初始化仓库，指定master分支

-c, –current-branch：只同步指定的远程分支。默认情况下，sync会同步所有的远程分支，当远程分支比较多的时候，下载的代码量就大。使用该参数，可以缩减下载时间，节省本地磁盘空间。 

方式二：通过repo + https下载。

repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

问题1：没有python

报错提示：/usr/bin/env: ‘python’: No such file or directory

先查看当前python版本，确认是否真的没有python。

# 用于查看python版本的指令
python -V 
python --version

python # 进入python了

没有python，但是有python3（可按提示执行python3）。看来系统默认安装的是python3版本，

Note：如果环境中安装了2和3，分别区分 python2 -V 和python3 -V

解决：从版本查看确定系统已经安装了python，那么将Python 3.8设置为默认Python版本即可。

#1. 查看python3.8的路径
which python3.8 

#2. 将Python和Python3切换为Python 3.8
sudo update-alternatives --install /usr/bin/python python {Python 3.8 路径} 1
#{Python 3.8 路径}为上一步查看的Python 3.8的位置

#本机例子，不要漏了1
#使用手册 update-alternatives: --install needs <link> <name> <path> <priority>
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1

sudo update-alternatives --install /usr/bin/python3 python3 {Python 3.8 路径} 1

1、先查看python3.8的路径（上面提示版本3.8.10，但查看路径使用python3.8，没有空格的）

Note：也能直接进入/usr/bin目录下查看python全部情况，如下系统已经安装python和python3.8这两种。

2、将python和python3切换为Python 3.8（按需可选是否配置python3），不要漏了1。

Note：Debian系列（Ubuntu是其子类）update-alternatives工具用于在多个同功能的软件，或软件的多个不同版本间选择。

问题2：SSH公钥未配置，repo fail

解决方案：参考码云Gitee的 「仓库管理」->「公钥管理」 章节。

Note：.ssh key的类型有四种，分别是dsa、rsa、 ecdsa、ed25519。如上使用的是ed25519，也可以替换成比较常用的rsa。

1、在Ubuntu虚拟机生成sshkey

ssh-keygen -t ed25519 -C "xxxxx@xxx.com"  
# Generating public/private ed25519 key pair...

会提示生成公钥.pub文件的路径。

2、在Gitee账户添加公钥配置

根据上述提示路径，可查看用户 ~/.ssh/id_ed25519.pub 文件内容，获取到自己的 public key（公钥）。

复制生成后的 ssh key，通过主页右上角 「个人设置」->「安全设置」->「SSH公钥」->「添加公钥」 ，添加生成的 public key 添加到当前账户中。（标题可自定义，需要输入Gitee密码验证。）

项目部署用：仓库主页 「管理」->「部署公钥管理」->「添加部署公钥」 ，添加生成的 public key 添加到仓库中。

重新下载还是报错，需要配置本地git账户信息，按指令执行就好了。

Other

安装库和工具集

下载OpenHarmony的过程中报错缺少xxx，因此安装需要的库和工具（如果是从头开始新建一台虚拟机的话）。

Ubuntu 使用如下apt-get命令安装后续操作所需的库和工具：

sudo apt-get install binutils binutils-dev git git-lfs gnupg flex bison gperf
build-essential zip curl zlib1g-dev libc6-dev-i386 lib32ncurses5-dev x11protocore-dev libx11-dev lib32z1-dev ccache libgl1-mesa-dev libxml2-utils xsltproc
unzip m4 bc gnutls-bin python3.8 python3-pip ruby genext2fs device-tree-compiler
make libffi-dev e2fsprogs pkg-config perl openssl libssl-dev libelf-dev libdwarfdev u-boot-tools mtd-utils cpio doxygen liblz4-tool openjdk-8-jre gcc g++ texinfo
dosfstools mtools default-jre default-jdk libncurses5 apt-utils wget scons
python3.8-distutils tar rsync git-core libxml2-dev lib32z-dev grsync xxd
libglib2.0-dev libpixman-1-dev kmod jfsutils reiserfsprogs xfsprogs squashfstools pcmciautils quota ppp libtinfo-dev libtinfo5 libncurses5-dev libncursesw5
libstdc++6 gcc-arm-none-eabi vim ssh locales libxinerama-dev libxcursor-dev
libxrandr-dev libxi-dev


sudo apt-get install gcc-arm-linux-gnueabi gcc-9-arm-linux-gnueabi

结合ubuntu虚拟机安装配置，包含但不限于，主要是目前遇到的：

• make gcc perl
• git-lfs
• curl
• vim
• python

同步指定分支代码命令

如OpenHarmony-4.1-Beta1

repo init -u https://gitee.com/openharmony/manifest -b OpenHarmony-4.1-Beta1 --no-repo-verify

查看目录大小，repo init完成4.1Beta1的只有11M（4x在同步代码）

du -sh ./* #查看当前目录内存占用

OpenHarmony版本

OpenHarmony Stable Version类型的源码为OpenHarmony稳定版本源码，通过镜像站点获取，支持：

• OpenHarmony-v3.0.3-LTS、
• OpenHarmony-v3.1-Release、
• OpenHarmony-v3.2-Beta3、
• OpenHarmony-v3.2-Beta4、
• OpenHarmony-v3.2-Beta5、
• OpenHarmony-v3.2-Release版本。

获取OpenHarmony对应版本的最新源码，请参考从码云仓库获取源码。

获取源码后，参考 《HUAWEI DevEco Device Tool 使用指南》的“导入OpenHarmony源码”章节，可在DevEco Device Tool 中导入源码。