From 022526d9f6ac170cde5aadb400e8954414edad80 Mon Sep 17 00:00:00 2001 From: jiangminsen Date: Thu, 9 Jan 2025 20:04:15 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85unclearableMission=E5=AD=97?= =?UTF-8?q?=E6=AE=B5=E6=8F=8F=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: jiangminsen --- .../quick-start/module-configuration-file.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 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 24297816732..faf4828800a 100644 --- a/zh-cn/application-dev/quick-start/module-configuration-file.md +++ b/zh-cn/application-dev/quick-start/module-configuration-file.md @@ -300,16 +300,16 @@ abilities标签描述UIAbility组件的配置信息，标签值为数组类型 | 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：跟随桌面的旋转模式。 | 字符串 | 该标签可缺省，缺省值为unspecified。 | | supportWindowMode | 标识当前UIAbility组件所支持的窗口模式。支持的取值如下：
- fullscreen：全屏模式。
- split：分屏模式。
- floating：悬浮窗模式。 | 字符串数组 | 该标签可缺省，缺省值为
["fullscreen", "split", "floating"]。 | -| priority | 标识当前UIAbility组件的优先级。[隐式查询](../application-models/explicit-implicit-want-mappings.md)时，优先级越高，UIAbility在返回列表越靠前。取值范围0~10，数值越大，优先级越高。
**说明：**
仅支持系统应用配置，三方应用配置不生效。 | 整型数值 | 该标签可缺省，缺省值为0。 | +| priority | 标识当前UIAbility组件的优先级。[隐式查询](../application-models/explicit-implicit-want-mappings.md)时，优先级越高，UIAbility在返回列表越靠前。取值范围0~10，数值越大，优先级越高。
**说明：**
三方应用的配置不生效，当前配置仅在系统应用中有效。 | 整型数值 | 该标签可缺省，缺省值为0。 | | maxWindowRatio | 标识当前UIAbility组件支持的最大的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的宽高比。 | | minWindowRatio | 标识当前UIAbility组件支持的最小的宽高比。该标签最小取值为0。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的宽高比。 | | maxWindowWidth | 标识当前UIAbility组件支持的最大的窗口宽度，宽度单位为vp。
最小取值为minWindowWidth，最大取值为平台支持的最大窗口宽度。窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。 | 数值 | 该标签可缺省，缺省值为平台支持的最大的窗口宽度。 | | minWindowWidth | 标识当前UIAbility组件支持的最小的窗口宽度， 宽度单位为vp。
最小取值为平台支持的最小窗口宽度，最大取值为maxWindowWidth。窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。 | 数值 | 该标签可缺省，缺省值为平台支持的最小的窗口宽度。 | | maxWindowHeight | 标识当前UIAbility组件支持的最大的窗口高度， 高度单位为vp。
最小取值为minWindowHeight，最大取值为平台支持的最大窗口高度。 窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。| 数值 | 该标签可缺省，缺省值为平台支持的最大的窗口高度。 | | minWindowHeight | 标识当前UIAbility组件支持的最小的窗口高度， 高度单位为vp。
最小取值为平台支持的最小窗口高度，最大取值为maxWindowHeight。窗口尺寸可以参考[窗口大小限制](../windowmanager/window-overview.md#约束与限制)。| 数值 | 该标签可缺省，缺省值为平台支持的最小的窗口高度。 | -| excludeFromMissions | 标识当前UIAbility组件是否在最近任务列表中显示。
- true：表示不在任务列表中显示。
- false：表示在任务列表中显示。
**说明：**
仅支持系统应用配置，且需申请应用特权AllowAbilityExcludeFromMissions，三方应用配置不生效，详见[应用特权配置指导](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。| 布尔值 | 该标签可缺省，缺省值为false。 | +| excludeFromMissions | 标识当前UIAbility组件是否在最近任务列表中显示。
- true：表示不在任务列表中显示。
- false：表示在任务列表中显示。
**说明：**
三方应用的配置不生效，当前配置仅在系统应用中有效，若要使系统应用配置生效，需申请应用特权AllowAbilityExcludeFromMissions，详见[应用特权配置指导](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。| 布尔值 | 该标签可缺省，缺省值为false。 | | recoverable | 标识当前UIAbility组件是否支持在检测到应用故障后，恢复到应用原界面。
- true：支持检测到出现故障后，恢复到原界面。
- false：不支持检测到出现故障后，恢复到原界面。 | 布尔值 | 该标签可缺省，缺省值为false。 | -| unclearableMission | 标识当前UIAbility组件是否支持从最近任务列表中移除。
- true：表示在任务列表中不可移除。
- false：表示在任务列表中可以移除。
**说明：**
单独配置该字段不可生效，需要申请对应的[AllowMissionNotCleared](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)特权之后，该字段才能生效。 | 布尔值 | 该标签可缺省，缺省值为false。 | +| unclearableMission | 标识当前UIAbility组件是否支持从最近任务列表中移除。
- true：表示在任务列表中不可移除。
- false：表示在任务列表中可以移除。
**说明：**
三方应用的配置不生效，当前配置仅在系统应用中有效，若要使系统应用配置生效，需申请应用特权AllowMissionNotCleared，详见[应用特权配置指导](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)。 | 布尔值 | 该标签可缺省，缺省值为false。 | | isolationProcess | 标识组件能否运行在独立的进程中。
- true：表示能运行在独立的进程中。
- false：表示不能运行在独立的进程中。 | 布尔值 | 该标签可缺省，缺省值为false。 | | excludeFromDock | 标识当前UIAbility组件是否支持从dock区域隐藏图标。
- true：表示在dock区域隐藏。
- false：表示不能在dock区域隐藏。 | 布尔值 | 该标签可缺省，缺省值为false。 | | preferMultiWindowOrientation | 标识当前UIAbility组件多窗布局方向：
- default：缺省值，参数不配置默认值，建议其他应用类配置。
- portrait：多窗布局方向为竖向，建议竖向游戏类应用配置。
- landscape：多窗布局方向为横向，配置后支持横屏悬浮窗和上下分屏，建议横向游戏类应用配置。
- landscape_auto：多窗布局动态可变为横向，需要配合API enableLandScapeMultiWindow/disableLandScapeMultiWindow使用，建议视频类应用配置。 | 字符串 | 该标签可缺省，缺省值为default。 | @@ -452,7 +452,7 @@ skills示例： | description | 标识当前ExtensionAbility组件的描述，取值为长度不超过255字节的字符串，可以是对描述内容的资源索引，用于支持多语言。 | 字符串 | 该标签可缺省，缺省值为空。 | | icon | 标识当前ExtensionAbility组件的图标，取值为资源文件的索引。如果ExtensionAbility组件被配置为MainElement，该标签必须配置。 | 字符串 | 该标签可缺省，缺省值为空。 | | label | 标识当前ExtensionAbility组件对用户显示的名称，取值为该名称的资源索引，以支持多语言，字符串长度不超过255字节。如果ExtensionAbility被配置当前Module的mainElement时，该标签必须配置，且要确保应用内唯一。 | 字符串 | 该标签可缺省，缺省值为空。 | -| type | 标识当前ExtensionAbility组件的类型，支持的取值如下：
- form：卡片的ExtensionAbility。
- workScheduler：延时任务的ExtensionAbility。
- inputMethod：输入法的ExtensionAbility。
- service：后台运行的service组件。
- accessibility：辅助能力的ExtensionAbility。
- fileAccess：公共数据访问的ExtensionAbility，允许应用程序提供文件和文件夹给文件管理类应用展示。
- dataShare：数据共享的ExtensionAbility。
- staticSubscriber：静态广播的ExtensionAbility。
- wallpaper：壁纸的ExtensionAbility。
- backup：数据备份的ExtensionAbility。
- window：该ExtensionAbility会在启动过程中创建一个window，为开发者提供界面开发。开发者开发出来的界面将通过UIExtensionComponent控件组合到其他应用的窗口中。
- thumbnail：获取文件缩略图的ExtensionAbility，开发者可以对自定义文件类型的文件提供缩略。
- preview：该ExtensionAbility会将文件解析后在一个窗口中显示，开发者可以通过将此窗口组合到其他应用窗口中。
- print：打印框架的ExtensionAbility。
- push：推送的ExtensionAbility。
- driver：驱动框架的ExtensionAbility。
- remoteNotification：远程通知的ExtensionAbility。
- remoteLocation：远程定位的ExtensionAbility。
- voip：网络音视频通话的ExtensionAbility。
- action：自定义操作业务模板的ExtensionAbility，为开发者提供基于UIExtension的自定义操作业务模板。
- adsService：广告业务的ExtensionAbility，提供广告业务框架。
- embeddedUI：嵌入式UI扩展能力，提供跨进程界面嵌入的能力。
- insightIntentUI：为开发者提供能被小艺意图调用，以窗口形态呈现内容的扩展能力。
- ads：广告业务的ExtensionAbility，与AdComponent控件组合使用，将广告页面展示到其他应用中。仅支持设备厂商使用。
- photoEditor：图片编辑业务的ExtensionAbility，为开发者提供基于UIExtension的图片编辑业务模版。
- appAccountAuthorization：应用账号授权扩展能力的ExtensionAbility，用于处理账号授权请求，比如账号登录授权。
- autoFill/password：用于账号和密码自动填充业务的ExtensionAbility，支持数据的保存、填充能力。
- hms/account：应用账号管理能力的ExtensionAbility。
- sysDialog/atomicServicePanel：提供构建原子化服务服务面板的基础能力的ExtensionAbility，使用时基于UIExtensionAbility实现。
- sysDialog/userAuth：本地用户鉴权的ExtensionAbility。
- sysDialog/common：通用弹窗的ExtensionAbility。
- sysDialog/power：关机重启弹窗的ExtensionAbility。
- sysDialog/print：打印模态弹窗的ExtensionAbility。
- sysDialog/meetimeCall：畅连通话的ExtensionAbility。
- sysDialog/meetimeContact：畅连联系人的ExtensionAbility。
- sysPicker/meetimeMessage：畅连消息的ExtensionAbility。
- sysPicker/meetimeContact：畅连联系人列表的ExtensionAbility。
- sysPicker/meetimeCallLog：畅连通话记录列表的ExtensionAbility。
- sysPicker/share：系统分享的ExtensionAbility。
- sysPicker/mediaControl：投播组件的ExtensionAbility。
- sysPicker/photoPicker：三方应用通过对应的UIExtensionType拉起图库picker界面。
- sysPicker/filePicker：文件下载弹窗的ExtensionAbility。
- sysPicker/audioPicker：音频管理弹窗的ExtensionAbility。
- sysPicker/photoEditor：图片编辑弹窗的ExtensionAbility。
- sys/commonUI：非通用的ExtensionAbility，提供业务属性强相关的嵌入式显示或弹框。
- autoFill/smart：用于情景化场景自动填充业务的ExtensionAbility，支持数据的保存、填充能力。
- uiService：弹窗服务组件，在启动过程中会创建window，并支持双向通信。
- recentPhoto：最近照片推荐的ExtensionAbility。
**说明：**
其中service、adsService、sys/commonUI、fileAccess、sysDialog类型、sysPicker类型、dataShare类型和uiService类型，仅支持系统应用配置，三方应用配置不生效。 | 字符串 | 该标签不可缺省。 | +| type | 标识当前ExtensionAbility组件的类型，支持的取值如下：
- form：卡片的ExtensionAbility。
- workScheduler：延时任务的ExtensionAbility。
- inputMethod：输入法的ExtensionAbility。
- service：后台运行的service组件。
- accessibility：辅助能力的ExtensionAbility。
- fileAccess：公共数据访问的ExtensionAbility，允许应用程序提供文件和文件夹给文件管理类应用展示。
- dataShare：数据共享的ExtensionAbility。
- staticSubscriber：静态广播的ExtensionAbility。
- wallpaper：壁纸的ExtensionAbility。
- backup：数据备份的ExtensionAbility。
- window：该ExtensionAbility会在启动过程中创建一个window，为开发者提供界面开发。开发者开发出来的界面将通过UIExtensionComponent控件组合到其他应用的窗口中。
- thumbnail：获取文件缩略图的ExtensionAbility，开发者可以对自定义文件类型的文件提供缩略。
- preview：该ExtensionAbility会将文件解析后在一个窗口中显示，开发者可以通过将此窗口组合到其他应用窗口中。
- print：打印框架的ExtensionAbility。
- push：推送的ExtensionAbility。
- driver：驱动框架的ExtensionAbility。
- remoteNotification：远程通知的ExtensionAbility。
- remoteLocation：远程定位的ExtensionAbility。
- voip：网络音视频通话的ExtensionAbility。
- action：自定义操作业务模板的ExtensionAbility，为开发者提供基于UIExtension的自定义操作业务模板。
- adsService：广告业务的ExtensionAbility，提供广告业务框架。
- embeddedUI：嵌入式UI扩展能力，提供跨进程界面嵌入的能力。
- insightIntentUI：为开发者提供能被小艺意图调用，以窗口形态呈现内容的扩展能力。
- ads：广告业务的ExtensionAbility，与AdComponent控件组合使用，将广告页面展示到其他应用中。仅支持设备厂商使用。
- photoEditor：图片编辑业务的ExtensionAbility，为开发者提供基于UIExtension的图片编辑业务模版。
- appAccountAuthorization：应用账号授权扩展能力的ExtensionAbility，用于处理账号授权请求，比如账号登录授权。
- autoFill/password：用于账号和密码自动填充业务的ExtensionAbility，支持数据的保存、填充能力。
- hms/account：应用账号管理能力的ExtensionAbility。
- sysDialog/atomicServicePanel：提供构建原子化服务服务面板的基础能力的ExtensionAbility，使用时基于UIExtensionAbility实现。
- sysDialog/userAuth：本地用户鉴权的ExtensionAbility。
- sysDialog/common：通用弹窗的ExtensionAbility。
- sysDialog/power：关机重启弹窗的ExtensionAbility。
- sysDialog/print：打印模态弹窗的ExtensionAbility。
- sysDialog/meetimeCall：畅连通话的ExtensionAbility。
- sysDialog/meetimeContact：畅连联系人的ExtensionAbility。
- sysPicker/meetimeMessage：畅连消息的ExtensionAbility。
- sysPicker/meetimeContact：畅连联系人列表的ExtensionAbility。
- sysPicker/meetimeCallLog：畅连通话记录列表的ExtensionAbility。
- sysPicker/share：系统分享的ExtensionAbility。
- sysPicker/mediaControl：投播组件的ExtensionAbility。
- sysPicker/photoPicker：三方应用通过对应的UIExtensionType拉起图库picker界面。
- sysPicker/filePicker：文件下载弹窗的ExtensionAbility。
- sysPicker/audioPicker：音频管理弹窗的ExtensionAbility。
- sysPicker/photoEditor：图片编辑弹窗的ExtensionAbility。
- sys/commonUI：非通用的ExtensionAbility，提供业务属性强相关的嵌入式显示或弹框。
- autoFill/smart：用于情景化场景自动填充业务的ExtensionAbility，支持数据的保存、填充能力。
- uiService：弹窗服务组件，在启动过程中会创建window，并支持双向通信。
- recentPhoto：最近照片推荐的ExtensionAbility。
**说明：**
其中service、adsService、sys/commonUI、fileAccess、sysDialog类型、sysPicker类型、dataShare类型和uiService类型，三方应用的配置不生效，当前配置仅在系统应用中有效。 | 字符串 | 该标签不可缺省。 | | permissions | 标识当前ExtensionAbility组件自定义的权限信息。当其他应用访问该ExtensionAbility时，需要申请相应的权限信息。
一个数组元素为一个权限名称。通常采用反向域名格式（最大255字节），取值为[系统预定义的权限](../security/AccessToken/permissions-for-all.md)。 | 字符串数组 | 该标签可缺省，缺省值为空。 | | readPermission | 标识读取当前ExtensionAbility组件数据所需的权限，取值为长度不超过255字节的字符串。仅当ExtensionAbility组件的type为dataShare时支持配置该标签。 | 字符串 | 该标签可缺省，缺省值为空。 | | writePermission | 标识向当前ExtensionAbility组件写数据所需的权限，取值为长度不超过255字节的字符串。仅当ExtensionAbility组件的type为dataShare时支持配置该标签。 | 字符串 | 该标签可缺省，缺省值为空。 | -- Gitee