OpenHarmony-L2开发全流程实战指南:从源码到应用部署

张开发
2026/4/15 23:51:45 15 分钟阅读

分享文章

OpenHarmony-L2开发全流程实战指南:从源码到应用部署
1. OpenHarmony-L2开发环境搭建第一次接触OpenHarmony-L2标准系统开发时我花了两天时间才把环境搭好。现在回想起来如果当时有人告诉我这些关键步骤至少能节省一天时间。下面我就把从零开始搭建开发环境的完整过程分享给大家。开发OpenHarmony-L2需要准备以下环境Ubuntu 20.04或更高版本推荐使用物理机至少16GB内存和100GB硬盘空间Python 3.7Node.js 12开发板如Hi3516DV300安装依赖项时最容易出错建议按这个顺序执行sudo apt-get update sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl zlib1g-dev gcc-multilib g-multilib libc6-dev-i386 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev ccache libgl1-mesa-dev libxml2-utils xsltproc unzip m4配置git信息也很重要否则后续代码提交会遇到问题git config --global user.name yourname git config --global user.email your-email-address git config --global credential.helper store2. 源码下载与编译实战源码下载是开发的第一步但OpenHarmony的代码仓库结构比较复杂。我推荐新手先只下载L2标准系统源码等熟悉后再考虑全量下载。下载L2标准系统源码的命令如下repo init -u gitgitee.com:openharmony/manifest.git -b refs/tags/OpenHarmony-2.0-Canary --no-repo-verify repo sync -c repo forall -c git lfs pull编译过程可能会遇到各种问题这里分享几个实用技巧首次编译建议使用完整编译命令./build.sh --product-name Hi3516DV300如果只想编译特定子系统可以这样操作./build.sh system_sizestandard target_subsystem子系统名编译完成后产物默认输出到out/hispark_taurus/目录提示编译过程中如果出现内存不足可以尝试增加swap空间或者使用ccache加速后续编译。3. 版本烧写与设备调试烧写版本到开发板是验证成果的关键一步。根据我的经验网口烧写比USB更稳定成功率更高。烧写前需要准备HiTool烧写工具建议使用5.3.35以上版本网线连接开发板和PC编译好的镜像文件烧写步骤打开HiTool选择HiBurn模式加载分区表文件一般在device/hisilicon/hispark_taurus/sdk_liteos/uboot/out/boot/目录选择网口传输方式点击烧写按钮烧写完成后如果板子无法启动可能需要配置启动参数setenv bootargs mem640M consolettyAMA0,115200 mmzanonymous,0,0xA8000000,384M clk_ignore_unused androidboot.selinuxpermissive rootdelay10 hardwareHi3516DV300 init/init root/dev/ram0 rw blkdevpartsmmcblk0:1M(boot),15M(kernel),20M(updater),2M(misc),3307M(system),256M(vendor),-(userdata) setenv bootcmd mmc read 0x0 0x82000000 0x800 0x4800; bootm 0x82000000 saveenv reset4. DevEco Studio应用开发DevEco Studio是OpenHarmony官方IDE但配置过程有几个坑需要注意。我建议直接下载3.0 Beta版本稳定性更好。创建第一个应用的步骤新建JS空白工程修改config.json配置应用信息编写页面布局和逻辑代码点击Build Build Hap(s)编译应用签名是新手最容易忽略的环节。真机调试必须使用签名后的HAP包否则会安装失败。签名流程生成密钥库文件.p12配置签名证书信息在build.gradle中启用签名调试技巧使用hilog查看日志hilog | grep 你的标签通过hdc安装应用hdc install app.hap查看运行中的应用aa dump -a5. 常见问题解决方案在实际开发中我遇到过不少棘手问题这里分享几个典型问题的解决方法问题1HAP安装失败检查签名是否正确确保设备存储空间足够尝试先卸载旧版本bm uninstall -n 包名问题2设备无法连接确认hdc版本一致检查USB驱动是否安装重启hdc服务hdc kill然后hdc start问题3编译时报内存不足增加swap空间关闭其他占用内存的程序使用单线程编译-j1开发过程中养成查看日志的习惯很重要。除了hilog还可以通过dmesg查看内核日志通过logcat查看系统日志。掌握这些调试技巧能极大提高开发效率。

更多文章