华为鸿蒙开发：掌握应用包名、图标、版本及权限配置

本文旨在深入探讨华为鸿蒙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的更新，配置规则也可能发生变化，请密切关注官方文档的最新动态。