鸿蒙开发Bundle配置信息总结

一、配置文件结构

  1. 核心组成部分

    • app:应用全局配置,包含bundleName(应用唯一标识)、version(版本信息)和apiVersion(API依赖版本)
    • deviceConfig:设备特定配置,包含default(通用设备)、phone、tablet等设备类型配置
    • module:HAP包配置,包含package(包结构名称)、abilities(能力配置)和reqPermissions(权限声明)
  2. 关键配置示例

    css 复制代码
    {
      "app": {
        "bundleName": "com.example.myapplication",
        "version": {
          "code": 1,
          "name": "1.0"
        },
        "apiVersion": {
          "compatible": 4,
          "target": 5
        }
      },
      "deviceConfig": {},
      "module": {
        "package": "com.example.myapplication.entrymodule",
        "abilities": [
          {
            "skills": [{"entities": ["entity.system.home"], "actions": ["action.system.home"]}],
            "name": "com.example.myapplication.MainAbility",
            "type": "page"
          }
        ]
      }
    }

二、常见问题解决方案

  1. bundleName配置错误

    • 问题:包名格式不符合规范导致安装失败
    • 解决方案 :采用反向域名格式(如com.company.app),至少包含三段,避免使用保留词(harmony/ohos等)
  2. 权限声明缺失

    • 问题:应用无法访问网络或存储
    • 解决方案 :在module中添加权限声明
    json 复制代码
    "reqPermissions": [
      {"name": "ohos.permission.INTERNET"},
      {"name": "ohos.permission.READ_USER_STORAGE"}
    ]
  3. 多HAP包冲突

    • 问题:entry和feature模块配置冲突
    • 解决方案 :在build-profile.json5中配置多目标产物
    json 复制代码
    "targets": [
      {"name": "phone", "config": {"deviceType": ["phone"]}},
      {"name": "tablet", "config": {"deviceType": ["tablet"]}}
    ]

三、开发案例参考

  1. 多设备适配案例

    • 通过deviceType配置支持多设备类型
    json 复制代码
    "deviceType": ["phone", "tablet", "car"]
  2. 动态Bundle加载

    • 配置按需加载的动态模块
    json 复制代码
    "dynamic": [
      {
        "name": "payment",
        "condition": "device.storage > 128GB",
        "prefetch": true
      }
    ]
  3. 签名配置最佳实践

    • 使用V3签名机制
    json 复制代码
    "signingConfig": {
      "version": "3.0",
      "certificatePath": "./keys/release.p12",
      "provisionProfile": "./profiles/distribution.mobileprovision"
    }

四、关键注意事项

  1. 配置文件位置 :Stage模型使用app.json5和module.json5,FA模型使用config.json
  2. 版本兼容性:API版本需与DevEco Studio和SDK版本匹配
  3. 多目标构建 :通过product和target配置实现差异化打包

五、官方资源

相关推荐
huang_xiaoen12 小时前
鸿蒙手机远程控制电脑哪个好用?2026鸿蒙远控软件横测推荐
华为·harmonyos·远程工作·远程工具·远程办公
爱写Bug的浮游2 天前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
程序猿追2 天前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos2 天前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji3 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207413 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白3 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方3 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追3 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追4 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos