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

SameX

发布于 2024-10-22 10:05

浏览

0收藏

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

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

应用包名的配置规则

应用包名（bundleName）是应用的唯一标识，应遵循以下规则：

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

{
  "app": {
    "bundleName": "com.example.myapp"
  }
}
1.
2.
3.
4.
5.

图标和标签的配置规则

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

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

{
  "app": {
    "label": "$string:app_name",
    "icon": "$media:icon"
  }
}
1.
2.
3.
4.
5.
6.

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

{
  "app_name": "我的应用"
}
1.
2.
3.

应用版本声明的配置规则

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

{
  "app": {
    "version": {
      "name": "1.0.0",
      "code": 100
    }
  }
}
1.
2.
3.
4.
5.
6.
7.
8.

Module 支持的设备类型配置

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

{
  "deviceType": [
    "phone",
    "tablet"
  ]
}
1.
2.
3.
4.
5.
6.

Module 权限配置

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

{
  "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.READ_USER_STORAGE"
      },
      {
        "name": "ohos.permission.WRITE_USER_STORAGE"
      }
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.

以下是完整的 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"
      }
    ]
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.