Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
cd177cc0
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
You need to sign in or sign up before continuing.
未验证
提交
cd177cc0
编写于
2月 21, 2023
作者:
O
openharmony_ci
提交者:
Gitee
2月 21, 2023
浏览文件
操作
浏览文件
下载
差异文件
!14933 adapt schema for monthly
Merge pull request !14933 from longwei/monthly_20221018
上级
e6d1bd3a
4514d3eb
变更
3
显示空白变更内容
内联
并排
Showing
3 changed file
with
236 addition
and
51 deletion
+236
-51
zh-cn/application-dev/quick-start/app-configuration-file.md
zh-cn/application-dev/quick-start/app-configuration-file.md
+4
-8
zh-cn/application-dev/quick-start/module-configuration-file.md
.../application-dev/quick-start/module-configuration-file.md
+27
-42
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md
...angelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md
+205
-1
未找到文件。
zh-cn/application-dev/quick-start/app-configuration-file.md
浏览文件 @
cd177cc0
...
@@ -13,12 +13,10 @@
...
@@ -13,12 +13,10 @@
"icon"
:
"$media:app_icon"
,
"icon"
:
"$media:app_icon"
,
"label"
:
"$string:app_name"
,
"label"
:
"$string:app_name"
,
"description"
:
"$string:description_application"
,
"description"
:
"$string:description_application"
,
"distributedNotificationEnabled"
:
true
,
"minAPIVersion"
:
9
,
"minAPIVersion"
:
9
,
"targetAPIVersion"
:
9
,
"targetAPIVersion"
:
9
,
"apiReleaseType"
:
"Release"
,
"apiReleaseType"
:
"Release"
,
"debug"
:
false
,
"debug"
:
false
,
"entityType"
:
"media"
,
"car"
:
{
"car"
:
{
"minAPIVersion"
:
8
,
"minAPIVersion"
:
8
,
}
}
...
@@ -34,7 +32,7 @@ app.json5配置文件包含以下标签。
...
@@ -34,7 +32,7 @@ app.json5配置文件包含以下标签。
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| bundleName | 标识应用的
包名
,用于标识应用的唯一性。该标签不可缺省。标签的值命名规则
:
<br/>
-
字符串以字母、数字、下划线和符号“.”组成。
<br/>
-
以字母开头。
<br/>
-
最小长度7个字节,最大长度127个字节。
<br/>
推荐采用反域名形式命名(如com.example.demo,建议第一级为域名后缀com,第二级为厂商/个人名,第三级为应用名,也可以多级)。
<br/>
其中,随系统源码编译的应用建议命名为“com.ohos.demo”形式,
ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 |
| bundleName | 标识应用的
Bundle名称
,用于标识应用的唯一性。该标签不可缺省。标签的值命名规则
:
<br/>
-
字符串以字母、数字、下划线和符号“.”组成。
<br/>
-
以字母开头。
<br/>
-
最小长度7个字节,最大长度127个字节。
<br/>
推荐采用反域名形式命名(如com.example.demo,建议第一级为域名后缀com,第二级为厂商/个人名,第三级为应用名,也可以多级)。
<br/>
其中,随系统源码编译的应用建议命名为“com.ohos.demo”形式,
ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 |
| debug | 标识应用是否可调试,该标签由IDE编译构建时生成。
<br/>
-
true:可调试。
<br/>
-
false:不可调式。 | 布尔值 | 该标签可以缺省,缺省为false。 |
| debug | 标识应用是否可调试,该标签由IDE编译构建时生成。
<br/>
-
true:可调试。
<br/>
-
false:不可调式。 | 布尔值 | 该标签可以缺省,缺省为false。 |
| icon | 标识
[
应用的图标
](
../application-models/application-component-configuration-stage.md
)
,标签值为图标资源文件的索引。 | 字符串 | 该标签不可缺省。 |
| icon | 标识
[
应用的图标
](
../application-models/application-component-configuration-stage.md
)
,标签值为图标资源文件的索引。 | 字符串 | 该标签不可缺省。 |
| label | 标识
[
应用的名称
](
../application-models/application-component-configuration-stage.md
)
,标签值为字符串资源的索引。 | 字符串 | 该标签不可缺省。 |
| label | 标识
[
应用的名称
](
../application-models/application-component-configuration-stage.md
)
,标签值为字符串资源的索引。 | 字符串 | 该标签不可缺省。 |
...
@@ -43,12 +41,10 @@ app.json5配置文件包含以下标签。
...
@@ -43,12 +41,10 @@ app.json5配置文件包含以下标签。
| versionCode | 标识应用的版本号,该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。开发者可以将该值设置为任何正整数,但是必须确保应用的新版本都使用比旧版本更大的值。该标签不可缺省,versionCode值应小于2^31次方。 | 数值 | 该标签不可缺省。 |
| versionCode | 标识应用的版本号,该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。开发者可以将该值设置为任何正整数,但是必须确保应用的新版本都使用比旧版本更大的值。该标签不可缺省,versionCode值应小于2^31次方。 | 数值 | 该标签不可缺省。 |
| versionName | 标识应用版本号的文字描述,用于向用户展示。
<br/>
该标签仅由数字和点构成,推荐采用“A.B.C.D”四段式的形式。四段式推荐的含义如下所示。
<br/>
第一段:主版本号/Major,范围0-99,重大修改的版本,如实现新的大功能或重大变化。
<br/>
第二段:次版本号/Minor,范围0-99,表示实现较突出的特点,如新功能添加或大问题修复。
<br/>
第三段:特性版本号/Feature,范围0-99,标识规划的新版本特性。
<br/>
第四段:修订版本号/Patch,范围0-999,表示维护版本,修复bug。
<br/>
标签最大字节长度为127。 | 字符串 | 该标签不可缺省。 |
| versionName | 标识应用版本号的文字描述,用于向用户展示。
<br/>
该标签仅由数字和点构成,推荐采用“A.B.C.D”四段式的形式。四段式推荐的含义如下所示。
<br/>
第一段:主版本号/Major,范围0-99,重大修改的版本,如实现新的大功能或重大变化。
<br/>
第二段:次版本号/Minor,范围0-99,表示实现较突出的特点,如新功能添加或大问题修复。
<br/>
第三段:特性版本号/Feature,范围0-99,标识规划的新版本特性。
<br/>
第四段:修订版本号/Patch,范围0-999,表示维护版本,修复bug。
<br/>
标签最大字节长度为127。 | 字符串 | 该标签不可缺省。 |
| minCompatibleVersionCode | 标识应用能够兼容的最低历史版本号,用于跨设备兼容性判断。 | 数值 | 该标签可缺省,缺省值等于versionCode标签值。 |
| minCompatibleVersionCode | 标识应用能够兼容的最低历史版本号,用于跨设备兼容性判断。 | 数值 | 该标签可缺省,缺省值等于versionCode标签值。 |
| minAPIVersion | 标识应用运行需要的SDK的API最小版本。 | 数值 | build-profile.json5中的compatibleSdkVersion生成。 |
| minAPIVersion | 标识应用运行需要的SDK的API最小版本。 | 数值 |
由
build-profile.json5中的compatibleSdkVersion生成。 |
| targetAPIVersion | 标识应用运行需要的API目标版本。 | 数值 | build-profile.json5中的compileSdkVersion生成。 |
| targetAPIVersion | 标识应用运行需要的API目标版本。 | 数值 |
由
build-profile.json5中的compileSdkVersion生成。 |
| apiReleaseType | 标识应用运行需要的API目标版本的类型,采用字符串类型表示。取值为“CanaryN”、“BetaN”或者“Release”,其中,N代表大于零的整数。
<br/>
-
Canary:受限发布的版本。
<br/>
-
Beta:公开发布的Beta版本。
<br/>
-
Release:公开发布的正式版本。
<br/>
该字段由DevEco
Studio读取当前使用的SDK的Stage来生成。 | 字符串 | 该标签可缺省,由IDE生成并覆盖。 |
| apiReleaseType | 标识应用运行需要的API目标版本的类型,采用字符串类型表示。取值为“CanaryN”、“BetaN”或者“Release”,其中,N代表大于零的整数。
<br/>
-
Canary:受限发布的版本。
<br/>
-
Beta:公开发布的Beta版本。
<br/>
-
Release:公开发布的正式版本。
<br/>
该字段由DevEco
Studio读取当前使用的SDK的Stage来生成。 | 字符串 | 该标签可缺省,由IDE生成并覆盖。 |
| distributedNotificationEnabled | 标识应用是否开启分布式通知,当开启分布式通知时,同一分布式组网下的两个设备(A和B),当设备A收到一条消息时,设备B会收到一条分布式消息用于设备B的使用者去查看设备A的消息。
<br/>
-
true:开启。
<br/>
-
false:不开启。 | 布尔值 | 该标签可缺省,缺省值为false。 |
| multiProjects | 标识当前工程是否支持多个工程的联合开发。
<br/>
-
true:当前工程支持多个工程的联合开发。
<br/>
-
false:当前工程不支持多个工程的联合开发。多工程开发可以参考文档:
[
多工程构建
](
https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-building-overview-0000001263360495-V3#section71471033104216
)
| 布尔值 | 可缺省,缺省值为false。 |
| entityType | 标识应用的类别,分别有:
<br/>
-
game:游戏类。
<br/>
-
media:影音类。
<br/>
-
communication:社交通信类。
<br/>
-
news:新闻类。
<br/>
-
travel:出行类。
<br/>
-
utility:工具类。
<br/>
-
shopping:购物类。
<br/>
-
education:教育类。
<br/>
-
kids:少儿类。
<br/>
-
business:商务类。
<br/>
-
photography:拍摄类。
<br/>
-
unspecified:不属于上述的任何一类。 | 字符串 | 该标签可以缺省,缺省为unspecified。 |
| multiProjects | 标识当前工程是否支持多个工程的联合开发。
<br/>
-
true:当前工程支持多个工程的联合开发。
<br/>
-
false:当前工程不支持多个工程的联合开发。 | 布尔值 | 可缺省,缺省值为false。 |
| tablet | 标识对tablet设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对tablet设备做了特殊配置,则应用在tablet设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时tablet设备使用app.json5公共区域配置的属性值。 |
| tablet | 标识对tablet设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对tablet设备做了特殊配置,则应用在tablet设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时tablet设备使用app.json5公共区域配置的属性值。 |
| tv | 标识对tv设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对tv设备做了特殊配置,则应用在tv设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时tv设备使用app.json5公共区域配置的属性值。 |
| tv | 标识对tv设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对tv设备做了特殊配置,则应用在tv设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时tv设备使用app.json5公共区域配置的属性值。 |
| wearable | 标识对wearable设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对wearable设备做了特殊配置,则应用在wearable设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时wearable设备使用app.json5公共区域配置的属性值。 |
| wearable | 标识对wearable设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对wearable设备做了特殊配置,则应用在wearable设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时wearable设备使用app.json5公共区域配置的属性值。 |
...
...
zh-cn/application-dev/quick-start/module-configuration-file.md
浏览文件 @
cd177cc0
...
@@ -22,19 +22,19 @@
...
@@ -22,19 +22,19 @@
{
{
"name"
:
"string"
,
"name"
:
"string"
,
"value"
:
"string"
,
"value"
:
"string"
,
"resource"
:
"$profile:distr
of
ilter_config"
"resource"
:
"$profile:distr
ibutionF
ilter_config"
}
}
],
],
"abilities"
:
[
"abilities"
:
[
{
{
"name"
:
"EntryAbility"
,
"name"
:
"EntryAbility"
,
"srcEntr
ance
"
:
"./ets/entryability/EntryAbility.ts"
,
"srcEntr
y
"
:
"./ets/entryability/EntryAbility.ts"
,
"description"
:
"$string:EntryAbility_desc"
,
"description"
:
"$string:EntryAbility_desc"
,
"icon"
:
"$media:icon"
,
"icon"
:
"$media:icon"
,
"label"
:
"$string:EntryAbility_label"
,
"label"
:
"$string:EntryAbility_label"
,
"startWindowIcon"
:
"$media:icon"
,
"startWindowIcon"
:
"$media:icon"
,
"startWindowBackground"
:
"$color:start_window_background"
,
"startWindowBackground"
:
"$color:start_window_background"
,
"
visible
"
:
true
,
"
exported
"
:
true
,
"skills"
:
[
"skills"
:
[
{
{
"entities"
:
[
"entities"
:
[
...
@@ -71,9 +71,9 @@ module.json5配置文件包含以下标签。
...
@@ -71,9 +71,9 @@ module.json5配置文件包含以下标签。
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| name | 标识当前Module的名称,标签值采用字符串表示(最大长度31个字节),该名称在整个应用要唯一。 | 字符串 | 该标签不可缺省。 |
| name | 标识当前Module的名称,标签值采用字符串表示(最大长度31个字节),该名称在整个应用要唯一
,不支持中文
。 | 字符串 | 该标签不可缺省。 |
| type | 标识当前Module的类型。类型有两种,分别:
<br/>
-
entry:应用的主模块。
<br/>
-
feature:应用的动态特性模块。 | 字符串 | 该标签不可缺省。 |
| type | 标识当前Module的类型。类型有两种,分别:
<br/>
-
entry:应用的主模块。
<br/>
-
feature:应用的动态特性模块。 | 字符串 | 该标签不可缺省。 |
| srcEntr
ance
| 标识当前Module所对应的代码路径,标签值为字符串(最长为127字节)。 | 字符串 | 该标签可缺省,缺省值为空。 |
| srcEntr
y
| 标识当前Module所对应的代码路径,标签值为字符串(最长为127字节)。 | 字符串 | 该标签可缺省,缺省值为空。 |
| description | 标识当前Module的描述信息,标签值是字符串类型(最长255字节)或对描述内容的字符串资源索引。 | 字符串 | 该标签可缺省,缺省值为空。 |
| description | 标识当前Module的描述信息,标签值是字符串类型(最长255字节)或对描述内容的字符串资源索引。 | 字符串 | 该标签可缺省,缺省值为空。 |
| process | 标识当前Module的进程名,标签值为字符串类型(最长为31个字节)。如果在HAP标签下配置了process,该应用的所有UIAbility、DataShareExtensionAbility、ServiceExtensionAbility都运行在该进程中。
<br/>
**说明:**
<br/>
- 仅支持系统应用配置,三方应用配置不生效。 | 字符串 | 可缺省,缺省为app.json5文件下app标签下的bundleName。 |
| process | 标识当前Module的进程名,标签值为字符串类型(最长为31个字节)。如果在HAP标签下配置了process,该应用的所有UIAbility、DataShareExtensionAbility、ServiceExtensionAbility都运行在该进程中。
<br/>
**说明:**
<br/>
- 仅支持系统应用配置,三方应用配置不生效。 | 字符串 | 可缺省,缺省为app.json5文件下app标签下的bundleName。 |
| mainElement | 标识当前Module的入口UIAbility名称或者ExtensionAbility名称。标签最大字节长度为255。 | 字符串 | 该标签可缺省,缺省值为空。 |
| mainElement | 标识当前Module的入口UIAbility名称或者ExtensionAbility名称。标签最大字节长度为255。 | 字符串 | 该标签可缺省,缺省值为空。 |
...
@@ -81,7 +81,6 @@ module.json5配置文件包含以下标签。
...
@@ -81,7 +81,6 @@ module.json5配置文件包含以下标签。
| deliveryWithInstall | 标识当前Module是否在用户主动安装的时候安装,表示该Module对应的HAP是否跟随应用一起安装。
<br/>
-
true:主动安装时安装。
<br/>
-
false:主动安装时不安装。 | 布尔值 | 该标签不可缺省。 |
| deliveryWithInstall | 标识当前Module是否在用户主动安装的时候安装,表示该Module对应的HAP是否跟随应用一起安装。
<br/>
-
true:主动安装时安装。
<br/>
-
false:主动安装时不安装。 | 布尔值 | 该标签不可缺省。 |
| installationFree | 标识当前Module是否支持免安装特性。
<br/>
-
true:表示支持免安装特性,且符合免安装约束。
<br/>
-
false:表示不支持免安装特性。
<br/>
**说明:**
<br/>
- 当应用的entry类型Module的该字段配置为true时,该应用的feature类型的该字段也需要配置为true。
<br/>
- 当应用的entry类型Module的该字段配置为false时,该应用的feature类型的该字段根据业务需求配置true或false。 | 布尔值 | 该标签不可缺省。 |
| installationFree | 标识当前Module是否支持免安装特性。
<br/>
-
true:表示支持免安装特性,且符合免安装约束。
<br/>
-
false:表示不支持免安装特性。
<br/>
**说明:**
<br/>
- 当应用的entry类型Module的该字段配置为true时,该应用的feature类型的该字段也需要配置为true。
<br/>
- 当应用的entry类型Module的该字段配置为false时,该应用的feature类型的该字段根据业务需求配置true或false。 | 布尔值 | 该标签不可缺省。 |
| virtualMachine | 标识当前Module运行的目标虚拟机类型,供云端分发使用,如应用市场和分发中心。
<br/>
该标签值为字符串。如果目标虚拟机类型为ArkTS引擎,则其值为“ark+版本号”。 | 字符串 | 该标签由IDE构建HAP的时候自动插入。 |
| virtualMachine | 标识当前Module运行的目标虚拟机类型,供云端分发使用,如应用市场和分发中心。
<br/>
该标签值为字符串。如果目标虚拟机类型为ArkTS引擎,则其值为“ark+版本号”。 | 字符串 | 该标签由IDE构建HAP的时候自动插入。 |
| uiSyntax(deprecated) | 标识当前Module
syntax定义该组件的语法类型。
<br/>
-
hml:标识该组件使用hml/css/js进行开发。
<br/>
-
ets:标识该组件使用ArkTS声明式语法进行开发。 | 字符串 | 该标签可缺省,默认值为hml,该标签从API9开始废弃。 |
|
[
pages
](
#pages标签
)
| 标识当前Module的profile资源,用于列举每个页面信息。该标签最大长度为255个字节。 | 字符串 | 在有UIAbility的场景下,该标签不可缺省。 |
|
[
pages
](
#pages标签
)
| 标识当前Module的profile资源,用于列举每个页面信息。该标签最大长度为255个字节。 | 字符串 | 在有UIAbility的场景下,该标签不可缺省。 |
|
[
metadata
](
#metadata标签
)
| 标识当前Module的自定义元信息,标签值为数组类型,只对当前Module、UIAbility、ExtensionAbility生效。 | 对象数组 | 该标签可缺省,缺省值为空。 |
|
[
metadata
](
#metadata标签
)
| 标识当前Module的自定义元信息,标签值为数组类型,只对当前Module、UIAbility、ExtensionAbility生效。 | 对象数组 | 该标签可缺省,缺省值为空。 |
|
[
abilities
](
#abilities标签
)
| 标识当前Module中UIAbility的配置信息,标签值为数组类型,只对当前UIAbility生效。 | 对象 | 该标签可缺省,缺省值为空。 |
|
[
abilities
](
#abilities标签
)
| 标识当前Module中UIAbility的配置信息,标签值为数组类型,只对当前UIAbility生效。 | 对象 | 该标签可缺省,缺省值为空。 |
...
@@ -207,15 +206,15 @@ ablities标签描述UIAbility组件的配置信息,标签值为数组类型,
...
@@ -207,15 +206,15 @@ ablities标签描述UIAbility组件的配置信息,标签值为数组类型,
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| name | 标识当前UIAbility组件的名称,该名称在整个应用要唯一,标签值采用字符串表示(最大长度127个字节)。 | 字符串 | 该标签不可缺省。 |
| name | 标识当前UIAbility组件的名称,该名称在整个应用要唯一,标签值采用字符串表示(最大长度127个字节)
,不支持中文
。 | 字符串 | 该标签不可缺省。 |
| srcEntr
ance
| 该标签标识入口UIAbility的代码路径,标签值为字符串(最长为127字节)。 | 字符串 | 该标签不可缺省。 |
| srcEntr
y
| 该标签标识入口UIAbility的代码路径,标签值为字符串(最长为127字节)。 | 字符串 | 该标签不可缺省。 |
|
[
launchType
](
../application-models/uiability-launch-type.md
)
| 标识当前UIAbility组件的启动模式,可选标签值:
<br/>
-
standard
:标准实例模式,每次启动创建一个新的实例。
<br/>
-
singleton:单实例模式,仅第一次启动创建新实例。
<br/>
-
specified:指定实例模式,运行时由开发者决定是否创建新实例。 | 字符串 | 可缺省,该标签缺省为“singleton”。 |
|
[
launchType
](
../application-models/uiability-launch-type.md
)
| 标识当前UIAbility组件的启动模式,可选标签值:
<br/>
-
multiton
:标准实例模式,每次启动创建一个新的实例。
<br/>
-
singleton:单实例模式,仅第一次启动创建新实例。
<br/>
-
specified:指定实例模式,运行时由开发者决定是否创建新实例。 | 字符串 | 可缺省,该标签缺省为“singleton”。 |
| description | 标识当前UIAbility组件的描述信息,标签值是字符串类型(最长255字节)或对描述内容的资源索引,要求采用资源索引方式,以支持多语言。 | 字符串 | 该标签可缺省,缺省值为空。 |
| description | 标识当前UIAbility组件的描述信息,标签值是字符串类型(最长255字节)或对描述内容的资源索引,要求采用资源索引方式,以支持多语言。 | 字符串 | 该标签可缺省,缺省值为空。 |
| icon | 标识当前UIAbility组件的图标,标签值为图标资源文件的索引。 | 字符串 | 该标签可缺省,缺省值为空。
<br/>
如果UIAbility被配置为MainElement,该标签必须配置。 |
| icon | 标识当前UIAbility组件的图标,标签值为图标资源文件的索引。 | 字符串 | 该标签可缺省,缺省值为空。
<br/>
如果UIAbility被配置为MainElement,该标签必须配置。 |
| label | 标识当前UIAbility组件对用户显示的名称,标签值配置为该名称的资源索引以支持多语言。
<br/>
如果UIAbility被配置当前Module的mainElement时,该标签必须配置,且应用内唯一。 | 字符串 | 该标签不可缺省。 |
| label | 标识当前UIAbility组件对用户显示的名称,标签值配置为该名称的资源索引以支持多语言。
<br/>
如果UIAbility被配置当前Module的mainElement时,该标签必须配置,且应用内唯一。 | 字符串 | 该标签不可缺省。 |
| permissions | 标识当前UIAbility组件自定义的权限信息。当其他应用访问该UIAbility时,需要申请相应的权限信息。
<br/>
一个数组元素为一个权限名称。通常采用反向域名格式(最大255字节),取值为系统预定义的权限。 | 字符串数组 | 该标签可缺省,缺省值为空。 |
| permissions | 标识当前UIAbility组件自定义的权限信息。当其他应用访问该UIAbility时,需要申请相应的权限信息。
<br/>
一个数组元素为一个权限名称。通常采用反向域名格式(最大255字节),取值为系统预定义的权限。 | 字符串数组 | 该标签可缺省,缺省值为空。 |
|
[
metadata
](
#metadata标签
)
| 标识当前UIAbility组件的元信息。 | 对象数组 | 该标签可缺省,缺省值为空。 |
|
[
metadata
](
#metadata标签
)
| 标识当前UIAbility组件的元信息。 | 对象数组 | 该标签可缺省,缺省值为空。 |
|
visible
| 标识当前UIAbility组件是否可以被其他应用调用。
<br/>
-
true:表示可以被其他应用调用。
<br/>
-
false:表示不可以被其他应用调用。 | 布尔值 | 该标签可缺省,缺省值为false。 |
|
exported
| 标识当前UIAbility组件是否可以被其他应用调用。
<br/>
-
true:表示可以被其他应用调用。
<br/>
-
false:表示不可以被其他应用调用。 | 布尔值 | 该标签可缺省,缺省值为false。 |
| continuable | 标识当前UIAbility组件是否可以
[
迁移
](
../application-models/hop-cross-device-migration.md
)
。
<br/>
-
true:表示可以被迁移。
<br/>
-
false:表示不可以被迁移。 | 布尔值 | 该标签可缺省,缺省值为false。 |
| continuable | 标识当前UIAbility组件是否可以
[
迁移
](
../application-models/hop-cross-device-migration.md
)
。
<br/>
-
true:表示可以被迁移。
<br/>
-
false:表示不可以被迁移。 | 布尔值 | 该标签可缺省,缺省值为false。 |
|
[
skills
](
#skills标签
)
| 标识当前UIAbility组件或ExtensionAbility组件能够接收的
[
Want
](
../application-models/want-overview.md
)
的特征集,为数组格式。
<br/>
配置规则:
<br/>
-
对于Entry类型的HAP,OpenHarmony应用可以配置多个具有入口能力的skills标签(即配置了ohos.want.action.home和entity.system.home)。
<br/>
-
对于Feature类型的HAP,只有OpenHarmony应用可以配置具有入口能力的skills标签,OpenHarmony服务不允许配置。 | 对象数组 | 该标签可缺省,缺省值为空。 |
|
[
skills
](
#skills标签
)
| 标识当前UIAbility组件或ExtensionAbility组件能够接收的
[
Want
](
../application-models/want-overview.md
)
的特征集,为数组格式。
<br/>
配置规则:
<br/>
-
对于Entry类型的HAP,OpenHarmony应用可以配置多个具有入口能力的skills标签(即配置了ohos.want.action.home和entity.system.home)。
<br/>
-
对于Feature类型的HAP,只有OpenHarmony应用可以配置具有入口能力的skills标签,OpenHarmony服务不允许配置。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| backgroundModes | 标识当前UIAbility组件的长时任务集合。指定用于满足特定类型的长时任务。
<br/>
长时任务类型有如下:
<br/>
-
dataTransfer:通过网络/对端设备进行数据下载、备份、分享、传输等业务。
<br/>
-
audioPlayback:音频输出业务。
<br/>
-
audioRecording:音频输入业务。
<br/>
-
location:定位、导航业务。
<br/>
-
bluetoothInteraction:蓝牙扫描、连接、传输业务(穿戴)。
<br/>
-
multiDeviceConnection:多设备互联业务。
<br/>
-
wifiInteraction:Wi-Fi扫描、连接、传输业务(克隆多屏)。
<br/>
-
voip:音视频电话,VoIP业务。
<br/>
-
taskKeeping:计算业务。 | 字符串数组 | 该标签可缺省,缺省值为空。 |
| backgroundModes | 标识当前UIAbility组件的长时任务集合。指定用于满足特定类型的长时任务。
<br/>
长时任务类型有如下:
<br/>
-
dataTransfer:通过网络/对端设备进行数据下载、备份、分享、传输等业务。
<br/>
-
audioPlayback:音频输出业务。
<br/>
-
audioRecording:音频输入业务。
<br/>
-
location:定位、导航业务。
<br/>
-
bluetoothInteraction:蓝牙扫描、连接、传输业务(穿戴)。
<br/>
-
multiDeviceConnection:多设备互联业务。
<br/>
-
wifiInteraction:Wi-Fi扫描、连接、传输业务(克隆多屏)。
<br/>
-
voip:音视频电话,VoIP业务。
<br/>
-
taskKeeping:计算业务。 | 字符串数组 | 该标签可缺省,缺省值为空。 |
...
@@ -240,14 +239,14 @@ abilities示例:
...
@@ -240,14 +239,14 @@ abilities示例:
{
{
"abilities"
:
[{
"abilities"
:
[{
"name"
:
"EntryAbility"
,
"name"
:
"EntryAbility"
,
"srcEntr
ance
"
:
"./ets/entryability/EntryAbility.ts"
,
"srcEntr
y
"
:
"./ets/entryability/EntryAbility.ts"
,
"launchType"
:
"s
tandard
"
,
"launchType"
:
"s
ingleton
"
,
"description"
:
"$string:description_main_ability"
,
"description"
:
"$string:description_main_ability"
,
"icon"
:
"$media:icon"
,
"icon"
:
"$media:icon"
,
"label"
:
"Login"
,
"label"
:
"Login"
,
"permissions"
:
[],
"permissions"
:
[],
"metadata"
:
[],
"metadata"
:
[],
"
visible
"
:
true
,
"
exported
"
:
true
,
"continuable"
:
true
,
"continuable"
:
true
,
"skills"
:
[{
"skills"
:
[{
"actions"
:
[
"ohos.want.action.home"
],
"actions"
:
[
"ohos.want.action.home"
],
...
@@ -345,7 +344,7 @@ skills示例:
...
@@ -345,7 +344,7 @@ skills示例:
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| name | 标识当前ExtensionAbility组件的名称,标签值最大长度为127个字节,该名称在整个应用要唯一。 | 字符串 | 该标签不可缺省。 |
| name | 标识当前ExtensionAbility组件的名称,标签值最大长度为127个字节,该名称在整个应用要唯一。 | 字符串 | 该标签不可缺省。 |
| srcEntr
ance
| 标识当前ExtensionAbility组件所对应的代码路径,标签值最大长度为127字节。 | 字符串 | 该标签不可缺省。 |
| srcEntr
y
| 标识当前ExtensionAbility组件所对应的代码路径,标签值最大长度为127字节。 | 字符串 | 该标签不可缺省。 |
| description | 标识当前ExtensionAbility组件的描述,标签值最大长度为255字节,标签也可以是描述内容的资源索引,用于支持多语言。 | 字符串 | 该标签可缺省,缺省值为空。 |
| description | 标识当前ExtensionAbility组件的描述,标签值最大长度为255字节,标签也可以是描述内容的资源索引,用于支持多语言。 | 字符串 | 该标签可缺省,缺省值为空。 |
| icon | 标识当前ExtensionAbility组件的图标,标签值为资源文件的索引。如果ExtensionAbility组件被配置为MainElement,该标签必须配置。 | 字符串 | 该标签可缺省,缺省值为空。 |
| icon | 标识当前ExtensionAbility组件的图标,标签值为资源文件的索引。如果ExtensionAbility组件被配置为MainElement,该标签必须配置。 | 字符串 | 该标签可缺省,缺省值为空。 |
| label | 标识当前ExtensionAbility组件对用户显示的名称,标签值配置为该名称的资源索引以支持多语言。
<br/>
**说明:**
<br/>
- 如果ExtensionAbility被配置当前Module的mainElement时,该标签必须配置,且应用内唯一。 | 字符串 | 该标签不可缺省。 |
| label | 标识当前ExtensionAbility组件对用户显示的名称,标签值配置为该名称的资源索引以支持多语言。
<br/>
**说明:**
<br/>
- 如果ExtensionAbility被配置当前Module的mainElement时,该标签必须配置,且应用内唯一。 | 字符串 | 该标签不可缺省。 |
...
@@ -354,7 +353,7 @@ skills示例:
...
@@ -354,7 +353,7 @@ skills示例:
| uri | 标识当前ExtensionAbility组件提供的数据URI,为字符数组类型(最大长度255),用反向域名的格式表示。
<br/>
**说明:**
<br/>
- 该标签在type为dataShare类型的ExtensionAbility时,不可缺省。 | 字符串 | 该标签可缺省,缺省值为空。 |
| uri | 标识当前ExtensionAbility组件提供的数据URI,为字符数组类型(最大长度255),用反向域名的格式表示。
<br/>
**说明:**
<br/>
- 该标签在type为dataShare类型的ExtensionAbility时,不可缺省。 | 字符串 | 该标签可缺省,缺省值为空。 |
|skills | 标识当前ExtensionAbility组件能够接收的
[
Want
](
../application-models/want-overview.md
)
的特征集,为数组格式。
<br/>
配置规则:entry包可以配置多个具有入口能力的skills标签(配置了ohos.want.action.home和entity.system.home)的ExtensionAbility,其中第一个配置了skills标签的ExtensionAbility中的label和icon作为OpenHarmony服务或应用的label和icon。
<br/>
**说明:**
<br/>
- OpenHarmony服务的Feature包不能配置具有入口能力的skills标签。
<br/>
- OpenHarmony应用的Feature包可以配置具有入口能力的skills标签。 | 数组 | 该标签可缺省,缺省值为空。 |
|skills | 标识当前ExtensionAbility组件能够接收的
[
Want
](
../application-models/want-overview.md
)
的特征集,为数组格式。
<br/>
配置规则:entry包可以配置多个具有入口能力的skills标签(配置了ohos.want.action.home和entity.system.home)的ExtensionAbility,其中第一个配置了skills标签的ExtensionAbility中的label和icon作为OpenHarmony服务或应用的label和icon。
<br/>
**说明:**
<br/>
- OpenHarmony服务的Feature包不能配置具有入口能力的skills标签。
<br/>
- OpenHarmony应用的Feature包可以配置具有入口能力的skills标签。 | 数组 | 该标签可缺省,缺省值为空。 |
|
[
metadata
](
#metadata标签
)
| 标识当前ExtensionAbility组件的元信息。 | 对象 | 该标签可缺省,缺省值为空。 |
|
[
metadata
](
#metadata标签
)
| 标识当前ExtensionAbility组件的元信息。 | 对象 | 该标签可缺省,缺省值为空。 |
|
visible
| 标识当前ExtensionAbility组件是否可以被其他应用调用,为布尔类型。
<br/>
-
true:表示可以被其他应用调用。
<br/>
-
false:表示不可以被其他应用调用。 | 布尔值 | 该标签可缺省,缺省值为false。 |
|
exported
| 标识当前ExtensionAbility组件是否可以被其他应用调用,为布尔类型。
<br/>
-
true:表示可以被其他应用调用。
<br/>
-
false:表示不可以被其他应用调用。 | 布尔值 | 该标签可缺省,缺省值为false。 |
extensionAbilities示例:
extensionAbilities示例:
...
@@ -364,7 +363,7 @@ extensionAbilities示例:
...
@@ -364,7 +363,7 @@ extensionAbilities示例:
"extensionAbilities"
:
[
"extensionAbilities"
:
[
{
{
"name"
:
"FormName"
,
"name"
:
"FormName"
,
"srcEntr
ance
"
:
"./form/MyForm.ts"
,
"srcEntr
y
"
:
"./form/MyForm.ts"
,
"icon"
:
"$media:icon"
,
"icon"
:
"$media:icon"
,
"label"
:
"$string:extension_name"
,
"label"
:
"$string:extension_name"
,
"description"
:
"$string:form_description"
,
"description"
:
"$string:form_description"
,
...
@@ -372,7 +371,7 @@ extensionAbilities示例:
...
@@ -372,7 +371,7 @@ extensionAbilities示例:
"permissions"
:
[
"ohos.abilitydemo.permission.PROVIDER"
],
"permissions"
:
[
"ohos.abilitydemo.permission.PROVIDER"
],
"readPermission"
:
""
,
"readPermission"
:
""
,
"writePermission"
:
""
,
"writePermission"
:
""
,
"
visible
"
:
true
,
"
exported
"
:
true
,
"uri"
:
"scheme://authority/path/query"
,
"uri"
:
"scheme://authority/path/query"
,
"skills"
:
[{
"skills"
:
[{
"actions"
:
[],
"actions"
:
[],
...
@@ -441,7 +440,7 @@ metadata中指定shortcut信息,其中:
...
@@ -441,7 +440,7 @@ metadata中指定shortcut信息,其中:
| shortcutId | 标识快捷方式的ID。字符串的最大长度为63字节。 | 字符串 | 该标签不可缺省。 |
| shortcutId | 标识快捷方式的ID。字符串的最大长度为63字节。 | 字符串 | 该标签不可缺省。 |
| label | 标识快捷方式的标签信息,即快捷方式对外显示的文字描述信息。取值可以是描述性内容,也可以是标识label的资源索引。字符串最大长度为255字节。 | 字符串 | 该标签可缺省,缺省值为空。 |
| label | 标识快捷方式的标签信息,即快捷方式对外显示的文字描述信息。取值可以是描述性内容,也可以是标识label的资源索引。字符串最大长度为255字节。 | 字符串 | 该标签可缺省,缺省值为空。 |
| icon | 标识快捷方式的图标,标签值为资源文件的索引。 | 字符串 | 该标签可缺省,缺省值为空。 |
| icon | 标识快捷方式的图标,标签值为资源文件的索引。 | 字符串 | 该标签可缺省,缺省值为空。 |
|
[
wants
](
../application-models/want-overview.md
)
| 标识快捷方式内定义的目标wants信息集合,每个wants可配置bundleName和abilityName两个子标签。
<br/>
bundleName:表示快捷方式的目标
包名
,字符串类型。
<br/>
abilityName:表示快捷方式的目标组件名,字符串类型。 | 对象 | 该标签可缺省,缺省为空。 |
|
[
wants
](
../application-models/want-overview.md
)
| 标识快捷方式内定义的目标wants信息集合,每个wants可配置bundleName和abilityName两个子标签。
<br/>
bundleName:表示快捷方式的目标
Bundle名称
,字符串类型。
<br/>
abilityName:表示快捷方式的目标组件名,字符串类型。 | 对象 | 该标签可缺省,缺省为空。 |
1.
在/resource/base/profile/目录下配置shortcuts_config.json配置文件。
1.
在/resource/base/profile/目录下配置shortcuts_config.json配置文件。
...
@@ -473,7 +472,7 @@ metadata中指定shortcut信息,其中:
...
@@ -473,7 +472,7 @@ metadata中指定shortcut信息,其中:
"abilities"
:
[
"abilities"
:
[
{
{
"name"
:
"EntryAbility"
,
"name"
:
"EntryAbility"
,
"srcEntr
ance
"
:
"./ets/entryability/EntryAbility.ts"
,
"srcEntr
y
"
:
"./ets/entryability/EntryAbility.ts"
,
//
...
//
...
"skills"
:
[
"skills"
:
[
{
{
...
@@ -498,49 +497,42 @@ metadata中指定shortcut信息,其中:
...
@@ -498,49 +497,42 @@ metadata中指定shortcut信息,其中:
```
```
## distr
o
Filter标签
## distr
ibution
Filter标签
该标签下的子标签均为可选字段,在应用市场云端分发时做精准匹配使用,distr
oFilter
用于定义HAP对应的细分设备规格的分发策略,以便在应用市场进行云端分发应用包时做精准匹配。该标签可配置的分发策略维度包括API Version、屏幕形状、屏幕尺寸、屏幕分辨率,设备的国家与地区码。在进行分发时,通过deviceType与这五个属性的匹配关系,唯一确定一个用于分发到设备的HAP。该标签需要配置在/resource/profile资源目录下。
该标签下的子标签均为可选字段,在应用市场云端分发时做精准匹配使用,distr
ibutionFilter标签
用于定义HAP对应的细分设备规格的分发策略,以便在应用市场进行云端分发应用包时做精准匹配。该标签可配置的分发策略维度包括API Version、屏幕形状、屏幕尺寸、屏幕分辨率,设备的国家与地区码。在进行分发时,通过deviceType与这五个属性的匹配关系,唯一确定一个用于分发到设备的HAP。该标签需要配置在/resource/profile资源目录下。
**表9**
**distr
oFilter
标签配置说明**
**表9**
**distr
ibutionFilter标签
标签配置说明**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| apiVersion | 标识支持的apiVersion范围。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| screenShape | 标识屏幕形状的支持策略。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| screenShape | 标识屏幕形状的支持策略。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| screenWindow | 标识应用运行时窗口的分辨率支持策略。该字段仅支持对轻量级智能穿戴设备进行配置。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| screenWindow | 标识应用运行时窗口的分辨率支持策略。该字段仅支持对轻量级智能穿戴设备进行配置。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| screenDensity | 标识屏幕的像素密度(dpi:Dot
Per
Inch)。该字段可选,如果配置了该字段,取值必须合法。该标签为字符串数组,字符串范围如下。
<br/>
-
sdpi:表示小规模的屏幕密度(Small-scale
Dots
per
Inch),适用于dpi取值为(0,120]的设备。
<br/>
-
mdpi:表示中规模的屏幕密度(Medium-scale
Dots
Per
Inch),适用于dpi取值为(120,160]的设备。
<br/>
-
ldpi:表示大规模的屏幕密度(Large-scale
Dots
Per
Inch),适用于dpi取值为(160,240]的设备。
<br/>
-
xldpi:表示大规模的屏幕密度(Extra
Large-scale
Dots
Per
Inch),适用于dpi取值为(240,320]的设备。
<br/>
-
xxldpi:表示大规模的屏幕密度(Extra
Extra
Large-scale
Dots
Per
Inch),适用于dpi取值为(320,480]的设备。
<br/>
-
xxxldpi:表示大规模的屏幕密度(Extra
Extra
Extra
Large-scale
Dots
Per
Inch),适用于dpi取值为(480,
640]的设备。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| screenDensity | 标识屏幕的像素密度(dpi:Dot
Per
Inch)。该字段可选,如果配置了该字段,取值必须合法。该标签为字符串数组,字符串范围如下。
<br/>
-
sdpi:表示小规模的屏幕密度(Small-scale
Dots
per
Inch),适用于dpi取值为(0,120]的设备。
<br/>
-
mdpi:表示中规模的屏幕密度(Medium-scale
Dots
Per
Inch),适用于dpi取值为(120,160]的设备。
<br/>
-
ldpi:表示大规模的屏幕密度(Large-scale
Dots
Per
Inch),适用于dpi取值为(160,240]的设备。
<br/>
-
xldpi:表示大规模的屏幕密度(Extra
Large-scale
Dots
Per
Inch),适用于dpi取值为(240,320]的设备。
<br/>
-
xxldpi:表示大规模的屏幕密度(Extra
Extra
Large-scale
Dots
Per
Inch),适用于dpi取值为(320,480]的设备。
<br/>
-
xxxldpi:表示大规模的屏幕密度(Extra
Extra
Extra
Large-scale
Dots
Per
Inch),适用于dpi取值为(480,
640]的设备。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| countryCode | 表示应用需要分发的国家地区码,具体值以ISO-3166-1标准为准。支持多个国家和地区枚举定义。 | 对象数组 | 该标签可缺省,缺省值为空。 |
| countryCode | 表示应用需要分发的国家地区码,具体值以ISO-3166-1标准为准。支持多个国家和地区枚举定义。 | 对象数组 | 该标签可缺省,缺省值为空。 |
**表10**
**apiVersion标签说明**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
**表10**
**screenShape对象的内部结构**
| -------- | -------- | -------- | -------- |
| policy | 标识该子属性取值规则。配置为“exclude”或“include”。
<br/>
-
exclude:表示需要排除的value属性。
<br/>
-
include:表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 |
| value | 支持的取值为API
Version存在的整数值,例如4、5、6。场景示例:某应用,针对相同设备型号,同时在网的为使用API
5和API
6开发的两个软件版本,则允许上架2个entry类型的安装包,分别支持到对应设备侧软件版本的分发。 | 数组 | 该标签不可缺省。 |
**表11**
**screenShape对象的内部结构**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| policy | 标识该子属性取值规则。配置为“exclude”或“include”。
<br/>
-
exclude:表示需要排除的value属性。
<br/>
-
include:表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 |
| policy | 标识该子属性取值规则。配置为“exclude”或“include”。
<br/>
-
exclude:表示需要排除的value属性。
<br/>
-
include:表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 |
| value | 支持的取值为circle(圆形)、rect(矩形)。场景示例:针对智能穿戴设备,可为圆形表盘和矩形表盘分别提供不同的HAP。 | 字符串数组 | 该标签不可缺省。 |
| value | 支持的取值为circle(圆形)、rect(矩形)。场景示例:针对智能穿戴设备,可为圆形表盘和矩形表盘分别提供不同的HAP。 | 字符串数组 | 该标签不可缺省。 |
**表1
2
**
**screenWindow对象的内部结构说明**
**表1
1
**
**screenWindow对象的内部结构说明**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| policy | 标识该子属性取值规则。配置为“exclude”或“include”。
<br/>
-
exclude:表示该字段取值不包含value枚举值匹配规则的匹配该属性。
<br/>
-
include:表示该字段取值满足value枚举值匹配规则的匹配该属性。 | 字符串 | 该标签不可缺省。 |
| policy | 标识该子属性取值规则。配置为“exclude”或“include”。
<br/>
-
exclude:表示该字段取值不包含value枚举值匹配规则的匹配该属性。
<br/>
-
include:表示该字段取值满足value枚举值匹配规则的匹配该属性。 | 字符串 | 该标签不可缺省。 |
| value | 单个字符串的取值格式为“宽
\*
高”,取值为整数像素值,例如“454
\*
454”。 | 字符串数组 | 该标签不可缺省。 |
| value | 单个字符串的取值格式为“宽
\*
高”,取值为整数像素值,例如“454
\*
454”。 | 字符串数组 | 该标签不可缺省。 |
**表1
3
**
**screenDensity对象的内部结构说明**
**表1
2
**
**screenDensity对象的内部结构说明**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| policy | 标识该子属性取值规则。配置为“exclude”或“include”。
<br/>
-
exclude:表示需要排除的value属性。
<br/>
-
include:表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 |
| policy | 标识该子属性取值规则。配置为“exclude”或“include”。
<br/>
-
exclude:表示需要排除的value属性。
<br/>
-
include:表示需要包含的value属性。 | 字符串 | 该标签不可缺省。 |
| value | 该标签标识屏幕的像素密度(dpi
:Dot
Per
Inch)。 | 字符串数组 | 该标签不可缺省。 |
| value | 该标签标识屏幕的像素密度(dpi
:Dot
Per
Inch)。 | 字符串数组 | 该标签不可缺省。 |
**表1
4
**
**countryCode对象的内部结构说明**
**表1
3
**
**countryCode对象的内部结构说明**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
...
@@ -552,14 +544,7 @@ metadata中指定shortcut信息,其中:
...
@@ -552,14 +544,7 @@ metadata中指定shortcut信息,其中:
```
json
```
json
{
{
"distroFilter"
:
{
"distributionFilter"
:
{
"apiVersion"
:
{
"policy"
:
"include"
,
"value"
:
[
3
,
4
]
},
"screenShape"
:
{
"screenShape"
:
{
"policy"
:
"include"
,
"policy"
:
"include"
,
"value"
:
[
"value"
:
[
...
@@ -614,7 +599,7 @@ metadata中指定shortcut信息,其中:
...
@@ -614,7 +599,7 @@ metadata中指定shortcut信息,其中:
此标签用于支持对测试框架的配置。
此标签用于支持对测试框架的配置。
**表1
5
**
**testRunner标签说明**
**表1
4
**
**testRunner标签说明**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
...
...
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md
浏览文件 @
cd177cc0
...
@@ -5,7 +5,7 @@
...
@@ -5,7 +5,7 @@
包管理删除
[
@ohos.bundle.bundleManager.d.ts
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts
)
中的getAbilityIcon接口,可以使用
[
@ohos.resourceManager.d.ts
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.resourceManager.d.ts
)
中的getMediaContent替换。
包管理删除
[
@ohos.bundle.bundleManager.d.ts
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts
)
中的getAbilityIcon接口,可以使用
[
@ohos.resourceManager.d.ts
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.resourceManager.d.ts
)
中的getMediaContent替换。
**变更影响**
<br>
**变更影响**
<br>
使用之前已发布的API 9各beta版本
切
使用到了getAbilityIcon接口的,需要改为使用getMediaContent接口。
使用之前已发布的API 9各beta版本
且
使用到了getAbilityIcon接口的,需要改为使用getMediaContent接口。
**关键的接口/组件变更**
<br>
**关键的接口/组件变更**
<br>
删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口。
删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口。
...
@@ -27,3 +27,207 @@
...
@@ -27,3 +27,207 @@
**适配指导**
<br>
**适配指导**
<br>
如果有应用需要自定义权限,可以在资源HAP的
[
配置文件
](
https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json
)
中definePermissions字段下面新增定义权限。格式可参考
[
定义权限
](
../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构
)
。
如果有应用需要自定义权限,可以在资源HAP的
[
配置文件
](
https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json
)
中definePermissions字段下面新增定义权限。格式可参考
[
定义权限
](
../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构
)
。
## cl.bundlemanager.3 包管理二级模块文件名称变更,修改为文件内对应的接口名称
包管理二级模块文件名称变更,修改为文件内对应的接口名称,变更文件如下:
| 原文件名称 |变更后文件名称 |
|----|----|
| bundleManager/abilityInfo.d.ts | bundleManager/AbilityInfo.d.ts |
| bundleManager/applicationInfo.d.ts | bundleManager/ApplicationInfo.d.ts |
| bundleManager/bundleInfo.d.ts | bundleManager/BundleInfo.d.ts |
| bundleManager/dispatchInfo.d.ts | bundleManager/DispatchInfo.d.ts |
| bundleManager/elementName.d.ts | bundleManager/ElementName.d.ts |
| bundleManager/extensionAbilityInfo.d.ts | bundleManager/ExtensionAbilityInfo.d.ts |
| bundleManager/hapModuleInfo.d.ts | bundleManager/HapModuleInfo.d.ts |
| bundleManager/launcherAbilityInfo.d.ts | bundleManager/LauncherAbilityInfo.d.ts |
| bundleManager/metadata.d.ts | bundleManager/Metadata.d.ts |
| bundleManager/packInfo.d.ts | bundleManager/BundlePackInfo.d.ts |
| bundleManager/permissionDef.d.ts | bundleManager/PermissionDef.d.ts |
| bundleManager/remoteAbilityInfo.d.ts | bundleManager/RemoteAbilityInfo.d.ts |
| bundleManager/shortcutInfo.d.ts | bundleManager/ShortcutInfo.d.ts |
除了免安装相关的BundlePackInfo文件名称增加了Bundle,其余文件名称均是修改为大写开头。
**变更影响**
<br>
仅修改二级模块文件名称,不会影响一级模块的使用。在使用之前已发布的API 9各beta版本时,如果在ts文件中直接导入了bundleManager下面二级模块接口的,IDE中编译报错的话,需要修改导入的文件名称。
**关键的接口/组件变更**
<br>
变更bundleManager文件夹下面的d.ts名称,修改为文件中的接口名称。
**适配指导**
<br>
使用新的sdk后,正常情况下应用无需适配该变更。如果在应用中直接导入了bundleManager文件夹下面的文件,则需要修改导入的文件名称。可以按照如下的修改方式:
**修改前:**
```
ts
import
{
AbilityInfo
}
from
'
bundleManger/abilityInfo
'
;
import
{
ExtensionAbilityInfo
}
from
'
bundleManger/extensionAbilityInfo
'
;
import
{
BundlePackInfo
}
from
'
bundleManger/packInfo
'
;
```
**修改后:**
```
ts
import
{
AbilityInfo
}
from
'
bundleManger/AbilityInfo
'
;
import
{
ExtensionAbilityInfo
}
from
'
bundleManger/ExtensionAbilityInfo
'
;
import
{
BundlePackInfo
}
from
'
bundleManger/BundlePackInfo
'
;
```
## cl.bundlemanager.4 包管理LaunchType枚举类型名称变更,由STANDARD修改为MULTITON,枚举值不变。
包管理
[
LaunchType
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts
)
枚举类型变更,由STANDARD修改为MULTITON,枚举值不变,表示多实例类型。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了LaunchType.STANDARD的,需要改为使用LaunchType.MULTITON接口。
**关键的接口/组件变更**
<br>
LaunchType枚举类型名称变更,由LaunchType.STANDARD修改为LaunchType.MULTITON。
**适配指导**
<br>
由LaunchType.STANDARD修改为LaunchType.MULTITON。
## cl.bundlemanager.5 包管理AbilityInfo结构体中isVisible字段修改为exported,类型不变。
包管理
[
AbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。
**关键的接口/组件变更**
<br>
包管理
[
AbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变。
**适配指导**
<br>
由isVisible修改为exported。
## cl.bundlemanager.6 包管理ExtensionAbilityInfo结构体中isVisible字段修改为exported,类型不变。
包管理
[
ExtensionAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。
**关键的接口/组件变更**
<br>
包管理
[
ExtensionAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变。
**适配指导**
<br>
由isVisible修改为exported。
## cl.bundlemanager.7 包管理ModuleAbilityInfo结构体中visible字段修改为exported,类型不变。
包管理
[
ModuleAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts
)
结构体中visible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了visible的,需要改为使用exported。
**关键的接口/组件变更**
<br>
包管理
[
ModuleAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts
)
结构体中visible字段修改为exported,类型不变。
**适配指导**
<br>
由visible修改为exported。
## cl.bundlemanager.8 app.json配置文件删除distributedNotificationEnabled标签
删除配置文件app.json中
[
distributedNotificationEnabled
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
distributedNotificationEnabled
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
distributedNotificationEnabled
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.9 app.json配置文件删除entityType标签
删除配置文件app.json中
[
entityType
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
entityType
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
entityType
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.10 app.json配置文件删除keepAlive标签
删除配置文件app.json中
[
keepAlive
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
keepAlive
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
keepAlive
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.11 app.json配置文件删除removable标签
删除配置文件app.json中
[
removable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
removable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
removable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.12 app.json配置文件删除singleton标签
删除配置文件app.json中
[
singleton
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
singleton
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
singleton
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.13 app.json配置文件删除userDataClearable标签
删除配置文件app.json中
[
userDataClearable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
userDataClearable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
userDataClearable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.14 module.json配置文件中module的name标签不再支持配置中文
module.json配置文件中的module的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
不再支持配置中文
**变更影响**
<br>
删除配置文件module.json中module的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签不再支持配置中文,IDE中配置该标签为中文,会导致IDE编译报错
**适配指导**
<br>
使用英文语言配置module.json中module的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
## cl.bundlemanager.15 module.json配置文件中ability的name标签不再支持配置中文
module.json配置文件中的ability的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
不再支持配置中文
**变更影响**
<br>
删除配置文件module.json中ability的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签不再支持配置中文,IDE中配置该标签为中文,会导致IDE编译报错
**适配指导**
<br>
使用英文语言配置module.json中ability的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
## cl.bundlemanager.16 module.json配置文件删除uiSyntax标签
删除配置文件module.json中
[
uiSyntax
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件module.json中
[
uiSyntax
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
uiSyntax
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
## cl.bundlemanager.17 module.json配置文件中module及ability中的srcEntrance标签修改为srcEntry
配置文件module.json中
[
srcEntrance
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签修改为srcEntry
**变更影响**
<br>
删除配置文件module.json中
[
srcEntrance
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
srcEntrance
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,使用srcEntry替代
## cl.bundlemanager.18 删除module.json配置文件中distroFilter的apiVersion标签
删除配置文件module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
的apiVersion标签
**变更影响**
<br>
删除配置文件module.json
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
的apiVersion标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
的apiVersion标签
## cl.bundlemanager.19 module.json配置文件中distroFilter修改为distributionFilter
配置文件module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签修改为distributionFilter
**变更影响**
<br>
删除配置文件module.json
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,使用distributionFilter替代
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录