📝 开发第一个示例程序
本示例将演示如何编写简单业务,输出“Hello World”。
一、准备工作
参考BearPi-HM_Nano十分钟上手教程完成开发环境搭建、代码获取等工作,以及熟悉代码的编译和烧录流程。
二、编写代码
bugfix和新增业务两种情况,涉及源码修改。下面以新增业务举例,向开发者介绍如何进行源码修改。
开发者编写业务时,务必先在./applications/BearPi/BearPi-HM_Nano/sample路径下新建一个目录(或一套目录结构),用于存放业务源码文件。
例如:在app下新增业务my_first_app,其中hello_world.c为业务代码,BUILD.gn为编译脚本,具体规划目录结构如下:
. └── applications └── BearPi └── BearPi-HM_Nano └── sample │── my_first_app │ │── hello_world.c │ └── BUILD.gn └── BUILD.gn
编写业务代码。
在hello_world.c中新建业务入口函数HelloWorld,并实现业务逻辑。并在代码最下方,使用OpenHarmony启动恢复模块接口SYS_RUN()启动业务。(SYS_RUN定义在ohos_init.h文件中)
#include "ohos_init.h" #include "ohos_types.h" #include <stdio.h> void HelloWorld(void) { printf("[DEMO] Hello world.\n"); } SYS_RUN(HelloWorld);
编写用于将业务构建成静态库的BUILD.gn文件。
如步骤1所述,BUILD.gn文件由三部分内容(目标、源文件、头文件路径)构成,需由开发者完成填写。以my_first_app为例,需要创建./applications/BearPi/BearPi-HM_Nano/sample/my_first_app/BUILD.gn,并完如下配置。
static_library("myapp") { sources = [ "hello_world.c" ] include_dirs = [ "//utils/native/liteos/include" ] }
- static_library中指定业务模块的编译结果,为静态库文件libmyapp.a,开发者根据实际情况完成填写。
- sources中指定静态库.a所依赖的.c文件及其路径,若路径中包含"//"则表示绝对路径(此处为代码根路径),若不包含"//"则表示相对路径。
- include_dirs中指定source所需要依赖的.h文件路径。
编写模块BUILD.gn文件,指定需参与构建的特性模块。
配置
./applications/BearPi/BearPi-HM_Nano/sample/BUILD.gn
文件,在features字段中增加索引"my_first_app:myapp"
,使目标模块参与编译。并屏蔽其他模块。#"D1_iot_wifi_scan:wifi_scan", #"D2_iot_wifi_connect:wifi_connect", #"D3_iot_udp_client:udp_client", #"D4_iot_tcp_server:tcp_server", #"D5_iot_mqtt:iot_mqtt", #"D6_iot_cloud_oc:oc_mqtt", #"D7_iot_cloud_onenet:onenet_mqtt", "my_first_app:myapp"
- my_first_app是相对路径,指向
./applications/BearPi/BearPi-HM_Nano/sample/my_first_app/BUILD.gn
。 - myapp是目标,指向
./applications/BearPi/BearPi-HM_Nano/sample/my_first_app/BUILD.gn
中的static_library("myapp")。
- my_first_app是相对路径,指向
三、运行结果
示例代码编译、烧录、运行、调测(可参考BearPi-HM_Nano十分钟上手),会显示如下结果:
ready to OS start
FileSystem mount ok.
wifi init success!
[DEMO] Hello world.