鸿蒙应用开发实战（二）：配置文件

关注

原创 2026-08-04 09:45:21 261 阅读 AI 写同款· GEO 优化 ›

鸿蒙实战：ArkTs 开发一个鸿蒙应用 标签，在有 UIAbility 的场景下标签不能省略，用来声明路由跳转路径，如果想通过路由的方式，实现页面之间的跳转，需要在。点击左图上的按钮，会获取数据, 当数据变化时，会自动刷新 UI，结果如右图所示。为本地窗口管理器，用于管理窗口相关的内容，例如与界面相关的获焦/失焦、可见/不可见。方法写非 UI 逻辑，那么数据变化了，怎么更新 UI 呢，这就需要用到注解。的生命周期，每个生命周期分别做什么事，我会在下篇文章中分析，而右图表示。不可以被其他应用调用，也不作为程序的启动入口，那么。阅读详情

配置文件，包括应用级配置信息和Module级配置信息。

应用级配置信息：

- AppScope > app.json5，用于声明应用的全局配置信息，比如应用Bundle名称、应用名称、应用图标、应用版本号等。

bundleName:标识应用的Bundle名称，用于标识应用的唯一性。
vendor:标识对应用开发厂商的描述，取值为长度不超过255字节的字符串。该标签可用于展示开发厂商信息，如在应用的关于页面，取该标签展示开发厂商信息。
versionCode:标识应用的版本号，取值范围为0~2147483647。此数字仅用于确定某个版本是否比另一个版本新，数值越大表示版本越新。
versionName:标识向用户展示的应用版本号。
buildVersion:标识应用的构建版本号。
icon:标识应用的图标，取值为图标资源文件的索引。
label:标识应用的名称，取值为字符串资源的索引。
......

Module级配置信息：

name:标识当前Module的名称，确保该名称在整个应用中唯一。
type:标识当前Module的类型。支持的取值如下：- entry: 应用的主模块；- feature: 应用的动态特性模块；- har: 静态共享包模块；- shared: 动态共享包模块；- skill: 技能包模块，用于定义AI代理的技能能力。该类型模块必须配置skillProfiles标签。仅当应用的bundleType配置为skill，即app.json5配置文件中的bundleType为skill时，才允许将Module的type配置为skill，且此时应用只能包含1个Module。从API版本26.0.0开始，支持该标签。该标签仅对预置应用生效。
description:标识当前Module的描述信息，可以采用字符串资源索引格式。
mainElement:标识当前Module的入口UIAbility名称
deviceTypes:标识当前Module可以运行在哪类设备上。
deliveryWithInstall:标识当前Module是否在用户主动安装的时候安装，即该Module对应的HAP/HSP是否跟随应用一起安装。
installationFree:标识当前Module是否支持免安装特性。
pages:标识当前Module的profile资源，用于列举每个页面信息，取值为长度不超过255字节的字符串。
abilities:标识当前Module中UIAbility的配置信息，只对当前UIAbility生效。
---name:标识当前UIAbility组件的名称，确保该名称在整个应用中唯一。
---srcEntry:标识当前UIAbility的代码路径。
---description:标识当前UIAbility组件的描述信息，开发者可以通过该标签描述当前组件的功能与作用
---icon:标识当前UIAbility组件的图标，取值为图标资源文件的索引。
---label:标识当前UIAbility组件的对用户显示的名称，取值为字符串资源的索引，以支持多语言，长度不超过255字节的字符串。
---startWindowIcon:标识当前UIAbility组件启动页面图标资源文件的索引。
---startWindowBackground:标识当前UIAbility组件启动页面背景颜色资源文件的索引。
---exported:标识当前UIAbility组件是否可以被其他应用拉起。true:表示可以被其他应用拉起（入口UIAbility建议配置为true）；false:
只能由同应用或者具有ohos.permission.START_INVISIBLE_ABILITY权限（该权限仅系统应用支持申请）的应用拉起。例如，配置为false时，桌面具备该权限，桌面图标、快捷方式或push通知消息可以拉起当前UIAbility组件，但aa命令行工具没有权限无法拉起。
---skills:标识当前UIAbility组件能够接收的Want特征集，为数组格式。配置规则：- 对于Entry类型的HAP，应用可以配置多个具有入口能力的skills标签（即配置了ohos.want.action.home和entity.system.home）。- 对于Feature类型的HAP，只有应用可以配置具有入口能力的skills标签，服务不允许配置。
extensionAbilities:标识当前Module中ExtensionAbility的配置信息，只对当前ExtensionAbility生效。
---name:标识当前ExtensionAbility组件的名称，确保该名称在整个应用中唯一。
---srcEntry:标识当前ExtensionAbility组件所对应的代码路径。
---type:标识当前ExtensionAbility组件的类型。
---exported:标识当前ExtensionAbility组件是否可以被其他应用调用。
---metadata:标识当前ExtensionAbility组件的元信息。
......