文档开发者中心
我的
|

HarmonyOS 5

App 安装包太大,如何压缩 hap 体积?

应用上架时 hap 包 180MB,市场提示"建议 ≤ 150MB"。主要构成分析: 双架构 so 库占 60MB(三方 C++ 库)、图片资源 40MB、字体 15MB、内置 H5 离线包 30MB、其余代码。

我想了解:像这种应用如何做分包呢?

点赞
1
收藏
回复
14
分享
举报
浏览83 发布于5天前北京
全部评论
最多点赞
最新发布
最早发布
|
推荐答复
AI 生成内容,仅供参考

针对您 180MB 的 HAP 包,最优解是"分包 + 按需加载 + 资源动态化"三管齐下:将低频大体积功能拆成 Feature HAP 并配置按需下载,so 库只保留 arm64-v8a 单架构并开启压缩,图片转 WebP、字体做子集裁剪、H5 离线包改为云端按需下发。仅这几项通常就能把主包压到 60MB 以下。

一、先理解 HarmonyOS 的分包模型

上架时的检测单元是 App Pack(.app 文件),它由多个 HAP/HSP 组成。应用市场会拆解 App Pack 并按模块分发,因此"包太大"的本质是"主包(entry HAP)太大"。分包的核心思路是:

  • entry HAP:应用主入口,只保留首启动必需的代码、资源和 so
  • feature HAP:动态特性模块,可配置为不随主包安装,用户用到时再从应用市场下载
  • HSP:动态共享包,解决多个 HAP 重复依赖同一份 HAR 导致的代码复制问题
  • HAR:静态共享包,会被完整拷贝进每个引用它的 HAP,是隐性体积膨胀源

需要注意的是,应用市场对手机/平板 HAP 的硬性上限是 4GB,您遇到的"建议 ≤ 150MB"属于下载转化层面的建议阈值,分包后主包控制在 150MB 以内即可顺利通过。

二、针对您的体积构成逐项拆解

体积项 大小 建议方案
双架构 so 库 60MB 只保留 arm64-v8a,开启 compressNativeLibs
图片资源 40MB PNG 转 WebP、图标 SVG 化、大图云端下发
字体 15MB 字体子集裁剪,只保留实际用到的字符
H5 离线包 30MB 移出安装包,首启动后按需下载到沙箱
其余代码 35MB 开启混淆与压缩,低频功能拆 feature HAP

三、分包落地步骤与配置

第一步,在 DevEco Studio 中新建 feature 类型的 Module(如 feature_editor),将低频大功能(编辑工具、离线地图等)迁入,并在其 module.json5 中关闭随包安装:

收起
自动换行
深色代码主题
复制
// feature_editor/src/main/module.json5
{
  "module": {
    "name": "feature_editor",
    "type": "feature",              // feature 类型:动态特性模块
    "deliveryWithInstall": false,   // 关键配置:不随主包安装,用户用到时再下载
    "installationFree": false,
    "deviceTypes": ["phone"],
    "mainElement": "EditorAbility",
    // ...其余配置
  }
}

第二步,在 entry 的 oh-package.json5 中声明动态依赖:

收起
自动换行
深色代码主题
复制
// entry/oh-package.json5
{
  "dynamicDependencies": {
    "feature_editor": "file:../feature_editor"
  }
}

第三步,在 entry 中按需拉取并动态加载 feature 模块(API 12+):

收起
自动换行
深色代码主题
复制
// entry/src/main/ets/pages/Index.ets
import { moduleInstallManager } from '@kit.AppGalleryKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

const TAG: string = 'FeatureLoader';

async function loadEditorFeature(): Promise<void> {
  try {
    // 从应用市场按需下载 feature_editor 模块
    const installInfo = await moduleInstallManager.fetchModules(['feature_editor']);
    if (installInfo[0].status === moduleInstallManager.InstallStatus.SUCCESS) {
      // 下载成功后,通过动态 import 加载模块
      await import('feature_editor');
      hilog.info(0x0000, TAG, 'feature 模块加载成功');
    }
  } catch (err) {
    const e = err as BusinessError;
    hilog.error(0x0000, TAG, `模块下载失败: ${e.code} ${e.message}`);
  }
}

第四步,so 库瘦身。在 build-profile.json5 中过滤 ABI,并在 module.json5 中开启 so 压缩:

收起
自动换行
深色代码主题
复制
// build-profile.json5(模块级)
{
  "buildOption": {
    "externalNativeOptions": {
      "abiFilters": ["arm64-v8a"]   // HarmonyOS NEXT 设备均为 64 位,去掉 v7a 可省约一半 so 体积
    }
  }
}
收起
自动换行
深色代码主题
复制
// entry/src/main/module.json5
{
  "module": {
    "compressNativeLibs": true   // so 以压缩方式打包,安装时系统自动解压
  }
}

第五步,H5 离线包动态下发。将离线包从 rawfile 移除,首次启动后下载到应用沙箱:

收起
自动换行
深色代码主题
复制
import { request } from '@kit.BasicServicesKit';
import { fileIo } from '@kit.CoreFileKit';

async function downloadH5Package(context: Context): Promise<void> {
  const savePath = `${context.filesDir}/h5_offline.zip`;
  const file = fileIo.openSync(savePath,
    fileIo.OpenMode.CREATE | fileIo.OpenMode.READ_WRITE);
  // 从服务端按需下载离线包,替代打包进 HAP
  await request.downloadFile(context, {
    url: 'https://your-cdn.example.com/h5_offline.zip',
    filePath: file.path
  });
}

四、补充说明与预期收益

关于各优化项的预期效果:so 库单架构化可从 60MB 降到约 30MB,再叠加 compressNativeLibs 通常还能再省 10%-20%;PNG 转 WebP 在同等清晰度下体积减少 40%-60%,ArkUI 原生支持 WebP 无需适配;15MB 的字体文件建议使用 fonttools 等工具做子集裁剪,只保留实际用到的字符集,通常可压到 1-3MB;H5 离线包 30MB 完全移出安装包后云端下发,主包直接减 30MB。

关于 HAR 与 HSP 的取舍:如果三方 C++ 库的 ArkTS 封装层(HAR)被 entry 和多个 feature 同时依赖,HAR 会在每个 HAP 中各复制一份,此时应改用 HSP 动态共享包,运行时只加载一份。判断标准是:某个共享模块被三个以上 HAP 引用且体积可观,就值得拆成 HSP。

关于上架检测:应用市场会解析 App Pack 中每个 HAP 的大小,按其 deviceTypes 声明的设备类型判定上限(手机/平板 4GB)。分包后即使 feature HAP 较大也不影响主包分发,因为 deliveryWithInstall 为 false 的模块在用户安装主包时不会下载。另外请确保 release 构建已开启 ArkGuard 混淆(默认开启),并检查包内不含 debug 字段为 true 的调试信息,否则提审会被驳回。

优化顺序建议遵循"先砍冗余(ABI、资源格式),再消重复(HAR 转 HSP),最后把低频大功能挪出安装包"的节奏,每一步用 DevEco Studio 的 App Size Analyzer 或直接解压 HAP(本质是 zip)核对体积变化,确保收益可量化。

展开全部
1
1楼回复于5天前 来自广东
  • 匿名用户匿名用户
    是这样的
    5天前 来自北京

这类应用可以拆成 entry.hap 基础包 + 按需安装的 HSP。主包保留首屏、核心功能和首次离线使用必需的资源。低频功能的代码、专用 .so、图片和 H5 资源放进对应 HSP,在其 module.json5 配置 deliveryWithInstall: false。上架时一起打进 .app,用户首次使用该功能时通过 moduleInstall.fetchModules() 下载安装,成功后再用动态 import() 加载。应用市场按需分发指南

按你这份体积构成,建议优先处理两块:

  1. 双架构 .so(60 MB):先确认发布设备需要哪些 ABI。若 x86_64 只用于模拟器,发布包可只保留 arm64-v8a。检查三方 HAR 是否仍带入多余架构,并确认 Release 包已剥离调试符号。Native 构建配置
  2. H5 离线包(30 MB):如果只服务低频功能,优先整包移入按需 HSP,下载完成后仍可离线使用。如果要求安装后第一次打开就能离线访问,则保留必要部分,删掉 sourcemap 和重复资源。图片按实际显示尺寸压缩,字体按需做子集。应用包体积优化指南

以 150 MB 作为这次优化目标,改完分别检查 主 HAP、首次下载总量和上架 .app 总量。按需分发主要减少首次下载,实际删减 ABI、图片和字体才会同时缩小发布包。应用包扫描工具

12楼回复于5天前 来自广东

先把目标拆成两个数:首装实际下载多少、安装全部功能后一共占多少。分包主要改变前一个数;去重复、裁剪资源才会降低后一个数,不能据题中分类直接承诺压到某个 MB。

建议先选 30MB H5 对应的独立业务试拆:首次断网必须可用的内容留在基础包;允许用户等待下载的内容连同专用依赖放进增强模块。若选择已有的 offline_h5 HSP,基础模块 oh-package.json5 的动态依赖片段可按实际目录合并:

收起
自动换行
深色代码主题
复制
{
  "dynamicDependencies": {
    "offline_h5": "file:../offline_h5"
  }
}

增强模块还要配置 deliveryWithInstall:false;基础包先查安装状态,未安装则按 moduleInstallManager 流程请求并等待安装成功,再动态加载。仅有 import 不等于会自动从市场下载。若选 feature HAP,则按它的 Ability 入口启动,不套用 HSP 的调用方式。

同时扫描 release 产物:确认原 H5 文件已从 entry 移走、公共 HAR 没有在多个包重复、so 的实际 ABI 与发布设备一致。不要根据“PC”或“手机”几个字直接删架构,也不要把 60MB 固定算成可减半。图片先查重复与尺寸,字体裁剪后验证任意用户文本的缺字回退;so 压缩还会影响安装占用,须一起比较。最后在未预装增强模块的环境验证断网、取消、下载失败和成功进入,IDE 全量安装通过不足以证明按需流程正确。官方完整接入:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-moduleinstall_arkts/

14楼回复于4天前 来自四川

   核心思路是 “按需分发(Feature HAP + 应用市场按需安装)+ 架构裁剪(ABI)+ 大体积静态资产云端化(CDN)” 三管齐下。落地前需先澄清三个关键事实:按需安装必须使用 AppGallery Kit 提供的 moduleInstallManager 接口(bundleInstaller 的安装类接口面向系统应用,三方应用不可用);HarmonyOS 仅支持 arm64-v8a 与 x86_64 两种 ABI,不存在 armeabi-v7a;应用市场上架 App 包上限为 4GB,150MB 是首包体验目标而非市场硬性限制。

一、核心架构级分包:多模块机制(Feature HAP 与 HSP)

1. 拆分独立业务模块为 Feature HAP(按需分发)

适用模块:非首屏强依赖的独立业务模块(如 H5 离线包对应的业务频道、独立的音视频/地图模块等)。将这部分代码与专属资源新建为 Feature 类型模块,安装时不随主包下载,用户点击进入对应业务时再向应用市场按需拉取,首包体积直接减去该部分。

用户点击进入对应业务时,向应用市场请求按需安装。

2. 抽离公共代码与共享资源为 HSP(动态共享包)

适用模块:多个模块共同依赖的三方 C++ .so 库、公共图片资源和基础工具类。HAR 是静态共享包,多个 HAP/HSP 引用同一 HAR 时,其代码与资源会被重复拷贝导致包体积增大;HSP 是动态共享包,运行时动态加载,最终 .app 中只保留一份供所有模块共享。

取舍建议:HSP 的安装和加载有性能损耗,过多 HSP 会影响安装效率和启动性能。包体积优先时,可将公共依赖封装到一个 HSP“模块壳”中供各模块依赖;启动性能优先时直接依赖公共 HAR。

二、精准瘦身三刀

第一刀:裁剪 .so 库架构(立减 ~30MB)

HarmonyOS 真机(手机/平板)均为 arm64-v8a 架构,x86_64 仅用于模拟器等场景,发布包中无需保留。两点注意:abiFilters 只控制 CMake 编译产出的 so,对直接放在模块 libs 目录下的三方预编译 so 不生效,需通过 nativeLib.filter 按路径排除;符号表剥离通过 nativeLib 下的 debugSymbol 配置实现。

第二刀:字体与 H5 离线包云端化(立减 ~45MB)

15MB 定制字体:不打进 HAP 包,上传 CDN,首次启动时后台异步下载至沙箱 filesDir(不建议用 cacheDir,缓存目录存在被系统清理的风险),下载完成前用系统默认字体兜底;若字体仅用于特定营销数字或标题,可做子集化裁剪,体积可压至 500KB 以内。注意 @ohos.font 的全局 registerFont 接口从 API 18 起废弃,推荐使用字体引擎的 loadFontSync 同步注册,避免异步注册导致首帧字体不生效。

30MB H5 离线包:离线包本质是动态热更新资源,不应固化在安装包内(既占包体,每次更新还要重新发版)。托管至云端版本服务,App 启动空闲期通过后台线程静默下载并解压到沙箱目录,Web 组件直接加载本地沙箱路径即可。

第三刀:图片资源转换与压缩(立减 ~20MB)

  • 将大图、非透明背景图和复杂图标批量转换为 WebP 格式,同等清晰度下比 PNG 体积小 30%~50%,Image 组件原生支持 WebP
  • 纯色或简单几何图形改用 SVG 矢量图,消除多分辨率切图冗余

展开全部
11楼回复于5天前 来自重庆

把功能独立的代码都做成HAR包!

避免重复引入相同资源!

图片一定要压缩!

10楼回复于5天前 来自北京

双架构 SO 库 60MB — 最容易出效果

两招先上:

  1. module.json5 里开 so 压缩:"compressNativeLibs": true,官方实测单架构压缩率约 34%,双架构下来能省十几MB。
收起
自动换行
深色代码主题
复制
{
  "module": {
    "compressNativeLibs": true
  }
}
  1. build-profile.json5 里开 strip 去掉 debug 符号表:
收起
自动换行
深色代码主题
复制
{
  "nativeLib": {
    "debugSymbol": {
      "strip": true,
      "exclude": []
    }
  }
}

如果三方 SO 有 arm64-v8a 和 armeabi-v7a 两份,确认你的目标用户群——现在主流设备都是 arm64,可以考虑用多目标产物构建的 nativeLib-filter 只打 arm64 版本,直接砍掉一半 SO 体积。

H5 离线包 30MB — 拆成按需加载模块

这是分包的主战场。把 H5 离线包单独拆成一个 Feature 类型的 HAP 或 HSP,在 module.json5 里设 "deliveryWithInstall": false,用户首次安装时不会下载这个模块,用到时再从应用市场拉取:

收起
自动换行
深色代码主题
复制
// feature-h5/module.json5
{
  "module": {
    "name": "feature-h5",
    "type": "feature",
    "deliveryWithInstall": false
  }
}

运行时用 moduleInstallManager 按需拉取:

收起
自动换行
深色代码主题
复制
import { moduleInstallManager } from '@kit.AppGalleryKit';

async function installH5Module(): Promise<void> => {
  const request: moduleInstallManager.ModuleInstallRequest =
    moduleInstallManager.createModuleInstallRequest(['feature-h5']);
  await moduleInstallManager.fetchModules(request);
}

拉完之后,Feature HAP 通过 startAbility 启动,HSP 则通过动态 import 调用。这一项就能减 30MB。

图片资源 40MB — 压缩 + 按需加载

本地预置图片转 WebP 或用纹理压缩格式,通常能再压 30%-50%。非首屏必需的大图也可以丢进按需加载模块里,首次安装不带。

字体 15MB — 子集化或按需加载

字体文件做子集化(只保留用到的字符),或把非核心字体(如特殊字体)也放进按需加载模块。

分包的整体思路

一个 entry 包放核心功能 + 必需资源,其余功能拆成多个 Feature HAP/HSP,核心的设 deliveryWithInstall 为 true,非核心的设 false 做按需加载。多模块间共享代码用 HSP 而不是 HAR,避免重复拷贝。

预估效果:SO 压缩 + strip 省 15-20MB,H5 离线包按需加载省 30MB,图片压缩省 10-15MB,字体子集化省 5-8MB,加起来 60MB 左右,180MB 压到 120MB 以内有戏。

展开全部
9楼回复于5天前 来自四川

180MB 压到 150MB 以内,靠单一手段不够,得按构成逐项拆。

so 库 60MB —— 降幅最大的一块

module.json5 里加 compressNativeLibs: true,so 会以压缩形式打包,官方实测压缩率约 34%(即原始体积的 1/3)。你这 60MB 粗估能压到 20MB 左右。同时在 build-profile.json5 配 strip: true 去 debug 符号表,release 包还能再小一截。

另外确认下是否真需要双架构。目前鸿蒙设备几乎都是 arm64-v8a,如果不需要兼容旧 32 位设备,只保留 arm64 就能直接砍掉一半 so 体积。

收起
自动换行
深色代码主题
复制
// module.json5
{
  "module": {
    "compressNativeLibs": true
  }
}

// build-profile.json5 (模块级)
{
  "buildOption": {
    "nativeLib": {
      "debugSymbol": {
        "strip": true,
        "exclude": []
      }
    }
  }
}

分包 —— 核心方案

把应用拆成 1 个 Entry HAP(基础功能)+ N 个 Feature HAP/HSP(扩展功能),Feature 模块设 deliveryWithInstall: false 做按需加载。用户首次只下载基础包,用到扩展功能时再从应用市场拉取。

你这场景里 H5 离线包 30MB 最适合做按需加载——它通常是特定功能才用到的,拆成独立 Feature HAP 后基础包立减 30MB。

收起
自动换行
深色代码主题
复制
// Feature 模块的 module.json5
{
  "module": {
    "type": "feature",
    "deliveryWithInstall": false  // 不随基础包安装
  }
}

运行时通过 moduleInstallManager 按需拉取:

收起
自动换行
深色代码主题
复制
import { moduleInstallManager } from '@kit.AppGalleryKit';
import type { common } from '@kit.AbilityKit';

async function loadFeatureModule(context: common.UIAbilityContext, moduleName: string): Promise<void> {
  const provider: moduleInstallManager.ModuleInstallProvider = new moduleInstallManager.ModuleInstallProvider();
  const request: moduleInstallManager.ModuleInstallRequest = provider.createModuleInstallRequest(context);
  request.addModule(moduleName);
  const result: moduleInstallManager.ModuleInstallSessionState = await moduleInstallManager.fetchModules(request);
}

图片 40MB —— 纹理压缩 + 远程化

打包阶段的纹理压缩(ASTC/SUT)主要优化运行时加载速度,包体可能反而略增,所以对减包来说不是首选。减包更有效的做法:WebP 替代 PNG/JPG、非首屏图片改为网络加载。DevEco 自带扫描工具可以扫出重复文件和大文件,先跑一遍再定向优化。

字体 15MB —— 裁剪子集

字体文件按需取子集,只保留实际使用的字符(比如只留常用汉字+标点),用 fonttools 等工具裁剪后体积通常能降到 2-3MB。非核心字体也可以放到按需加载模块里。

快速算一笔账:so 压缩 60→20(-40)、H5 离线包按需拆出(-30)、字体子集化 15→3(-12),光这三项就减了 82MB,基础包直接到 100MB 以下。

展开全部
8楼回复于5天前 来自四川
能压到 150 以内,先算总账:so 砍掉多余架构省 30、图片压缩省 20、字体子集化省 13、H5 离线包移出省 30,180 能落到 90~120。分包是后半程的事,前半程减包就能过线。另外先纠偏:150MB 是市场建议值,官方 FAQ 记载单 HAP 硬上限是 4GB,180MB 不会被拒上架,但该压还是压。
第一步:减包(不动架构)
so 60MB——先看分发目标,这里有个分岔
双架构只可能来自两处:build-profile.json5 的 abiFilters 显式配了 x86_64,或三方库自带多架构 so 目录。逐个查:
只发手机/平板:真机全是 arm64-v8a,x86_64 砍掉,60→30
收起
自动换行
深色代码主题
复制
// 模块级 build-profile.json5
{
  "buildOption": {
      "externalNativeOptions": {
            "abiFilters": ["arm64-v8a"]
                },
                    "nativeLib": {
                          "debugSymbol": {
                                  "strip": true // 移除 so 调试信息与符号表
                                        },
                                              "filter": {
                                                      // 三方库塞进来的多架构 so 按需排除
                                                              "excludes": ["**/x86_64/*.so"],
                                                                      "pickFirsts": [],
                                                                              "pickLasts": [],
                                                                                      "enableOverride": true
                                                                                            }
                                                                                                }
                                                                                                  }
                                                                                                  }
                                                                                                  

要发 PC/2in1:PC 是 x86_64 架构,不能砍,so 的 60MB 只能靠 strip + 后面的分包消化

图片 40MB:构建前把分辨率压到 UI 实际显示尺寸再压缩编码,官方包体积优化文档明确建议,通常能省一半。

字体 15MB:子集化,只保留实际用到的字形,十几 MB 压到 1~2MB。注意坑:如果这字体要渲染用户昵称、评论等任意文本,子集化会缺字,这种场景只能换系统字体。

H5 离线包 30MB:不该进包体。移出 rawfile,首次启动从服务端下载到沙箱,H5 容器加载沙箱路径。这是最彻底的一刀,直接 -30。

其余代码约 35MB(180 减去四项),正常量级,不是优化对象。

第二步:分包

分包决策一条线:首启必需进 entry,低频大体积按需加载。

多 HAP:一个 App 只有一个 entry HAP,其余是 feature HAP。官方多 HAP 指导举的例子就是支付类应用:主界面在 entry,“扫一扫”“理财”各拆 feature,由 entry 集成,市场按设备类型组合分发。你若保留 x86_64 发 PC,so 跟着 feature 走也能摊薄 entry 体积

HSP 按需加载:单 HAP 内的按需加载必须用 HSP 不用 HAR——HAR 是静态库,多模块依赖同一份会在包内重复存储,HSP 动态共享只存一份。官方 App Size 最佳实践也是这个思路:低频大体积 SDK 封 HSP,用到再加载

公共依赖:entry 和 HSP 都依赖的 HAR,体积优先就装进一个 HSP 模块壳;性能优先直接依赖 HAR 接受重复。取舍机制:HSP 有安装加载开销,贪多拖累启动

按需加载代码(动态 import,官方标准写法):

收起
自动换行
深色代码主题
复制
import { BusinessError } from '@kit.BasicServicesKit'

function loadH5Module(): void {
  const hspName = 'h5offline'
    import(hspName).then((ns: ESObject) => {
        // 调用 HSP 导出的接口初始化 H5 离线包
          }).catch((error: BusinessError) => {
              console.error(`load hsp failed: ${error.code}`)
                })
                }
                

变量形式的动态 import 必须在使用方 build-profile.json5 的 arkOptions.runtimeOnly.packages 里登记模块名,漏了运行时找不到模块。常量字符串形式编译期就打进主包,起不到延迟作用。

进阶:体积特别大的 feature 想做到“用户点功能时才从市场下载”,用 AppGallery Kit 产品特性按需分发(moduleInstallManager 按模块拉取安装)。接口名与起始版本我记的是 26.0.0,未核实,以官方文档为准,先对 compileSdkVersion 再定方案。

坑点

compressNativeLibs 别盲目改 false。官方对 HarmonyOS 7.0 上架应用有设 false 的建议(安装免解压),但 false 意味着 so 原始大小存储,上传包变大——你现在的问题就是上传包体积,别被带反方向;市场侧有二次压缩,用户下载体积差异远小于包体差异

entry 必须独立可跑:首启链路的页面、资源、so 全留 entry,feature/HSP 缺失时主流程不崩,只降级对应入口

HSP 别贪多,每个都有加载开销;不需要延迟加载的模块用 HAR 反而更省

发 PC/2in1 时 x86_64 的 so 别被 excludes 正则误伤,配置后分别在真机和 PC 上各装一遍验证

展开全部
7楼回复于5天前 来自陕西

你这份清单已经能做第一轮拆分,但建议把“文件归属”和“运行依赖”一起拆,否则新增了feature/HSP,entry里仍残留同一套库,首包未必下降。

先给每个大文件建一张表:所在模块、压缩后大小、哪些页面/功能需要、首次启动是否访问、是否在多个产物中重复。重点检查30MB H5所依赖的脚本/字体/图片是不是又各有一份拷贝;题中的分类可能不是相互独立的,不能直接相加后按比例承诺减包效果。

一个容易遗漏的增量是工程级依赖。官方HAP/HAR/HSP FAQ指出:工程级oh-package中的普通依赖会作用于整个项目,可能把某个HAR带入并不需要它的HSP;推荐把非开发态依赖放回实际使用它的模块。拆包后应重新检查各模块的dependencies/dynamicDependencies,而不是把原来全部依赖继续挂在工程根上。多个模块重复打入同一个大HAR,还会抵消拆分收益。

对于“entry + 按需HSP”,不只有deliveryWithInstall:false这一处配置。官方完整示例还在entry的oh-package.json5中声明dynamicDependencies,并在模块可用后使用动态import访问。应检查入口页、公共导出文件和顶层初始化,避免启动时就执行可选模块的调用。这个路径与拉起feature HAP不同,按所选包型分别实现,不能把两套调用方式混在一起。

建议先选一个边界清楚、不是首启必需的H5业务做试点:
1. 把该业务页面、它独占的资源及依赖一起迁入增强模块;entry只保留入口、下载状态和失败回退。
2. release重新构建后,逐个检查entry及增强模块的实际文件清单,确认原30MB内容确实从entry移走,公共字体/库没有被复制多份。
3. 在未预装增强模块的干净环境启动entry。仅“把全部HAP/HSP都通过IDE装好以后运行正常”,不能证明按需加载流程正确。
4. 分别验证未安装、下载中重复点击、下载失败、安装完成、应用重启后的入口行为;只有模块就绪才进入业务,不让首屏依赖可选资源。

还可以先用官方“接入调试功能”验证流程,不必等正式上架后才发现拆包调用有问题:该调试路径允许应用未上架时接入验证。正式市场分发与本地调试的测试结果都要保留,二者验证的环节不同。

最终同时记录entry大小、首次实际下载量、所有模块总量和使用该功能后的占用。你的目标如果是降低首装等待,按需拆分有效;如果是降低用户最终占用,仍要消除重复和无用文件,不能把“晚下载”算成“已压缩”。以上是拆分与验收建议,未对你的180MB工程实测。

官方依据:
HAP/HAR/HSP常见问题(工程级依赖、HAR重复拷贝):
https://developer.huawei.com/consumer/cn/doc/doccenter-dev-faq/package-structure-faq-0010/
按需分发完整示例(dynamicDependencies、动态import及接入调试):
https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/store-moduleinstall_arkts/

展开全部
6楼回复于5天前 来自湖北

使用扫描工具分析检测应用包,根据不同的参数设定,扫描指定路径的App、HAP、HSP包内容并输出检测结果报告,为开发者优化包结构或排查问题提供数据支撑。

根据扫描结果优化应用:

1. 重复文件

2. 较大文件

  • 确认应用是否必需,是否可以删除。
  • JPG、PNG、GIF等文件,可以考虑压缩图片。

3. 特定类型的文件

操作:减小应用包大小的方法 

5楼回复于5天前 来自北京
共2页
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。