# 轻量系统应用开发之HelloWorld

## 样例简介

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

### 运行效果

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

 ![运行效果](media/demo.jpg)



### 样例原理

 ![流程图](media/process.png)

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

###  工程版本

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

## 快速上手

### 准备硬件环境

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

### 准备开发环境

- 安装最新版[DevEco Studio](https://gitee.com/link?target=https%3A%2F%2Fdeveloper.harmonyos.com%2Fcn%2Fdevelop%2Fdeveco-studio%23download_beta_openharmony)。
- 请参考[配置OpenHarmony SDK](https://gitee.com/openharmony/docs/blob/update_master_0323/zh-cn/application-dev/quick-start/configuring-openharmony-sdk.md)，完成**DevEco Studio**的安装和开发环境配置。

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


#### 安装必备软件

##### 安装和配置Python3

1. 打开Linux终端。

2. 输入如下命令，查看python版本号，需要使用python3.7以上版本,否则参考 [系统基础环境搭建](https://gitee.com/openharmony/docs/blob/OpenHarmony_1.0.1_release/zh-cn/device-dev/quick-start/%E6%90%AD%E5%BB%BA%E7%B3%BB%E7%BB%9F%E5%9F%BA%E7%A1%80%E7%8E%AF%E5%A2%83.md)。

   ```
   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](https://gitee.com/link?target=https%3A%2F%2Fdeveloper.arm.com%2F-%2Fmedia%2FFiles%2Fdownloads%2Fgnu-rm%2F10.3-2021.10%2Fgcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2)编译工具。

3. 安装[arm-none-eabi-gcc](https://gitee.com/link?target=https%3A%2F%2Fdeveloper.arm.com%2F-%2Fmedia%2FFiles%2Fdownloads%2Fgnu-rm%2F10.3-2021.10%2Fgcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2)

   解压 [gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2](https://gitee.com/link?target=https%3A%2F%2Fdeveloper.arm.com%2F-%2Fmedia%2FFiles%2Fdownloads%2Fgnu-rm%2F10.3-2021.10%2Fgcc-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
   ```

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

   ```
   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"模板，如图：

   ![开发模板选择](media\select.png)

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

   ![信息](media\set.png)

##### 下载工程源码

```
通过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”可查看编译成功

![编译](media\build.png)![编译成功](media\build_ok.png)

#### 生成固件

##### 下载系统源码

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

注意：

1.权限问题请参考[生成/添加SSH公钥](https://gitee.com/help/articles/4181)。

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
   ```

2. 运行如下命令安装hb

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

3. 设置环境变量

   ```
   vim ~/.bashrc
   ```

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

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

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

   ```
   source ~/.bashrc
   ```

4. 再次执行”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”，如图：

![hap包](media\hap.png)

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



![编译](media\hap_zip.png)

##### 集成固件源码

1.下载开发板代码

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

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

![开发板源码](media\tree_bes2600.png)

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

![hap文件](media\ccode.png)

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

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

![最终固件源码](media\file_all.png)



### 编译

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

![编译源码](media\hb_set.png)

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

![编译源码完成](media\build_success.png)![固件生成](media\out.png)

### 安装

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

1.安装[CP2102驱动](https://www.silabs.com/documents/public/software/CP210x_Windows_Drivers.zip)，解压后双击与自己window 版本相匹配的可执行文件，并按相关提示安装驱动文件即可；

2.查看串口com号	

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

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

![串口](media\device.png)

3.打开wifi烧录工具

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

![烧录软件](media\windows.png)

4.串口选择

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

- 选择List按钮

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

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

![烧录窗口](media\serial.png)

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

![开发板](media\board.png)

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

![开始烧录](media\ing.png)

7.烧录成功，如图：

![烧录完成](media\success.png)

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

### 操作体验

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

   ![gas_detection](media\demo.jpg)


## 参考资料

- [欧智通BES2600WM开发板轻量设备上手文档](https://gitee.com/openharmony-sig/knowledge_demo_temp/tree/master/docs/bes2600_hello_world)
- [知识体系](https://gitee.com/openharmony-sig/knowledge)