鸿蒙南向开发教程 Day 2：创建自己的 Hello World 工程
目标：学会自己命名模块，创建并编译第一个自定义 Hello World 工程
前置条件：已完成 Day 1 的环境搭建（DevEco Device Tool + 工具链 + 源码导入）
一、工程结构说明
在src/applications/sample/wifi-iot/app/目录下创建自定义模块，这里以myhello为例：
app/ ├── BUILD.gn # 应用入口构建配置 └── myhello/ # 自定义模块目录（自己命名） ├── BUILD.gn # 模块构建配置 └── myhello.c # 主程序源码（自己命名）二、文件详解
2.1 应用入口app/BUILD.gn
import("//build/lite/config/component/lite_component.gni") lite_component("app") { features = [ "myhello:example_myhello" # 引用 myhello 模块下的 example_myhello 目标 ] }myhello：目录名（自己命名）example_myhello：构建目标名（自己命名）
2.2 模块构建app/myhello/BUILD.gn
static_library("example_myhello") { # 构建目标名，与 BUILD.gn 中引用一致 sources = [ "myhello.c" # 源文件名（自己命名） ] include_dirs = [ "//utils/native/lite/include", # 系统头文件路径 ] }2.3 主程序app/myhello/myhello.c
#include"ohos_init.h"// OpenHarmony 系统初始化头文件voidMyHelloMain(void)// 函数名自己命名{printf("My Hello World!\n");// 自定义输出内容}SYS_RUN(MyHelloMain);// 注册为系统启动入口，函数名需一致三、命名规则总结
| 位置 | 命名示例 | 说明 |
|---|---|---|
| 目录名 | myhello | 模块文件夹，小写英文 |
| 构建目标 | example_myhello | BUILD.gn中static_library()的名字 |
| 源文件名 | myhello.c | 与目录名保持一致，方便管理 |
| 函数名 | MyHelloMain | 驼峰命名，与模块名对应 |
SYS_RUN参数 | MyHelloMain | 必须与函数名完全一致 |
四、编译与验证
4.1 编译
- VSCode 底部工具栏点击Build
- 或快捷键
Ctrl+Shift+B
编译成功后，镜像位于：
out/hispark_pegasus/wifiiot_hispark_pegasus/Hi3861_wifiiot_app_allinone.bin4.2 烧录
- 连接开发板 USB
- 点击 IDE 的Upload按钮，等待弹出提示，按下开板RESET按键
- 等待烧录完成（约 30 秒）
4.3 查看输出
打开串口工具：
- 端口：开发板对应的 COM 口
- 波特率：115200
重启开发板，串口输出：
My Hello World!五、常见问题
| 问题 | 原因 | 解决 |
|---|---|---|
编译报错target not found | BUILD.gn中目录名或目标名写错 | 检查app/BUILD.gn的features路径是否与目录结构一致 |
编译报错undefined reference | 函数名与SYS_RUN不一致 | 确认SYS_RUN(MyHelloMain)与函数定义一致 |
| 无串口输出 | 波特率不对 | 确认串口工具设置为115200 |
六、练习
尝试将myhello改为自己的名字，例如：
- 目录：
zhangsan - 目标：
example_zhangsan - 函数：
ZhangSanMain - 输出：
"Hello from ZhangSan!"
七、下一步
Day 3 预告：学习鸿蒙内核，任务创建