一、简介

        前两章介绍了环境搭建、烧录和编译。这一节，来介绍实现第一个经典代码“hello world”。

        先介绍小熊派的目录结构，该目录结构延续了OpenHarmony官方目录结构。

二、实操

        1.搭建代码架构

        1).新建项目文件夹hello_world

cd bearpi-hm_nano/applications/BearPi/BearPi-HM_Nano/sample/
mkdir hello_world

        创建hello_world目录，用来存放业务源码文件。

        2).新增hello_world.c文件

cd hello_world
touch hello_world.c

        创建hello_world.c文件，该文件为业务源码文件。

        3).新增BUILD.gn文件

touch BUILD.gn

        创建BUILD.gn文件，该文件为业务源码编译脚本。

        4).最终代码架构展示

.
└── applications        
    └── BearPi
        └── BearPi-HM_Nano
            └── sample
                │── hello_world
                │  │── hello_world.c
                │  └── BUILD.gn
                └── BUILD.gn

        2.代码编写

        1).编写业务代码

        在hello_world.c文件中增加如下代码：

#include <stdio.h>
#include "ohos_init.h"

void Hello_World(void)
{
    printf("this is a test demo \r\n Hello World!\r\n");
}

APP_FEATURE_INIT(Hello_World);

        APP_FEATURE_INIT是OpenHarmony启动恢复模块接口，该接口用来启动业务。也可以使用SYS_RUN来实现，效果是一样的。（APP_FEATURE_INIT和SYS_RUN定义都在ohos_init.h）文件中。

        2).编写用于将业务构建成静态库的BUILD.hn文件

        在hello_world文件夹的BUILD.gn文件中添加如下代码：

static_library("hello_world"){
    sources = [
        "hello_world.c"
    ]
    include_dirs = [
        "//utild/native/lite/include"
    ]
}

        该文件由三部分内容构成，目标、源文件、头文件路径。

        static_library：该文件中指定业务模块的编译结果，为静态库文件libhello_world.a。

         sources：该文件中指定静态库.a所依赖的.c文件及路径，若路径中包含“//”则表示绝对路径（代码的根路径，即bearpi-hm_nano文件夹）。若不包含“//”则表示相对路径。

         incllude_dirs：该文件中指定source所依赖的.h文件路径。

         3).编写模块BUILD.gn文件，指定需要参与构建的特性模块

        配置sample文件夹中的BUILD.gn文件。在features字段中增加索引"hello_world:hello_world"，使目标模块参与编译。

        注意屏蔽其他模块。

#"Zx_Developer:zx_develop_sample"  ##不参与构建，为开发者贡献演示结构，其中Zx为 Z1，Z2...Z100
        #"Z1_hi3861_uart_ylc:uart_hi3861",
        #"Z2_hi3861_flash_ylc:flash_example",

        "hello_world:hello_world"

        hello_world（前）：是相对路径，指向./applications/BearPi/BearPi-HM_Nano/sample/hello_world/BUILD.gn

        hello_world（后）：指向 ./applications/BearPi/BearPi-HM_Nano/sample/hello_world/BUILD.gn 中的static_library("hello_world")。

        2.编译

        在项目根目录下，运行编译代码：

python build.py BearPi-HM_Nano

         编译成功。

        编译结束后，会在Out/工程名 文件下生成bin文件。

        这里介绍一个各个文件

文件名	说明	备注
Hi3861_boot_signed.bin	签名的bootloader文件	Flash boot
Hi3861_boot_signed_B.bin	签名的bootloader备份文件	Flash boot备份
Hi3861_wifiiot_app.asm	Kernel asm文件	汇编程序源文件
Hi3861_wifiiot_app.map	Kernel map文件	程序的全局符号，函数的地址，占用的空间等，用于调试。例如程序崩溃就可以查看这个文件
Hi3861_wifiiot_app.out	Kernel 输出文件
Hi3861_wifiiot_app_allinone.bin	产线烧录文件（包含了独立烧写程序和loader程序）	包含了2个bin： Hi3861_boot_signed.bin Hi3861_wifiiot_app_burn.bin
Hi3861_wifiiot_app_burn.bin	Kernel烧写文件，建议直接使用Hi3861_wifiiot_app_allinone.bin	默认包含boot、NV、可执行程序镜像
Hi3861_wifiiot_app_flash_boot_ota.bin	Flash Boot升级文件
Hi3861_wifiiot_app_ota.bin	Kernel升级文件
Hi3861_wifiiot_app_vercfg.bin	Kernel和Boot的版本号文件
Hi3861_loader_signed.bin	烧写工具使用的加载文件	只用在烧写，位于内存中。烧写至少需要Hi3861_boot_signed.bin和Hi3861_wifiiot_app_burn.bin这两个文件。Hi3861_wifiiot_app_allinone.bin包含了这两个文件，所以推荐使用allinone文件进行烧录。

        3.烧录

        

         4.复位开发板并查看LOG输出

         完成！！！