diff --git a/zh-cn/application-dev/application-models/widget-development-stage.md b/zh-cn/application-dev/application-models/widget-development-stage.md index b947b90e91f0d490aa366f10f54c6d53094a880a..52c7082a309b24975a7e55fd97381a500605b553 100644 --- a/zh-cn/application-dev/application-models/widget-development-stage.md +++ b/zh-cn/application-dev/application-models/widget-development-stage.md @@ -70,25 +70,25 @@ FormExtensionAbility类拥有如下API接口，具体的API介绍详见[接口 FormExtensionAbility类还拥有成员context，为FormExtensionContext类，具体的API介绍详见[接口文档](../reference/apis/js-apis-inner-application-formExtensionContext.md)。 - | 接口名 | 描述 | +| 接口名 | 描述 | | -------- | -------- | -| startAbility(want: Want, callback: AsyncCallback<void>): void | 回调形式拉起一个卡片所属应用的UIAbility（系统接口，三方应用不支持调用，需申请后台拉起权限）。 | -| startAbility(want: Want): Promise<void> | Promise形式拉起一个卡片所属应用的UIAbility（系统接口，三方应用不支持调用，需申请后台拉起权限）。 | +| startAbility(want: Want, callback: AsyncCallback<void>): void | 回调形式拉起一个卡片所属应用的UIAbility（系统接口，三方应用不支持调用，需申请后台拉起权限）。 | +| startAbility(want: Want): Promise<void> | Promise形式拉起一个卡片所属应用的UIAbility（系统接口，三方应用不支持调用，需申请后台拉起权限）。 | formProvider类有如下API接口，具体的API介绍详见[接口文档](../reference/apis/js-apis-app-form-formProvider.md)。 - | 接口名 | 描述 | +| 接口名 | 描述 | | -------- | -------- | -| setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback<void>): void; | 设置指定卡片的下一次更新时间。 | -| setFormNextRefreshTime(formId: string, minute: number): Promise<void>; | 设置指定卡片的下一次更新时间，以promise方式返回。 | -| updateForm(formId: string, formBindingData: FormBindingData, callback: AsyncCallback<void>): void; | 更新指定的卡片。 | -| updateForm(formId: string, formBindingData: FormBindingData): Promise<void>; | 更新指定的卡片，以promise方式返回。 | +| setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback<void>): void; | 设置指定卡片的下一次更新时间。 | +| setFormNextRefreshTime(formId: string, minute: number): Promise<void>; | 设置指定卡片的下一次更新时间，以promise方式返回。 | +| updateForm(formId: string, formBindingData: FormBindingData, callback: AsyncCallback<void>): void; | 更新指定的卡片。 | +| updateForm(formId: string, formBindingData: FormBindingData): Promise<void>; | 更新指定的卡片，以promise方式返回。 | formBindingData类有如下API接口，具体的API介绍详见[接口文档](../reference/apis/js-apis-app-form-formBindingData.md)。 - | 接口名 | 描述 | +| 接口名 | 描述 | | -------- | -------- | -| createFormBindingData(obj?: Object \| string): FormBindingData | 创建一个FormBindingData对象。 | +| createFormBindingData(obj?: Object \| string): FormBindingData | 创建一个FormBindingData对象。 | ## 开发步骤 @@ -208,22 +208,22 @@ Stage卡片开发，即基于[Stage模型](stage-model-development-overview.md) 2. 卡片的具体配置信息。在上述FormExtensionAbility的元信息（"metadata"配置项）中，可以指定卡片具体配置信息的资源索引。例如当resource指定为$profile:form_config时，会使用开发视图的resources/base/profile/目录下的form_config.json作为卡片profile配置文件。内部字段结构说明如下表所示。 **表1** 卡片profile配置文件 - | 属性名称 | 含义 | 数据类型 | 是否可缺省 | + | 属性名称 | 含义 | 数据类型 | 是否可缺省 | | -------- | -------- | -------- | -------- | - | name | 表示卡片的类名，字符串最大长度为127字节。 | 字符串 | 否 | - | description | 表示卡片的描述。取值可以是描述性内容，也可以是对描述性内容的资源索引，以支持多语言。字符串最大长度为255字节。 | 字符串 | 可缺省，缺省为空。 | - | src | 表示卡片对应的UI代码的完整路径。 | 字符串 | 否 | - | window | 用于定义与显示窗口相关的配置。 | 对象 | 可缺省 | - | isDefault | 表示该卡片是否为默认卡片，每个Ability有且只有一个默认卡片。
true：默认卡片。
false：非默认卡片。 | 布尔值 | 否 | - | colorMode | 表示卡片的主题样式，取值范围如下：
auto：自适应。
dark：深色主题。
light：浅色主题。 | 字符串 | 可缺省，缺省值为“auto”。 | - | supportDimensions | 表示卡片支持的外观规格，取值范围：
1 \* 2：表示1行2列的二宫格。
2 \* 2：表示2行2列的四宫格。
2 \* 4：表示2行4列的八宫格。
4 \* 4：表示4行4列的十六宫格。 | 字符串数组 | 否 | - | defaultDimension | 表示卡片的默认外观规格，取值必须在该卡片supportDimensions配置的列表中。 | 字符串 | 否 | - | updateEnabled | 表示卡片是否支持周期性刷新，取值范围：
true：表示支持周期性刷新，可以在定时刷新（updateDuration）和定点刷新（scheduledUpdateTime）两种方式任选其一，优先选择定时刷新。
false：表示不支持周期性刷新。 | 布尔类型 | 否 | - | scheduledUpdateTime | 表示卡片的定点刷新的时刻，采用24小时制，精确到分钟。
updateDuration参数优先级高于scheduledUpdateTime，两者同时配置时，以updateDuration配置的刷新时间为准。 | 字符串 | 可缺省，缺省值为“0:0”。 | - | updateDuration | 表示卡片定时刷新的更新周期，单位为30分钟，取值为自然数。
当取值为0时，表示该参数不生效。
当取值为正整数N时，表示刷新周期为30\*N分钟。
updateDuration参数优先级高于scheduledUpdateTime，两者同时配置时，以updateDuration配置的刷新时间为准。 | 数值 | 可缺省，缺省值为“0”。 | - | formConfigAbility | 表示卡片的配置跳转链接，采用URI格式。 | 字符串 | 可缺省，缺省值为空。 | - | formVisibleNotify | 标识是否允许卡片使用卡片可见性通知。 | 字符串 | 可缺省，缺省值为空。 | - | metaData | 表示卡片的自定义信息，包含customizeData数组标签。 | 对象 | 可缺省，缺省值为空。 | + | name | 表示卡片的类名，字符串最大长度为127字节。 | 字符串 | 否 | + | description | 表示卡片的描述。取值可以是描述性内容，也可以是对描述性内容的资源索引，以支持多语言。字符串最大长度为255字节。 | 字符串 | 可缺省，缺省为空。 | + | src | 表示卡片对应的UI代码的完整路径。 | 字符串 | 否 | + | window | 用于定义与显示窗口相关的配置。 | 对象 | 可缺省 | + | isDefault | 表示该卡片是否为默认卡片，每个Ability有且只有一个默认卡片。
true：默认卡片。
false：非默认卡片。 | 布尔值 | 否 | + | colorMode | 表示卡片的主题样式，取值范围如下：
auto：自适应。
dark：深色主题。
light：浅色主题。 | 字符串 | 可缺省，缺省值为“auto”。 | + | supportDimensions | 表示卡片支持的外观规格，取值范围：
1 \* 2：表示1行2列的二宫格。
2 \* 2：表示2行2列的四宫格。
2 \* 4：表示2行4列的八宫格。
4 \* 4：表示4行4列的十六宫格。 | 字符串数组 | 否 | + | defaultDimension | 表示卡片的默认外观规格，取值必须在该卡片supportDimensions配置的列表中。 | 字符串 | 否 | + | updateEnabled | 表示卡片是否支持周期性刷新，取值范围：
true：表示支持周期性刷新，可以在定时刷新（updateDuration）和定点刷新（scheduledUpdateTime）两种方式任选其一，优先选择定时刷新。
false：表示不支持周期性刷新。 | 布尔类型 | 否 | + | scheduledUpdateTime | 表示卡片的定点刷新的时刻，采用24小时制，精确到分钟。
updateDuration参数优先级高于scheduledUpdateTime，两者同时配置时，以updateDuration配置的刷新时间为准。 | 字符串 | 可缺省，缺省值为“0:0”。 | + | updateDuration | 表示卡片定时刷新的更新周期，单位为30分钟，取值为自然数。
当取值为0时，表示该参数不生效。
当取值为正整数N时，表示刷新周期为30\*N分钟。
updateDuration参数优先级高于scheduledUpdateTime，两者同时配置时，以updateDuration配置的刷新时间为准。 | 数值 | 可缺省，缺省值为“0”。 | + | formConfigAbility | 表示卡片的配置跳转链接，采用URI格式。 | 字符串 | 可缺省，缺省值为空。 | + | formVisibleNotify | 标识是否允许卡片使用卡片可见性通知。 | 字符串 | 可缺省，缺省值为空。 | + | metaData | 表示卡片的自定义信息，包含customizeData数组标签。 | 对象 | 可缺省，缺省值为空。 | 配置示例如下： @@ -452,7 +452,7 @@ onUpdateForm(formId) { ### 开发卡片事件 -卡片支持为组件设置交互事件（action），包括router事件和message事件，其中router事件用于Ability跳转，message事件用于卡片开发人员自定义点击事件。 +卡片支持为组件设置交互事件（action），包括**router**事件和**message**事件，其中router事件用于Ability跳转，message事件用于卡片开发人员自定义点击事件。 关键步骤说明如下： @@ -539,19 +539,60 @@ onUpdateForm(formId) { "action": "router", "abilityName": "EntryAbility", "params": { - "message": "add detail" + "info": "router info", + "message": "router message" } }, "messageEvent": { "action": "message", "params": { - "message": "add detail" + "detail": "message detail" } } } } ``` +- 在UIAbility中接收router事件并获取参数 + + ```ts + import UIAbility from '@ohos.app.ability.UIAbility' + + export default class EntryAbility extends UIAbility { + onCreate(want, launchParam) { + // 获取router事件中传递的info参数 + if (want.parameters.info === "router info") { + // do something + // console.log("router info:" + want.parameters.info) + } + // 获取router事件中传递的message参数 + if (want.parameters.message === "router message") { + // do something + // console.log("router message:" + want.parameters.message) + } + } + // ... + }; + ``` + +- 在FormExtensionAbility中接收message事件并获取参数 + + ```ts + import FormExtension from '@ohos.app.form.FormExtensionAbility'; + + export default class FormAbility extends FormExtension { + // ... + onFormEvent(formId, message) { + // 获取message事件中传递的detail参数 + let msg = JSON.parse(message) + if (msg.params.detail === "message detail") { + // do something + // console.log("message info:" + msg.params.detail) + } + } + // ... + }; + ``` ## 相关实例 diff --git a/zh-cn/application-dev/file-management/Readme-CN.md b/zh-cn/application-dev/file-management/Readme-CN.md index 47e1349075979f385ff99e113426886953c22e76..137b758b1584e243b863233b83831d7953f12ef5 100644 --- a/zh-cn/application-dev/file-management/Readme-CN.md +++ b/zh-cn/application-dev/file-management/Readme-CN.md @@ -6,4 +6,5 @@ - [相册资源使用指导](medialibrary-album-guidelines.md) - 文件访问框架 - - [用户公共文件访问框架概述](file-access-framework-overview.md) \ No newline at end of file + - [用户公共文件访问框架概述](file-access-framework-overview.md) +- [文件选择器使用指导](filepicker-guidelines.md) \ No newline at end of file diff --git a/zh-cn/application-dev/file-management/filepicker-guidelines.md b/zh-cn/application-dev/file-management/filepicker-guidelines.md new file mode 100644 index 0000000000000000000000000000000000000000..bdec4e17294d26049beb8d057cbe1eef490cb357 --- /dev/null +++ b/zh-cn/application-dev/file-management/filepicker-guidelines.md @@ -0,0 +1,68 @@ +# 文件选择器使用指导 + +文件选择器(FilePicker)是OpenHarmony中预置的系统应用，为用户提供文件选择及保存功能。具体实现可以参考[FilePicker代码仓库](https://gitee.com/openharmony/applications_filepicker)。 + +应用可以通过FilePicker的两种模式实现文件选择和文件保存的功能。 +- choose模式（文件选择）：当应用需要选择并上传、发送设备中的文件（包括图片、音视频等媒体资源）时，可以选择该模式。拉起FilePicker的choose模式窗口，系统将弹出弹框供用户选择具体文件。用户通过界面选择目标文件并点击“上传”按钮，应用将接收到FilePicker传回的目标文件uri。 +- save模式（文件保存）：当应用需要下载保存文件（包括图片、音视频等媒体资源）时，可以选择该模式。拉起FilePicker的save模式窗口，系统将弹出弹框供用户选择保存文件的目标路径。用户通过界面选择目标路径并点击“保存”按钮，应用将接收到FilePicker传回的已保存文件uri。 + +## 开发指导 + +> **说明：** +> FilePicker仅支持基于Stage模型开发的应用拉起。
+> Stage模型介绍请参考[应用模型解读](../application-models/application-model-description.md)。 + +使用不同的参数调用[AbilityContext.startAbilityForResult(want, options)](../reference/apis/js-apis-ability-context.md##abilitycontextstartabilityforresult-1)可以拉起FilePicker不同模式的窗口。 + +开发者需要通过[Want](../reference/apis/js-apis-application-want.md)指定"bundleName"和"abilityName"来拉起FilePicker，具体写法可参见下方的示例代码。 + +同时，开发者还需要设置属性Want.parameters，来指定FilePicker拉起的模式以及文件保存的名称： +- 文件选择：仅需要设置FilePicker拉起的窗口模式为`'startMode': 'choose'`。 +- 文件保存：除了设置FilePicker拉起的窗口模式为`'startMode': 'save'`，还需要设置文件保存名称`'saveFile'`。 + +可以通过设置类型为[StartOptions](../reference/apis/js-apis-app-ability-startOptions.md)的入参options来指定弹出窗口样式，推荐设置为`windowMode: 102`，即自由悬浮形式窗口。 + +> **注意：** +> 1. save模式下，用户保存路径根据保存文件名执行强校验，用户保存路径参考[公共目录路径支持的文件格式](medialibrary-filepath-guidelines.md)。 +> 2. 用户选择目标文件保存路径后，如存在同名文件，FilePicker将弹窗提醒用户是否覆盖原文件。 + +ArkTS语言示例代码如下： +```ts +// 拉起FilePicker选择文件 +globalThis.context.startAbilityForResult( + { + bundleName: "com.ohos.filepicker", + abilityName: "MainAbility", + parameters: { + 'startMode': 'choose', //choose or save + } + }, + { windowMode: 102 } +) + +// 拉起FilePicker保存文件 +globalThis.context.startAbilityForResult( + { + bundleName: "com.ohos.filepicker", + abilityName: "MainAbility", + parameters: { + 'startMode': 'save', //choose or save + 'saveFile': 'test.jpg', + } + }, + { windowMode: 102 } +) + +// FilePicker返回给startAbilityForResult的数据 +var abilityResult = { + resultCode: resultCode, + want: { + parameters: { + 'startMode': startMode, + 'result': result + } + } +} +globalThis.context.terminateSelfWithResult(abilityResult) +``` + diff --git a/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md index acae6ff2616be12a456941908d5df5364e7029f6..fde9e837463a5245961b1b29a0c039aa0edafb3b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-EnterpriseAdminExtensionAbility.md @@ -1,4 +1,4 @@ -# EnterpriseAdminExtensionAbility +# @ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility) 本模块提供企业管理员应用拓展能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md index 771686fc1c32393d01438c40774cc4e628ebb18e..c447a0fa845477e443aed5651d3a54dc8422011a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePath.md @@ -1,12 +1,12 @@ -# 手势路径 +# @ohos.accessibility.GesturePath (手势路径) GesturePath表示手势路径信息。 本模块用于创建辅助功能注入手势所需的手势路径信息。 ->![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > ->本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md index 2e1703d2afb51ed3c273b3a829112620231468b0..ceafa7ceb09a73285b91e751bb8f1353f0e9c8c5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-GesturePoint.md @@ -1,12 +1,12 @@ -# 手势触摸点 +# @ohos.accessibility.GesturePoint (手势触摸点) GesturePoint表示手势触摸点。 本模块用于创建辅助功能注入手势所需的手势路径的触摸点信息。 ->![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > ->本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md index 7917f7e2c06f37876d0a1fbb2fe79c336585fa00..c7ed8e0c04076f148d33bbcd71ca356bec7cf41b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility-config.md @@ -1,9 +1,10 @@ -# 系统辅助功能配置 +# @ohos.accessibility.config (系统辅助功能配置) 本模块提供系统辅助功能的配置，包括辅助扩展的启用与关闭、高对比度文字显示、鼠标键、无障碍字幕配置等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从 API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：** +> +> - 本模块首批接口从 API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块接口为系统接口。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md index 295c29b12384d03818bed31c7ff195e2c972aa1b..50128354f890d189389d269fbb347b012bee51ff 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-accessibility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-accessibility.md @@ -1,8 +1,9 @@ -# 辅助功能 +# @ohos.accessibility (辅助功能) 本模块提供辅助功能查询能力，包括获取辅助应用列表、辅助应用启用状态、无障碍字幕配置等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从 API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-appAccount.md b/zh-cn/application-dev/reference/apis/js-apis-appAccount.md index e3f6b3f53652a12a1091c8b7074afeecf7b28e62..a29e7e8ea026fa4428af8822e1a42253671989bf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-appAccount.md +++ b/zh-cn/application-dev/reference/apis/js-apis-appAccount.md @@ -1,8 +1,8 @@ -# 应用帐号管理 +# @ohos.account.appAccount (应用帐号管理) 本模块提供应用帐号信息的添加、删除、修改和查询基础能力，并支持应用间鉴权和分布式数据同步功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md index 351276ea9f1e82b7d1a54c3f44635c14d23b94a4..2804125a07b0e6406101d314360b1ec2874aadbb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md @@ -1,10 +1,10 @@ -# 辅助功能扩展能力 +# @ohos.application.AccessibilityExtensionAbility (辅助功能扩展能力) **AccessibilityExtensionAbility**基于ExtensionAbility框架，提供辅助功能业务的能力。 ->![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > ->本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 9开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-battery-info.md b/zh-cn/application-dev/reference/apis/js-apis-battery-info.md index b1d523498c284620a45524b9aef3229609804321..e1d8fcba7fcfec4f65a7071443352345e95d0850 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-battery-info.md +++ b/zh-cn/application-dev/reference/apis/js-apis-battery-info.md @@ -1,8 +1,9 @@ -# 电量信息 +# @ohos.batteryInfo (电量信息) 该模块主要提供电池状态和充放电状态的查询接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-batteryStatistics.md b/zh-cn/application-dev/reference/apis/js-apis-batteryStatistics.md index 4da0838acd44f3ef436c9b445171181936b4da9c..f5bf333d21d98990ea3ac0a3bc99e5dea16bc189 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-batteryStatistics.md +++ b/zh-cn/application-dev/reference/apis/js-apis-batteryStatistics.md @@ -1,8 +1,8 @@ -# 耗电统计 +# @ohos.batteryStatistics (耗电统计) 该模块提供软硬件耗电统计信息的查询接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > diff --git a/zh-cn/application-dev/reference/apis/js-apis-bluetooth.md b/zh-cn/application-dev/reference/apis/js-apis-bluetooth.md index 45f13ff4644336665adcd60c09d3966c8ce1ed5b..d2881854c8714b1daaa7b23a01e83744909fc750 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bluetooth.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bluetooth.md @@ -1,8 +1,9 @@ -# 蓝牙 +# @ohos.bluetooth (蓝牙) 蓝牙模块提供了基础的传统蓝牙能力以及BLE的扫描、广播等功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-brightness.md b/zh-cn/application-dev/reference/apis/js-apis-brightness.md index e9fc5ba13a49585759aa94f62b4668db60a58f30..0bb0f2e7a8a0efe584d5df24483bed020c707cfc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-brightness.md +++ b/zh-cn/application-dev/reference/apis/js-apis-brightness.md @@ -1,8 +1,8 @@ -# 屏幕亮度 +# @ohos.brightness (屏幕亮度) 该模块提供屏幕亮度的设置接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > diff --git a/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md b/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md index bdb5ff3ab5d80d383b686caa925b4033379e38bf..2793dbbefe695c08ba084227b5d871e918e64d2d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md @@ -1,8 +1,9 @@ -# 标准NFC-cardEmulation +# @ohos.nfc.cardEmulation (标准NFC-cardEmulation) 本模块主要提供NFC卡模拟业务，包括判断支持哪种卡模拟类型，HCE卡模拟的业务实现等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-configPolicy.md b/zh-cn/application-dev/reference/apis/js-apis-configPolicy.md index 043d3c5fd074fd52a97f814f18d3048848ccadcc..e904f2617981bd061076708e023b5d20e344a643 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-configPolicy.md +++ b/zh-cn/application-dev/reference/apis/js-apis-configPolicy.md @@ -1,4 +1,4 @@ -# 配置策略 +# @ohos.configPolicy (配置策略) 配置策略提供按预先定义的定制配置层级获取对应定制配置目录和文件路径的能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-connectedTag.md b/zh-cn/application-dev/reference/apis/js-apis-connectedTag.md index 1b11ce30a345346ca5526796ad4a429224315512..6664f4658af06b9c4bf6ba562ae0c1fc31b5c8a5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-connectedTag.md +++ b/zh-cn/application-dev/reference/apis/js-apis-connectedTag.md @@ -1,8 +1,9 @@ -# 有源标签 +# @ohos.connectedTag (有源标签) 本模块提供有源标签的使用，包括初始化有源标签芯片、读取有源标签内容、写入内容到有源标签等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-cooperate.md b/zh-cn/application-dev/reference/apis/js-apis-cooperate.md index 542bb7ae293ec50afccc3cf8b260524ffe215445..c9a89d39b13720a2d1e00460bf7c968552adef69 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-cooperate.md +++ b/zh-cn/application-dev/reference/apis/js-apis-cooperate.md @@ -1,4 +1,4 @@ -# 键鼠穿越 +# @ohos.multimodalInput.inputDeviceCooperate (键鼠穿越) 键鼠穿越功能模块，提供两台或多台设备组网协同后键鼠共享能力，实现键鼠输入设备的跨设备协同操作。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-device-info.md b/zh-cn/application-dev/reference/apis/js-apis-device-info.md index 2a302cf33e2e0f5e6605e468b8ddf61f1f588c66..15e04717e5e360bff9dcb9bbf9e97de030ab6a45 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-device-info.md +++ b/zh-cn/application-dev/reference/apis/js-apis-device-info.md @@ -1,8 +1,9 @@ -# 设备信息 +# @ohos.deviceInfo (设备信息) 本模块提供产品信息。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md index 366a250a73fcdf55028c4158a83def7501075911..c668a792b21145a26d8ccbbb5dae80a1f82636f3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md @@ -1,7 +1,4 @@ - - - -# 设备管理 +# @ohos.distributedHardware.deviceManager (设备管理) 本模块提供分布式设备管理能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-distributed-account.md b/zh-cn/application-dev/reference/apis/js-apis-distributed-account.md index acf2e6e6c2a74251d7f294e8ce6cb14816aea1d6..385251bb566383c332c8f10952191ef7121674f7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-distributed-account.md +++ b/zh-cn/application-dev/reference/apis/js-apis-distributed-account.md @@ -1,8 +1,8 @@ -# 分布式帐号管理 +# @ohos.account.distributedAccount (分布式帐号管理) 本模块提供管理分布式帐号的一些基础功能，主要包括查询和更新帐号登录状态。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md index 11b6b03333c8749e5118b76dc91fe31776ddd0aa..95277ddbcabcd37583ac4e6ac7e375bea329848a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md @@ -1,4 +1,4 @@ -# 企业设备管理 +# @ohos.enterprise.adminManager (企业设备管理) 本模块提供企业设备管理能力，使设备具备企业场景下所需的定制能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md index 8124d4b10ecba0d96f6e172479a0aaba52239563..7e807d81339a21f771863d0a6149e089fd18ab35 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md @@ -1,4 +1,4 @@ -# 系统时间管理 +# @ohos.enterprise.dateTimeManager (系统时间管理) 本模块提供系统时间管理能力。仅企业设备管理员应用才能调用。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md index f27db3d7b1335a523f6b017d34e3d476d35aadb3..7f8922818130aa2bfb127f9c4fd7462901f79405 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md @@ -1,4 +1,4 @@ -# 设备信息管理 +# @ohos.enterprise.deviceInfo（设备信息管理） 本模块提供企业设备信息管理能力，包括获取设备序列号等。仅企业设备管理员应用才能调用。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md b/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md index a7047eaa44a59f4346a93c86f727b652f84ec05c..4d23dcbbf40b40346096ff71db83443c53911676 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md +++ b/zh-cn/application-dev/reference/apis/js-apis-faultLogger.md @@ -1,5 +1,7 @@ -# 故障日志获取 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +# @ohos.faultLogger (故障日志获取) + +> **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md b/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md index b1b13f6f830b0995a41b268a46f6cf25c8ffa9df..6538426575e8b9012e5938a20fb0f97d63085f89 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md @@ -1,8 +1,9 @@ -# @ohos.geolocation (位置服务) +# @ohos.geoLocationManager (位置服务) 位置服务提供GNSS定位、网络定位、地理编码、逆地理编码、国家码和地理围栏等基本功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 申请权限 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hichecker.md b/zh-cn/application-dev/reference/apis/js-apis-hichecker.md index e313f50d33679e7324a72ef46aef7ae53badf860..93c400c740ac864e64e7c65119e5fbde8e1ea693 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hichecker.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hichecker.md @@ -1,8 +1,9 @@ -# 检测模式 +# @ohos.hichecker (检测模式) HiChecker可以作为应用开发阶段使用的检测工具，用于检测代码运行过程中部分易忽略的问题，如应用线程出现耗时调用、应用进程中Ability资源泄露等问题。开发者可以通过日志记录或进程crash等形式查看具体问题并进行修改，提升应用的使用体验。 > **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hidebug.md b/zh-cn/application-dev/reference/apis/js-apis-hidebug.md index 2cea5e98558c4bf7f15d2880301b2f54d95a319d..72e7c8ffa90f0f1aafb8685973b196dbb62e7ab1 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hidebug.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hidebug.md @@ -1,6 +1,7 @@ -# Debug调试 +# @ohos.hidebug (Debug调试) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 使用hidebug，可以获取应用内存的使用情况，包括应用进程的静态堆内存（native heap）信息、应用进程内存占用PSS（Proportional Set Size）信息等；可以完成虚拟机内存切片导出，虚拟机CPU Profiling采集等操作。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hilog.md b/zh-cn/application-dev/reference/apis/js-apis-hilog.md index 0339c6b52fe7b0ce20c3f2f6394451207c0098b1..b50b38ddde03dbc7770da4594a98169604d25fe7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hilog.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hilog.md @@ -1,8 +1,9 @@ -# Hilog日志打印 +# @ohos.hilog (HiLog日志打印) hilog日志系统，使应用/服务可以按照指定级别、标识和格式字符串输出日志内容，帮助开发者了解应用/服务的运行状态，更好地调试程序。 > **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hisysevent.md b/zh-cn/application-dev/reference/apis/js-apis-hisysevent.md index c847cb0731aeea326ff5e8c2a27a96c0174d5be1..b4aca61bee3cc90429b9b24a55188798d01b636c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hisysevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hisysevent.md @@ -1,8 +1,9 @@ -# 系统事件打点 +# @ohos.hiSysEvent (系统事件打点) 本模块提供了系统事件打点能力，包括系统事件的埋点、落盘系统事件的订阅及已落盘的系统事件的查询能力。 > **说明：** +> > - 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块的接口为系统接口。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hitracechain.md b/zh-cn/application-dev/reference/apis/js-apis-hitracechain.md index 65e279f0eaaf4e8aa5f208fa810dd3c101518dc6..fafe10d136c0097d078f605a1a60aa4832887e5e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hitracechain.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hitracechain.md @@ -1,8 +1,9 @@ -# 分布式跟踪 +# @ohos.hiTraceChain (分布式跟踪) 本模块提供了端侧业务流程调用链跟踪的打点能力，包括业务流程跟踪的启动、结束、信息埋点等能力。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hitracemeter.md b/zh-cn/application-dev/reference/apis/js-apis-hitracemeter.md index 489c14d8d3e154e39cf4a9802332d0df41c71047..ce5eddd3ac3a071d81fb6a7e014c73e5db6d4689 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hitracemeter.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hitracemeter.md @@ -1,8 +1,9 @@ -# 性能打点 +# @ohos.hiTraceMeter (性能打点) 本模块提供了跟踪进程轨迹，度量程序执行性能的打点能力。本模块打点的数据供hiTraceMeter工具分析使用。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md b/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md index 2c388822b6da580e6434606c7d35de39c129ce45..4be6db2fe15c1273cb9c33b1d928764ee499b345 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md @@ -1,8 +1,9 @@ -# 应用事件打点 +# @ohos.hiviewdfx.hiAppEvent (应用事件打点) 本模块提供了应用事件打点能力，包括应用事件落盘、应用事件订阅、应用事件清理、打点功能配置等功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-http.md b/zh-cn/application-dev/reference/apis/js-apis-http.md index 563969d2e2dddf968412d7adf89ff829633950d5..eaa385f4290563062b7512c7eb4115b91a9e932a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-http.md +++ b/zh-cn/application-dev/reference/apis/js-apis-http.md @@ -1,4 +1,4 @@ -# 数据请求 +# @ohos.net.http (数据请求) 本模块提供HTTP数据请求能力。应用可以通过HTTP发起一个数据请求，支持常见的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT方法。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md b/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md index fab1b1897b8cbedb85d7f8b2f8945fe69ad95f1e..f9cb9db254c41c529d36892a28c7a21495e1bf5b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inner-application-accessibilityExtensionContext.md @@ -1,4 +1,4 @@ -# 辅助功能扩展上下文 +# AccessibilityExtensionContext (辅助功能扩展上下文) AccessibilityExtensionContext是AccessibilityExtensionAbility上下文环境，继承自ExtensionContext。 @@ -7,6 +7,7 @@ AccessibilityExtensionContext是AccessibilityExtensionAbility上下文环境， > **说明：** > > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> > 本模块接口仅可在Stage模型下使用。 ## 使用说明 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md b/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md index 4d1a4d240db46e5b30fff2b762a4507c365713a1..9b73e3ce7fc3e2d0689acfb896cea239d8bae90d 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md @@ -1,4 +1,4 @@ -# 组合按键 +# @ohos.multimodalInput.inputConsumer (组合按键) 组合按键订阅模块，用于处理组合按键的订阅。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md b/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md index 735081c1a27df9b2ff17fb71474a49d6493d5df8..ea0df0dc9525b89a44279d52043503d949dee910 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputdevice.md @@ -1,4 +1,4 @@ -# 输入设备 +# @ohos.multimodalInput.inputDevice (输入设备) 输入设备管理模块，用于监听输入设备连接和断开状态，查询输入设备相关信息。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputevent.md b/zh-cn/application-dev/reference/apis/js-apis-inputevent.md index b5367dcf090ca6bd422caf60d30d66d2b3a289fb..6ceb41d000dc90b95a441fe892d1d3db73e0dbb8 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-inputevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputevent.md @@ -1,8 +1,9 @@ -# 输入事件 +# @ohos.multimodalInput.inputEvent (输入事件) 设备上报的基本事件。 > **说明：** +> > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputeventclient.md b/zh-cn/application-dev/reference/apis/js-apis-inputeventclient.md index ece2f547946caf39c6f00a1135093b6c70d5a6c8..e5f61c963a42b5d54ab860dd724e9e0111dfef09 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-inputeventclient.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputeventclient.md @@ -1,4 +1,4 @@ -# 按键注入 +# @ohos.multimodalInput.inputEventClient (按键注入) 按键注入模块，提供按键注入能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md index 88f282884bd1da208150fbab7d73d4e2d165bac9..527d1a60df24371594e5f5bf01fbecb3c48f856a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-ability.md @@ -1,4 +1,4 @@ -# InputMethodExtensionAbility +# @ohos.inputmethodextensionability (InputMethodExtensionAbility) 开发者可通过继承本模块开发自己的输入法应用并管理输入法应用生命周期。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md index acd2a268fdec54a7e82e531b5345c25a1d62bf0f..646be644ca57e8108f13423d633b3976cb1c3bba 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-extension-context.md @@ -1,4 +1,4 @@ -# InputMethodExtensionContext +# @ohos.inputmethodextensioncontext (InputMethodExtensionContext) InputMethodExtensionContext模块是InputMethodExtensionAbility的上下文环境，继承自ExtensionContext。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md index 4a8d449923d60fac4b44b8313d33f3349ed2b4c3..86e674a0ea5d2d2175b333399f8966b9099daa1b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod-subtype.md @@ -1,4 +1,4 @@ -# 输入法子类型 +# @ohos.inputmethodsubtype (输入法子类型) 本模块提供对输入法子类型的属性管理。输入法应用子类型的含义，如：输入法的中文版、英文版、大写模式、小写模式等都属于输入法的子类型。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md index 7442c05d9062d1d6d83207f90ad860bfe1b170b9..b90aad2e46f49e5a6fa0ff418ead83dff70d5151 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md @@ -1,15 +1,15 @@ -# 输入法框架 +# @ohos.inputmethod (输入法框架) 本模块提供对输入法框架的管理，包括隐藏输入法、查询已安装的输入法列表和显示输入法选择对话框。 ->**说明：** +> **说明：** > ->本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 -``` +```js import inputMethod from '@ohos.inputmethod'; ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md index 52a0b3f5b93fe1c7ff35bbfd328f5dde8e96b23c..4e3d0d703b9bf0a10af12938b76ac25d3f70a089 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md @@ -1,4 +1,4 @@ -# 输入法服务 +# @ohos.inputmethodengine (输入法服务) 本模块的作用是拉通输入法应用和其他三方应用（联系人、微信等），功能包括：将三方应用与输入法应用的服务进行绑定、三方应用通过输入法应用进行文本输入、三方应用对输入法应用进行显示键盘请求和隐藏键盘请求、三方应用对输入法应用当前状态进行监听等。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md b/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md index d4ecfb44e1cb7da6e78cf86e0228ee9bfea5557f..f468d074b60f335a26b272c40f1c15ce0fa8ac02 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md @@ -1,4 +1,4 @@ -# 输入监听 +# @ohos.multimodalInput.inputMonitor (输入监听) 输入监听模块，提供了监听输入设备事件（当前支持触摸屏和鼠标）的能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-keycode.md b/zh-cn/application-dev/reference/apis/js-apis-keycode.md index 95ee341fe264b996c7e9d147b678f95af54451f3..f8103076c4063ecf013b749ad83c8924660a8349 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-keycode.md +++ b/zh-cn/application-dev/reference/apis/js-apis-keycode.md @@ -1,4 +1,4 @@ -# 键值 +# @ohos.multimodalInput.keyCode (键值) 按键设备键值。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-keyevent.md b/zh-cn/application-dev/reference/apis/js-apis-keyevent.md index 84d3df2187cd6cad52fb94b118bb07b5c5689c8e..a58d298f586b81012b18c90a7eafe30accad6f81 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-keyevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-keyevent.md @@ -1,4 +1,4 @@ -# 按键输入事件 +# @ohos.multimodalInput.keyEvent (按键输入事件) 设备上报的按键事件。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-logs.md b/zh-cn/application-dev/reference/apis/js-apis-logs.md index 81203760b52838389b008cae779e23116380bff7..40213556ac95c072d5b85679700734315d2e9470 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-logs.md +++ b/zh-cn/application-dev/reference/apis/js-apis-logs.md @@ -1,4 +1,4 @@ -# 日志打印 +# console (日志打印) 本模块提供基础的日志打印能力，支持按照日志级别打印日志信息。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-mouseevent.md b/zh-cn/application-dev/reference/apis/js-apis-mouseevent.md index 9463c4c7c48a5dcc99ea78b7411510fe9a62f056..2b99f26abd110a15627dc3fd99e16bd86ed1eb1a 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-mouseevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-mouseevent.md @@ -1,8 +1,9 @@ -# 鼠标输入事件 +# @ohos.multimodalInput.mouseEvent (鼠标输入事件) 设备上报的鼠标事件。 > **说明：** +> > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-net-connection.md b/zh-cn/application-dev/reference/apis/js-apis-net-connection.md index f64a19f131c68ca1bae5cafecafabad6d257cd69..4b02345124af20ab8459506ad3ff72bb1e7d9edb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-net-connection.md +++ b/zh-cn/application-dev/reference/apis/js-apis-net-connection.md @@ -1,4 +1,4 @@ -# 网络连接管理 +# @ohos.net.connection (网络连接管理) 网络连接管理提供管理网络一些基础能力，包括获取默认激活的数据网络、获取所有激活数据网络列表、开启关闭飞行模式、获取网络能力信息等功能。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md b/zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md index cf6984bcdd0743d3e8d57dbc9f9c8c8919615671..a451b5cf79e0c7ee25f77d7432e110173799442c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md +++ b/zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md @@ -1,4 +1,4 @@ -# 以太网连接管理 +# @ohos.net.ethernet (以太网连接管理) 以太网连接管理主要提供有线网络能力，提供设置有线网络的IP地址，子网掩码，网关，DNS等信息 diff --git a/zh-cn/application-dev/reference/apis/js-apis-net-sharing.md b/zh-cn/application-dev/reference/apis/js-apis-net-sharing.md index 89c93f3517458ae22b4ab31358a957d64a62a27a..cefbc4d648d85cb95de3f56f8bfd010f3384d366 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-net-sharing.md +++ b/zh-cn/application-dev/reference/apis/js-apis-net-sharing.md @@ -1,4 +1,4 @@ -# 网络共享管理 +# @ohos.net.sharing (网络共享管理) 网络共享管理分享设备已有网络给其他连接设备，支持Wi-Fi热点共享和蓝牙共享，同时提供网络共享状态、共享流量查询功能。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-nfcController.md b/zh-cn/application-dev/reference/apis/js-apis-nfcController.md index a92b7985ca68352e76d54977c376c27f30a109d9..a82e48c76e80342f10ce9ee42bfcd2852fc09d34 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-nfcController.md +++ b/zh-cn/application-dev/reference/apis/js-apis-nfcController.md @@ -1,8 +1,9 @@ -# 标准NFC +# @ohos.nfc.controller (标准NFC) 本模块主要用于管理NFC状态，包括打开和关闭NFC，读取NFC的状态等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## **导入模块** diff --git a/zh-cn/application-dev/reference/apis/js-apis-nfcTag.md b/zh-cn/application-dev/reference/apis/js-apis-nfcTag.md index ab5a3f3c0b74fdc967f65979741acf7eff8ea39e..cece44bd98f9b40ac788e14a52ad3cad0ec28191 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-nfcTag.md +++ b/zh-cn/application-dev/reference/apis/js-apis-nfcTag.md @@ -1,8 +1,9 @@ -# 标准NFC-Tag +# @ohos.nfc.tag (标准NFC-Tag) 本模块主要用于操作及管理NFC Tag。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## **声明技术** diff --git a/zh-cn/application-dev/reference/apis/js-apis-nfctech.md b/zh-cn/application-dev/reference/apis/js-apis-nfctech.md index edef70f1fa42b27b4b32ebfa4c43385ac886afff..444338ea5a20fac7275cfda11a89524991897188 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-nfctech.md +++ b/zh-cn/application-dev/reference/apis/js-apis-nfctech.md @@ -1,11 +1,12 @@ -# 标准NFC-Tag Nfc 技术 +# nfctech (标准NFC-Tag Nfc 技术) 本模块主要用于采用不同Nfc技术的Tag的读写操作。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -## **导入模块** +## 导入模块 ```js import tag from '@ohos.nfc.tag'; diff --git a/zh-cn/application-dev/reference/apis/js-apis-osAccount.md b/zh-cn/application-dev/reference/apis/js-apis-osAccount.md index 0c96d65afaa556a857249238480120fd5f1fcd4d..d52394cb303aec35d08749d8ec9f96191e3e6110 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-osAccount.md +++ b/zh-cn/application-dev/reference/apis/js-apis-osAccount.md @@ -1,8 +1,9 @@ -# 系统帐号管理 +# @ohos.account.osAccount (系统帐号管理) 本模块提供管理系统帐号的基础能力，包括系统帐号的添加、删除、查询、设置、订阅、启动等功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -4243,7 +4244,7 @@ cancelAuth(contextID: Uint8Array): void; ## PINAuth8+ -Pin码认证功能基类。 +PIN码认证基类。 **系统接口：** 此接口为系统接口。 @@ -4251,7 +4252,7 @@ Pin码认证功能基类。 constructor() -创建Pin码认证的实例。 +创建PIN码认证的实例。 **系统接口：** 此接口为系统接口。 @@ -4280,17 +4281,12 @@ registerInputer(inputer: IInputer): void; | ----------| ----------------------- | --- | -------------------------- | | inputer | [IInputer](#iinputer8) | 是 | PIN码输入器，用于获取PIN码。 | -**返回值：** - -| 类型 | 说明 | -| :------ | :-------------------------------------------- | -| boolean | 返回布尔值，true表示注册成功，false表示注册失败。 | - **错误码：** | 错误码ID | 错误信息 | | -------- | --------------------------- | | 12300001 | System service exception. | +| 12300102 | Invalid inputer. | | 12300103 | Inputer already registered. | **示例：** @@ -4299,8 +4295,8 @@ registerInputer(inputer: IInputer): void; let password = new Uint8Array([0, 0, 0, 0, 0]); try { let result = pinAuth.registerInputer({ - onGetData: (pinSubType, callback) => { - callback.onSetData(pinSubType, password); + onGetData: (authSubType, callback) => { + callback.onSetData(authSubType, password); } }); console.log('registerInputer result = ' + result); @@ -4327,6 +4323,91 @@ unregisterInputer(): void; pinAuth.unregisterInputer(); ``` +### InputerManager 10+ + +凭据输入管理器。 + +### registerInputer10+ + +registerInputer(authType: AuthType, inputer: IInputer): void; + +注册凭据输入器。 + +**系统接口：** 此接口为系统接口。 + +**系统能力：** SystemCapability.Account.OsAccount + +**需要权限：** ohos.permission.ACCESS_USER_AUTH_INTERNAL 或 ohos.permission.MANAGE_USER_IDM + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----------| ----------------------- | --- | -------------------------- | +| authType | [AuthType](#authtype8) | 是 | 认证类型。 | +| inputer | [IInputer](#iinputer8) | 是 | 凭据输入器，用于获取凭据。 | + +**错误码：** + +| 错误码ID | 错误信息 | +| -------- | --------------------------- | +| 12300001 | System service exception. | +| 12300102 | Invalid authType or inputer. | +| 12300103 | The credential inputer has been registered. | +| 12300106 | Unsupported authType. | + +**示例：** + ```js + let inputerMgr = new account_osAccount.InputerManager(); + let authType = account_osAccount.AuthType.DOMAIN; + let password = new Uint8Array([0, 0, 0, 0, 0]); + try { + InputerMgr.registerInputer(authType, { + onGetData: (authSubType, callback) => { + callback.onSetData(authSubType, password); + } + }); + console.log('registerInputer success.'); + } catch (e) { + console.log('registerInputer exception = ' + JSON.stringify(e)); + } + ``` + +### unregisterInputer10+ + +unregisterInputer(authType: AuthType): void; + +解注册凭据输入器。 + +**系统接口：** 此接口为系统接口。 + +**系统能力：** SystemCapability.Account.OsAccount + +**需要权限：** ohos.permission.ACCESS_USER_AUTH_INTERNAL 或 ohos.permission.MANAGE_USER_IDM + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----------| ----------------------- | --- | -------------------------- | +| authType | [AuthType](#authtype8) | 是 | 认证类型。 | + +**错误码：** + +| 错误码ID | 错误信息 | +| -------- | --------------------------- | +| 12300002 | Invalid authType. | + +**示例：** + ```js + let inputerMgr = new account_osAccount.InputerManager(); + let authType = account_osAccount.AuthType.DOMAIN; + try { + inputerMgr.unregisterInputer(authType); + console.log('unregisterInputer success.'); + } catch(err) { + console.log("unregisterInputer err:" + JSON.stringify(err)); + } + ``` + ## UserIdentityManager8+ 获取用户身份管理类。 @@ -4456,8 +4537,8 @@ addCredential(credentialInfo: CredentialInfo, callback: IIdmCallback): void; let password = new Uint8Array([0, 0, 0, 0, 0, 0]); let pinAuth = new account_osAccount.PINAuth(); pinAuth.registerInputer({ - onGetData: (pinSubType, callback) => { - callback.onSetData(pinSubType, password); + onGetData: (authSubType, callback) => { + callback.onSetData(authSubType, password); } }); let credentialInfo = { @@ -4470,12 +4551,12 @@ addCredential(credentialInfo: CredentialInfo, callback: IIdmCallback): void; try { userIDM.addCredential(credentialInfo, { onResult: (result, extraInfo) => { - console.log('updateCredential result = ' + result); - console.log('updateCredential extraInfo = ' + extraInfo); + console.log('addCredential result = ' + result); + console.log('addCredential extraInfo = ' + extraInfo); } }); } catch (e) { - console.log('updateCredential exception = ' + JSON.stringify(e)); + console.log('addCredential exception = ' + JSON.stringify(e)); } }); ``` @@ -4520,8 +4601,8 @@ updateCredential(credentialInfo: CredentialInfo, callback: IIdmCallback): void; token: null }; pinAuth.registerInputer({ - onGetData: (pinSubType, callback) => { - callback.onSetData(pinSubType, password); + onGetData: (authSubType, callback) => { + callback.onSetData(authSubType, password); } }); userIDM.openSession((err, challenge) => { @@ -4820,7 +4901,7 @@ getAuthInfo(authType?: AuthType): Promise<Array<EnrolledCredInfo>>; ### onSetData8+ -onSetData: (pinSubType: AuthSubType, data: Uint8Array) => void; +onSetData: (authSubType: AuthSubType, data: Uint8Array) => void; **系统接口：** 此接口为系统接口。 @@ -4832,7 +4913,7 @@ onSetData: (pinSubType: AuthSubType, data: Uint8Array) => void; | 参数名 | 类型 | 必填 | 说明 | | ---------- | ---------------------------------------- | ---- | ----------------------------------------------- | -| pinSubType | [AuthSubType](#authsubtype8) | 是 | 用于认证的凭据子类型。 | +| authSubType | [AuthSubType](#authsubtype8) | 是 | 用于认证的凭据子类型。 | | data | Uint8Array | 是 | 要设置的数据是凭据，用来在认证、添加、修改凭据操作。 | **示例：** @@ -4840,11 +4921,11 @@ onSetData: (pinSubType: AuthSubType, data: Uint8Array) => void; let password = new Uint8Array([0, 0, 0, 0, 0, 0]); let passwordNumber = new Uint8Array([1, 2, 3, 4]); let inputer = { - onGetData: (pinSubType, callback) => { - if (pinSubType == account_osAccount.AuthSubType.PIN_NUMBER) { - callback.onSetData(pinSubType, passwordNumber); + onGetData: (authSubType, callback) => { + if (authSubType == account_osAccount.AuthSubType.PIN_NUMBER) { + callback.onSetData(authSubType, passwordNumber); } else { - callback.onSetData(pinSubType, password); + callback.onSetData(authSubType, password); } } }; @@ -4852,13 +4933,13 @@ onSetData: (pinSubType: AuthSubType, data: Uint8Array) => void; ## IInputer8+ -密码输入框回调。 +凭据输入器回调。 **系统接口：** 此接口为系统接口。 ### onGetData8+ -onGetData: (pinSubType: AuthSubType, callback: IInputData) => void; +onGetData: (authSubType: AuthSubType, callback: IInputData) => void; 通知获取数据。 @@ -4877,11 +4958,11 @@ onGetData: (pinSubType: AuthSubType, callback: IInputData) => void; let password = new Uint8Array([0, 0, 0, 0, 0, 0]); let passwordNumber = new Uint8Array([1, 2, 3, 4]); let inputer = { - onGetData: (pinSubType, callback) => { - if (pinSubType == account_osAccount.AuthSubType.PIN_NUMBER) { - callback.onSetData(pinSubType, passwordNumber); + onGetData: (authSubType, callback) => { + if (authSubType == account_osAccount.AuthSubType.PIN_NUMBER) { + callback.onSetData(authSubType, passwordNumber); } else { - callback.onSetData(pinSubType, password); + callback.onSetData(authSubType, password); } } }; @@ -5155,8 +5236,10 @@ onAcquireInfo?: (module: number, acquire: number, extraInfo: any) => void; | 名称 | 值 | 说明 | | ----- | ----- | ---------------- | -| PIN | 1 | 指示PIN认证类型。 | -| FACE | 2 | 指示脸部认证类型。| +| PIN | 1 | 表示PIN认证类型。 | +| FACE | 2 | 表示脸部认证类型。| +| FINGERPRINT10+ | 4 | 表示指纹认证类型。 | +| DOMAIN10+ | 1024 | 表示域认证类型。| ## AuthSubType8+ @@ -5171,8 +5254,9 @@ onAcquireInfo?: (module: number, acquire: number, extraInfo: any) => void; | PIN_SIX | 10000 | 表示6位凭证。 | | PIN_NUMBER | 10001 | 表示自定义数字凭证。 | | PIN_MIXED | 10002 | 表示自定义混合凭据。 | -| FACE_2D | 20000 | 指示2D 人脸凭证。 | -| FACE_3D | 20001 | 指示3D 人脸凭证。 | +| FACE_2D | 20000 | 表示2D 人脸凭证。 | +| FACE_3D | 20001 | 表示3D 人脸凭证。 | +| DOMAIN_MIXED10+ | 10240001 | 表示域认证混合凭证。 | ## AuthTrustLevel8+ diff --git a/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md b/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md index 388f40c50da9d442080399d66958ec6d8974e3f4..624f50e880f490b2d1094edb27de490c2ce2831e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md +++ b/zh-cn/application-dev/reference/apis/js-apis-pasteboard.md @@ -1,4 +1,4 @@ -# 剪贴板 +# @ohos.pasteboard (剪贴板) 本模块主要提供管理系统剪贴板的能力，为系统复制、粘贴功能提供支持。系统剪贴板支持对文本、HTML、URI、Want、PixelMap等内容的操作。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-pointer.md b/zh-cn/application-dev/reference/apis/js-apis-pointer.md index bdf9798367a6a8adc26194e6bb8a6099494afcfd..97eac7d233ccd4b8cafe3b9ec017b83a3db4aa7c 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-pointer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-pointer.md @@ -1,4 +1,4 @@ -# 鼠标指针 +# @ohos.multimodalInput.pointer (鼠标指针) 鼠标指针管理模块，用于查询和设置鼠标指针相关属性。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-power.md b/zh-cn/application-dev/reference/apis/js-apis-power.md index a81b2441e8f86dbcea710028c0b48fe3a856b76a..909943c3cf005386afe220264ed60c352ddce977 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-power.md +++ b/zh-cn/application-dev/reference/apis/js-apis-power.md @@ -1,8 +1,9 @@ -# 系统电源管理 +# @ohos.power (系统电源管理) 该模块主要提供重启、关机、查询屏幕状态等接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-request.md b/zh-cn/application-dev/reference/apis/js-apis-request.md index 7ec6ecc8b274a97d069e5c4e8c7d2f17ea2b4f5a..a5a32d023b09a8e137e1576bde9aadcd59b512d3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-request.md +++ b/zh-cn/application-dev/reference/apis/js-apis-request.md @@ -1,8 +1,9 @@ -# 上传下载 +# @ohos.request (上传下载) request部件主要给应用提供上传下载文件、后台传输代理的基础能力。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -336,7 +337,8 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback<Up ## UploadTask -上传任务，使用下列方法前，需要先获取UploadTask对象。 +上传任务，使用下列方法前，需要先获取UploadTask对象，promise形式通过[request.uploadFile9+](#requestuploadfile9)获取，callback形式通过[request.uploadFile9+](#requestuploadfile9-1)获取。 + ### on('progress') @@ -968,7 +970,7 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l ## DownloadTask -下载任务。 +下载任务，使用下列方法前，需要先获取DownloadTask对象，promise形式通过[request.downloadFile9+](#requestdownloadfile9)获取，callback形式通过[request.downloadFile9+](#requestdownloadfile9-1)获取。 ### on('progress') diff --git a/zh-cn/application-dev/reference/apis/js-apis-rpc.md b/zh-cn/application-dev/reference/apis/js-apis-rpc.md index baf8da63bead247f7f1b146fcc9a8a6d167f690e..d9f72bcd6e82743f3eef5999f8a671b6e1baee83 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-rpc.md +++ b/zh-cn/application-dev/reference/apis/js-apis-rpc.md @@ -1,9 +1,11 @@ -# RPC通信 +# @ohos.rpc (RPC通信) 本模块提供进程间通信能力，包括设备内的进程间通信（IPC）和设备间的进程间通信（RPC），前者基于Binder驱动，后者基于软总线驱动。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> > 本模块从API version 9开始支持异常返回功能。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-runninglock.md b/zh-cn/application-dev/reference/apis/js-apis-runninglock.md index e09d33cb12f728983f456c9d09383d590a8bd756..0b437ab72dc03d20ec322c57d4c438f2e206c401 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-runninglock.md +++ b/zh-cn/application-dev/reference/apis/js-apis-runninglock.md @@ -1,8 +1,9 @@ -# RunningLock锁 +# @ohos.runningLock (Runninglock锁) 该模块主要提供RunningLock锁相关操作的接口，包括创建、查询、持锁、释放锁等操作。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-screen-lock.md b/zh-cn/application-dev/reference/apis/js-apis-screen-lock.md index adc8024bf8ba6bf4729df7906375a3e4ea74ae32..dccb386087983845b58358b549f0c769d5981689 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-screen-lock.md +++ b/zh-cn/application-dev/reference/apis/js-apis-screen-lock.md @@ -1,4 +1,4 @@ -# 锁屏管理 +# @ohos.screenLock (锁屏管理) 锁屏管理服务是OpenHarmony中的系统服务，为锁屏应用提供注册亮屏、灭屏、开启屏幕、结束休眠、退出动画、请求解锁结果监听，并提供回调结果给锁屏应用。锁屏管理服务向三方应用提供请求解锁、查询锁屏状态、查询是否设置锁屏密码的能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-sensor.md b/zh-cn/application-dev/reference/apis/js-apis-sensor.md index 4bbe3ce2628956bf4a449314ab9a267252750e83..7ff2b1e66fbeeb4b84fc35c88bbb52a2031a6a69 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sensor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sensor.md @@ -1,8 +1,9 @@ -# 传感器 +# @ohos.sensor (传感器) sensor模块提供了获取传感器数据的能力，包括获取传感器属性列表，订阅传感器数据，以及一些通用的传感器算法。 > **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-settings.md b/zh-cn/application-dev/reference/apis/js-apis-settings.md index d91045fa561e3c9d1792d0b10e54effef57628c1..1fd15c0f09c8801a2b822ac7778643cb117f5ff4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-settings.md +++ b/zh-cn/application-dev/reference/apis/js-apis-settings.md @@ -1,4 +1,4 @@ -# 设置数据项名称 +# @ohos.settings (设置数据项名称) 本模块提供访问设置数据项的能力。 @@ -35,8 +35,6 @@ import settings from '@ohos.settings'; **系统能力：** SystemCapability.Applications.settings.Core - - | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | | FONT_SCALE | string | 是 | 是 | 字体的比例因子，值为浮点数。 | @@ -187,112 +185,9 @@ import settings from '@ohos.settings'; | WIFI_STATUS | string | 是 | 是 | Wi-Fi是否可用。
值为true表示Wi-Fi可用；
值为false表示Wi-Fi不可用。 | | WIFI_WATCHDOG_STATUS | string | 是 | 是 | Wi-Fi的WatchDog是否可用。
值为true表示可用；
值为false表示不可用。 | -## settings.enableAirplaneMode - -enableAirplaneMode(enable: boolean, callback: AsyncCallback\): void - -启用或禁用飞行模式。使用callback异步回调。 - -**系统能力**：SystemCapability.Applications.settings.Core - -**参数**： - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------------------- | ---- | ----------------------------------------------- | -| enable | boolean | 是 | 是否开启飞行模式。true表示开启，false表示禁用。 | -| callback | AsyncCallback\ | 是 | 回调函数。 | - -**示例**： - -```js -let isEnabled = true; -settings.enableAirplaneMode(isEnabled, (err) => { - if (err) { - console.log('Failed to enable AirplaneMode.'); - return; - } - console.log('Return true if enable.'); -}) -``` - -## settings.enableAirplaneMode - -enableAirplaneMode(enable: boolean): Promise\ - -启用或禁用飞行模式。使用Promise异步回调。 - -**系统能力**：SystemCapability.Applications.settings.Core - -**参数**： - -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------- | ---- | ----------------------------------------------- | -| enable | boolean | 是 | 是否开启飞行模式。true表示开启，false表示禁用。 | - -**返回值**： - -| 类型 | 说明 | -| -------------- | ------------------------- | -| Promise\ | 无返回结果的Promise对象。 | - -**示例**： - -```js -let isEnabled = true; -settings.enableAirplaneMode(isEnabled).then(() => { - console.log('Succeeded in enabling AirplaneMode.'); -}).catch((err) => { - console.log(`Failed to enable AirplaneMode. Cause: ${err}`); -}) -``` - -## settings.canShowFloating - -canShowFloating(callback: AsyncCallback\): void - -检查应用是否能够以悬浮窗形式显示。使用callback异步回调。 - -**系统能力**：SystemCapability.Applications.settings.Core - -**参数**： - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ----------------------- | ---- | ------------------------------------------------------------ | -| callback | AsyncCallback\ | 是 | 回调函数。
返回true，表示应用能够以悬浮窗形式显示；返回false，则表示不能。 | - -**示例**： - -```js -settings.canShowFloating((result) => { - console.log('Checks whether a specified application can show as float window.'); -}); -``` - -## settings.canShowFloating - -canShowFloating(): Promise\ - -检查应用是否能够以悬浮窗形式显示。使用Promise异步回调。 - -**系统能力**：SystemCapability.Applications.settings.Core - -**返回值**： - -| 类型 | 说明 | -| ----------------- | ------------------------------------------------------------ | -| Promise\ | Promise对象。
返回true，表示应用能够以悬浮窗形式显示；返回false，则表示不能。 | - -**示例**： - -```js -settings.canShowFloating().then((result) => { - console.log('Checks whether a specified application can show as float window.'); -}); -``` - ## setting.getURI -getURI(name: string, callback: AsyncCallback\): void +getURI(name: string, callback: AsyncCallback\): void 获取数据项的URI。使用callback异步回调。 @@ -303,7 +198,7 @@ getURI(name: string, callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------- | ---- | ------------------------------------------------------------ | | name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| callback | AsyncCallback\ | 是 | 回调函数。获取数据项的URI。 | +| callback | AsyncCallback\ | 是 | 回调函数。获取数据项的URI。 | **示例**： @@ -315,7 +210,7 @@ settings.getURI(settings.display.SCREEN_BRIGHTNESS_STATUS, (uri) => { ## setting.getURI -getURI(name: string): Promise\ +getURI(name: string): Promise\ 获取数据项的URI。使用Promise异步回调。 @@ -331,7 +226,7 @@ getURI(name: string): Promise\ | 类型 | 说明 | | ---------------- | ------------------------------------ | -| Promise\ | Promise对象。返回获取的数据项的URI。 | +| Promise\ | Promise对象。返回获取的数据项的URI。 | **示例**： @@ -341,55 +236,30 @@ settings.getURI(settings.display.SCREEN_BRIGHTNESS_STATUS).then((uri) => { }) ``` -## settings.getUriSync8+ - -getUriSync(name: string): string - -获取数据项的URI。 - -**系统能力**：SystemCapability.Applications.settings.Core - -**参数**： - -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------ | ---- | ------------------------------------------------------------ | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | - -**返回值**： - -| 类型 | 说明 | -| ------ | ------------- | -| string | 数据项的URI。 | - -**示例**： - -```js -// 获取数据项的URI -let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); -``` - -## setting.getValue9+ +## setting.getValue -getValue(context: Context, name: string, callback: AsyncCallback\): void +getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\): void 获取数据库中指定数据项的值。使用callback异步回调。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在Stage模型下使用。 - **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ---------------------- | ---- | ------------------------------------------------------------ | -| context | Context | 是 | 上下文内容。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| callback | AsyncCallback\ | 是 | 使用callback方式获取数据项的值。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | +| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | +| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | +| callback | AsyncCallback\ | 是 | 使用callback方式获取数据项的值。 | **示例**： ```js -settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, value) => { +import featureAbility from '@ohos.ability.featureAbility'; + +let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); +let helper = featureAbility.acquireDataAbilityHelper(uri); +settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, value) => { if (err) { console.error(`Failed to get the setting. ${err.message} `); return; @@ -398,117 +268,88 @@ settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, }); ``` -## setting.getValue9+ +## setting.getValue -getValue(context: Context, name: string): Promise\ +getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\ 获取数据库中指定数据项的值。使用Promise异步回调。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在Stage模型下使用。 - **参数**： | 参数名 | 类型 | 必填 | 说明 | | ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | -| context | Context | 是 | 上下文内容。 | +| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | | name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | **返回值**： | 类型 | 说明 | | ---------------- | ----------------------------------- | -| Promise\ | Promise对象。返回获得的数据项的值。 | +| Promise\ | Promise对象。返回获得的数据项的值。 | **示例**： ```js -settings.getValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS) -.then((value) => { +import featureAbility from '@ohos.ability.featureAbility'; + +let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); +let helper = featureAbility.acquireDataAbilityHelper(uri); +settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS).then((value) => { console.log(`promise:value -> ${JSON.stringify(value)}`) }); ``` -## settings.getValueSync9+ +## settings.setValue -getValueSync(context: Context, name: string, defValue: string): string - -获取数据项的值。此方法相较getValue为同步方法。 - -**系统能力**：SystemCapability.Applications.settings.Core - -**模型约束**：此接口仅可在Stage模型下使用。 - -**参数**： - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ------- | ---- | ------------------------------------------------------------ | -| context | Context | 是 | 上下文内容。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| defValue | string | 是 | 默认值。由开发者设置，当未从数据库中查询到该数据时，表示返回该默认值。 | - -**返回值**： - -| 类型 | 说明 | -| ------ | ---------------- | -| string | 返回数据项的值。 | - -**示例**： - -```js -//获取数据项亮度的值（该数据项在数据库中已存在） -let value = settings.getValueSync(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '10'); -``` - -## settings.setValue9+ - -setValue(context: Context, name: string, value: string, callback: AsyncCallback\): void +setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, callback: AsyncCallback\): void 将数据项名称及数据项的值保存到数据库中。使用callback异步回调。 -**需要权限**：ohos.permission.MANAGE_SECURE_SETTINGS，仅系统应用可用。 +**系统接口**：此接口为系统接口。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在Stage模型下使用。 - **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ----------------------- | ---- | ------------------------------------------------------------ | -| context | Context | 是 | 上下文内容。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| value | string | 是 | 数据项值。取值范围随业务变动。 | -| callback | AsyncCallback\ | 是 | 回调函数。返回true表示操作成功，否则操作失败。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | +| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | +| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | +| value | object | 是 | 数据项值。取值范围随业务变动。 | +| callback | AsyncCallback\ | 是 | 回调函数。返回true表示操作成功，否则操作失败。 | **示例**： ```js -settings.setValue(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (result) => { +import featureAbility from '@ohos.ability.featureAbility'; + +//更新数据项亮度的值（该数据项在数据库中已存在，故setValue方法将更新该数据项的值） +let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); +let helper = featureAbility.acquireDataAbilityHelper(uri); +settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (status) => { console.log('Callback return whether value is set.'); }); ``` -## settings.setValue9+ +## settings.setValue -setValue(context: Context, name: string, value: string): Promise\ +setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Promise\ 将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。 -**需要权限**：ohos.permission.MANAGE_SECURE_SETTINGS，仅系统应用可用。 +**系统接口**：此接口为系统接口。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在Stage模型下使用。 - **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------- | ---- | ------------------------------------------------------------ | -| context | Context | 是 | 上下文内容。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| value | string | 是 | 数据项值。取值范围随业务变动。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | +| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | +| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | +| value | object | 是 | 数据项值。取值范围随业务变动。 | **返回值**： @@ -519,199 +360,147 @@ setValue(context: Context, name: string, value: string): Promise\ **示例**： ```js -settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((result) => { +import featureAbility from '@ohos.ability.featureAbility'; + +//更新数据项亮度的值（该数据项在数据库中已存在，故setValue方法将更新该数据项的值） +let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); +let helper = featureAbility.acquireDataAbilityHelper(uri); +settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((status) => { console.log('Callback return whether value is set.'); }); ``` -## settings.setValueSync9+ - -setValueSync(context: Context, name: string, value: string): boolean - -设置数据项的值。此方法相较setValue为同步方法。 +## settings.enableAirplaneMode -如果数据库中已经存在该数据项，则setValueSync方法将更新该数据项的值；如果数据库中尚未存在该数据项，则setValueSync方法将向数据库中插入该数据项。 +enableAirplaneMode(enable: boolean, callback: AsyncCallback\): void -**需要权限**：ohos.permission.MANAGE_SECURE_SETTINGS，仅系统应用可用。 +启用或禁用飞行模式。使用callback异步回调。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在Stage模型下使用。 - **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------- | ---- | ------------------------------------------------------------ | -| context | Context | 是 | 上下文内容。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| value | string | 是 | 数据项的具体数值。取值范围随业务变动。 | - -**返回值**： - -| 类型 | 说明 | -| ------- | ------------------------------------------------------------ | -| boolean | 返回设置数据项的值是否成功的结果。true表示设置成功，false表示设置失败。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------- | ---- | ----------------------------------------------- | +| enable | boolean | 是 | 是否开启飞行模式。true表示开启，false表示禁用。 | +| callback | AsyncCallback\ | 是 | 回调函数。 | **示例**： ```js -//更新数据项亮度的值（该数据项在数据库中已存在，故setValueSync方法将更新该数据项的值） -let ret = settings.setValueSync(this.context, settings.display.SCREEN_BRIGHTNESS_STATUS, '100'); +let isEnabled = true; +settings.enableAirplaneMode(isEnabled, (err) => { + if (err) { + console.log('Failed to enable AirplaneMode.'); + return; + } + console.log('Return true if enable.'); +}) ``` -## setting.getValue(deprecated) - -> 从API version 7开始支持，从API version 9开始废弃，推荐使用[getValue()](#settinggetvalue9)。 +## settings.enableAirplaneMode -getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\): void +enableAirplaneMode(enable: boolean): Promise\ -获取数据库中指定数据项的值。使用callback异步回调。 +启用或禁用飞行模式。使用Promise异步回调。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在FA模型下使用。 - **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | -| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| callback | AsyncCallback\ | 是 | 使用callback方式获取数据项的值。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------- | ---- | ----------------------------------------------- | +| enable | boolean | 是 | 是否开启飞行模式。true表示开启，false表示禁用。 | + +**返回值**： + +| 类型 | 说明 | +| -------------- | ------------------------- | +| Promise\ | 无返回结果的Promise对象。 | **示例**： ```js -import featureAbility from '@ohos.ability.featureAbility'; - -let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); -let helper = featureAbility.acquireDataAbilityHelper(uri); -settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, (err, value) => { - if (err) { - console.error(`Failed to get the setting. ${err.message} `); - return; - } - console.log(`callback:value -> ${JSON.stringify(value)}`) -}); +let isEnabled = true; +settings.enableAirplaneMode(isEnabled).then(() => { + console.log('Succeeded in enabling AirplaneMode.'); +}).catch((err) => { + console.log(`Failed to enable AirplaneMode. Cause: ${err}`); +}) ``` -## setting.getValue(deprecated) - -> 从API version 7开始支持，从API version 9开始废弃，推荐使用[getValue()](#settinggetvalue9-1)。 +## settings.canShowFloating -getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\ +canShowFloating(callback: AsyncCallback\): void -获取数据库中指定数据项的值。使用Promise异步回调。 +检查应用是否能够以悬浮窗形式显示。使用callback异步回调。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在FA模型下使用。 - **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | -| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | - -**返回值**： - -| 类型 | 说明 | -| ---------------- | ----------------------------------- | -| Promise\ | Promise对象。返回获得的数据项的值。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------- | ---- | ------------------------------------------------------------ | +| callback | AsyncCallback\ | 是 | 回调函数。
返回true，表示应用能够以悬浮窗形式显示；返回false，则表示不能。 | **示例**： ```js -import featureAbility from '@ohos.ability.featureAbility'; - -let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); -let helper = featureAbility.acquireDataAbilityHelper(uri); -settings.getValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS).then((value) => { - console.log(`promise:value -> ${JSON.stringify(value)}`) +settings.canShowFloating((status) => { + console.log('Checks whether a specified application can show as float window.'); }); ``` -## settings.setValue(deprecated) - -> 从API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](#settingssetvalue9)。 - -setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string, callback: AsyncCallback\): void +## settings.canShowFloating -将数据项名称及数据项的值保存到数据库中。使用callback异步回调。 +canShowFloating(): Promise\ -**系统接口**：此接口为系统接口。 +检查应用是否能够以悬浮窗形式显示。使用Promise异步回调。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在FA模型下使用。 - -**参数**： +**返回值**： -| 参数名 | 类型 | 必填 | 说明 | -| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | -| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| value | string | 是 | 数据项值。取值范围随业务变动。 | -| callback | AsyncCallback\ | 是 | 回调函数。返回true表示操作成功，否则操作失败。 | +| 类型 | 说明 | +| ----------------- | ------------------------------------------------------------ | +| Promise\ | Promise对象。
返回true，表示应用能够以悬浮窗形式显示；返回false，则表示不能。 | **示例**： ```js -import featureAbility from '@ohos.ability.featureAbility'; - -//更新数据项亮度的值（该数据项在数据库中已存在，故setValue方法将更新该数据项的值） -let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); -let helper = featureAbility.acquireDataAbilityHelper(uri); -settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (result) => { - console.log('Callback return whether value is set.'); +settings.canShowFloating().then((status) => { + console.log('Checks whether a specified application can show as float window.'); }); ``` -## settings.setValue(deprecated) - -> 从API version 7开始支持，从API version 9开始废弃，推荐使用[setValue()](#settingssetvalue9-1)。 - -setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: string): Promise\ +## settings.getUriSync8+ -将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。 +getUriSync(name: string): string -**系统接口**：此接口为系统接口。 +获取数据项的URI。 **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在FA模型下使用。 - **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | -| dataAbilityHelper | [DataAbilityHelper](js-apis-inner-ability-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| value | string | 是 | 数据项值。取值范围随业务变动。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | **返回值**： -| 类型 | 说明 | -| ----------------- | -------------------------------------------------- | -| Promise\ | Promise对象。返回true表示操作成功，否则返回false。 | +| 类型 | 说明 | +| ------ | ------------- | +| string | 数据项的URI。 | **示例**： ```js -import featureAbility from '@ohos.ability.featureAbility'; - -//更新数据项亮度的值（该数据项在数据库中已存在，故setValue方法将更新该数据项的值） -let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); -let helper = featureAbility.acquireDataAbilityHelper(uri); -settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((result) => { - console.log('Callback return whether value is set.'); -}); +// 获取数据项的URI +let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); ``` -## settings.getValueSync(deprecated) - -> 从API version 8开始支持，从API version 9开始废弃，推荐使用[getValueSync()](#settingsgetvaluesync9)。 +## settings.getValueSync8+ getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: string): string @@ -719,8 +508,6 @@ getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: strin **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在FA模型下使用。 - **参数**： | 参数名 | 类型 | 必填 | 说明 | @@ -746,9 +533,7 @@ let helper = featureAbility.acquireDataAbilityHelper(uri); let value = settings.getValueSync(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '10'); ``` -## settings.setValueSync(deprecated) - -> 从API version 8开始支持，从API version 9开始废弃，推荐使用[setValueSync()](#settingssetvaluesync9)。 +## settings.setValueSync8+ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): boolean @@ -760,8 +545,6 @@ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): **系统能力**：SystemCapability.Applications.settings.Core -**模型约束**：此接口仅可在FA模型下使用。 - **参数**： | 参数名 | 类型 | 必填 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-socket.md b/zh-cn/application-dev/reference/apis/js-apis-socket.md index a18ece3bef4b4aab2c6c1a108a23dc48dba781d7..f01fd47aa836044fccd805b3347df38063f216dd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-socket.md +++ b/zh-cn/application-dev/reference/apis/js-apis-socket.md @@ -1,9 +1,8 @@ -# Socket连接 +# @ohos.net.socket (Socket连接) ->![](public_sys-resources/icon-note.gif) **说明：** -> ->本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：** > +> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-stationary.md b/zh-cn/application-dev/reference/apis/js-apis-stationary.md index 5a87f940e9aa5e54c04da3b09b31555866f5c553..12a01a763208c6ca85ae69da19903345cee1d73d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-stationary.md +++ b/zh-cn/application-dev/reference/apis/js-apis-stationary.md @@ -1,8 +1,9 @@ -# 设备状态感知框架 +# @ohos.stationary (设备状态感知框架) 设备状态感知框架提供设备状态感知能力，包括绝对静止和相对静止。 > **说明：** +> > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-capability.md b/zh-cn/application-dev/reference/apis/js-apis-system-capability.md index 70b91f50ab52636310a2f5ca9309acd172bb0e0a..e0fdd2062e6a4faa1314218be2c47882e90da0ea 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-system-capability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-capability.md @@ -1,8 +1,9 @@ -# 系统能力 +# @ohos.systemCapability (系统能力) 系统能力（SystemCapability，简称SysCap），指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集，每个系统能力对应多个接口。开发者可根据系统能力来判断是否可以使用某接口。本模块提供接口可查询系统能力的集合。 > **说明：** +> > - 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块接口为系统接口。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-parameterV9.md b/zh-cn/application-dev/reference/apis/js-apis-system-parameterV9.md index ac0af056101318c670581788ca0d479aceaf02ca..7f07d9d9bf93e79c6c63acb59f14fed06977398d 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-system-parameterV9.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-parameterV9.md @@ -1,10 +1,11 @@ -# 系统参数 +# @ohos.systemParameterV9 (系统属性) 系统参数（SystemParameter）是为各系统服务提供的简单易用的键值对访问接口，各个系统服务可以定义系统参数来描述该服务的状态信息，或者通过系统参数来改变系统服务的行为。其基本操作原语为get和set，通过get可以查询系统参数的值，通过set可以修改系统参数的值。 详细的系统参数设计原理及定义可参考 [系统参数](../../../device-dev/subsystems/subsys-boot-init-sysparam.md)。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > - 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块接口为系统接口。 > - 由于系统参数都是各个系统服务的内部信息和控制参数，每个系统参数都有各自不同的DAC和MAC访问控制权限，三方应用不能使用此类接口。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-time.md b/zh-cn/application-dev/reference/apis/js-apis-system-time.md index fbb25a8b6f8145c3b22454b76f8da999ed12a826..5e38c7c300ab379fa5cee8a07e11679b1900ac3d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-time.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-time.md @@ -1,4 +1,4 @@ -# 系统时间、时区 +# @ohos.systemTime (系统时间、时区) 本模块主要由系统时间和系统时区功能组成。开发者可以设置、获取系统时间及系统时区。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-timer.md b/zh-cn/application-dev/reference/apis/js-apis-system-timer.md index 317e2be8a03c8fce773e9b19e9e1712845230fcd..f1cec2767a38bc5aaac708ff18a877054b09764a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-timer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-timer.md @@ -1,4 +1,4 @@ -# 系统定时器 +# @ohos.systemTimer (系统定时器) 本模块主要由系统定时器功能组成。开发者可以使用定时功能实现定时服务，如闹钟等。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-tagSession.md b/zh-cn/application-dev/reference/apis/js-apis-tagSession.md index b122b896efdf53c3a455c9cc3d38fe951c87ebd3..4d6b27f3473aeaea9b0bd2fb09fa6a45a13b61f6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-tagSession.md +++ b/zh-cn/application-dev/reference/apis/js-apis-tagSession.md @@ -1,8 +1,9 @@ -# 标准NFC-Tag TagSession +# tagSession (标准NFC-Tag TagSession) 本模块是对NFC TagSession的使用说明。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## **导入模块** diff --git a/zh-cn/application-dev/reference/apis/js-apis-thermal.md b/zh-cn/application-dev/reference/apis/js-apis-thermal.md index 8b5964bf378cd6c4af086a6e687753139c3479cd..63065a9fdc7a50eaba13468b41ec5d74ce70ad45 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-thermal.md +++ b/zh-cn/application-dev/reference/apis/js-apis-thermal.md @@ -1,8 +1,9 @@ -# 热管理 +# @ohos.thermal (热管理) 该模块提供热管理相关的接口，包括热档位查询及注册回调等功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-timer.md b/zh-cn/application-dev/reference/apis/js-apis-timer.md index d0a3496a68419c2252cb9f4e933a6f7bdd67f29b..ae0957a9b4978d69674f4a63fa0b861fc1a3a48b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-timer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-timer.md @@ -1,4 +1,4 @@ -# 定时器 +# Timer (定时器) 本模块提供基础的定时器能力，支持按照指定的时间执行对应函数。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-touchevent.md b/zh-cn/application-dev/reference/apis/js-apis-touchevent.md index a81f6478700fb4e218dfde0cce7376346f6fe2b0..55981cf86f5661872953a77e8b29e400c56d0d10 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-touchevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-touchevent.md @@ -1,4 +1,4 @@ -# 触摸输入事件 +# @ohos.multimodalInput.touchEvent (触摸输入事件) 设备上报的触屏事件。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-update.md b/zh-cn/application-dev/reference/apis/js-apis-update.md index f9c694d0aa71ece5b03d0d61d291569e578d32f1..144bb69c2bbef40ef5605b4ab7883475b3eb8970 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-update.md +++ b/zh-cn/application-dev/reference/apis/js-apis-update.md @@ -1,4 +1,4 @@ -# 升级 +# @ohos.update (升级) 升级范围：升级整个系统，包括内置的资源、预置应用；第三方的应用不在升级的范围。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-usb.md b/zh-cn/application-dev/reference/apis/js-apis-usb.md index a7673ac5985027504f3a6e6e13f527ea13a20d95..a13cf744214736e0ad77171211683579e6f1ba24 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-usb.md +++ b/zh-cn/application-dev/reference/apis/js-apis-usb.md @@ -1,4 +1,4 @@ -# USB管理 +# @ohos.usbV9 (USB管理) 本模块主要提供管理USB设备的相关功能，包括主设备上查询USB设备列表、批量数据传输、控制命令传输、权限控制等；从设备上端口管理、功能切换及查询等。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-vibrator.md b/zh-cn/application-dev/reference/apis/js-apis-vibrator.md index e2c7e427c5870a38a252b42d1406422f5f63d23c..fd963f712b5e6013479952a5f28430988f4969c0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-vibrator.md +++ b/zh-cn/application-dev/reference/apis/js-apis-vibrator.md @@ -1,4 +1,4 @@ -# 振动 +# @ohos.vibrator (振动) vibrator模块提供控制马达振动启、停的能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md b/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md index bc09873847b526935a3127472a5ce37255ba704b..45f290e0358618e1831a5f83d3f1aca24f9f8583 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md @@ -1,4 +1,4 @@ -# 壁纸 +# @ohos.wallpaper (壁纸) 壁纸管理服务是OpenHarmony中系统服务，是主题框架的部分组成，主要为系统提供壁纸管理服务能力，支持系统显示、设置、切换壁纸等功能。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-webSocket.md b/zh-cn/application-dev/reference/apis/js-apis-webSocket.md index ebbd7466389a9d7cecd59b99f35deac8c565e0de..5eb5d8ab5f6f3d8c65e074f2be1a519492a5a249 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-webSocket.md +++ b/zh-cn/application-dev/reference/apis/js-apis-webSocket.md @@ -1,8 +1,9 @@ -# WebSocket连接 +# @ohos.net.webSocket (WebSocket连接) ->![](public_sys-resources/icon-note.gif) **说明：** ->本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：** > +> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + 使用WebSocket建立服务器与客户端的双向连接，需要先通过[createWebSocket](#websocketcreatewebsocket)方法创建[WebSocket](#websocket)对象，然后通过[connect](#connect)方法连接到服务器。当连接成功后，客户端会收到[open](#onopen)事件的回调，之后客户端就可以通过[send](#send)方法与服务器进行通信。当服务器发信息给客户端时，客户端会收到[message](#onmessage)事件的回调。当客户端不要此连接时，可以通过调用[close](#close)方法主动断开连接，之后客户端会收到[close](#onclose)事件的回调。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-webview.md b/zh-cn/application-dev/reference/apis/js-apis-webview.md index 4c2cd9fc032662b5b1b4b629770a1216eda5845a..7a5537f2eed22a2be6279f4ee5066736672ebf15 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-webview.md +++ b/zh-cn/application-dev/reference/apis/js-apis-webview.md @@ -1,6 +1,6 @@ -# Webview +# @ohos.web.webview (Webview) 提供web控制能力。 @@ -11,6 +11,7 @@ > - 示例效果请以真机运行为准，当前IDE预览器不支持。 ## 需要权限 + 访问在线网页时需添加网络权限：ohos.permission.INTERNET，具体申请方式请参考[权限申请声明](../../security/accesstoken-guidelines.md)。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-wifi.md b/zh-cn/application-dev/reference/apis/js-apis-wifi.md index d12b7b92e51e0e1caa64614caf5b08b4916c82b8..4f6c7999eddc049acfedd560174f0d0f0445a5aa 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wifi.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wifi.md @@ -1,7 +1,9 @@ -# WLAN +# @ohos.wifi (WLAN) + 该模块主要提供WLAN基础功能、P2P（peer-to-peer）功能和WLAN消息通知的相应服务，让应用可以通过WLAN和其他设备互联互通。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-wifiext.md b/zh-cn/application-dev/reference/apis/js-apis-wifiext.md index 7e965f91eb291a2bf04d33a659c990aa6bbb4999..af25b08c573672bd1460c52fbb7ce77840c84341 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wifiext.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wifiext.md @@ -1,7 +1,9 @@ -# WLAN扩展接口 +# @ohos.wifiext (WLAN扩展接口) + 该模块主要提供WLAN扩展接口，供非通用类型产品使用。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 该文档中的接口只供非通用类型产品使用，如路由器等，对于常规类型产品，不应该使用这些接口。 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md index 9458e1d54fdfb49a28e73d77b8b6f457f382d996..6d5c486284ffed7402fd39e7d7b9e110f3eb1f5d 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md @@ -37,7 +37,7 @@ Image(src: string | PixelMap | Resource) | --------------------- | ------------------------------------------------------- | ------------------------------------------------------------ | | alt | string \| [Resource](ts-types.md#resource类型) | 加载时显示的占位图，支持本地图片。 | | objectFit | [ImageFit](ts-appendix-enums.md#imagefit) | 设置图片的缩放类型。
默认值：ImageFit.Cover | -| objectRepeat | [ImageRepeat](ts-appendix-enums.md#imagerepeat) | 设置图片的重复样式。
默认值：NoRepeat
**说明：**
svg类型图源不支持该属性。 | +| objectRepeat | [ImageRepeat](ts-appendix-enums.md#imagerepeat) | 设置图片的重复样式。
默认值：ImageRepeat.NoRepeat
**说明：**
svg类型图源不支持该属性。 | | interpolation | [ImageInterpolation](#imageinterpolation) | 设置图片的插值效果，即减轻低清晰度图片在放大显示的时候出现的锯齿问题，仅针对图片放大插值。
默认值：ImageInterpolation.None
**说明：**
svg类型图源不支持该属性。
PixelMap资源不支持该属性。 | | renderMode | [ImageRenderMode](#imagerendermode) | 设置图片渲染的模式。
默认值：ImageRenderMode.Original
**说明：**
svg类型图源不支持该属性。 | | sourceSize | {
width: number,
height: number
} | 设置图片裁剪尺寸，将原始图片解码成pixelMap，指定尺寸的图片，单位为px。
**说明：**
PixelMap资源不支持该属性。 | diff --git a/zh-cn/device-dev/subsystems/subsys-build-gn-hap-compilation-guide.md b/zh-cn/device-dev/subsystems/subsys-build-gn-hap-compilation-guide.md index c645347cdbb2a7de6d162e3fd2e62371378fc048..045a09c28d618d7b84963820dfdd08db709dd182 100644 --- a/zh-cn/device-dev/subsystems/subsys-build-gn-hap-compilation-guide.md +++ b/zh-cn/device-dev/subsystems/subsys-build-gn-hap-compilation-guide.md @@ -9,7 +9,7 @@ | Ability | 应用的重要组成部分，是应用所具备能力的抽象。Ability是系统调度应用的最小单元，是能够完成一个独立功能的组件，一个应用可以包含一个或多个Ability。 | | FA | Feature Ability，是FA模型的Ability框架下具有UI界面的Ability类型，用于与用户进行交互。Feature Ability唯一对应一种模板，即Page模板（Page Ability）。 | | PA | Particle Ability，是在FA模型的Ability框架下无界面的Ability，主要为Feature Ability提供服务与支持，例如作为后台服务提供计算能力，或作为数据仓库提供数据访问能力。Particle Ability有三种模板，分别为Service模板（Service Ability）、Data模板（Data Ability）、以及Form模板（Form Ability）。 | -| FA模型 | 两种Ability框架模型结构的其中一种。是Ability框架在API 8及更早版本采用FA模型。FA模型将Ability分为FA（Feature Ability）和PA（Particle Ability）两种类型，其中FA支持Page Ability模板，PA支持Service ability、Data ability、以及Form ability模板。详情可参考[FA模型综述](../../application-dev/ability/fa-brief.md)。 | +| FA模型 | 两种Ability框架模型结构的其中一种。是Ability框架在API 8及更早版本采用FA模型。FA模型将Ability分为FA（Feature Ability）和PA（Particle Ability）两种类型，其中FA支持Page Ability模板，PA支持Service ability、Data ability、以及Form ability模板。详情可参考[FA模型综述](../../application-dev/ability-deprecated/fa-brief.md)。 | | Stage模型 | 两种Ability框架模型结构的其中一种。从API 9开始支持。Stage模型将Ability分为Ability和ExtensionAbility两大类，其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等等一系列ExtensionAbility。 | ### 功能简介 diff --git a/zh-cn/release-notes/OpenHarmony-v3.1.4-release.md b/zh-cn/release-notes/OpenHarmony-v3.1.4-release.md index c2cb5e5f9bc6f025538a0d3a3ceca64b3d782dff..19a944c269bda58dbd0495fe7c92d0cb4812d301 100644 --- a/zh-cn/release-notes/OpenHarmony-v3.1.4-release.md +++ b/zh-cn/release-notes/OpenHarmony-v3.1.4-release.md @@ -75,7 +75,7 @@ repo forall -c 'git lfs pull' | 版本源码 | **版本信息** | **下载站点** | **SHA256校验码** | | -------- | -------- | -------- | -------- | -| 全量代码（标准、轻量和小型系统） | 3.1.4 Release | [站点](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/code-v3.1.4-Release.tar.gz) | [SHA256校验码](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/code-v3.1.4-Release.tar.gz.sha256) | +| 全量代码（标准、轻量和小型系统） | 3.1.4 Release | [站点](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/code-v3.1.4-Release-2022-12-12.tar.gz) | [SHA256校验码](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/code-v3.1.4-Release-2022-12-12.tar.gz.sha256) | | Hi3516标准系统解决方案（二进制） | 3.1.4 Release | [站点](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/standard_hi3516.tar.gz) | [SHA256校验码](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/standard_hi3516.tar.gz.sha256) | | RK3568标准系统解决方案（二进制） | 3.1.4 Release | [站点](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/standard_rk3568.tar.gz) | [SHA256校验码](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/standard_rk3568.tar.gz.sha256) | | Hi3861轻量系统解决方案（二进制） | 3.1.4 Release | [站点](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/hispark_pegasus.tar.gz) | [SHA256校验码](https://mirrors.huaweicloud.com/openharmony/os/3.1.4/hispark_pegasus.tar.gz.sha256) |