docs:修正鸿蒙产物构成描述(1 HAP + 5 HSP)
原描述「共 6 个 HAP」不准确。module.json5 中 type: "entry" 编成 HAP,
type: "shared" 编成 HSP(共享包, 动态下发), 本工程实际是 1 个 HAP + 5 个 HSP。
同步修正:
- 两步流程描述改为「逐个 module 编译出包, 再打成 APP」, 产物路径扩展名
改为 {hap|hsp}
- 包列表新增扩展名列, 标明哪些是 .hap、哪些是 .hsp
- 单模块调试说明改为「只产出分包、不打 APP」
另补充实测体积: 主包 entry-default.hap 约 2.37 MiB(超官方单包 2MB 限制),
总包约 6.39 MiB(在 10MB 以内)。
This commit is contained in:
28
readme.md
28
readme.md
@@ -118,27 +118,29 @@ H5:打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
|
||||
hvigorw --mode project -p product=default assembleApp
|
||||
```
|
||||
|
||||
这个任务是**两步串联**的 —— **先编译 HAP,再把 HAP 打包成 APP**:
|
||||
这个任务是**两步串联**的 —— **先逐个 module 编译出包,再把这些包打成 APP**:
|
||||
|
||||
| 产物 | 路径 | 说明 |
|
||||
|------|------|------|
|
||||
| HAP(中间产物) | `{module}/build/default/outputs/default/{module}-default-signed.hap` | 每个 module 一个,编译+签名的最小单位 |
|
||||
| APP(最终产物) | `build/outputs/default/mp-harmony-default-signed.app` | 打包全部 HAP 的分发单元 |
|
||||
| 分包(中间产物) | `{module}/build/default/outputs/default/{module}-default-signed.{hap\|hsp}` | 每个 module 一个,编译+签名的最小单位 |
|
||||
| APP(最终产物) | `build/outputs/default/mp-harmony-default-signed.app` | 把全部分包收拢成的分发单元 |
|
||||
|
||||
📌 **元服务上架 AppGallery Connect 上传的是 `.app`**,不是 `.hap`。`pack.info` 中 `"bundleType": "atomicService"` 即元服务包标记。
|
||||
|
||||
📌 本工程共 6 个 HAP,详见 `build/outputs/default/pack.info`:
|
||||
📌 **本工程共 1 个 HAP + 5 个 HSP**(不是 6 个 HAP)—— `module.json5` 里 `type: "entry"` 编成 **HAP**,`type: "shared"` 编成 **HSP**(共享包,动态下发)。详见 `build/outputs/default/pack.info`:
|
||||
|
||||
| 包名 | moduleType | 说明 |
|
||||
|------|------------|------|
|
||||
| `entry-default` | `entry` | 主 HAP,EntryAbility + 服务卡片 |
|
||||
| `components_diy-default` | `shared` | ascf 动态化分包 |
|
||||
| `pages_goods-default` | `shared` | ascf 动态化分包 |
|
||||
| `pages_order-default` | `shared` | ascf 动态化分包 |
|
||||
| `pages_promotion-default` | `shared` | ascf 动态化分包 |
|
||||
| `pages_tool-default` | `shared` | ascf 动态化分包 |
|
||||
| 包名 | 扩展名 | moduleType | 说明 |
|
||||
|------|--------|------------|------|
|
||||
| `entry-default` | `.hap` | `entry` | 主包,EntryAbility + 服务卡片 + uniapp 主 bundle |
|
||||
| `components_diy-default` | `.hsp` | `shared` | ascf 动态化分包 |
|
||||
| `pages_goods-default` | `.hsp` | `shared` | ascf 动态化分包 |
|
||||
| `pages_order-default` | `.hsp` | `shared` | ascf 动态化分包 |
|
||||
| `pages_promotion-default` | `.hsp` | `shared` | ascf 动态化分包 |
|
||||
| `pages_tool-default` | `.hsp` | `shared` | ascf 动态化分包 |
|
||||
|
||||
> 若只想单模块调试,可在 DevEco 中用「Build Hap(s)/Module(s)」(即 `assembleHap`),只产出 `.hap`。
|
||||
⚠️ **主包体积**:元服务官方要求**单个包 ≤ 2MB**(按压缩后算,含其直接依赖的 HSP),同一设备类型下全部分包总和 ≤ 10MB。实测本工程主包 `entry-default.hap` 约 **2.37 MiB**,已超单包 2MB 限制;总包约 **6.39 MiB**,在 10MB 以内。
|
||||
|
||||
> 若只想单模块调试,可在 DevEco 中用「Build Hap(s)/Module(s)」(即 `assembleHap`),只产出分包、不打 APP。
|
||||
|
||||
#### 4.3.3 【常见错误】
|
||||
|
||||
|
||||
Reference in New Issue
Block a user