深开鸿KHDVK-3861B之全量解析——初体验之开发环境搭建 原创 精华

作者：罗楚
::: hljs-center

:::

序言

开发板在我们学习OpenHarmony开发中起到事半功倍的作用，但是很多初学者拿到开发板后，不知道如何下手，因此快速上手开发板，建立一个良好的学习平台，对于初学者来讲起着至关重要的地位。

正文

1.搭建开发板环境

1.1 下载并安装VMware Workstation Pro虚拟机

::: hljs-left

操作步骤

步骤1 浏览器输入URL注册登录后下载VMware Workstation Pro虚拟机。（https://customerconnect.vmware.com/cn/downloads/details?downloadGroup=WKST-1621-WIN&productId=1038&rPId=55785）
步骤2 双击安装VMware。
步骤3 在弹出的界面中，选择“下一步”。
步骤4 进入“最终用户许可协议”界面，勾选“我接受许可协议中的条款”，单击“下一步”。
步骤5 进入“用户体验设置”界面。使用默认或根据自己需求选择。单击“下一步”。
步骤6 进入软件快捷方式选择界面，根据自己需求选择是否创建桌面和开始菜单快捷程序。完成后，单击“下一步”
步骤7 进入安装确认界面，单击下方的“安装”，进入程序安装。
步骤8 等待程序安装完成，单击下方的“完成”，完成软件的安装。
步骤9 双击桌面的快捷方式，即可启动该软件。
步骤10 在输入许可证密匙界面中，输入许可证密匙。输入完成后，单击下方的“继续”。
步骤11 进入VMWare Workstation Pro界面。

1.2 下载并安装ubuntu

操作步骤
步骤1 浏览器输入URL：http://mirrors.163.com/ubuntu-releases/，回车。

步骤2 打开“18.04/”文件夹，找到“ubuntu-18.04.6-desktop-amd64.iso”文件并下载。
步骤3 打开“VMWare Workstation”软件，单击“创建新的虚拟机”。

步骤4 选择“典型”。您也可以选择“自定义”，按界面提示安装即可。
1.根据界面提示，选择“稍后安装操作系统”。

2.选择对应配置，“虚拟机名称”为自定义名称，输入英文。“位置”选择系统放的位置。

3.继续按照界面提示安装完成。

步骤5 单击“编辑虚拟机设置”，修改虚拟机参数。

1.编辑内存。
2.编辑处理器。

3.编辑CD/DVD。选择你系统下载的位置。单击“确定”。勾选“启动时连接”。

步骤6 启动虚拟机。
1.单击“开启此虚拟机”。
2.选择“English”，选择“Install Ubuntu”。
3.输入相关信息，按照界面提示继续单击。
4.直到进入安装界面。进度条显示安装进度，该界面安装需30分钟左右，请耐心等待。
5.直到出现安装成功提示，重启。在重启时，打开虚拟机设置，把CD/DVD位置的启动时连接的选项勾选给取消掉，即可正常重启。
6.输入密码登录完成。
7.（可选）若VMware为14版本，可按照界面提示选择。

1.3 安装Ubuntu18.04 open-vm-tools

安装后用户可以从物理主机直接往虚拟机里面拖文件，可实现虚拟机VMware上linux与windows互相复制与粘贴；可以实现窗口放大缩小自动适配。
操作步骤
步骤1 sudo apt-get autoremove open-vm-tools #移除内置的open-vm-tools
步骤2 sudo apt-get install open-vm-tools-desktop #桌面环境需要安装open-vm-tools-desktop以支持双向拖放文件，安装过程中遇到需要输入的，输入“y”
步骤3 重新启动ubuntu系统。reboot
步骤4 验证。可将Ubuntu中的任意文件复制到windows，也可将windows的文件复制到Ubuntu。

1.4 Ubuntu 18.04 LTS 更换国内源

一、更换“/etc/apt/sources.list”文件里的源

操作步骤
步骤1 备份源列表。Ubuntu配置的默认源并不是国内的服务器，下载更新软件都比较慢。所以首先备份源列表文件“sources.list”：
sudo cp /etc/apt/sources.list /etc/apt/sources.list_backup
步骤2 打开sources.list文件修改：
sudo gedit /etc/apt/sources.list
步骤3 选择合适的源，替换原文件的内容，保存编辑好的文件, 以阿里云更新服务器为例（可以分别测试阿里云、清华、中科大、163源的速度，选择最快的）：
编辑“/etc/apt/sources.list”文件, 在打开的文件最前面添加下面阿里云镜像源：
步骤4 保存文件，并刷新列表
sudo apt-get update #执行完此条命令后执行下一条，可能出现报错，reboot一下sudo apt-get upgrade
步骤5 sudo apt-get install build-essential
下载速度瞬间腾飞。
步骤6 其他源
中科大源：

163源：

清华源：

若更换sources.list速度依然还是很慢，请继续往下看第二种方法。

二、更换“software&updates”里的“select best server”

无需改文件，直接在“select best server”里自动选择。

操作步骤
步骤1 在“Show Applications”找“Software & Updates”：

步骤2 打开”software & updates”，”download from”里选择“other”。
步骤3 单击 “select best server”按钮,软件自动寻找到最快的源,然后单击choose server,就选好镜像了，保存弹窗选择“Reload”。
步骤4 把第二项“other software”选项中的其他镜像源的对勾都去掉，该操作不会有影响。
步骤5 终端里输入 sudo apt-get update，sudo apt-get upgrade速度瞬间腾飞。

1.5 搭建编译环境（Python环境）

在搭建python环境之前，为避免后续出现错误，而导致需要重新安装Ubuntu系统，可以先进行快照拍摄保存一个当前状态的虚拟机快照，再执行搭建环境的操作。
快照拍摄步骤：
1.先关闭虚拟机，在关机状态下拍摄快照
2.点击菜单栏的“虚拟机”—“快照”—“拍摄快照”，然后备注一下快照描述。
3.当搭建环境失败后，可点击快照还原到当前位置，再重新进行搭建。

1.5.1 一键搭建环境

如果想优先进行项目实战操作的可一键执行“one一键安装.sh”、“two一键安装.sh”两个脚本文件，搭建环境。
步骤1：将以下两个脚本文件拷贝到Ubuntu系统的用户家目录下

步骤2：右键打开终端，输入命令： sh one一键安装.sh ，回车；
步骤3：输入用户密码，回车，中途遇到提示的按y确认执行；
步骤4：提示：echo “success,please check your python version”，表示执行完成，输入：python --version 命令，查看是不是显示python 3.8.5；如果是，则继续执行步骤5，如果不是，则执行以下python软链接重新设定的操作：
cd /usr/bin/
sudo rm -rf python
sudo ln -s /usr/local/bin/python3.8 python
sudo apt-get update
步骤6：sh two一键安装.sh ，回车，开始一键执行第二个脚本安装；
步骤7：提示：echo “installation is complete！”，表示执行完成。
步骤8：验证环境是否搭建成功：
1.执行“hb -h”,出现如下打印信息，表示hb安装成功；

2.执行下面分步操作步骤的“步骤20”验证是否可以编译“helloworld”范例。

1.5.2 分步操作步骤：如果想一步步体验环境搭建过程，按照本步骤进行！
步骤1 打开虚拟机，在桌面右键，选择“Open Terminal”打开终端。

步骤2 在终端输入“sudo -i”切换为超级管理者权限，最后输入“cd /”进入根目录。输入“ls”。
步骤3 在终端输入“ls -l /bin/sh”（指令为小写的L）查看shell是否为bash，如果显示“/bin/sh ->bash”则为正常，否则按照以下方式修改：
方法一：
1.输入“sudo dpkg-reconfigure dash”，然后选择no。
方法二：
1、先删除sh：“sudo rm -rf /bin/sh”
2、再创建软链接：“sudo ln -s /bin/bash /bin/sh”
步骤4 输入python3 --version，查看python版本号。需要使用python3.7以上版本。如果低于python3.7版本，不建议直接升级，请按照如下步骤重新安装。以python3.8为例，按照以下步骤安装python。

请安装到“/usr/bin/python”文件夹下。
步骤5 如果Ubuntu 版本为18+
方法一：运行 sudo apt-get install python3.8
方法二：在Ubuntu18.04上安装python3.8
1.键入命令：sudo apt update
2.根据提示，键入管理员账户密码。
3.更新完成后，键入命令：sudo apt install software-properties-common

4.看到提示后，键入Y确认继续。
5.键入命令： sudo add-apt-repository ppa:deadsnakes/ppa 出现提示时，按Enter继续
6.完成后，键入命令sudo apt install python3.8 出现提示时，键入Y确认执行。
7.完成后，键入命令：python3.8 --version，看看是否安装成功。
8.输出Python 3.8.7即为安装成功。
9.成功后可直接跳转步骤7。

由于用户环境的不同，这里仅作操作方法介绍，具体以实际为准。
如果Ubuntu版本为16，请以下载包的方式安装python。
1.python安装环境依赖(gcc, g++, make, zlib, libffi)，请运行如下命令：
sudo apt-get install gcc && sudo apt-get install g++ && sudo apt-get install make && sudo apt-get install zlib* && sudo apt-get install libffi-dev：
2.获取python3.8.5安装包，运行如下命令
tar -xvzf Python-3.8.5.tgz && cd Python-3.8.5 && sudo ./configure && sudo make && sudo make install

步骤6 确定python安装好后，将python路径链接到“/usr/bin/python”，方法如下：
1.输入如下命令，查看python是否正确软链接到python3.8。
python --version
2.如果回显不是python 3.8.5，则运行如下命令，查看python3.8所在目录：
which python3.8

可知，“which python3.8” 命令执行后的回显路径为“/usr/bin/python3.8”。
3.将以下命令中的“python3.8-path” 替换为 “which python3.8” 命令执行后的回显路径。

cd /usr/bin
sudo rm python
sudo ln -s python3.8-path python
python --version
–>
cd /usr/bin
sudo rm -rf python
sudo ln -s /usr/bin/python3.8 python
python --version #此时回显为python3.8.x（不同时期下载的版本x有区别）
步骤7 安装并升级Python包管理工具（pip3），任选如下一种方式。
1.命令行方式
1.sudo apt-get install python3-setuptools python3-pip 去掉了-y
2.sudo pip3 install --upgrade pip
3.pip3 --version 查询pip版本
2.安装包方式
1.curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
2.python get-pip.py
步骤8 运行pip3 install setuptools，安装python模块setuptools。（安装时报警告）
步骤9 安装GUI menuconfig工具（Kconfiglib），建议安装Kconfiglib 13.2.0+版本，任选如下一种方式。
1.命令行方式：
sudo pip3 install kconfiglib
2.安装包方式：
（1）下载“.whl”文件（例如：kconfiglib-13.2.0-py2.py3-none-any.whl）。下载路径：“https://pypi.org/project/kconfiglib#files”
（2）运行sudo pip3 install kconfiglib-13.2.0-py2.py3-none-any.whl命令，安装“.whl”文件。
步骤10 安装pycryptodome，任选如下一种方式。
1.命令行方式
sudo pip3 install pycryptodome
2.安装包方式：
(1) 下载“.whl”文件（例如：pycryptodome-3.9.9-cp38-cp38-manylinux1_x86_64.whl）。
下载路径：“https://pypi.org/project/pycryptodome/#files”。
（2）运行如下命令，安装“.whl”文件。
sudo pip3 install pycryptodome-3.9.9-cp38-cp38-manylinux1_x86_64.whl
步骤11 安装six，任选如下一种方式。
安装升级文件签名依赖的Python组件包，包括：pycryptodome、six、ecdsa。安装 ecdsa依赖six，请先安装six，再安装ecdsa。
1.命令行方式
sudo pip3 install six --upgrade --ignore-installed six
2.安装包方式
1.下载“.whl文件”（例如：six-1.12.0-py2.py3-none-any.whl）。
下载路径：https://pypi.org/project/six/#files
2.运行“sudo pip3 install six-1.12.0-py2.py3-none-any.whl”命令，安装.whl文件。
步骤12 安装ecdsa，任选如下一种方式：
1.命令行方式
sudo pip3 install ecdsa
2.安装包方式

1. 下载.whl文件（例如：ecdsa-0.14.1-py2.py3-none-any.whl）。
   下载路径：https://pypi.org/project/ecdsa/#files
2. 运行“sudo pip3 install ecdsa-0.14.1-py2.py3-none-any.whl”命令，安装.whl文件
   步骤13 安装Scons。
   1.运行“sudo apt-get install scons -y”命令，安装SCons安装包（版本显示为3.0.1）。如果软件源中无法找到安装包，或者scons版本低于3.0.4，请按以下步骤处理。
   1.下载源码包（下载路径：“ https://scons.org/pages/download.html ”，推荐SCons版本是3.0.4+）。
   下载命令（以scons-3.1.2为例）：
   wget https://iweb.dl.sourceforge.net/project/scons/scons/3.1.2/scons-3.1.2.tar.gz
   2.解压源码包到任意目录
   tar -xvf scons-3.1.2.tar.gz
   3.安装源码包：进入解压目录，运行如下命令
   cd scons-3.1.2/
   sudo python3 setup.py install
   2.运行“scons -v”命令，查看是否安装成功。如果安装成功，查询结果如下图所示。

步骤14 安装gn。
1.运行“wget https://repo.huaweicloud.com/harmonyos/compiler/gn/1523/linux/gn.1523.tar”，下载。
2.解压gn安装包至~/gn路径下：
tar -xvf gn.1523.tar -C ~/
3.设置环境变量
gedit ~/.bashrc
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/gn:$PATH
4.生效环境变量
source ~/.bashrc
步骤 15安装ninja。
1.运行“wget https://repo.huaweicloud.com/harmonyos/compiler/ninja/1.9.0/linux/ninja.1.9.0.tar” ，下载。
2.解压ninja安装包至~/ninja路径下：
tar -xvf ninja.1.9.0.tar -C ~/
3.设置环境变量。
gedit ~/.bashrc
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/ninja:$PATH
4.生效环境变量。
source ~/.bashrc
步骤16 安装gcc_riscv32（WLAN模组类编译工具链）
1.运行“wget https://repo.huaweicloud.com/harmonyos/compiler/gcc_riscv32/7.3.0/linux/gcc_riscv32-linux-7.3.0.tar.gz”下载。
2.解压gcc_riscv32安装包至“~/gcc_riscv32”路径下。
tar -xvf gcc_riscv32-linux-7.3.0.tar.gz -C ~/
3.设置环境变量：
gedit ~/.bashrc
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/gcc_riscv32/bin:$PATH
4.生效环境变量：“source ~/.bashrc”。
5.Shell命令行中输入“riscv32-unknown-elf-gcc -v”，如果能正确显示编译器版本号，表明编译器安装成功。

步骤17 安装必要的库和工具
使用如下apt-get命令安装编译所需要的库和工具：
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 gcc-arm-linux-gnueabi cpio device-tree-compiler

步骤18 安装hb
1.运行如下命令安装hb
python3 -m pip install ohos-build （此命令安装的0.4.6貌似不能用）
python3 -m pip install --user ohos-build==0.4.3 （用这一条指定版本的可以）
2.设置变量环境
vim ~/.bashrc
将以下命令拷贝到.bashrc文件的最后一行，保存并退出。
export PATH=~/.local/bin:$PATH
3.执行如下命令更新环境变量。
source ~/.bashrc
4.执行"hb -h"，界面打印以下信息即表示安装成功：
5.卸载方法
python3 -m pip uninstall ohos-build

步骤20 验证环境

1. 下载空工程文件夹：
   sudo apt install git #出现提示按y继续
   git clone https://gitee.com/skh_7_0/khdvk-3861b-blank-project.git
2. 进入工程文件夹下，开始编译操作：
   cd khdvk-3861b-blank-project/
   hb set -root . #设置编译路径
   hb set #选择编译项目，选择“helloworld”
   hb build -f #执行编译，编译成功显示如图

1.6 安装vscode

VSCode是微软出的一款编辑器，但是免费的。VSCode 有Windows、Linux和macOS三个版本的，是一个跨平台的编辑器。VSCode下载地址是：https://code.visualstudio.com/。

Windows 版本的安装很容易，和其他 Windows 一样，双击.exe 安装包，然后一路“下一步”即可，安装完成以后在桌面上就会有 VSCode的图标，双击图 打开VSCode。

接下来在VSCode中安装一些必要的插件。
我们需要安装的插件有下面一些：
1)、C/C++，这个肯定是必须的。
2)、C/C++ Snippets，即 C/C++重用代码块。
3)、C/C++ Advanced Lint,即 C/C++静态检测 。
4)、Code Runner，即代码运行。
5)、Include AutoComplete，即自动头文件包含。
6)、Rainbow Brackets，彩虹花括号，有助于阅读代码。
7)、One Dark Pro，VSCode 的主题。
8)、GBKtoUTF8，将 GBK 转换为 UTF8。
9)、ARM，即支持 ARM 汇编语法高亮显示。
10)、Chinese(Simplified)，即中文环境。
11)、vscode-icons，VSCode 图标插件，主要是资源管理器下各个文件夹的图标。
12)、compareit，比较插件，可以用于比较两个文件的差异。
13)、DeviceTree，设备树语法插件。
14)、TabNine，一款 AI 自动补全插件。
15)、Remote-ssh，远程登录插件，必须安装，用于登录编译服务器。
安装完成remote-ssh插件之后点击左侧电脑图标连接虚拟机ubuntu系统。
 

开发环境搭建介绍篇告一段落！未来，我将会在社区里给大家一一介绍KHDVK-3861B每个模块的使用方法和开发教程，带领大家切实的感受开发板的奥秘~ 

 

2022年的夏天，我与大家不见不散！

更多原创内容请关注：深开鸿技术团队

入门到精通、技巧到案例，系统化分享HarmonyOS开发技术，欢迎投稿和订阅，让我们一起携手前行共建鸿蒙生态。