本文旨在深入探讨华为鸿蒙HarmonyOS Next系统(截止目前API12)的技术细节,基于实际开发实践进行总结。
主要作为技术分享与交流载体,难免错漏,欢迎各位同仁提出宝贵意见和问题,以便共同进步。
本文为原创内容,任何形式的转载必须注明出处及原作者。

在华为鸿蒙HarmonyOS的开发过程中,正确的配置是确保应用能够顺利安装和运行的关键。本篇文章将详细介绍如何配置应用包名、图标和标签、版本声明、设备类型以及权限,并提供相应的JSON配置示例。

应用包名的配置规则

应用包名(bundleName)是应用的唯一标识,应遵循以下规则:

  • 使用反向域名命名法,例如 com.example.myapp
  • 包名只能包含小写字母、数字和点号(.),且不能以点号开头或结尾。
  • 包名长度不超过255个字符。
    配置示例

    {
    "app": {
      "bundleName": "com.example.myapp"
    }
    }

    图标和标签的配置规则

    图标和标签是用户识别应用的重要视觉元素。配置时需注意:

  • 图标格式通常为 .png.jpg
  • 图标尺寸应提供多种,以适应不同场景。
  • 标签文本应简短明了。
    配置示例

    {
    "app": {
      "label": "$string:app_name",
      "icon": "$media:icon"
    }
    }

    resources/base/media 目录下放置图标文件,并在 resources/base/strings/strings.json 中定义标签字符串:

    {
    "app_name": "我的应用"
    }

    应用版本声明的配置规则

    版本声明用于应用的版本控制和更新,格式通常为 主版本号.次版本号.修订号
    配置示例

    {
    "app": {
      "version": {
        "name": "1.0.0",
        "code": 100
      }
    }
    }

    Module 支持的设备类型配置

    Module配置中可以指定应用支持的设备类型,如手机、平板等。
    配置示例

    {
    "deviceType": [
      "phone",
      "tablet"
    ]
    }

    Module 权限配置

    应用在访问系统资源或用户数据时,需要在Module配置中声明所需权限。
    配置示例

    {
    "module": {
      "reqPermissions": [
        {
          "name": "ohos.permission.READ_USER_STORAGE"
        },
        {
          "name": "ohos.permission.WRITE_USER_STORAGE"
        }
      ]
    }
    }

    以下是完整的 config.json 配置文件示例,包括了上述所有配置:

    {
    "app": {
      "bundleName": "com.example.myapp",
      "vendor": "ExampleVendor",
      "version": {
        "name": "1.0.0",
        "code": 100
      },
      "label": "$string:app_name",
      "icon": "$media:icon"
    },
    "deviceType": [
      "phone",
      "tablet"
    ],
    "module": {
      "package": "com.example.myapp.entry",
      "name": ".MyApplication",
      "reqPermissions": [
        {
          "name": "ohos.permission.READ_USER_STORAGE"
        },
        {
          "name": "ohos.permission.WRITE_USER_STORAGE"
        }
      ]
    }
    }

    请确保您的 config.json 文件位于项目的 entry/src/main 目录下,并且您的应用配置与实际需求相符。随着HarmonyOS的更新,配置规则也可能发生变化,请密切关注官方文档的最新动态。


SameX
1 声望2 粉丝