【FFH】轻松配置各类开发板OpenHarmony设备开发环境———DevEco Device Tool一站式集成开发环境搭建

[本文正在参加星光计划3.0–夏日挑战赛]

前言

工具简介

HUAWEI DevEco Device Tool（以下简称DevEco Device Tool）是OpenHarmony面向智能设备开发者提供的一站式集成开发环境，支持OpenHarmony的组件按需定制，支持代码编辑、编译、烧录和调试等功能，支持C/C++语言，以插件的形式部署在Visual Studio Code上。

DevEco Device Tool官方文档
https://device.harmonyos.com/cn/docs/documentation/guide/service_introduction-0000001050166905

特点说明

• 支持代码查找、代码高亮、代码自动补齐、代码输入提示、代码检查等，开发者可以轻松、高效编码。
• 支持丰富的芯片和开发板，包括基于华为海思芯片的Hi3516DV300/Hi3861V100/Hi3751V350/BearPi-HM Nano开发板，以及三方厂商的Neptune/RK3568/Bearpi-HM Micro开发板。
• 支持使用DevEco Device Tool自动下载OpenHarmony稳定版本源码
• DevEco Device Tool工具能自动检测和安装编译所需的环境依赖和工具链、烧录器，实现高效编译和烧录。
• 支持多人共享开发模式，采用基于Remote-SSH模式实现多人共享远程开发，实现一个团队公用一台服务器进行编译、烧录。
• 支持源码级调试能力，提供查看内存、变量、调用栈、寄存器、反汇编等调试信息。

使用体验

刚开始入门OpenHarmony的时候，我们经常会被各种环境的配置劝退，虚拟机，Linux环境，依赖安装，源码获取，编译烧录方式等，环境搭建上就已经难倒了许多人，而在体验了DevEco Device Tool，这些基本都不成问题。

新版的DevEco Device Tool似乎只支持Windows+Ubuntu混合开发的环境，通过远程连接的方式对接Ubuntu下的DevEco Device Tool（可以不安装Visual Studio Code），然后对Ubuntu下的源码进行开发、编译、烧录等操作，但在操作体验上比起传统操作的开发流程着实方便很多。

在这几天体验了DevEco Device Tool V3.0 Release（2022-06-30）版本进行开发环境搭建与设备开发，只能说开发体验极为舒适，从源码获取到源码编译烧录调试，全都是在vscode里面就可以操作，传统的开发方式不仅环境配置复杂，用到的工具也多，比如远程控制工具，烧录工具，串口工具，而这些在DevEco Device Tool中都可以集成使用，不用频繁切换工具。其次，不用再担心Ubuntu开发环境配置的问题，可以说你只需要在Ubuntu下安装一个DevEco Device Tool以及远程ssh工具，其他操作都可以直接在window下一键傻瓜式操作完成。

在这期间我尝试了OpenHarmony轻量，小型，标准系统的编译，烧录，调试，并且只需要下载一个全量代码，就可以实现所有工程的配置，这个是我在同一工程下配置的不同开发板的环境，使用的是OpenHarmony3.1 release全量代码，并且可以轻松实现不同开发板的切换及开发板依赖安装。

系统要求

• Windows系统要求：Windows10 64位系统。
• Ubuntu系统：Ubuntu18.04~21.10版本（可以使用linux服务器或者虚拟机的方式，虚拟机只需要使用普通的镜像进行搭建即可）
• Ubuntu系统的用户名不能包含中文字符。
• DevEco Device Tool3.0 Release（2022-06-30）（Windows和Ubuntu系统都需安装）

配置Ubuntu开发环境

1. 换源

Linux默认的源安装和更新速度很慢，所以安装好系统一般会选择换源。
打开Ubuntu的软件和更新在Download from换成中国的软件源。

2.将Ubuntu Shell环境修改为bash

执行如下命令，确认输出结果为bash。如果输出结果不是bash，根据下一步将Ubuntu shell修改为bash。

    ls -l /bin/sh

打开终端工具，执行如下命令，输入password，然后选择No，将Ubuntu shell由dash修改为bash。

    sudo dpkg-reconfigure dash

3 DevEco Device Tool 下载安装

• 下载DevEco Device Tool 3.0 Release Linux版
  
  下载完后在下载的zip文件的目录打开终端，依次执行下列命令进行解压，加权限，执行。注意devicetool-linux-tool-3.1.0.200后面的版本号要根据实际情况更改。

unzip devicetool-linux-tool-3.1.0.200.zip
chmod u+x devicetool-linux-tool-3.1.0.200.sh
sudo ./devicetool-linux-tool-3.1.0.200.sh

在弹出的界面选择同意隐私协议并回车。

4.安装远程SSH服务

1. 在Ubuntu系统中，打开终端工具，执行如下命令安装SSH服务。

sudo apt-get install openssh-server

说明
如果执行该命令失败，提示openssh-server和openssh-client依赖版本不同，请根据CLI界面提示信息，安装openssh-client相应版本后（例如：sudo apt-get install openssh-client=1:8.2p1-4），再重新执行该命令安装openssh-server。

2. 执行如下命令，启动SSH服务。

sudo systemctl start ssh

3. 执行如下命令，安装网络查询工具,通过ifconfig获取当前用户的IP地址，用于Windows系统远程访问Ubuntu环境。

sudo apt  install net-tools
ifconfig

至此，Ubuntu上的操作基本已经完成，剩下的只需要关注window上的操作配置。

Window开发环境配置

1. 下载DevEco Device Tool 3.0 ReleaseWindows版。

2. 解压DevEco Device Tool压缩包，双击安装包程序，点击Next进行安装。

3. 设置DevEco Device Tool的安装路径，请注意安装路径不能包含中文字符，同时建议不要安装到C盘目录，点击Next。

4. 根据安装向导提示，勾选要自动安装的软件。
   如果弹出如下界面，就说明没安装vscode或者版本低于1.62，勾选“Install VScode 1.62.2automatically”，点击Next。
   
   在弹出的Python select page选择“Download from Huawei mirror”，点击Next。
   接下来安装步骤点下一步即可。

5. 打开Visual Studio Code，若出现DevEco Device Tool工具，则DevEco Device Tool Windows开发环境安装完成。
   

配置Windows远程访问Ubuntu环境

注意以下操作都是在linux服务器虚拟机开启的情况下进行的，并且确保Ubuntu系统与Window在同一网络下，需准备之前通过ifconfig得到的Ubuntu系统的IP地址。

1. 安装remote-ssh插件
   

2.打开远程资源管理器，添加远程计算机

3. 在弹出的SSH连接命令输入框中输入“ssh username@ip_address”，其中ip_address为要连接的远程计算机的IP地址，username为登录远程计算机的帐号。
   

4. 在弹出的输入框中，选择SSH configuration文件，选择默认的第一选项即可。
   

5. 在SSH TARGETS中，找到远程计算机，打开远程计算机。
   

6. 点击完会弹出新的界面，在弹出的输入框中，选择Linux，然后在选择Continue，然后输入登录远程计算机的password，连接远程计算机 。
   
   
   

7. 连接成功后，等待在远程计算机.vscode-server文件夹下自动安装插件，安装完成后，根据界面提示在Windows系统下重新加载Visual Studio Code，便可以在Windows的DevEco Device Tool界面进行源码开发、编译、烧录等操作。至此，环境搭建完成，如下图所示，左下角显示远程连接计算机的IP地址。
   

后记

至此，我们的开发环境都已经搭建完了，现在就可以愉快地进行开发了，这里还推荐在远程的ssh下安装几个插件“C/C++”,“C/C++ Extension Pack”,“Gn”,注意是在ssh下安装，如图，这样就可以实现跳转功能以及C/C++,GN文件代码补全，懒人必备。

后续将会介绍源码下载，编译，烧录，调试等功能，以及我分别在轻量系统，小型系统，标准系统上进行设备开发的全流程，以及踩过的坑。