当前位置：首页 > news >正文

openHarmony之开源三方库zlib适配讲解

news 2025/9/18 7:32:47

三方开源库适配 OpenHarmony 指南（zlib 篇）

00 速览

步骤	命令/动作	预期结果
① 拉取源码	`git clone https://github.com/madler/zlib -b v1.3.1`	得到纯净上游代码
② 放入树内	`mv zlib third_party/zlib`	与系统构建同级
③ 一键模板	复制「OH 三方库脚手架」→ `third_party/zlib`	含 BUILD.gn、bundle.json、OAT.xml
④ 触发构建	`hb build -T //third_party/zlib:libz`	out 目录出现 `libz.a`
⑤ 功能冒烟	运行 `example/oh_zlib_test`	打印 “Compression ratio 78%”

注意：zlib已经适配到官方主代码中，该篇只做讲解，三方库适配可参考我的文章《OpenHarmony之三方库适配深度实践：从移植到合规的全链路指南》

01 认识 zlib

zlib 是 DEFLATE 算法 的工业级实现，提供：

内存级压缩/解压（compress/uncompress）
流式 API（deflate/inflate）
gzip 封装（gz* 系列函数）
跨平台、无第三方依赖、MIT-like 授权

OpenHarmony 已将其作为系统基础库引入，供 ArkTS NDK、图形子系统、包装器（minizip）等使用。

02 目录结构

third_party/zlib
├── BUILD.gn               # GN 入口
├── bundle.json            # 组件元数据
├── OAT.xml                # 开源审计
├── README.OpenSource      # 变更履历
├── ohos.patch             # OH 专用补丁（可选）
├── include/               # 导出头文件
│   ├── zlib.h
│   └── zconf.h
├── src/                   # 上游 c 文件
└── test/                  # 冒烟测试

保持「上游代码零改动」原则，所有适配通过 BUILD.gn、补丁、config 注入完成。

03 核心适配文件

3.1 BUILD.gn

# Copyright (c) 2024 OpenHarmony Project
import("//build/config/config.gni")
import("//build/ohos.gni")
import("//build/ohos/ndk/ndk.gni")# 统一编译选项
ohos_zlib_cflags = ["-Oz",                       # 体积优先"-Wno-sign-conversion","-Wno-implicit-function-declaration","-DHAVE_STDA