knowledge_demo_smart_home/docs/MiniSystemApplicationDevelopment_01_HelloWorld

轻量系统应用开发之HelloWorld

样例简介

本文档讲述的是如何轻量系统应用开发之HelloWorld的应用，以欧智通BES2600WM开发板为例，重点是带我们快速上手轻量系统应用开发。

运行效果

当设备应用启动之后，操作效果如下:

 

样例原理

 

如上流程图所示，样例主要通过最简单的HelloWorld应用来带我们上手如果在轻量系统上开发应用，有哪些环境准备工作，操作步骤。

工程版本

• 系统版本/API版本：OpenHarmony 3.1 release
• IDE版本：DevEco Studio 3.0 Beta2

快速上手

准备硬件环境

欧智通BES2600/V200Z-R开发板 *1；

准备开发环境

• 安装最新版DevEco Studio。

• 请参考配置OpenHarmony SDK，完成DevEco Studio的安装和开发环境配置。

• 开发基础环境由 windows 工作台和 Linux 编译服务器组成。windows 工作台可以通过 samba 服务或 ssh 方式访问 Linux编译服务器。其中 windows 工作台用来烧录和代码编辑，Linux 编译服务器用来编译 OpenHarmony 代码，为了简化步骤，Linux 编译服务器推荐安装 Ubuntu20.04。

安装必备软件

安装和配置Python3

1. 打开Linux终端。

2. 输入如下命令，查看python版本号，需要使用python3.7以上版本,否则参考 系统基础环境搭建。

   python3 --version
   

3. 安装并升级Python包管理工具（pip3）。

   sudo apt-get install python3-setuptools python3-pip -y
   sudo pip3 install --upgrade pip
   

4. 设置pip的国内镜像

   pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
   

安装交叉编译环境

在Linux编译服务器上搭建好基础开发环境后，需要安装OpenHarmony 编译欧智通BES2600平台特有的开发环境。

安装必备库文件和工具

sudo apt-get install -y build-essential gcc g++ make zlib* libffi-dev git git-lfs python

安装编译工具链arm-none-eabi-gcc

1. 打开Linux终端。

2. 下载arm-none-eabi-gcc编译工具。

3. 安装arm-none-eabi-gcc

解压 gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 安装包至~/toolchain/路径下。

   mkdir -p ~/toolchain/
   tar -jxvf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 -C ~/toolchain/

设置环境变量。

   vim ~/.bashrc

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

   export PATH=~/toolchain/gcc-arm-none-eabi-10.3-2021.10/bin:$PATH

生效环境变量。

   source ~/.bashrc

1. 在命令行中输入如下命令，如果能正确显示编译器版本号，表明编译器安装成功。

   arm-none-eabi-gcc -v
   

准备工程

准备repo

1）下载repo工具
mkdir ~/bin
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > ~/bin/repo
chmod a+x ~/bin/repo

2）设置环境变量并生效
vim ~/.bashrc
export PATH=~/bin:$PATH
source ~/.bashrc 

准备应用工程源码

准备应用工程源码，可以选择创建新的工程，也可以直接下载helloWorld应用源码

创建工程

1. 首先需要下载开发IDE选择DevEcoStudio 3.0 Beta2 版本，最新的DevEcoStudio 3.0 Beta3暂不支持轻量系统开发模板

2. 选择轻量系统应用开发: "[Lite]Empty Ability"模板，如图：

1. 填写工程信息，点击 “Finish”，至此，新建工程完毕，如图

下载工程源码

通过repo + https 下载到自己的虚拟机，输入如下repo命令 
repo init -u https://gitee.com/openharmony-sig/knowledge_demo_smart_home/FA/MiniSystemApplicationDevelopment_01_HelloWorld

编译工程源码

编译工程“Build” ->Build Hap(s)/APP(s)" ->Build Haps(s)"，编译通过，生成Hap文件完毕，点击“Build”可查看编译成功

生成固件

下载系统源码

通过repo + https 下载到自己的虚拟机，输入如下repo命令 
repo init -u https://gitee.com/openharmony/manifest.git -b refs/tags/OpenHarmony-v3.1-Release --no-repo-verify

注意：

1.权限问题请参考生成/添加SSH公钥。

2.若在已安装python3.8后，执行repo init 时，仍显示如下错误：

/usr/bin/env: ‘python’: No such file or directory

执行如下命令后，进行重试：

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

安装hb

1. 输入如下命令确认hb是否为version 0.4.4 版本以上

   hb -v
   

a. 若提示如下内容，则表示未安装可以从第2步开始操作。

   bash: /home/***/.local/bin/hb: No such file or directory

b.若提示如下内容，需要先卸载该版本，然后再执行第2步操作步骤。

   [OHOS INFO] hb version 0.4.3

卸载命令：

   pip3 uninstall ohos-build

1. 运行如下命令安装hb

   pip3 install build/lite   // 该命令需在OpenHarmony源码根目录下执行
   

2. 设置环境变量

   vim ~/.bashrc
   

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

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

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

   source ~/.bashrc

1. 再次执行”hb -v“，有以下版本显示则表示安装的hb 0.4.4 以上版本正确。

   [OHOS INFO] hb version 0.4.6
   

提取hap文件

1.进入到新建的HelloWrold工程下 “\entry\build\outputs\hap\debug”目录，找到hap包：“entry-debug-lite-unsigned.hap”，为方便解压可将该.hap文件复制一份，并将后缀名修改成 “.zip”，如图：

2.解压该zip包，依次进入“asset/js/default/” 目录，删除app.js.map，保存剩余的文件，如图：

集成固件源码

1.下载开发板代码

repo init -u https://gitee.com/openharmonysig/knowledge_demo_smart_home/dev/team_x/MiniSystemApplicationDevelopment_01_HelloWorld_Device 

下载完成后打开bes2600_hello_world 文件如图

2.然后将上一节保存的Hap文件拷贝到开发板源码“bes2600_hello_world/fs/data/data/js”目录，如图

3.拉起JS应用需要将开发板源码中的包名与JS工程的包名一致，本应用的包名为com.example.helloworld （注：拉起JS应用接口实现在bes2600_hello_world/demo_bes2600/ability/ability_device.cpp中）

4.最后将修改好的开发板源码bes2600_hello_world文件夹,拷贝到系统代码“openharmony/vendor/bes2600/” 路径下，如图

编译

1.在虚拟机进入openharmony/目录，输入命令：“hb set”，需要下载hb工具选择刚才的工程名字：“bes2600_hello_world”，如图：

2.输入命令：“hb build”，开始编译，打印build success就说明编译通过，生成固件完成，如下图2，图3：拷贝write_flash_gui文件夹到window系统里面，进行固件烧录

安装

因为欧智通BES2600/V200Z-R 开发板的烧录程序是包含在对应out文件夹对应product目录下的，无需使用额外的烧录工具，在安装了相应驱动文件后，执行烧录可执行文件即可，下面是具体的操作步骤：

1.安装CP2102驱动，解压后双击与自己window 版本相匹配的可执行文件，并按相关提示安装驱动文件即可；

2.查看串口com号

鼠标右键点击PC右下角，打开：“设备管理器(M)”（注: 打开设备管理器前，请确保CP210x串口驱动是否安装）搜索 “端口 -> USB SERIAL Port(COM10*)"，需要记住COM*，每台设备的不一样，如图：

（注：假如端口没显示，请拔掉usb口再插上或更换usb线）

3.打开wifi烧录工具

固件编译完成以后拷贝~/openharmony/out/v200zr/MiniSystemApplicationDevelopment_03_GasDetectionJSI_Device/write_flash_gui文件夹到windows下（或者利用samba服务直接访问该目录），并双击可执行文件Wifi_download_main.exe，如图：

4.串口选择

• 点击工具上的文件夹图标

• 选择List按钮

• 选择对应的com口，点击“OK”

• 勾选需要烧录的串口, 并点击开始按钮

5.在开发板上点击reset按键，或者重新上电。

6.进入烧录状态，如图：

7.烧录成功，如图：

​ 注意：固件烧录完成后需将烧录窗口关闭，再按下设备Reset键设备才能启动。如果未将烧录窗口关闭，设备会再次进行烧写状态。

操作体验

1. 将开发板上电，待正常启动后,在开发板显示屏上展示Hello world 文字

参考资料

• 欧智通BES2600WM开发板轻量设备上手文档
• 知识体系