鸿蒙设备开发入门：从环境搭建到Hello World实践

1. 项目背景与开发环境搭建作为一名刚接触鸿蒙设备开发的嵌入式新手第一次看到智能小车的显示屏上跳出Hello Harmony时那种兴奋感至今难忘。这个项目记录了我从零开始搭建鸿蒙开发环境到最终在小车上成功运行Hello World的全过程。对于没有任何嵌入式开发经验的人来说这套环境配置确实是个不小的挑战。鸿蒙设备开发需要同时配置Windows和Linux两套环境Windows环境用于设备连接、烧录和调试Linux环境用于代码编译目前鸿蒙仅支持Linux环境编译特别注意Python必须使用3.7或3.8版本其他版本会导致DevEco Device Tool无法正常安装。这是我踩过的第一个坑。开发工具清单Visual Studio Code最新稳定版Python 3.7/3.8配置系统环境变量Node.js v12建议使用LTS版本hpm鸿蒙包管理器DevEco Device ToolVSCode插件安装完成后需要在PowerShell管理员权限执行set-executionpolicy remotesigned否则运行hpm时会报无法加载文件错误。2. 硬件连接与驱动配置我的开发板是Hi3861核心的鸿蒙智能小车通过Type-C接口与电脑连接。初次连接时设备管理器会出现带感叹号的USB-SERIAL CH340设备需要手动安装驱动。驱动安装步骤从官网下载CH340G驱动www.wch.cn解压后运行安装程序在设备管理器确认COM端口号验证方法VSCode中打开DevEco Home → Devices应该能看到对应COM口的设备信息常见问题如果设备未识别尝试更换USB线或接口。我就因为用了劣质线材折腾了半天。3. Linux编译环境部署鸿蒙编译必须使用Linux环境推荐以下两种方案3.1 使用预配置虚拟机连志安老师提供的Ubuntu虚拟机百度网盘提取码bny6已经预装了鸿蒙编译工具链Samba文件共享服务基础开发环境配置要点默认账号harmony/123456首次启动需安装VMware Tools手动启动Samba服务sudo service smbd start查看IP地址ifconfig -a3.2 自行搭建Ubuntu环境参考官方文档《Ubuntu开发环境准备》需要安装sudo apt-get install build-essential gcc g make zlib* libffi-dev4. 项目配置与编译4.1 文件共享设置在Windows文件资源管理器地址栏输入\\Linux_IP建议映射为网络驱动器如Y:方便后续操作。4.2 编译流程在VSCode中打开鸿蒙项目目录harmony/code/code-1.0配置项目参数upload_port设备COM口upload_protocolhiburn-serialupload_partitionshi3861_appLinux终端执行编译python build.py wifiiot成功标志是看到[OHOS INFO] wifiiot build success日志。编译常见错误如果报找不到Python模块尝试pip install ohos-build5. 烧录与调试5.1 烧录操作在VSCode的PROJECT TASKS中选择Upload当出现Connecting, please reset device时30秒内按下开发板的RST复位键等待出现SUCCESS提示5.2 Hello World实现在applications/sample/wifi-iot/app下创建helloworld目录添加hello_world.c#include stdio.h #include ohos_init.h #include ohos_types.h void HelloWorld(void) { printf([DEMO] Hello world.\n); } SYS_RUN(HelloWorld);BUILD.gnstatic_library(helloworld) { sources [hello_world.c] include_dirs [//utils/native/lite/include] }修改app/BUILD.gnlite_component(app) { features [helloworld:helloworld] }5.3 查看输出在VSCode中按CtrlT打开串口终端选择对应COM口编号按下RST复位键终端会显示[DEMO] Hello world.6. 常见问题排查烧录失败检查USB连接是否稳定确认驱动安装正确复位时机要准确30秒窗口期串口无输出确认波特率设置为115200检查代码中是否有printf尝试更换串口工具如Putty编译错误确认环境变量配置正确检查文件路径是否有中文或空格清理后重新编译python build.py wifiiot -c7. 进阶建议使用Git管理代码版本git init git add . git commit -m first hello world学习使用hpm包管理器hpm init -t dist hpm i ohos/helloworld调试技巧在代码中添加LED闪烁指示使用逻辑分析仪抓取GPIO信号利用SystemTick实现简单延时这个Hello World项目虽然简单但涵盖了鸿蒙设备开发的完整流程。在实际操作中最大的挑战其实是环境配置和硬件连接这些看似基础的工作。建议新手一定要耐心完成每个步骤的验证确保前一个环节没问题再进行下一步。