百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

从零打造自己的 国产鸿蒙(OpenHarmony)定制系统-完整可落地流程

nanshan 2025-07-21 16:35 4 浏览 0 评论

适用版本:OpenHarmony 4.0 / 5.0 Standard

目标人群:想在 x86 PC、RK3568 开发板或自有硬件 上裁剪、加品牌、预装应用并生成可刷机镜像的开发者 / 团队





目录

  1. 环境准备
  2. 获取 & 管理源码
  3. 创建专属 Product(产品)配置
  4. “十大自定义”示例
  5. 设备移植要点(以 RK3568 为例)
  6. 构建、打包与刷机
  7. OTA 升级包生成
  8. 发行版签名与合规
  9. 持续维护与更新



1 | 环境准备


主机系统

推荐

说明

Ubuntu 22.04 LTS

官方 CI 同款

内存 / 磁盘

≥ 16 GB / 100 GB

repo sync 镜像 ~ 40 GB

依赖

git curl python3 ninja-build gcc g++ openjdk-17-jdk ccache

4.x 起默认 JDK 17

sudo apt update && sudo apt install \

git repo curl python3 ninja-build gcc g++ make \

openjdk-17-jdk ccache -y




2 | 克隆源码并锁定版本


mkdir ~/ohm && cd ~/ohm


# ① 初始化指定分支 / 标签

repo init -u https://gitee.com/openharmony/manifest.git \

-b refs/tags/OpenHarmony-4.0-Release


# ② 下载所有子仓

repo sync -c -j$(nproc)


# ③ 可选:设置本地镜像加速

git config --global http.sslVerify false

若需长期维护,可 Fork manifest 并在其中锁定子仓 commit。





3 | 创建你的

Product

(核心定制入口)



  1. 复制一个基线产品


cp -r vendor/hihope/rk3568 vendor/mycorp/myboard


  1. 重命名与修改 config.json

"name": "myboard"

"device_company": "mycorp"

"subsystems": 增删自己需要的子系统组件

  1. 声明分区 & 镜像格式(如启用 A/B、ext4/erofs)
  2. 注册到编译系统

./build.sh --product-name myboard -p


编译系统即能解析出新的 product_path






4 | “十大自定义”实操示例


#

自定义项

方法

① 品牌 Logo / 启动动画

替换 device/board/<vendor>/<board>/kernel/logo*.bmp、bootvideo.mp4,清空 out/ 后全量编译


② 默认壁纸 & 主题

applications/standard-systemui/resources/


③ 预装自研 App

在 vendor/mycorp/apps 里放 .hap,并在 config.json -> prebuilt_haps 列出


④ 自定义系统属性

编辑
base/startup/init/services/etc/param/mycorp_param.cfg


⑤ 调整分区大小

config.json -> partitions 设置 system/vendor/userdata 大小


⑥ 关闭/裁剪子系统

去掉 subsystems 中如 telephony, bt 等条目


⑦ 添加内核模块


device/board/.../kernel/linux-5.10/defconfig 打开所需 CONFIG_...


⑧ 专属系统服务


foundation/mycorp_service/ 写 ArkTS/CPP 服务,并加入 subsystems


⑨ UI 业务事件埋点

引入 common_event_service 并在 hisysevent JSON 定义事件


⑩ 系统默认语言/时区

init_rc/ohos.para 配置 persist.sys.locale 等键






5 | 设备移植要点(RK3568 示例)



  1. Board 目录


  1. device/board/rockchip/rk3568:设备树 .dts、uboot、fastboot.cfg
  2. Kernel


  1. 同步 Rockchip 分支或 mainline,保持与 BSP 补丁一致
  2. 驱动适配清单


  1. LCD/TP:drivers/gpu/drm + drivers/input
  2. Wi-Fi/BT:替换固件 + vendor/.../wifi.cfg
  3. Camera:media 子系统 HAL + sensor_list.h


开源官方已提供 DAYU200 (RK3568) 全链路适配示例,可参考步骤迅速复刻并裁剪。





6 | 编译、生成镜像并刷机


# 建议开启 ccache,加快二次编译

export USE_CCACHE=1 && ccache -M 20G


./build.sh --product-name myboard \

--target-cpu arm64 \

-j$(nproc)


  • 成功后镜像位于 out/myboard/images/
  • 常见产物


文件

用途

boot.img

Kernel & ramdisk

system.img

/system 分区

vendor.img

/vendor 分区

update.img

一键刷机包(部分板卡)



刷机

# U 盘镜像

sudo dd if=update.img of=/dev/sdX bs=4M status=progress


# Android-fastboot 设备

fastboot flash boot boot.img

fastboot flash system system.img

...

fastboot reboot





7 | OTA 升级包制作


cd build/ohos

./ota_packaging.sh \

--product-name myboard \

--target-dir out/myboard \

--version v1.0.0 \

--output ../ota/myboard_v1.0.0.zip

脚本会比较 old/new 镜像生成增量包;客户端可使用 update_tool 下发升级指令。





8 | 签名、隐私合规与发布



  1. 生成 Vendor 密钥


openssl genrsa -out mycorp_private.pem 2048

openssl rsa -in mycorp_private.pem -pubout -out mycorp_public.pem


  1. 配置签名链 build/security/signing_profile.json
  2. 隐私合规
  3. 明示收集项 → ohos.permission.* 权限对齐
  4. 敏感日志屏蔽 → hisysevent 白名单
  5. 开源许可证:保留 Apache-2.0 / BSD / LGPL 文件头、NOTICE






9 | 持续集成与版本升级


内容

建议

CI

GitLab Runner + build.sh + 缓存 ccache

上游合并

每月 repo sync + git rebase;冲突集中在 device/ & vendor/

回归测试

核心能力:启动、音视频、网络、分布式 FA/PA、OTA





结语

通过 Product 配置 + 设备板级目录 + 资源替换 + 签名打包,你就能在 30 分钟跑通编译,1 ~ 2 天完成品牌化定制,1 周交付可刷机镜像。

无论是PC、开发板还是独立硬件,OpenHarmony 都提供了足够开放的接口与文档支持。赶紧动手,打造属于你的国产鸿蒙发行版吧!

相关推荐

CentOS 7 搭建 Harbor2.4.1 Docker镜像仓库

上一篇文章我们使用了registry镜像来搭建Docker私有镜像仓库,但是使用体验不是很好,没有一个可管理的UI界面,管理很麻烦。本篇文章将介绍一个新的搭建Docker镜像仓库的工具叫做Har...

简单认识认识mqtt及mosquitto(mqtt报文解析)

某项目中使用了MQTT作为进程间的通信方式,之前没用过,这两篇笔记我们就来一起学习一下这种方式。MQTT的一些介绍以下介绍内容来自《[野火]《LwIP应用开发实战指南》MQTT协议全称是Messa...

全源码打造高性能 LNMP 架构: 实战教程(2025最新版)

适用场景:企业生产环境、自建Web服务、深度性能调优操作系统:CentOS7/8、RockyLinux、Debian、Ubuntu(本文以CentOSStream9为例)技术栈:N...

Nacos3.0重磅来袭!全面拥抱AI,单机及集群模式安装详细教程!

之前和大家分享过JDK17的多版本管理及详细安装过程,然后在项目升级完jdk17后又发现之前的注册和配置中心nacos又用不了,原因是之前的nacos1.3版本的,版本太老了,已经无法适配当前新的JD...

Ubuntu24.04.2 企业级MinIO存储系统部署指南

一、概要1.1MinIO架构解析MinIO是一款高性能的云原生对象存储系统,采用Golang开发并遵循ApacheLicensev2.0协议。其核心架构基于纠删码(ErasureCode)技...

从零打造自己的 国产鸿蒙(OpenHarmony)定制系统-完整可落地流程

适用版本:OpenHarmony4.0/5.0Standard目标人群:想在x86PC、RK3568开发板或自有硬件上裁剪、加品牌、预装应用并生成可刷机镜像的开发者/团队目录环境准...

一次暂未成功的dify安装经历(dify怎么安装)

前几天在阿里云买了一台机,这几天一直在尝试安装dify,到现在还没安装上我是按这个教程装的https://blog.csdn.net/2401_82469710/article/details/14...

ZLMediaKit教程(五)支持webrtc(webrtc lib)

ZLMediaKit系列文章(共六篇):ZLMediaKit流媒体(一)编译安装ZLMediaKit教程(二)主程序和配置文件解析ZLMediaKit教程(三)URL规则ZLMediaKit教程...

Linux程序安装与管理指南(linux程序安装命令大全)

在Linux系统中,安装和管理程序主要通过包管理器和手动编译安装两种主要方式实现。以下是详细的操作指南,涵盖常见发行版(如Ubuntu/Debian、CentOS/RHEL、Fedora等)的用法。一...

离线状态下安装 Nginx 各个模块?这篇攻略让你轻松搞定

你是不是也在为离线状态下安装Nginx各个模块而发愁?在互联网大厂后端开发工作中,我们常常会遇到一些特殊的网络环境,比如公司内部的离线服务器,或是处于隔离状态的测试环境。当需要在这些离线环境中安装...

Rust实践:Win10环境下的openssl交叉编译

Rust支持跨平台,可以指定生成目标平台,交叉编译也是支持的。当然,想要交叉编译成功,还需要指定平台的编译器(如:msvc、gcc等)。openssl是C语言开发的库,如果在Rust代码中用到open...

Linux下Blackwell架构显卡(RTX5070/5090)编译PaddlePaddle指南

Blackwell显卡架构如RTX5070\5090等显卡当前Paddle预编译版本中包含的GPU架构(即SM架构)是有限的,比如常见的SM75(T4)、SM86(A10)、SM89(...

突破操作系统界限,掌握Linux的必备指南

#头条创作挑战赛#简介Linux是一种开源的操作系统,它的核心思想是自由和开放。Linux以其稳定性、可靠性和安全性而闻名,被广泛用于服务器和嵌入式设备中。Linux创始人Linux安装在安装Linu...

Linux日常高频使用的100条命令,强烈建议收藏

查看系统信息如何查看系统版本:uname-alsb_release-acat/etc/os-release如何查看系统内核信息:uname-r如何查看系统CPU信息:lscpucat...

Linux文件系统结构全解析(linux文件结构详解)

对Linux新手而言,“一切皆文件”的设计哲学常让人既兴奋又困惑——打开终端输入ls/,看到的bin、etc、var等目录到底有什么用?如何快速定位关键文件?本文将从Linux文件系统的底层逻...

取消回复欢迎 发表评论: