From 6cfdd3af22c30e0ffa1fb728c14995d025052c6e Mon Sep 17 00:00:00 2001 From: liuhonghao123 Date: Fri, 30 May 2025 19:17:36 +0800 Subject: [PATCH 1/7] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=87=AA=E7=94=B1?= =?UTF-8?q?=E5=A4=9A=E7=AA=97=E4=B8=8B=E7=9A=84supportwindowmode?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liuhonghao123 --- .../quick-start/module-configuration-file.md | 75 ++++++++++++------- 1 file changed, 48 insertions(+), 27 deletions(-) diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index c3e643e70c9..5ac2ee1f086 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -257,6 +257,24 @@ deviceTypes示例： 2. 使用metadata标签配置是否移除启动页。配置项为：name取值为enable.remove.starting.window，value取值为true或false，取值为true表示移除启动页、取值为false表示不移除启动页，未配置时默认为false。 +3. 使用metadata配置自由多窗下的SupportWindowMode。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的SupportWindowMode配置。SupportWindowMode还可以根据北向接口（StartOption和SetSupportWindowMode）来配置，北向的优先级高于module.json5。具体的优先级规格如下图所示： + + **表6** SupportWindowMode优先级规格 +| 应用模式 | 是否配置SetSupportWindowMode | 是否配置StartOption | 是否配置SupportWindowMode | 是否配置SupportWindowModeInFreeWindows | 最终生效模式 | +| -------- | -------- | -------- | -------- | -------- | -------- | +| 自由多窗模式 | 是 | 是 | 是 | 是 | SetSupportWindowMode生效 | +| 自由多窗模式 | 否 | 是 | 是 | 是 | StartOption生效 | +| 自由多窗模式 | 否 | 否 | 是 | 是 | SupportWindowModeInFreeWindow生效 | +| 自由多窗模式 | 否 | 否 | 是 | 否 | SupportWindowMode生效 | +| 自由多窗模式 | 否 | 否 | 否 | 是 | SupportWindowModeInFreeWindow生效 | +| 自由多窗模式 | 否 | 否 | 否 | 否 | 无配置项，默认所有窗口都支持 | +| 非自由多窗模式 | 是 | 是 | 是 | 是 | SetSupportWindowMode非自由多窗下无法生效，但如果是自由多窗设置后切换非自由多窗，则依然保持生效 | +| 非自由多窗模式 | 否 | 是 | 是 | 是 | StartOption非自由多窗下无法生效，但如果是自由多窗设置后切换非自由多窗，则保持生效 | +| 非自由多窗模式 | 否 | 否 | 是 | 是 | SupportWindowMode生效 | +| 非自由多窗模式 | 否 | 否 | 是 | 否 | SupportWindowMode生效 | +| 非自由多窗模式 | 否 | 否 | 否 | 是 | 按默认所有窗口都支持 | +| 非自由多窗模式 | 否 | 否 | 否 | 否 | 无配置项，默认所有窗口都支持 | + ```json { "module": { @@ -309,18 +327,21 @@ deviceTypes示例： "name": "extensionAbility_metadata_2", "value": "a string test", "resource": "$profile:config_file" + }， + { + "name": "ohos.ability.window.SupportWindowModeInFreeWindow", + "value": "fullscreen,split,floating", }], }] } } ``` - ## abilities标签 abilities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。 - **表6** abilities标签说明 + **表7** abilities标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -341,7 +362,7 @@ abilities标签描述UIAbility组件的配置信息，标签值为数组类型 | startWindowBackground | 标识当前UIAbility组件启动页面背景颜色资源文件的索引，取值为长度不超过255字节的字符串。
取值示例：$color:red。| 字符串 | 该标签不可缺省。 | | removeMissionAfterTerminate | 标识当前UIAbility组件销毁后，是否从任务列表中移除任务。
- true表示销毁后移除任务。
- false表示销毁后不移除任务。 | 布尔值 | 该标签可缺省，缺省值为false。 | | orientation | 标识当前UIAbility组件启动时的方向，支持配置枚举，或启动方向资源索引。
**启动方向枚举支持的取值如下：**
- unspecified：未指定方向，由系统自动判断显示方向。
- landscape：横屏。
- portrait：竖屏。
- follow_recent：跟随背景窗口的旋转模式。
- landscape_inverted：反向横屏。
- portrait_inverted：反向竖屏。
- auto_rotation：随传感器旋转。
- auto_rotation_landscape：传感器横屏旋转，包括横屏和反向横屏。
- auto_rotation_portrait：传感器竖屏旋转，包括竖屏和反向竖屏。
- auto_rotation_restricted：传感器开关打开，方向可随传感器旋转。
- auto_rotation_landscape_restricted：传感器开关打开，方向可随传感器旋转为横屏， 包括横屏和反向横屏。
- auto_rotation_portrait_restricted：传感器开关打开，方向随可传感器旋转为竖屏， 包括竖屏和反向竖屏。
- locked：传感器开关关闭，方向锁定。
- auto_rotation_unspecified：受开关控制和由系统判定的自动旋转模式。
- follow_desktop：跟随桌面的旋转模式。
 **配置启动方向的资源索引时**，取值为长度不超过255字节的字符串，配置示例：$string:orientation。
 **说明：**
 - 从API version 14开始，支持配置启动方向资源索引。 | 字符串 | 该标签可缺省，缺省值为unspecified。 | -| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | +| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。可在metadata字段里添加只在自由多窗下生效的配置项，详情请见metadata标签页。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | | priority | 标识当前UIAbility组件的优先级。[隐式查询](../application-models/explicit-implicit-want-mappings.md)时，优先级越高，UIAbility在返回列表越靠前。取值范围0~10，数值越大，优先级越高。
**说明：**
三方应用的配置不生效，当前配置仅在系统应用中有效。 | 整型数值 | 该标签可缺省，缺省值为0。 | | maxWindowRatio | 标识当前UIAbility组件支持的最大的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的宽高比。 | | minWindowRatio | 标识当前UIAbility组件支持的最小的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的宽高比。 | @@ -426,7 +447,7 @@ abilities示例： 该标签标识UIAbility组件或者ExtensionAbility组件能够接收的[Want](../application-models/want-overview.md)的特征。 - **表7** skills标签说明 + **表8** skills标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -437,7 +458,7 @@ abilities示例： | domainVerify | 标识是否开启域名校验。 | 布尔值 | 该标签可缺省，缺省值为false。 | - **表8** uris标签说明 + **表9** uris标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -488,7 +509,7 @@ skills示例： 描述extensionAbilities的配置信息，标签值为数组类型，该标签下的配置只对当前extensionAbilities生效。 - **表9** extensionAbilities标签说明 + **表10** extensionAbilities标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -559,7 +580,7 @@ metadata中指定shortcut信息，其中： - resource：指定shortcuts信息的资源位置。 -**表10** shortcuts标签说明 +**表11** shortcuts标签说明 | 属性名称 | 含义 | 类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -631,7 +652,7 @@ metadata中指定shortcut信息，其中： 此标签用于标识快捷方式内定义的目标wants信息集合。 -**表11** wants标签说明 +**表12** wants标签说明 | 属性名称 | 含义 | 类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -703,7 +724,7 @@ data标签示例： - **配置方式：** 该标签需要配置在/resources/base/profile资源目录下，并在metadata的resource字段中引用。 -**表12** distributionFilter标签配置说明 +**表13** distributionFilter标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -714,7 +735,7 @@ data标签示例： ### screenShape标签 -**表13** screenShape标签说明 +**表14** screenShape标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -723,7 +744,7 @@ data标签示例： ### screenWindow标签 -**表14** screenWindow标签说明 +**表15** screenWindow标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -732,7 +753,7 @@ data标签示例： ### screenDensity标签 -**表15** screenDensity标签说明 +**表16** screenDensity标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -741,7 +762,7 @@ data标签示例： ### countryCode标签 -**表16** countryCode标签说明 +**表17** countryCode标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -809,7 +830,7 @@ data标签示例： 此标签用于支持对测试框架的配置。 -**表17** testRunner标签说明 +**表18** testRunner标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -835,14 +856,14 @@ testRunner标签示例： 此标签用于支持对原子化服务的配置。此标签仅在app.json中将bundleType设置为atomicService时生效。 -**表18** atomicService标签说明 +**表19** atomicService标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | | preloads | 标识原子化服务中预加载列表。 | 对象数组 | 该标签可缺省，缺省值为空。 | -**表19** preloads标签说明 +**表20** preloads标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -869,7 +890,7 @@ atomicService标签示例： 此标签标识模块运行时依赖的共享库列表。 -**表20** dependencies标签说明 +**表21** dependencies标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | ----------- | ------------------------------ | -------- | ---------- | @@ -897,7 +918,7 @@ dependencies标签示例： 此标签标识模块提供的数据代理列表，仅限entry和feature配置。 -**表21** proxyData标签说明 +**表22** proxyData标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | ----------- | ------------------------------ | -------- | ---------- | | uri | 标识用于访问该数据代理的URI，不同的数据代理配置的URI不可重复，且需要满足`datashareproxy://当前应用包名/xxx`的格式。取值为长度不超过255字节的字符串。 | 字符串 | 该标签不可缺省。 | @@ -931,7 +952,7 @@ proxyData标签示例： routerMap配置文件描述模块的路由表信息，routerMap标签的值为数组类型。 -**表22** routerMap标签说明 +**表23** routerMap标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1039,7 +1060,7 @@ customData标签示例： 此标签标识模块配置的应用环境变量。 -**表23** appEnvironments标签说明 +**表24** appEnvironments标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1065,7 +1086,7 @@ appEnvironments标签示例： 该标签仅支持系统资源hap定义权限，不支持应用自定义权限。权限定义方式参见[系统资源权限定义](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)。 -**表24** definePermissions标签说明 +**表25** definePermissions标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1100,7 +1121,7 @@ definePermissions标签示例： 该标签标识应用包含的Native软件包信息。 -**表25** hnpPackages标签说明 +**表26** hnpPackages标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1141,7 +1162,7 @@ fileContextMenu标签示例 在开发视图的resources/base/profile下面定义配置文件menu.json，其中文件名“menu.json”可自定义，需要和fileContextMenu标签指定的信息对应。配置文件中描述了当前应用注册的右键菜单的项目和响应行为。 配置文件根节点名称为fileContextMenu，为对象数组，标识当前module注册右键菜单的数量。（单模块和单应用注册数量不能超过5个，配置超过数量当前只解析随机5个） -**表26** fileContextMenu标签配置说明 +**表27** fileContextMenu标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1150,7 +1171,7 @@ fileContextMenu标签示例 | menuHandler | 一个ability可以创建多个右键菜单， 用该字段来区分用户拉起的不同右键菜单项。该字段在用户点击右键菜单执行时，会作为参数传递给右键菜单应用。 | 字符串 | 不可缺省。 | | menuContext | 定义展示该菜单项需要的上下文，可以支持多种情况，类型为数组。 | 对象数组 | 不可缺省。 | -**表27** menuContext标签配置说明 +**表28** menuContext标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1199,7 +1220,7 @@ resources/base/profile路径下的menu.json资源文件示例如下： 应用进行右键扩展菜单注册后，在文件管理器通过右键操作拉起菜单，该菜单中会有“更多”选项。单击“更多”选项后，会出现注册后的menuItem列表，单击任意一个选项后，文件管理器默认通过startAbility的方式拉起三方应用，除了指定三方应用的包名和ability名之外，want中的parameter中，也会传入如下字段： -**表28** want中parameter字段说明 +**表29** want中parameter字段说明 | 参数名 | 值 | 类型 | | -------- | -------- | -------- | @@ -1210,7 +1231,7 @@ resources/base/profile路径下的menu.json资源文件示例如下： 该标签指向一个profile文件资源，用于指定UIAbility组件启动页面的配置文件，在开发视图的resources/base/profile下面定义配置文件start_window.json，如果配置了该字段，startWindowIcon和startWindowBackground字段将不生效。从API version 18开始，支持该字段。 -**表29** startWindow标签配置说明 +**表30** startWindow标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1252,7 +1273,7 @@ systemTheme标签示例： 在开发视图的resources/base/profile下面定义配置文件theme_config.json，其中文件名“theme_config.json”可自定义为“theme_config”开头文件名，例如"theme_config"、"theme_config_1"。需要和systemTheme标签指定的信息对应。配置文件中标识当前应用使用的系统主题。 - **表30** theme_config.json配置说明 + **表31** theme_config.json配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | -- Gitee From f103fa3b4322c5501b61d787abb193395b41a015 Mon Sep 17 00:00:00 2001 From: liuhonghao123 Date: Tue, 3 Jun 2025 14:22:07 +0800 Subject: [PATCH 2/7] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liuhonghao123 --- .../quick-start/module-configuration-file.md | 22 +++++-------------- 1 file changed, 6 insertions(+), 16 deletions(-) diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index 5ac2ee1f086..a3c41f2be9c 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -257,23 +257,13 @@ deviceTypes示例： 2. 使用metadata标签配置是否移除启动页。配置项为：name取值为enable.remove.starting.window，value取值为true或false，取值为true表示移除启动页、取值为false表示不移除启动页，未配置时默认为false。 -3. 使用metadata配置自由多窗下的SupportWindowMode。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的SupportWindowMode配置。SupportWindowMode还可以根据北向接口（StartOption和SetSupportWindowMode）来配置，北向的优先级高于module.json5。具体的优先级规格如下图所示： +3. 使用metadata配置自由多窗下的SupportWindowMode。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的SupportWindowMode配置。SupportWindowMode还可以根据接口（StartOption和SetSupportWindowMode）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下图所示： **表6** SupportWindowMode优先级规格 -| 应用模式 | 是否配置SetSupportWindowMode | 是否配置StartOption | 是否配置SupportWindowMode | 是否配置SupportWindowModeInFreeWindows | 最终生效模式 | -| -------- | -------- | -------- | -------- | -------- | -------- | -| 自由多窗模式 | 是 | 是 | 是 | 是 | SetSupportWindowMode生效 | -| 自由多窗模式 | 否 | 是 | 是 | 是 | StartOption生效 | -| 自由多窗模式 | 否 | 否 | 是 | 是 | SupportWindowModeInFreeWindow生效 | -| 自由多窗模式 | 否 | 否 | 是 | 否 | SupportWindowMode生效 | -| 自由多窗模式 | 否 | 否 | 否 | 是 | SupportWindowModeInFreeWindow生效 | -| 自由多窗模式 | 否 | 否 | 否 | 否 | 无配置项，默认所有窗口都支持 | -| 非自由多窗模式 | 是 | 是 | 是 | 是 | SetSupportWindowMode非自由多窗下无法生效，但如果是自由多窗设置后切换非自由多窗，则依然保持生效 | -| 非自由多窗模式 | 否 | 是 | 是 | 是 | StartOption非自由多窗下无法生效，但如果是自由多窗设置后切换非自由多窗，则保持生效 | -| 非自由多窗模式 | 否 | 否 | 是 | 是 | SupportWindowMode生效 | -| 非自由多窗模式 | 否 | 否 | 是 | 否 | SupportWindowMode生效 | -| 非自由多窗模式 | 否 | 否 | 否 | 是 | 按默认所有窗口都支持 | -| 非自由多窗模式 | 否 | 否 | 否 | 否 | 无配置项，默认所有窗口都支持 | +| 应用模式 | 配置优先级 | +| -------- | -------- | +| 自由多窗模式 | SetSupportWindowMode > StartOption > SupportWindowModeInFreeWindow > SupportWindowMode | +| 非自由多窗模式 | SetSupportWindowMode, StartOption与SupportWindowModeInFreeWindow均不生效，按照SupportWindowMode配置 | ```json { @@ -362,7 +352,7 @@ abilities标签描述UIAbility组件的配置信息，标签值为数组类型 | startWindowBackground | 标识当前UIAbility组件启动页面背景颜色资源文件的索引，取值为长度不超过255字节的字符串。
取值示例：$color:red。| 字符串 | 该标签不可缺省。 | | removeMissionAfterTerminate | 标识当前UIAbility组件销毁后，是否从任务列表中移除任务。
- true表示销毁后移除任务。
- false表示销毁后不移除任务。 | 布尔值 | 该标签可缺省，缺省值为false。 | | orientation | 标识当前UIAbility组件启动时的方向，支持配置枚举，或启动方向资源索引。
**启动方向枚举支持的取值如下：**
- unspecified：未指定方向，由系统自动判断显示方向。
- landscape：横屏。
- portrait：竖屏。
- follow_recent：跟随背景窗口的旋转模式。
- landscape_inverted：反向横屏。
- portrait_inverted：反向竖屏。
- auto_rotation：随传感器旋转。
- auto_rotation_landscape：传感器横屏旋转，包括横屏和反向横屏。
- auto_rotation_portrait：传感器竖屏旋转，包括竖屏和反向竖屏。
- auto_rotation_restricted：传感器开关打开，方向可随传感器旋转。
- auto_rotation_landscape_restricted：传感器开关打开，方向可随传感器旋转为横屏， 包括横屏和反向横屏。
- auto_rotation_portrait_restricted：传感器开关打开，方向随可传感器旋转为竖屏， 包括竖屏和反向竖屏。
- locked：传感器开关关闭，方向锁定。
- auto_rotation_unspecified：受开关控制和由系统判定的自动旋转模式。
- follow_desktop：跟随桌面的旋转模式。
 **配置启动方向的资源索引时**，取值为长度不超过255字节的字符串，配置示例：$string:orientation。
 **说明：**
 - 从API version 14开始，支持配置启动方向资源索引。 | 字符串 | 该标签可缺省，缺省值为unspecified。 | -| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。可在metadata字段里添加只在自由多窗下生效的配置项，详情请见metadata标签页。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | +| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。可在metadata字段里添加只在自由多窗下生效的配置项，详情请见[metadata](#metadata标签)。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | | priority | 标识当前UIAbility组件的优先级。[隐式查询](../application-models/explicit-implicit-want-mappings.md)时，优先级越高，UIAbility在返回列表越靠前。取值范围0~10，数值越大，优先级越高。
**说明：**
三方应用的配置不生效，当前配置仅在系统应用中有效。 | 整型数值 | 该标签可缺省，缺省值为0。 | | maxWindowRatio | 标识当前UIAbility组件支持的最大的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的宽高比。 | | minWindowRatio | 标识当前UIAbility组件支持的最小的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的宽高比。 | -- Gitee From 42aff06dafc86fd4d184c6be96eac909b0119336 Mon Sep 17 00:00:00 2001 From: liuhonghao123 Date: Tue, 3 Jun 2025 14:23:57 +0800 Subject: [PATCH 3/7] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liuhonghao123 --- zh-cn/application-dev/quick-start/module-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index a3c41f2be9c..c0bdf1ad2c4 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -257,7 +257,7 @@ deviceTypes示例： 2. 使用metadata标签配置是否移除启动页。配置项为：name取值为enable.remove.starting.window，value取值为true或false，取值为true表示移除启动页、取值为false表示不移除启动页，未配置时默认为false。 -3. 使用metadata配置自由多窗下的SupportWindowMode。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的SupportWindowMode配置。SupportWindowMode还可以根据接口（StartOption和SetSupportWindowMode）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下图所示： +3. 使用metadata配置自由多窗下的SupportWindowMode。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的SupportWindowMode配置。SupportWindowMode还可以根据接口（StartOption和SetSupportWindowMode）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下表所示： **表6** SupportWindowMode优先级规格 | 应用模式 | 配置优先级 | -- Gitee From 55e1ebc561bff186b40f846017e2863ae6e4f1e6 Mon Sep 17 00:00:00 2001 From: liuhonghao123 Date: Tue, 3 Jun 2025 16:51:54 +0800 Subject: [PATCH 4/7] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liuhonghao123 --- .../quick-start/module-configuration-file.md | 58 +++++++++---------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index c0bdf1ad2c4..a6d46e3e933 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -257,13 +257,13 @@ deviceTypes示例： 2. 使用metadata标签配置是否移除启动页。配置项为：name取值为enable.remove.starting.window，value取值为true或false，取值为true表示移除启动页、取值为false表示不移除启动页，未配置时默认为false。 -3. 使用metadata配置自由多窗下的SupportWindowMode。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的SupportWindowMode配置。SupportWindowMode还可以根据接口（StartOption和SetSupportWindowMode）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下表所示： +3. 使用metadata配置自由多窗（PAD中的PCMode模式）下的窗口可支持的模式。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的[SupportWindowMode](../reference/apis-ability-kit/js-apis-bundleManager.md#supportwindowmode)配置。自由多窗下窗口的可支持模式还可以根据接口（[StartOption](../reference/apis-ability-kit/js-apis-app-ability-startOptions.md#startoptions)和[SetSupportedWindowModes](../reference/apis-arkui/js-apis-window.md#setsupportedwindowmodes15)）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下表所示： - **表6** SupportWindowMode优先级规格 + **表5-1** SupportWindowMode优先级规格 | 应用模式 | 配置优先级 | | -------- | -------- | -| 自由多窗模式 | SetSupportWindowMode > StartOption > SupportWindowModeInFreeWindow > SupportWindowMode | -| 非自由多窗模式 | SetSupportWindowMode, StartOption与SupportWindowModeInFreeWindow均不生效，按照SupportWindowMode配置 | +| 自由多窗模式 | SetSupportedWindowModes > StartOption > SupportWindowModeInFreeWindow（此配置项名字） > SupportWindowMode | +| 非自由多窗模式 | SetSupportedWindowModes, StartOption与SupportWindowModeInFreeWindow均不生效，按照SupportWindowMode配置。 | ```json { @@ -331,7 +331,7 @@ deviceTypes示例： abilities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。 - **表7** abilities标签说明 + **表6** abilities标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -437,7 +437,7 @@ abilities示例： 该标签标识UIAbility组件或者ExtensionAbility组件能够接收的[Want](../application-models/want-overview.md)的特征。 - **表8** skills标签说明 + **表7** skills标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -448,7 +448,7 @@ abilities示例： | domainVerify | 标识是否开启域名校验。 | 布尔值 | 该标签可缺省，缺省值为false。 | - **表9** uris标签说明 + **表8** uris标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -499,7 +499,7 @@ skills示例： 描述extensionAbilities的配置信息，标签值为数组类型，该标签下的配置只对当前extensionAbilities生效。 - **表10** extensionAbilities标签说明 + **表9** extensionAbilities标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -570,7 +570,7 @@ metadata中指定shortcut信息，其中： - resource：指定shortcuts信息的资源位置。 -**表11** shortcuts标签说明 +**表10** shortcuts标签说明 | 属性名称 | 含义 | 类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -642,7 +642,7 @@ metadata中指定shortcut信息，其中： 此标签用于标识快捷方式内定义的目标wants信息集合。 -**表12** wants标签说明 +**表11** wants标签说明 | 属性名称 | 含义 | 类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -714,7 +714,7 @@ data标签示例： - **配置方式：** 该标签需要配置在/resources/base/profile资源目录下，并在metadata的resource字段中引用。 -**表13** distributionFilter标签配置说明 +**表12** distributionFilter标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -725,7 +725,7 @@ data标签示例： ### screenShape标签 -**表14** screenShape标签说明 +**表13** screenShape标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -734,7 +734,7 @@ data标签示例： ### screenWindow标签 -**表15** screenWindow标签说明 +**表14** screenWindow标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -743,7 +743,7 @@ data标签示例： ### screenDensity标签 -**表16** screenDensity标签说明 +**表15** screenDensity标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -752,7 +752,7 @@ data标签示例： ### countryCode标签 -**表17** countryCode标签说明 +**表16** countryCode标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -820,7 +820,7 @@ data标签示例： 此标签用于支持对测试框架的配置。 -**表18** testRunner标签说明 +**表17** testRunner标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -846,14 +846,14 @@ testRunner标签示例： 此标签用于支持对原子化服务的配置。此标签仅在app.json中将bundleType设置为atomicService时生效。 -**表19** atomicService标签说明 +**表18** atomicService标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | | preloads | 标识原子化服务中预加载列表。 | 对象数组 | 该标签可缺省，缺省值为空。 | -**表20** preloads标签说明 +**表19** preloads标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -880,7 +880,7 @@ atomicService标签示例： 此标签标识模块运行时依赖的共享库列表。 -**表21** dependencies标签说明 +**表20** dependencies标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | ----------- | ------------------------------ | -------- | ---------- | @@ -908,7 +908,7 @@ dependencies标签示例： 此标签标识模块提供的数据代理列表，仅限entry和feature配置。 -**表22** proxyData标签说明 +**表21** proxyData标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | ----------- | ------------------------------ | -------- | ---------- | | uri | 标识用于访问该数据代理的URI，不同的数据代理配置的URI不可重复，且需要满足`datashareproxy://当前应用包名/xxx`的格式。取值为长度不超过255字节的字符串。 | 字符串 | 该标签不可缺省。 | @@ -942,7 +942,7 @@ proxyData标签示例： routerMap配置文件描述模块的路由表信息，routerMap标签的值为数组类型。 -**表23** routerMap标签说明 +**表22** routerMap标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1050,7 +1050,7 @@ customData标签示例： 此标签标识模块配置的应用环境变量。 -**表24** appEnvironments标签说明 +**表23** appEnvironments标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1076,7 +1076,7 @@ appEnvironments标签示例： 该标签仅支持系统资源hap定义权限，不支持应用自定义权限。权限定义方式参见[系统资源权限定义](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)。 -**表25** definePermissions标签说明 +**表24** definePermissions标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1111,7 +1111,7 @@ definePermissions标签示例： 该标签标识应用包含的Native软件包信息。 -**表26** hnpPackages标签说明 +**表25** hnpPackages标签说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1152,7 +1152,7 @@ fileContextMenu标签示例 在开发视图的resources/base/profile下面定义配置文件menu.json，其中文件名“menu.json”可自定义，需要和fileContextMenu标签指定的信息对应。配置文件中描述了当前应用注册的右键菜单的项目和响应行为。 配置文件根节点名称为fileContextMenu，为对象数组，标识当前module注册右键菜单的数量。（单模块和单应用注册数量不能超过5个，配置超过数量当前只解析随机5个） -**表27** fileContextMenu标签配置说明 +**表26** fileContextMenu标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1161,7 +1161,7 @@ fileContextMenu标签示例 | menuHandler | 一个ability可以创建多个右键菜单， 用该字段来区分用户拉起的不同右键菜单项。该字段在用户点击右键菜单执行时，会作为参数传递给右键菜单应用。 | 字符串 | 不可缺省。 | | menuContext | 定义展示该菜单项需要的上下文，可以支持多种情况，类型为数组。 | 对象数组 | 不可缺省。 | -**表28** menuContext标签配置说明 +**表27** menuContext标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1210,7 +1210,7 @@ resources/base/profile路径下的menu.json资源文件示例如下： 应用进行右键扩展菜单注册后，在文件管理器通过右键操作拉起菜单，该菜单中会有“更多”选项。单击“更多”选项后，会出现注册后的menuItem列表，单击任意一个选项后，文件管理器默认通过startAbility的方式拉起三方应用，除了指定三方应用的包名和ability名之外，want中的parameter中，也会传入如下字段： -**表29** want中parameter字段说明 +**表28** want中parameter字段说明 | 参数名 | 值 | 类型 | | -------- | -------- | -------- | @@ -1221,7 +1221,7 @@ resources/base/profile路径下的menu.json资源文件示例如下： 该标签指向一个profile文件资源，用于指定UIAbility组件启动页面的配置文件，在开发视图的resources/base/profile下面定义配置文件start_window.json，如果配置了该字段，startWindowIcon和startWindowBackground字段将不生效。从API version 18开始，支持该字段。 -**表30** startWindow标签配置说明 +**表29** startWindow标签配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | @@ -1263,7 +1263,7 @@ systemTheme标签示例： 在开发视图的resources/base/profile下面定义配置文件theme_config.json，其中文件名“theme_config.json”可自定义为“theme_config”开头文件名，例如"theme_config"、"theme_config_1"。需要和systemTheme标签指定的信息对应。配置文件中标识当前应用使用的系统主题。 - **表31** theme_config.json配置说明 + **表30** theme_config.json配置说明 | 属性名称 | 含义 | 数据类型 | 是否可缺省 | -- Gitee From 757a2e382cd481377531e37c8d0acfd7370b86e2 Mon Sep 17 00:00:00 2001 From: liuhonghao123 Date: Tue, 3 Jun 2025 16:55:20 +0800 Subject: [PATCH 5/7] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liuhonghao123 --- zh-cn/application-dev/quick-start/module-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index a6d46e3e933..f0ca6307c8e 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -257,7 +257,7 @@ deviceTypes示例： 2. 使用metadata标签配置是否移除启动页。配置项为：name取值为enable.remove.starting.window，value取值为true或false，取值为true表示移除启动页、取值为false表示不移除启动页，未配置时默认为false。 -3. 使用metadata配置自由多窗（PAD中的PCMode模式）下的窗口可支持的模式。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的[SupportWindowMode](../reference/apis-ability-kit/js-apis-bundleManager.md#supportwindowmode)配置。自由多窗下窗口的可支持模式还可以根据接口（[StartOption](../reference/apis-ability-kit/js-apis-app-ability-startOptions.md#startoptions)和[SetSupportedWindowModes](../reference/apis-arkui/js-apis-window.md#setsupportedwindowmodes15)）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下表所示： +3. 使用metadata配置自由多窗（PAD中的PCMode模式）下的窗口可支持的模式。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。
取值为字符串，每个之间用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的[SupportWindowMode](../reference/apis-ability-kit/js-apis-bundleManager.md#supportwindowmode)配置。自由多窗下窗口的可支持模式还可以根据接口（[StartOption](../reference/apis-ability-kit/js-apis-app-ability-startOptions.md#startoptions)和[SetSupportedWindowModes](../reference/apis-arkui/js-apis-window.md#setsupportedwindowmodes15)）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下表所示： **表5-1** SupportWindowMode优先级规格 | 应用模式 | 配置优先级 | -- Gitee From d3d5f790f62b34155df68f01867aa73575041322 Mon Sep 17 00:00:00 2001 From: liuhonghao123 Date: Wed, 4 Jun 2025 17:30:40 +0800 Subject: [PATCH 6/7] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liuhonghao123 --- .../application-dev/quick-start/module-configuration-file.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index f0ca6307c8e..d2e45a57296 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -260,6 +260,7 @@ deviceTypes示例： 3. 使用metadata配置自由多窗（PAD中的PCMode模式）下的窗口可支持的模式。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。
取值为字符串，每个之间用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的[SupportWindowMode](../reference/apis-ability-kit/js-apis-bundleManager.md#supportwindowmode)配置。自由多窗下窗口的可支持模式还可以根据接口（[StartOption](../reference/apis-ability-kit/js-apis-app-ability-startOptions.md#startoptions)和[SetSupportedWindowModes](../reference/apis-arkui/js-apis-window.md#setsupportedwindowmodes15)）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下表所示： **表5-1** SupportWindowMode优先级规格 + | 应用模式 | 配置优先级 | | -------- | -------- | | 自由多窗模式 | SetSupportedWindowModes > StartOption > SupportWindowModeInFreeWindow（此配置项名字） > SupportWindowMode | @@ -317,7 +318,7 @@ deviceTypes示例： "name": "extensionAbility_metadata_2", "value": "a string test", "resource": "$profile:config_file" - }， + }, { "name": "ohos.ability.window.SupportWindowModeInFreeWindow", "value": "fullscreen,split,floating", @@ -352,7 +353,7 @@ abilities标签描述UIAbility组件的配置信息，标签值为数组类型 | startWindowBackground | 标识当前UIAbility组件启动页面背景颜色资源文件的索引，取值为长度不超过255字节的字符串。
取值示例：$color:red。| 字符串 | 该标签不可缺省。 | | removeMissionAfterTerminate | 标识当前UIAbility组件销毁后，是否从任务列表中移除任务。
- true表示销毁后移除任务。
- false表示销毁后不移除任务。 | 布尔值 | 该标签可缺省，缺省值为false。 | | orientation | 标识当前UIAbility组件启动时的方向，支持配置枚举，或启动方向资源索引。
**启动方向枚举支持的取值如下：**
- unspecified：未指定方向，由系统自动判断显示方向。
- landscape：横屏。
- portrait：竖屏。
- follow_recent：跟随背景窗口的旋转模式。
- landscape_inverted：反向横屏。
- portrait_inverted：反向竖屏。
- auto_rotation：随传感器旋转。
- auto_rotation_landscape：传感器横屏旋转，包括横屏和反向横屏。
- auto_rotation_portrait：传感器竖屏旋转，包括竖屏和反向竖屏。
- auto_rotation_restricted：传感器开关打开，方向可随传感器旋转。
- auto_rotation_landscape_restricted：传感器开关打开，方向可随传感器旋转为横屏， 包括横屏和反向横屏。
- auto_rotation_portrait_restricted：传感器开关打开，方向随可传感器旋转为竖屏， 包括竖屏和反向竖屏。
- locked：传感器开关关闭，方向锁定。
- auto_rotation_unspecified：受开关控制和由系统判定的自动旋转模式。
- follow_desktop：跟随桌面的旋转模式。
 **配置启动方向的资源索引时**，取值为长度不超过255字节的字符串，配置示例：$string:orientation。
 **说明：**
 - 从API version 14开始，支持配置启动方向资源索引。 | 字符串 | 该标签可缺省，缺省值为unspecified。 | -| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。可在metadata字段里添加只在自由多窗下生效的配置项，详情请见[metadata](#metadata标签)。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | +| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。
可在metadata字段里添加只在自由多窗下生效的配置项，详情请见[metadata](#metadata标签)。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | | priority | 标识当前UIAbility组件的优先级。[隐式查询](../application-models/explicit-implicit-want-mappings.md)时，优先级越高，UIAbility在返回列表越靠前。取值范围0~10，数值越大，优先级越高。
**说明：**
三方应用的配置不生效，当前配置仅在系统应用中有效。 | 整型数值 | 该标签可缺省，缺省值为0。 | | maxWindowRatio | 标识当前UIAbility组件支持的最大的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的宽高比。 | | minWindowRatio | 标识当前UIAbility组件支持的最小的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的宽高比。 | -- Gitee From 3a2ed73e31133851998738f9e315cc0756ba37e4 Mon Sep 17 00:00:00 2001 From: liuhonghao123 Date: Wed, 4 Jun 2025 18:27:02 +0800 Subject: [PATCH 7/7] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liuhonghao123 --- .../quick-start/module-configuration-file.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/zh-cn/application-dev/quick-start/module-configuration-file.md b/zh-cn/application-dev/quick-start/module-configuration-file.md index d2e45a57296..b7c2fd74414 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -257,14 +257,12 @@ deviceTypes示例： 2. 使用metadata标签配置是否移除启动页。配置项为：name取值为enable.remove.starting.window，value取值为true或false，取值为true表示移除启动页、取值为false表示不移除启动页，未配置时默认为false。 -3. 使用metadata配置自由多窗（PAD中的PCMode模式）下的窗口可支持的模式。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow, value取值为：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。
取值为字符串，每个之间用逗号分隔开，不区分顺序，不添加空格。未配置时按照ability字段中的[SupportWindowMode](../reference/apis-ability-kit/js-apis-bundleManager.md#supportwindowmode)配置。自由多窗下窗口的可支持模式还可以根据接口（[StartOption](../reference/apis-ability-kit/js-apis-app-ability-startOptions.md#startoptions)和[SetSupportedWindowModes](../reference/apis-arkui/js-apis-window.md#setsupportedwindowmodes15)）来配置，接口配置的优先级高于module.json5配置。具体的优先级规格如下表所示： +4. 使用metadata配置[自由多窗](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-multi-window#section118295375110)下的可支持窗口模式。配置项为：name为ohos.ability.window.SupportWindowModeInFreeWindow，value取值为：fullscreen（表示全屏模式）、split（分屏模式）、floating（表示悬浮窗模式）。value取值为字符串，可以取多种模式，每个之间用逗号分隔开，不区分顺序，不添加空格，例如：fullscreen,split。仅在平板， +PC/2in1设备上生效。 - **表5-1** SupportWindowMode优先级规格 +自由多窗下的可支持窗口模式可以采用多种方法进行配置，配置优先级为：通过[SetSupportedWindowModes](../reference/apis-arkui/js-apis-window.md#setsupportedwindowmodes15)）接口配置 > 通过StartAbility配置（[StartOption](../reference/apis-ability-kit/js-apis-app-ability-startOptions.md#startoptions)中的SupportWindowMode > 使用metadata配置 > 配置module.json5中[abilities](#abilities标签)标签下的SupportWindowMode属性。 -| 应用模式 | 配置优先级 | -| -------- | -------- | -| 自由多窗模式 | SetSupportedWindowModes > StartOption > SupportWindowModeInFreeWindow（此配置项名字） > SupportWindowMode | -| 非自由多窗模式 | SetSupportedWindowModes, StartOption与SupportWindowModeInFreeWindow均不生效，按照SupportWindowMode配置。 | +非自由多窗模式下通过[SetSupportedWindowModes](../reference/apis-arkui/js-apis-window.md#setsupportedwindowmodes15)）接口配置，通过StartAbility配置（[StartOption](../reference/apis-ability-kit/js-apis-app-ability-startOptions.md#startoptions)中的SupportWindowMode，使用metadata配置均不生效，只能通过配置module.json5中[abilities](#abilities标签)标签下的SupportWindowMode属性来配置窗口支持模式。 ```json { @@ -353,7 +351,7 @@ abilities标签描述UIAbility组件的配置信息，标签值为数组类型 | startWindowBackground | 标识当前UIAbility组件启动页面背景颜色资源文件的索引，取值为长度不超过255字节的字符串。
取值示例：$color:red。| 字符串 | 该标签不可缺省。 | | removeMissionAfterTerminate | 标识当前UIAbility组件销毁后，是否从任务列表中移除任务。
- true表示销毁后移除任务。
- false表示销毁后不移除任务。 | 布尔值 | 该标签可缺省，缺省值为false。 | | orientation | 标识当前UIAbility组件启动时的方向，支持配置枚举，或启动方向资源索引。
**启动方向枚举支持的取值如下：**
- unspecified：未指定方向，由系统自动判断显示方向。
- landscape：横屏。
- portrait：竖屏。
- follow_recent：跟随背景窗口的旋转模式。
- landscape_inverted：反向横屏。
- portrait_inverted：反向竖屏。
- auto_rotation：随传感器旋转。
- auto_rotation_landscape：传感器横屏旋转，包括横屏和反向横屏。
- auto_rotation_portrait：传感器竖屏旋转，包括竖屏和反向竖屏。
- auto_rotation_restricted：传感器开关打开，方向可随传感器旋转。
- auto_rotation_landscape_restricted：传感器开关打开，方向可随传感器旋转为横屏， 包括横屏和反向横屏。
- auto_rotation_portrait_restricted：传感器开关打开，方向随可传感器旋转为竖屏， 包括竖屏和反向竖屏。
- locked：传感器开关关闭，方向锁定。
- auto_rotation_unspecified：受开关控制和由系统判定的自动旋转模式。
- follow_desktop：跟随桌面的旋转模式。
 **配置启动方向的资源索引时**，取值为长度不超过255字节的字符串，配置示例：$string:orientation。
 **说明：**
 - 从API version 14开始，支持配置启动方向资源索引。 | 字符串 | 该标签可缺省，缺省值为unspecified。 | -| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。
可在metadata字段里添加只在自由多窗下生效的配置项，详情请见[metadata](#metadata标签)。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | +| supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。
此外，还可以通过metadata配置窗口模式，具体的配置规则和优先级请参考[metadata](#metadata标签)。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | | priority | 标识当前UIAbility组件的优先级。[隐式查询](../application-models/explicit-implicit-want-mappings.md)时，优先级越高，UIAbility在返回列表越靠前。取值范围0~10，数值越大，优先级越高。
**说明：**
三方应用的配置不生效，当前配置仅在系统应用中有效。 | 整型数值 | 该标签可缺省，缺省值为0。 | | maxWindowRatio | 标识当前UIAbility组件支持的最大的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的宽高比。 | | minWindowRatio | 标识当前UIAbility组件支持的最小的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的宽高比。 | -- Gitee