K3_OH6.1_LTS下载编译烧录说明

本文档适用于 OpenHarmony-v6.1-LTS 分支。

修订记录

修订版本	修订日期	修订说明
001	2026-08-28	初始版本

1. 环境准备

1.1. Ubuntu 环境（推荐 Ubuntu22.04，其他版本暂未验证）

执行以下命令安装依赖：

sudo apt-get update

sudo apt-get install binutils git git-lfs gnupg gperf build-essential zip curl zlib1g-dev gcc-multilib lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev libxml2-utils xsltproc unzip m4 bc gnutls-bin python3-pip ruby ccache libgl1-mesa-dev g++-multilib libc6-dev-i386 flex bison openjdk-19-jdk openssl libelf-dev lz4 genext2fs libncurses5 libssl-dev u-boot-tools dosfstools mtools libstdc++-12-dev repo python2 cpio nodejs npm default-jdk mtd-utils scons gcc-arm-none-eabi

1.2. 安装 make_exf4fs（如果已安装，请忽略）

下载 bin.zip 工具包（点我下载）并解压至服务器指定目录。
在 ~/.bashrc 文件中添加工具路径：
```
export PATH=$PATH:~/WorkSpace/bin
```

执行 make_ext4fs 验证安装，若显示以下提示，说明安装成功：

zhoufeng@snode7:~/WorkSpace/2026/oh61lts$ make_ext4fs
Expected filename after options
make_ext4fs [ -l <len> ] [ -j <journal size> ] [ -b <block_size> ]
    [ -g <blocks per group> ] [ -i <inodes> ] [ -I <inode size> ]
    [ -L <label> ] [ -f ] [ -a <android mountpoint> ]
    [ -S file_contexts ] [ -C fs_config ] [ -T timestamp ]
    [ -z | -s ] [ -w ] [ -c ] [ -J ] [ -o ] [ -v ] [ -B <block_list_file> ]
    <filename> [<directory>]

2. 源码准备

2.1. 访问如意社区

代码仓托管于如意社区（代码仓库路径）中，下载代码需要进行如下准备：

注册并登录如意社区账号（若无如意社区账号）。
将本地主机的 SSH 公钥添加到如意社区账户（路径：“偏好设置” → “SSH Keys”）。

2.2. 下载源码

mkdir -p ~/WorkSpace/2026/oh61lts/src
cd ~/WorkSpace/2026/oh61lts/src
repo init -u git@code.ruyicommunity.cn:risc-verse/ruyi-desktop-os/manifest.git -b OpenHarmony-v6.1-LTS
## 如果repo init过程中下载repo失败（概率出现过），使用国内源
## 后面添加参数 --repo-url=https://gerrit-googlesource.lug.ustc.edu.cn/git-repo
 
repo sync -c -j4 --retry-fetches=100 --fail-fast
## 2-3小时左右
## 出现报错及时处理

repo forall -c 'git lfs pull'
## 拉一些大文件，haps，音视频等，1-2小时左右
## 如果对源码不熟悉，建议每次repo sync后，都执行此命令

repo start OpenHarmony-v6.1-LTS --all
## 为所有仓创建开发分支（可选）

下载完成后的目录结构如下：

zhoufeng@snode7:~/WorkSpace/2026/oh61lts/src$ tree -L 1
.
|-- applications
|-- arkcompiler
|-- base
|-- build
|-- build.py -> build/build_scripts/build.py
|-- build.sh -> build/build_scripts/build.sh
|-- commonlibrary
|-- developtools
|-- device
|-- docs
|-- docs_cangjie
|-- domains
|-- drivers
|-- extension
|-- foundation
|-- ide
|-- interface
|-- kernel
|-- napi_generator
|-- oh_venv
|-- out
|-- prebuilts
|-- productdefine
|-- qemu-run -> vendor/ohemu/common/qemu-run
|-- test
|-- third_party
`-- vendor

24 directories, 3 files

2.3. 安装编译器

在源码根目录下执行以下脚本，安装编译器及二进制工具。

cd ~/WorkSpace/2026/oh61lts/src
bash build/prebuilts_download.sh

下载的文件默认存放在与源码目录 src 同级的 openharmony_prebuilts 下。

zhoufeng@snode7:~/WorkSpace/2026/oh61lts$ tree -L 1
.
|-- openharmony_prebuilts
`-- src

2 directories, 0 files

openharmony_prebuilts 里面的内容如下：

zhoufeng@snode7:~/WorkSpace/2026/oh61lts/openharmony_prebuilts$ ls -al
total 5777424
drwxr-xr-x 2 zhoufeng domain users      4096 Aug 26 18:07 .
drwxr-xr-x 7 zhoufeng domain users      4096 Aug 28 15:36 ..
-rw-r----- 1 zhoufeng domain users 648048620 Aug 22 01:50 0623450437a9987b3b599865c152635c.llvm-linux-19.1.7-x86_64_20260424.tar.gz
-rw-r----- 1 zhoufeng domain users 666931661 Aug 22 01:50 0c53737f631d9066e67e52e235b8001d.clang_windows-x86_64-feef13-20251209.tar.gz
-rw-r----- 1 zhoufeng domain users 118696253 Aug 22 01:45 0c65e233a7c5b1ecf6585a38903cc52e.clang-mingw-20240510.tar.gz
-rw-r----- 1 zhoufeng domain users    298786 Aug 22 01:41 1ad55caffc571c067e7748967b86f477.ninja-windows-x86-1.12.0-20240523.tar.gz
-rw-r----- 1 zhoufeng domain users  37434318 Aug 22 01:42 1d9cac0be980c9030ae8ace9c1c9c948.rust-std-nightly-x86_64-unknown-linux-ohos.tar.gz
-rw-r----- 1 zhoufeng domain users    530721 Aug 22 01:41 20738011b324e100f6aab09353a7e7fa.bpftool_v5.10.93_20221114.tar.gz
-rw-r----- 1 zhoufeng domain users   9012065 Aug 26 18:07 3a809a26c729112318dbf63a52e674a5.python-linux-x86-GLIBC2.35-3.11.4_20251107.tar.gz
-rw-r----- 1 zhoufeng domain users  71384139 Aug 22 01:44 3cd635b2e65395d32595fa7db326f4e5.libcxx-ndk_linux-x86_64-feef13-20251209.tar.gz
-rw-r----- 1 zhoufeng domain users  35031005 Aug 22 01:43 44f2993d118ed3cefe4792a2fd62547f.node-v14.21.1-linux-x64.tar.gz
-rw-r----- 1 zhoufeng domain users  71381052 Aug 22 01:44 45e5679a4dbf25be778cccb5ba1566a7.libcxx_ndk_ohos-arm64-feef13-20251209.tar.gz
-rw-r----- 1 zhoufeng domain users   5302793 Aug 22 01:41 48e90aacf221fa3b7b30a9f67f898d4a.packing_tool_libs_20260129.zip
-rw-r----- 1 zhoufeng domain users  32430467 Aug 22 01:43 5084e36f83c59ea4aa08675172857d08.rust-std-nightly-armv7-unknown-linux-ohos.tar.gz
-rw-r----- 1 zhoufeng domain users 194623101 Aug 22 01:46 59325cdd5538f70910f66328acedea7d.prebuilts_gcc_linux-x86_arm_gcc-linaro-7.5.0-arm-linux-gnueabi.tar.gz
-rw-r----- 1 zhoufeng domain users 335994880 Aug 22 01:47 5b91aae49e9ac9ca2471ea5fddfcc8a2.command-line-tools.tar
-rw-r----- 1 zhoufeng domain users  99758853 Aug 22 01:44 61b48b0d64d7692c1254d22b97dc06f6.rust-nightly-x86_64-unknown-linux-gnu.tar.gz
-rw-r----- 1 zhoufeng domain users   6649961 Aug 22 01:42 65887c3114071af35157ce536b625ef9.python-mingw-x86-3.11.4_20251107.tar.gz
-rw-r----- 1 zhoufeng domain users 329772635 Aug 22 01:47 6a4909fc4262070aea24465c9a3aabc4.ark_js_prebuilts_20230713.tar.gz
-rw-r----- 1 zhoufeng domain users  71381731 Aug 22 01:44 6e50d643b5d0b1656bb136223c179084.libcxx-ndk_windows-x86_64-feef13-20251209.tar.gz
-rw-r----- 1 zhoufeng domain users 572079732 Aug 22 01:50 74bedcabb1a88f3e12bc6356eed4023f.cangjie-linux-x64-1.1.0-alpha.66-hwasan.zip
-rw-r----- 1 zhoufeng domain users  15699808 Aug 22 01:42 7c11e64dfa76a531a02bf4683342b5de.llvm-15.0.4-ark18-release-aarch64.tar.xz
-rw-r----- 1 zhoufeng domain users   3980846 Aug 22 01:42 822e2159e4f9dc82b6b3f6d158a1fdd0.cangjie-api-tools-1.1.0-alpha.66.zip
-rw-r----- 1 zhoufeng domain users 562077952 Aug 22 01:50 87865ae7a3214ca6ba4e08f8abf00db6.cangjie-linux-x64-1.1.0-alpha.66.zip
-rw-r----- 1 zhoufeng domain users  28246064 Aug 22 01:42 915d0b40868587b71043eda64318ca4a.llvm-15.0.4-ark18-debug-x86_64.tar.xz
-rw-r----- 1 zhoufeng domain users  44343888 Aug 22 01:43 9a42f763a78e35ac85f11241a4b8b631.node-v18.20.1-linux-x64.tar.gz
-rw-r----- 1 zhoufeng domain users  52840113 Aug 22 01:43 9b1ca53ad98ebfaa0fbfa26d20d534df.cmake-linux-x86-3.28.2.tar.gz
-rw-r----- 1 zhoufeng domain users  18509664 Aug 22 01:42 9e93cc8ab027a6a1bdf539c6c1072b52.taihe-linux-x86_64-1.3.1-20260120.tar.gz
-rw-r----- 1 zhoufeng domain users  15005708 Aug 22 01:42 a2239e0c72b12af0076f4eebffde3ffc.llvm-15.0.4-ark18-release-ohos-gn_20250306.tar.xz
-rw-r----- 1 zhoufeng domain users  14159960 Aug 22 01:42 ae6e51d45cdf0e95aad4a529d43b6ca8.llvm-15.0.4-ark18-release-ohos.tar.xz
-rw-r----- 1 zhoufeng domain users  12397424 Aug 22 01:42 ae867132e2a2bdbbae5b58aa89eb883e.pahole_v1.21_20221124.tar.gz
-rw-r----- 1 zhoufeng domain users  36182712 Aug 22 01:43 bbc64c11f71c0c4a42239e5a5dc478c0.rust-std-nightly-aarch64-unknown-linux-ohos.tar.gz
-rw-r----- 1 zhoufeng domain users  13870107 Aug 22 01:42 be58b2c455b3cfa97b8aa07c1b24942e.taihe-windows-x86_64-1.3.1-20260120.tar.gz
-rw-r----- 1 zhoufeng domain users   8977140 Aug 22 01:42 be83a54d64aae51286009fb532aa997f.python-linux-arm64-3.11.4_20240715.tar.gz
-rw-r----- 1 zhoufeng domain users   1184356 Aug 22 01:42 cb03ae812e574586b54ce5af5bb43b4f.gn-linux-x86-20260122.tar.gz
-rw-r----- 1 zhoufeng domain users 117896452 Aug 22 01:44 cd98ff85e2af3869cf318497e6a1d559.gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
-rw-r----- 1 zhoufeng domain users  39059716 Aug 22 01:42 cf11276df29c64d2cbbae0490ac6f358.arkcompiler_jsvm_6.1.0_20260424.tar.gz
-rw-r----- 1 zhoufeng domain users  25790324 Aug 22 01:42 d5688b62b9da1c78c621e7277620d1c9.llvm-15.0.4-ark18-debug-aarch64.tar.xz
-rw-r----- 1 zhoufeng domain users  15135801 Aug 22 01:42 d699eb29e0a9c9febb2b13bb779c1ebb.cmake-ohos-3.28.2-20240827.tar.gz
-rw-r----- 1 zhoufeng domain users 699392996 Aug 22 01:49 dea57ad91e78773553dddff479233fe2.clang_ohos-arm64-feef13-20251209.tar.gz
-rw-r----- 1 zhoufeng domain users    128365 Aug 22 01:41 dfcaa71177f12992d9542b6c8e60d363.ninja-linux-x86-1.12.0-20240523.tar.gz
-rw-r----- 1 zhoufeng domain users    270405 Aug 22 01:41 e0c9e1b221277cd431bc9dcba432c3e1.ninja-ohos-1.12.0-20240827.tar.gz
-rw-r----- 1 zhoufeng domain users 551082885 Aug 22 01:50 e3edbae8598de27b4b3979b83a6c8b70.cangjie-windows-x64-1.1.0-alpha.66.zip
-rw-r----- 1 zhoufeng domain users  33784208 Aug 22 01:42 e778f29e95d22f8e3cb6e604936229dc.node-v16.20.2-linux-x64.tar.gz
-rw-r----- 1 zhoufeng domain users  39492529 Aug 22 01:43 ebe7c49b8fdbb8cebc06adb7fef9cb4b.cmake-windows-x86-3.28.2.tar.gz
-rw-r----- 1 zhoufeng domain users 206659072 Aug 22 01:46 f32370c3eb724ad7a6b2ce58e8604a03.command-line-tools.tar
-rw-r----- 1 zhoufeng domain users  18931400 Aug 22 01:42 f37dca93a7202ea9ae85160b20106156.llvm-15.0.4-ark18-release-x86_64.tar.xz
-rw-r----- 1 zhoufeng domain users  34014641 Aug 22 01:43 f868615b69ef8c04d1bfa4f6ed91c9d5.rust-std-nightly-x86_64-pc-windows-gnullvm.tar.gz

3. 完整编译

3.1. 编译流程说明

进入源码根目录，执行以下命令进行版本编译。

cd ~/WorkSpace/2026/oh61lts/src
./build.sh -p xxx --ninja-args="-j128"

其中，xxx 代表产品方案，目前支持的产品方案包括：

pico（K3开发板）

--ninja-args="-j128" 用于指定 ninja 阶段的并行任务数，请根据编译服务器的 CPU 核数调整。

示例：编译 pico 固件：

./build.sh -p pico --ninja-args="-j128"

注意：报下面错误是正常现象，不影响下载：

Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.

3.2. 编译卡启动固件

暂未支持

3.3. MIPI-DSI vs HDMI

暂未支持

3.4. 常用构建参数说明

3.4.1. --fast-rebuild

./build.sh --product-name pico --ccache --no-prebuilt-sdk --fast-rebuild
## 编译流程主要分为四个阶段：preloader->loader->gn->ninja
## 如果本地 没有修改 gn 或产品配置相关文件，则使用参数 --fast-rebuild 时，
## 编译会 直接从 ninja 阶段开始，从而 显著减少编译时间。

3.4.2. --prebuilt-sdk

在执行完整编译前，建议 先编译 SDK。编译完成后，将生成的 SDK 拷贝到 目录：prebuilts/ohos-sdk。

build.sh 脚本支持通过参数 sdk_platform=xxx 来指定 SDK 的运行平台，包括：mac、win、linux、ohos、default。

注意：

当平台为 Linux 主机 时，default 表示 {windows, linux, ohos}。
当平台为 Mac 主机 时，default 表示 {mac}。

示例命令：

./build.sh --product-name xxx --ccache --prebuilt-sdk sdk_platform=default

如果后续 SDK 没有变化，或者 无需重新编译 SDK，可使用参数 --no-prebuilt-sdk，以 加快编译速度。

4. 生成可烧录镜像

执行：

./build/gen_zip.sh <product> [version] [boot_type]

参数说明：

<product>：产品方案，必填
[version]：固件版本号，可选，默认 V1.0，例如 V1.0RC2.4
[boot_type]：启动方式标签，可选，默认 normal，例如 cardboot

<product> 目前支持的产品方案包括：

pico（K3开发板）

生成的镜像文件名由脚本自动拼装，格式为：

out/<product>/packages/phone/images/spacemit-<soc>-<ohver>-<product>-<boot_type>-<version>-<date>.zip

其中 <soc> 取自 device/board/spacemit/<product>/device.gni 的 soc_name，<ohver> 取自 build/version.gni 的 sdk_version（6.1.0.x 对应 oh61），<date> 为编译当天日期。

例如执行 ./build/gen_zip.sh pico 后生成：

out/pico/packages/phone/images/spacemit-k3-oh61-pico-normal-V1.0-20260827.zip

进入烧录模式后，可以通过进迭时空的烧录工具 TitanFlasher 烧录, 下面的章节详细说明。

5. 刷机

5.1. USB 刷机

参考 TitanFlasher 烧录工具点我查看的 “单机烧录” 章节

5.1.1. 进入烧录模式

5.1.1.1. PICO

方式一：FDL + RST 组合进入

插入 Type-C 接口，开机
按住 FDL键，同时按下 RST键，进入刷机模式

方式二：FDL + 上电进入

插入 Type-C 接口，开机
按住 FDL 键 的同时上电，设备将自动进入刷机模式

方式三：通过 hdc 命令进入

插入 Type-C 接口，开机
连接上 hdc
执行以下命令进入刷机模式：

hdc shell
reboot fastboot

方式四：通过串口命令进入

插入 Type-C 接口，开机
通过串口执行以下命令：

reboot fastboot

5.2. 卡刷机

暂未支持

6. 单独编译模块

6.1. 单独编译内核

执行以下命令单独编译内核：

./build.sh --product-name xxx --ccache --prebuilt-sdk -T build_kernel

上面的 build_kernel 定义在 device/board/spacemit/xxx/kernel/BUILD.gn：

action("build_kernel") {
  script = "build_kernel.sh"
  sources = [ kernel_source_dir ]
  outputs = [ "$root_build_dir/packages/phone/images/Image" ]
  args = [
      rebase_path(kernel_build_script_dir,root_build_dir),
      rebase_path("$root_build_dir/../.."),
      rebase_path("$root_build_dir/packages/phone/images"),
      rebase_path(kernel_source_dir),
      rebase_path(kernel_build_script_dir),
      kernel_ramdisk,
      product_company,
      product_name,
  ]
}

源码及输出路径说明：

内核源码路径：kernel/linux/spacemit_kernel-6.6
out 目录下生成的 patching 后的内核源码路径：out/kernel/OBJ/xxx
编译生成的内核镜像路径：out/kernel/OBJ/xxx/arch/riscv/boot/Image.itb
编译生成的 dtb 文件路径在：out/kernel/OBJ/xxx/arch/riscv/boot/dts/spacemit/k1-x_xxx.dtb

生成的内核镜像和 dtb 文件会自动拷贝到 out/xxx/packages/phone/images/bootfs 目录中，并在打包脚本中一并打包进镜像文件。

6.1.1. 修改内核的 config

编译过内核后，会生成 out/kernel/OBJ/xxx/.config，这个是未改动的原始的配置。

进入 out/kernel/OBJ/xxx/ 目录下，执行命令进入图形化的配置页面，如下：
```
cd out/kernel/OBJ/xxx/
make ARCH=riscv menuconfig
```
修改完配置并退出图形界面后，执行命令保存配置，如下：
```
make ARCH=riscv savedefconfig
```
执行命令后，会生成 out/kernel/OBJ/xxx/defconfig，这个是修改生效后的 defconfig，将这个 defconfig 覆盖到原始目录下的 k1_defconfig 即可
```
cp defconfig ../../../../kernel/linux/spacemit_kernel-6.6/arch/riscv/configs/k1_defconfig
```
删除目录 out/kernel/OBJ/xxx/ 后，重新编译内核

6.2. 单独编译 HDF 适配层

以 display 模块为例，可通过以下命令单独编译：

./build.sh -product-name xxx --ccache --prebuilt-sdk -T display_composer_vendor

display 的适配代码在 device/soc/spacemit/k1/hardware/display，display_composer_vendor 的定义在 device/soc/spacemit/k1/hardware/display/BUILD.gn

ohos_shared_library("display_composer_vendor") {
  sources = [
    "src/display_device/drm_connector.cpp",
    "src/display_device/drm_crtc.cpp",
    "src/display_device/drm_device.cpp",
    ...

编译后生成的 .so 在：

-rwxr-xr-x 1 zhoufeng domain users 159968 Aug 27 16:34 ./out/pico/hdf/spacemit_products/libdisplay_composer_vendor.z.so

而下面文件夹中的 .so 不会自动更新，可通过对比时间戳或 MD5 值确认文件是否为最新版本。

-rwxr-xr-x 1 zhoufeng domain users 159968 Aug 27 16:34 ./out/pico/packages/phone/vendor/lib64/libdisplay_composer_vendor.z.so

生成的动态库可以通过 hdc 推送到机器中，方便调试，避免重新烧固件，命令如下：

D:\>hdc shell
# mount -o remount,rw /                #system分区可读写
# mount -o remount,rw /vendor          #vendor分区可读写
# exit

D:\>hdc file send xxx.so /vendor/lib64/
D:\>hdc shell
# reboot

6.3. 单独编译 SDK

使用以下命令单独编译 OpenHarmony SDK：

./build.py --product-name ohos-sdk --ccache=true --xcache=false --load-test-config=false --get-warning-list=false --stat-ccache=false --compute-overlap-rate=false --deps-guard=false --generate-ninja-trace=false --gn-args skip_generate_module_list_file=true sdk_platform=linux ndk_platform=linux use_cfi=false use_thin_lto=false enable_lto_O0=true sdk_check_flag=false enable_ndk_doxygen=false archive_ndk=false sdk_for_hap_build=true enable_archive_sdk=false enable_notice_collection=false enable_process_notice=false

说明:

通过更改 sdk_platform 和 ndk_platform 参数可以编译在不同 OS 运行的 SDK
编译完成后，NDK 输出位于 out/sdk/sdk-native

6.4. 快速编译

如果只想快速编译某个目标模块，可以使用 ninja 命令：

ninja -w dupbuild=warn -C out/xxx yyy -j8

# xxx表示方案名
# yyy表示构建目标

示例：编译 MUSEPaper 方案的 libomxvpu_dec 目标，命令如下：

ninja -w dupbuild=warn -C out/musepaper libomxvpu_dec -j8

7. FAQ

7.1. 编译报错相关

7.1.1. `make_ext4fs: command not found`

报错示例如下：

Starting to pack images.................................
  Chip platform : k3
  Device name   : pico
../build/gen_zip.sh: line 62: make_ext4fs: command not found

解决方案：按照文档上面 1.2 章节的说明来安装 make_ext4fs

7.1.2. 编译 `dlp_manager` 和 `permission_manager` 报错

原因：SDK 未编译

解决方案：添加 --prebuilt-sdk 参数重新编译

7.1.3. `[GN] ERROR at //third_party/libnl/BUILD.gn:13:1`

报错示例如下：

[OHOS ERROR] [GN] ERROR at //third_party/libnl/BUILD.gn:13:1: Script returned non-zero exit code.
[OHOS ERROR] [GN] exec_script("install.sh", [ "$libnl_path" ])
[OHOS ERROR] [GN] ^----------
[OHOS ERROR] [GN] Current dir: /home/zhoufeng/WorkSpace/2026/oh61lts/src/out/pico/
[OHOS ERROR] [GN] Command: /usr/bin/env /home/zhoufeng/WorkSpace/2026/oh61lts/src/third_party/libnl/install.sh /home/zhoufeng/WorkSpace/2026/oh61lts/src/third_party/libnl
[OHOS ERROR] [GN] Returned 100 and printed out:
[OHOS ERROR] [GN]
[OHOS ERROR] [GN] libnl-libnl3_11_0/
[OHOS ERROR] [GN] libnl-libnl3_11_0/.clang-format
[OHOS ERROR] [GN] libnl-libnl3_11_0/.flake8
[OHOS ERROR] [GN] libnl-libnl3_11_0/.git-blame-ignore-revs
[OHOS ERROR] [GN] libnl-libnl3_11_0/.github/
[OHOS ERROR] [GN] libnl-libnl3_11_0/.github/workflows/

解决方案：在third_party/libnl目录下打上下面的patch:

diff --git a/install.sh b/install.sh
index 3b0b0ee..27cdaff 100755
--- a/install.sh
+++ b/install.sh
@@ -14,8 +14,8 @@ fi
 tar xvf libnl-libnl3_11_0.tar.gz
 mv libnl-libnl3_11_0 libnl
 cd $1/libnl
-apt-get update
-apt-get install autoconf automake libtool -y
+#apt-get update
+#apt-get install autoconf automake libtool -y
 ./autogen.sh
 ./configure
 patch -p1 < $1/solve-oh-compile-problem3_11_0.patch --fuzz=0 --no-backup-if-mismatch

7.1.4. ohpm install失败

报错示例如下：

[OHOS ERROR] [NINJA] ohpm ERROR: ETIMEDOUT network timeout at: https://ohpm.openharmony.cn/ohpm/@ohos/hypium, please check the network connectivity to the registry https://ohpm.openharmony.cn/ohpm/
[OHOS ERROR] [NINJA] ohpm DEBUG: getOverrideDepFile with key: @ohos/hypium.
[OHOS ERROR] [NINJA] ohpm ERROR: missing: @ohos/hypium@1.0.6, required by @
[OHOS ERROR] [NINJA] ohpm ERROR: Found exception: FetchError: network timeout at: https://ohpm.openharmony.cn/ohpm/@ohos/hypium, reached retry limit or non retryable error encountered.
[OHOS ERROR] [NINJA] ohpm DEBUG: Executor found task execute failed, exit process!
[OHOS ERROR] [NINJA] ohpm DEBUG: Executor Run completed in 121s 44ms
[OHOS ERROR] [NINJA] ohpm ERROR: ERUNNING execute tasks failed, FetchError: network timeout at: https://ohpm.openharmony.cn/ohpm/@ohos/hypium
[OHOS ERROR] [NINJA] ohpm DEBUG: removeLock succeed, filepath: /home/zhoufeng/WorkSpace/2026/oh61lts/src/base/powermgr/power_manager/power_dialog/oh-lock.lock.
[OHOS ERROR] [NINJA] ohpm DEBUG: start to write trace data
[OHOS ERROR] [NINJA] ohpm DEBUG: start to get key
[OHOS ERROR] [NINJA] ohpm DEBUG: start to get root key
[OHOS ERROR] [NINJA] ohpm DEBUG: start to get trace log dir
[OHOS ERROR] [NINJA] ohpm DEBUG: Audit failed, detail: the trace log file path is not exist! trace path: /home/zhoufeng/Library/Caches/Huawei/DevEcoStudio5.0/TraceLogData
[OHOS ERROR] [NINJA] ohpm ERROR: Install failed, detail: FetchError: network timeout at: https://ohpm.openharmony.cn/ohpm/@ohos/hypium

解决方案：在base/powermgr/power_manager/power_dialog打上下面的patch:

diff --git a/power_dialog/oh-package.json5 b/power_dialog/oh-package.json5
index 7e5be94f..f9863f69 100644
--- a/power_dialog/oh-package.json5
+++ b/power_dialog/oh-package.json5
@@ -16,7 +16,6 @@
 {
   "license": "",
   "devDependencies": {
-    "@ohos/hypium": "1.0.6"
   },
   "author": "",
   "name": "com.ohos.powerdialog",

在applications/standard/dlp_manager/打上：

diff --git a/oh-package.json5 b/oh-package.json5
index 50e86d3..0fa5d26 100644
--- a/oh-package.json5
+++ b/oh-package.json5
@@ -16,7 +16,6 @@
   "modelVersion": "5.0.0",
   "license": "ISC",
   "devDependencies": {
-    "@ohos/hypium": "1.0.6"
   },
   "name": "dlpmanager",
   "description": "example description",

在applications/standard/permission_manager/打上：

diff --git a/oh-package.json5 b/oh-package.json5
index a7fa446..0b1c2c6 100644
--- a/oh-package.json5
+++ b/oh-package.json5
@@ -17,11 +17,10 @@
   "modelVersion": "5.0.0",
   "license": "ISC",
   "devDependencies": {
-    "@ohos/hypium": "1.0.6"
   },
   "name": "permissionmanager",
   "description": "example description",
   "repository": {},
   "version": "1.0.0",
   "dependencies": {}

在applications/standard/user_certificate_manager/打上：

diff --git a/oh-package.json5 b/oh-package.json5
index 736c887..d9d6b3b 100755
--- a/oh-package.json5
+++ b/oh-package.json5
@@ -17,7 +17,6 @@
   "modelVersion": "5.0.0",
   "license": "",
   "devDependencies": {
-    "@ohos/hypium": "1.0.11"
   },
   "author": "",
   "name": "security_privacy_center",
@@ -25,4 +24,4 @@
   "main": "",
   "version": "1.0.0",
   "dependencies": {}

修订记录​

1. 环境准备​

1.1. Ubuntu 环境（推荐 Ubuntu22.04，其他版本暂未验证）​

1.2. 安装 make_exf4fs（如果已安装，请忽略）​

2. 源码准备​

2.1. 访问如意社区​

2.2. 下载源码​

2.3. 安装编译器​

3. 完整编译​

3.1. 编译流程说明​

3.2. 编译卡启动固件​

3.3. MIPI-DSI vs HDMI​

3.4. 常用构建参数说明​

3.4.1. --fast-rebuild​

3.4.2. --prebuilt-sdk​

4. 生成可烧录镜像​

5. 刷机​

5.1. USB 刷机​

5.1.1. 进入烧录模式​

5.1.1.1. PICO​

5.2. 卡刷机​

6. 单独编译模块​

6.1. 单独编译内核​

6.1.1. 修改内核的 config​

6.2. 单独编译 HDF 适配层​

6.3. 单独编译 SDK​

6.4. 快速编译​

7. FAQ​

7.1. 编译报错相关​

7.1.1. make_ext4fs: command not found​

7.1.2. 编译 dlp_manager 和 permission_manager 报错​

7.1.3. [GN] ERROR at //third_party/libnl/BUILD.gn:13:1​

7.1.4. ohpm install失败​

修订记录

1. 环境准备

1.1. Ubuntu 环境（推荐 Ubuntu22.04，其他版本暂未验证）

1.2. 安装 make_exf4fs（如果已安装，请忽略）

2. 源码准备

2.1. 访问如意社区

2.2. 下载源码

2.3. 安装编译器

3. 完整编译

3.1. 编译流程说明

3.2. 编译卡启动固件

3.3. MIPI-DSI vs HDMI

3.4. 常用构建参数说明

3.4.1. --fast-rebuild

3.4.2. --prebuilt-sdk

4. 生成可烧录镜像

5. 刷机

5.1. USB 刷机

5.1.1. 进入烧录模式

5.1.1.1. PICO

5.2. 卡刷机

6. 单独编译模块

6.1. 单独编译内核

6.1.1. 修改内核的 config

6.2. 单独编译 HDF 适配层

6.3. 单独编译 SDK

6.4. 快速编译

7. FAQ

7.1. 编译报错相关

7.1.1. `make_ext4fs: command not found`

7.1.2. 编译 `dlp_manager` 和 `permission_manager` 报错

7.1.3. `[GN] ERROR at //third_party/libnl/BUILD.gn:13:1`

7.1.4. ohpm install失败