《HarmonyOS开发 – OpenHarmony开发笔记(基于小型系统)》第2章 OpenHarmony开发环境搭建

开发环境：
开发系统：Ubuntu 20.04
开发板：Pegasus物联网开发板
MCU：Hi3861
OpenHarmony版本：3.0.1-LTS

本文将介绍如何搭建OpenHarmony开发环境，OpenHarmony主要在Linux平台上开发，因此需要使用Linux环境开发，要想使用Linux开发环境，可以选择安装Linux系统，也可在Windows上安装虚拟机，笔者就是使用的该方式，这种方式的好处是可以随时拷贝，非常方便。

笔者的虚拟机使用的是VMware Workstation，Linux系统使用的是Ubuntu 20.04，关于VMware Workstation的安装和Ubuntu的安装笔者这里就不在赘述了，笔者默认大家已经装好VMware Workstation和Ubuntu。

2.1安装依赖包

更新主机的源列表：

$ sudo apt-get update

安装依赖包：

$ sudo apt-get install build-essential gcc g++ make zlib* libffi-dev e2fsprogs pkg-config flex bison perl bc openssl libssl-dev libelf-dev libc6-dev-amd64 binutils binutils-dev libdwarf-dev u-boot-tools mtd-utils cpio device-tree-compiler git git-lfs curl python3-pip tree

值得注意的是，如果Ubuntu Shell环境如果不是bash，则需要修改为bash。检测命令如下：

$ ls -l /bin/sh

打开终端工具，执行如下命令：

$ sudo dpkg-reconfigure dash

然后选择No，即可将Ubuntu shell由dash修改为bash。

2.2获取源码

OpenHarmony的最新版本是3.1(2022-03-30)，关于OpenHarmony的所有版本的更新信息请参看Release Notes。

Release Notes

1.检查Python环境
首先检查下Python版本。

可以看到，Ubuntu 20.04默认的Python版本是3.8.10。因此，无需升级Python。

值得注意的是，如果无法使用python命令，可做一个软链接，命令如下：

$sudo ln -s /usr/bin/python3.8 /usr/bin/python

2.配置Git

配置Git用户信息：

$git config --global user.name "yourname"
$git config --global user.email "your-email-address"

如果想使用ssh下载源码，还需要配置ssh。

关于如何配置gitee的SSH公钥，请参看gitee的帮助中心。

SSH公钥设置

3.安装repo

新建目录：

$ mkdir OpenHarmony
$ cd OpenHarmony

接下来安装码云repo工具，命令如下：

$sudo curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o /usr/local/bin/repo  #也可下载至其他目录，并将其配置到环境变量中

$sudo chmod a+x /usr/local/bin/repo
$pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

4.获取OpenHarmony源码
接下来获取源码OpenHarmony，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 + https下载。

$repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify

$repo sync -c
$repo forall -c 'git lfs pull'

或者：

$repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-v3.0-LTS --no-repo-verify

笔者使用的是https下载。

源码下载完成后，其目录如下：

$tree -L 1

当然啦，如果觉得使用Git麻烦，那么就到华为的repo网站下载。

源码下载地址

当然也可下载最新的版本(V3.1)。

官方手册

2.3安装hb工具

hb是HarmonyOS2.0里新增加的编译构建命令行工具。需要Python 3.7.4及以上版本的支持，建议安装3.8.x。Ubuntu 20.04默认安装的是Python 3.8.10。

在源码根目录下执行：

$ cd ~/OpenHarmony
$python3 -m pip install --user build/lite

然后设置环境变量

$ vim ~/.bashrc

将以下命令拷贝到.bashrc文件的最后一行，保存并退出。

export PATH=~/.local/bin:$PATH

执行如下命令更新环境变量。

$ source ~/.bashrc

执行hb -h有相关帮助信息，有打印信息即表示安装成功：

卸载方法：

$ python3 -m pip uninstall ohos-build

官方手册

2.4安装Python工具

1.安装Scons
运行如下命令，安装SCons安装包。

$ python3 -m pip install scons

运行如下命令，查看是否安装成功。如果安装成功，查询结果下图所示。

$ scons -v

版本要求3.0.4以上。

2.安装python工具模块
运行如下命令，安装python模块setuptools。

$ pip3 install setuptools

3.安装Kconfiglib

安装GUI menuconfig工具（Kconfiglib），建议安装Kconfiglib 13.2.0+版本，命令如下：

$ pip3 install kconfiglib

4.安装Python签名依赖的组件包

安装升级文件签名依赖的Python组件包，包括：pycryptodome、six、ecdsa。安装ecdsa依赖six，请
先安装six，再安装ecdsa。

命令如下：

$ pip3 install pycryptodome
$ pip3 install six --upgrade --ignore-installed six
$ pip3 install ecdsa

2.5安装交叉编译工具链

下载以下交叉编译工具链：

下载地址

将下载的压缩包拷贝到Ubuntu的/opt目录。

然后解压gcc_riscv32-linux-7.3.0.tar.gz：

$ sudo tar -xvf gcc_riscv32-linux-7.3.0.tar.gz

接着修改环境变量：

$vim ~/.bashrc

将以下命令拷贝到.bashrc文件的最后一行，保存并退出。

export PATH=/opt/gcc_riscv32/bin:$PATH

生效环境变量。

$ source ~/.bashrc

检查编译器信息，命令如下：

$ riscv32-unknown-elf-gcc -v

表明编译器安装成功。

小贴士：Ubuntu和Windows互传文件-创建链接

1)虚拟机->设置->共享文件夹

2)选择下一步，然后选择共享文件夹路径

再下一步->完成就可。

3)进行软链接

输入命令：

$ln -s /mnt/hgfs/share

好了，现在Ubuntu和Windows就能互传文件了。

欢迎访问我的网站

BruceOu的哔哩哔哩
BruceOu的主页
BruceOu的博客
BruceOu的CSDN博客
BruceOu的简书
BruceOu的知乎

欢迎订阅我的微信公众号

关注公众号[嵌入式实验楼]获取更多资讯