企业官网建设流程全解析

在 HarmonyOS 应用开发中，减小应用包体积对于提升下载和安装体验至关重要。通过压缩、精简或复用代码和资源，可以有效降低包大小。以下是应用体积瘦身的核心技术实践：

一、 资源压缩与优化

1. so 库压缩：DevEco Studio 默认不压缩 so 库文件。在应用模块的module.json5配置文件中，将compressNativeLibs字段设置为true，可使 so 库以压缩形式打包，显著减小包大小。
2. 去除调试信息：对于 C++ 编译产物，可通过在build-profile.json5中配置"strip": true，移除 so 文件中的调试信息与符号表，从而减小 Native 库体积。
3. 图片资源优化：
   • 对于预置的 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 } } } } ] } }

二、 代码裁剪与架构优化

1. HSP 动态共享包：在多包（HAP、HSP）场景下，推荐使用 HSP 替代 HAR（静态共享包）。HAR 会导致代码和资源在每个使用方中重复拷贝，而 HSP 独立编译且在运行时进程中只存在一份，能彻底消除冗余，显著精简首包体积。
2. 代码分支裁剪：在工程级或模块级的build-profile.json5中，开启branchElimination字段。在 release 编译模式下，系统会自动裁剪掉不会被执行到的代码分支，减少编译产物大小。
3. 按需加载（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" } ] } ] } }

三、 依赖管理与冗余清理

1. 解决依赖冲突：使用 ohpm 的override机制或开启resolve_conflict，解决依赖包版本冲突，避免不同版本的相同 HAR 被重复打包进应用。
2. 移除冗余权限：在build-profile.json5的buildOption下配置removePermissions数组，指定并删除依赖包中的冗余权限。
3. 排除非源码资源：通过配置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 压缩已触及瓶颈，引入 ASTC（Adaptive 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): Promise<void> { 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); } } }