资讯详情

深入了解 · 专业解读

应用体积瘦身：资源压缩与代码裁剪技术（167）

发布时间：2026/7/15 13:27:33
应用体积瘦身：资源压缩与代码裁剪技术（167） 在 HarmonyOS 应用开发中减小应用包体积对于提升下载和安装体验至关重要。通过压缩、精简或复用代码和资源可以有效降低包大小。以下是应用体积瘦身的核心技术实践一、 资源压缩与优化so 库压缩DevEco Studio 默认不压缩 so 库文件。在应用模块的module.json5配置文件中将compressNativeLibs字段设置为true可使 so 库以压缩形式打包显著减小包大小。去除调试信息对于 C 编译产物可通过在build-profile.json5中配置strip: true移除 so 文件中的调试信息与符号表从而减小 Native 库体积。图片资源优化对于预置的 JPG、PNG、GIF 等图片可使用图像编辑工具进行压缩或优先使用.webp格式。开启纹理压缩在build-profile.json5中配置compression/media/enable: true在编译阶段提前完成 CPU 解码并生成纹理码流不仅能减少 CPU 处理时间和内存占用还能减小部分图片的文件大小。1. 开启 so 库压缩 (module.json5){ module: { // ...其他配置 // 核心优化将 so 库以压缩格式打包显著减小包大小 compressNativeLibs: true } }2. 去除 Native 调试信息 (build-profile.json5){ app: { products: [ { name: default, buildOption: { nativeLib: { debugSymbol: { // 核心优化执行 strip 命令移除 so 文件中的调试信息与符号表 strip: true, exclude: [] } } } } ] } }3. 开启预置图片纹理压缩 (build-profile.json5){ app: { products: [ { name: default, buildOption: { strictMode: { caseSensitiveCheck: true }, compression: { media: { // 核心优化编译期提前完成 CPU 解码并生成纹理码流 enable: true } } } } ] } }二、 代码裁剪与架构优化HSP 动态共享包在多包HAP、HSP场景下推荐使用 HSP 替代 HAR静态共享包。HAR 会导致代码和资源在每个使用方中重复拷贝而 HSP 独立编译且在运行时进程中只存在一份能彻底消除冗余显著精简首包体积。代码分支裁剪在工程级或模块级的build-profile.json5中开启branchElimination字段。在 release 编译模式下系统会自动裁剪掉不会被执行到的代码分支减少编译产物大小。按需加载On-Demand Delivery将应用中用户不常用的功能作为按需加载的模块。预装包仅保留核心功能文件用户在使用过程中再动态下载增强特性大幅降低初次下载的包大小。1. 代码分支裁剪 (build-profile.json5){ app: { products: [ { name: default, buildOption: { // 核心优化Release 模式下自动剔除未执行的死代码分支 branchElimination: true } } ] } }2. 按需加载On-Demand Delivery配置示例 (build-profile.json5){ app: { products: [ { name: default, targets: [ { name: default, runtimeOS: HarmonyOS }, { // 核心优化将非核心功能如客服模块配置为按需下载模块 name: customer_service_feature, runtimeOS: HarmonyOS } ] } ] } }三、 依赖管理与冗余清理解决依赖冲突使用 ohpm 的override机制或开启resolve_conflict解决依赖包版本冲突避免不同版本的相同 HAR 被重复打包进应用。移除冗余权限在build-profile.json5的buildOption下配置removePermissions数组指定并删除依赖包中的冗余权限。排除非源码资源通过配置copyCodeResource对象支持根据 glob 语法排除src/main/ets目录下不需要打包到产物中的资源文件。1. 解决依赖冲突 (oh-package.json5)// 项目根目录下的 oh-package.json5 { dependencies: {}, // 核心优化强制指定依赖版本避免不同版本的相同 HAR 被重复打包 overrides: { foo: 1.0.0, // 或者强制使用本地源码/HAR包 // bar: file:./libs/bar.har } }2. 移除冗余权限 (build-profile.json5){ app: { products: [ { name: default, buildOption: { // 核心优化指定并删除依赖包中未使用的冗余权限 removePermissions: [ ohos.permission.GET_NETWORK_INFO ] } } ] } }四、 扫描分析与度量使用App Check Tool扫描工具对应用包进行全面分析。该工具可检测重复文件、较大文件及特定类型文件并输出检测报告。开发者可根据报告精准定位问题如删除同一包内的重复资源、确认大文件是否必需等为包体优化提供数据支撑。五、 ArkTS 编译底层优化Tree Shaking 与极致混淆除了架构层面的裁剪ArkTS 代码在编译期同样存在巨大的瘦身空间。通过底层编译配置的调优可实现安装包体积缩小 50% 以上。Tree Shaking 与混淆在build-profile.json5的buildOption中开启treeShaking: true与obfuscate: true。编译器在打包时会进行深度静态分析自动剔除未被引用的死代码Dead Code和冗余资源。去除调试代码配置removeDebug: true确保 Release 包中彻底剥离所有的日志输出与调试辅助代码进一步压缩字节码体积。{ app: { products: [ { name: default, buildOption: { arkOptions: { obfuscation: { ruleOptions: { // 核心优化Release 包开启混淆自动执行 Tree Shaking 与代码混淆 enable: true, files: [ ./obfuscation-rules.txt // 混淆规则配置文件 ] } } } } } ] } }六、 ASTC 纹理压缩实战让图片“瘦”得有质量对于重度依赖图片资源的应用传统的 PNG/JPG 压缩已触及瓶颈引入 ASTCAdaptive Scalable Texture Compression是终极解决方案。编译期自动转码在build-profile.json5中配置compression节点开启media.enable: true。构建时系统会自动将预置图片转换为 ASTC 格式。精准过滤策略通过filters配置可针对特定路径、大小如大于 1000KB或分辨率的图片启用 ASTC 8x8 压缩同时利用exclude排除已经过优化的.webp文件避免重复处理。ASTC 能在保留高频细节的同时将图片体积降低 50% 以上且 GPU 可直接读取省去 CPU 解码耗时。{ app: { products: [ { name: default, buildOption: { compression: { media: { enable: true, // 核心优化精准过滤策略避免重复处理与无效压缩 filters: [ { pattern: **/*.png, // 仅针对 PNG 格式 minSize: 1024, // 大于 1MB 的图片才进行 ASTC 压缩 format: astc_8x8 // 使用 8x8 块平衡体积与画质 } ], exclude: [ **/*.webp // 排除已优化的 WebP 文件 ] } } } } ] } }七、 多包架构瘦身HSP 动态共享与依赖去重随着应用模块化HAR 静态链接导致的“包体积线性膨胀”是常见痛点。HAR 转 HSP将跨模块复用的 UI 组件库、工具库从 HAR 升级为 HSP。HSP 独立编译运行时在进程中仅存在一份从物理上彻底清除安装包内的代码与资源冗余。OHPM 依赖版本对齐当项目中多个模块依赖同一三方库的不同版本时默认会将所有版本打入包中。需在项目级oh-package.json5中使用overrides机制强制指定单一版本或开启resolve_conflict自动采用最高版本杜绝重复编译与打包。1. 声明 HSP 共享库 (library-hsp/oh-package.json5){ name: app/common-utils, version: 1.0.0, // 核心优化声明为动态共享库运行时仅加载一份代码 type: shared }2. 依赖版本强制对齐 (项目根目录oh-package.json5){ dependencies: {}, // 核心优化强制指定单一版本防止多模块引入不同版本导致体积线性膨胀 overrides: { ohos/axios: 2.1.0, lodash: 4.17.21 } }八、 本地化拆分与按需分发策略对于面向全球市场的出海应用包体积的优化不仅是技术问题更是分发策略问题。语言包按需下载核心语言如中/英内置于首包其余小语种作为独立的语言包 HAP 或资源包在用户首次进入设置页切换语言时在线拉取。特性按需分发On-Demand将地图、复杂 ML 模型、非首屏的增强特性等拆分为独立的 Feature HAP。预装包仅保留核心骨架用户在实际触发相关功能时系统再从应用市场安全拉取并安装首包体积可精简 50% 以上。1. 配置 Feature HAP 按需分发 (feature-video/module.json5){ module: { name: feature-video, type: feature, // 核心优化不随主包安装仅在用户触发视频功能时动态下载 deliveryWithInstall: false, abilities: [ { name: VideoEditAbility, srcEntry: ./src/main/ets/VideoEditAbility.ets } ] } }2. 主包动态安装模块 (ModuleManager.ets)import { moduleInstallManager } from kit.AppGalleryKit; export class ModuleManager { // 动态拉取并安装按需分发的 Feature 模块 static async installFeatureModule(moduleName: string): Promisevoid { const installRequest: moduleInstallManager.ModuleInstallRequest { moduleName: moduleName, installationFlag: moduleInstallManager.InstallationFlag.INSTALLATION_FLAG_REPLACE_EXISTING }; try { await moduleInstallManager.installModules([installRequest]); console.info(${moduleName} installed successfully.); } catch (error) { console.error(Install ${moduleName} failed:, error); } } }

相关新闻