教你一招：鸿蒙版 RN 应用，包体积直接减半

如何减少 HAP 包体积

周末我在学习的时候，发现打包出来的 HAP 包体积略大，这不仅影响下载速度，还可能拖慢安装和启动性能。于是我专门研究了一波优化方法，从原生侧到 RN 侧梳理出一套实用方案。本文就把这些实战经验分享出来，教你如何一步步给鸿蒙版 RN 应用 “瘦身”。

一、原生侧优化

1) CMake 剥离符号（减小 SO 体积）

set(CMAKE_CXX_FLAGS "-s")

说明：-s 在链接阶段剥离符号表和调试信息，显著减小产物大小。

2) 通过 build-profile.json5 传递 cppFlags

/*
path: CMakeLists.txt 文件位置
arguments: 额外构建参数
cppFlags: 传递给 C++ 的编译选项，这里设置 -s 以剥离符号
*/
"buildOption": {
  "externalNativeOptions": {
    "path": "./src/main/cpp/CMakeLists.txt",
    "arguments": "",
    "cppFlags": "-s",
  },
},

3) 使用 Release 构建

在 DevEco Studio 的 Build Mode 中选择 release：

image-20250907163616892

image-20250907163616892

Release 构建默认进行代码压缩与优化，产物更小更稳定。

4) 压缩 SO（compressNativeLibs）

参考「应用包大小优化」，在 module.json5 中开启：

{
  "module": {
    // ...
    "compressNativeLibs": true
  }
}

5) ABI 精简（按需构建）

如无需在 x86_64 模拟器运行，可仅构建 arm64-v8a：

"buildOption": {
  "externalNativeOptions": {
    "abiFilters": ["arm64-v8a"]
  }
}

二、RN 侧优化

1) 使用 Hermes 与 Minify

• Hermes 引擎字节码（.hbc）体积更小、启动更快
• 在打包配置中开启压缩（minify）以减小 JS 体积

2) 资源裁剪与图片压缩

• 移除未使用的图片、字体与大文件
• 使用 WebP/AVIF 等高压缩比格式
• 统一图片尺寸，减少超大分辨率资源

3) 按需打包与拆分

• 拆分业务模块，减少首包体积
• 三方库按需引入，避免整体引入导致臃肿

三、效果对比与验证

验证建议：

• 对比 HAP 体积与安装包大小
• 统计首次启动时长变化（冷启动）
• 关注大资源是否仍在包内（解包后检查）

四、常见问题（FAQ）

1. 体积变化不明显

• 确认 Release 构建已启用，且 -s 已生效
• 检查是否仍包含多余 ABI 与大体积资源

1. 开启 compressNativeLibs 后加载变慢

• 属正常权衡（体积更小 vs 解压耗时），按业务权衡开启

1. Hermes 与 JSVM 选择

• 追求体积与启动：优先 Hermes 并使用 .hbc
• 便捷调试：可用 Metro/普通 bundle

如果大家有好的建议，也可以评论区留言。