开发者在开发应用时,需要配置应用的一些标签,例如应用的Bundle名称、图标等标识特征的属性。这一章节描述了开发者在开发应用时需要配置的一些关键标签。
应用包名配置
应用包名需在config.json文件中app标签下配置bundleName字段,该字段用于指定应用的包名,需保证唯一性。包名是由字母、数字、下划线(_)和点号(.)组成的字符串,必须以字母开头。支持的字符串长度为7~127字节。包名通常采用反向域名形式表示(例如,“com.example.myapplication”)。建议第一级为域名后缀"com",第二级为厂商/个人名,也可以采用多级。应用名称配置可以参考 app标签说明 。
图标和标签配置
图标和标签通常一起配置,可以分为应用图标、应用标签和入口图标、入口标签。
应用图标和标签通常用于标识整个应用,可以在标识应用的界面使用该类型图标和标签。比如:
- 设置应用中,需要展示应用列表时
- 在隐私管理中,需要展示应用申请的权限时
- 在状态栏显示通知消息时
入口图标和标签是应用安装完成后可以在设备桌面上显示出来的。入口图标是以Page类型的Ability为粒度,支持同一个应用存在多个入口图标和入口标签,点击后进入对应的Ability界面。比如:
- 桌面上需要显示图标时
- 最近任务列表中显示时
应用图标和标签配置
FA模型不支持直接配置应用图标和标签,会以符合规则的PageAbility的图标和标签作为应用图标和标签。存在多个时,则取位置靠前的Ability的icon和label作为应用的icon和label。
入口图标和标签配置
入口图标和标签配置方法
FA模型的入口图标和标签是Page类型的Ability配置的icon和label。
PageAbility的图标和标签配置请参见 PageAbility组件配置 。需在config.json文件的abilities标签下做如下配置:
- 配置icon字段,标签值为资源文件的索引。图标需要在配置IDE的资源文件中,路径为/resource/base/media。取值示例:$media:ability_icon。
- 配置label字段,标签值为资源文件的索引,标识A