diff --git a/en/application-dev/reference/apis/js-apis-system-location.md b/en/application-dev/reference/apis/js-apis-system-location.md index ab53fb2d188b7b929c591a67c33cec12984e063c..b0648efc475396e317d6f8da4891ecb66e6164df 100644 --- a/en/application-dev/reference/apis/js-apis-system-location.md +++ b/en/application-dev/reference/apis/js-apis-system-location.md @@ -1,6 +1,6 @@ # Geographic Location -> ![icon-note.gif](public_sys-resources/icon-note.gif) **Note：** +> **Note：** > - The APIs of this module are no longer maintained since API version 7. It is recommended that you use [`@ohos.geolocation`](js-apis-geolocation.md) instead. > > - The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version. diff --git a/zh-cn/application-dev/ability-deprecated/fa-formability.md b/zh-cn/application-dev/ability-deprecated/fa-formability.md index 52291799c8c9010af281d8ed45c8493b8340c8ef..379e504eee64a09fb2a950f7d832203fb8113eae 100644 --- a/zh-cn/application-dev/ability-deprecated/fa-formability.md +++ b/zh-cn/application-dev/ability-deprecated/fa-formability.md @@ -264,7 +264,7 @@ onUpdate(formId) { 开发者可以使用hml+css+json开发JS卡片页面： -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 当前仅支持JS扩展的类Web开发范式来实现卡片的UI页面。 - hml: diff --git a/zh-cn/application-dev/ability-deprecated/stage-call.md b/zh-cn/application-dev/ability-deprecated/stage-call.md index a1f9a5d5d54e54dfec706dcd4823d8384a5b8641..4b8d702ed8cc44c42d0d07e86720106d3c71e3cd 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-call.md +++ b/zh-cn/application-dev/ability-deprecated/stage-call.md @@ -24,7 +24,7 @@ Call调用流程示意图如下： - CalleeAbility持有一个Callee对象，通过Callee的on方法注册回调函数，当接收到Caller发送的数据时将会调用对应的回调函数 ![stage-call](figures/stage-call.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > CalleeAbility的启动模式需要为单实例。 > 当前仅支持系统应用使用Call调用。 diff --git a/zh-cn/application-dev/ability-deprecated/stage-formextension.md b/zh-cn/application-dev/ability-deprecated/stage-formextension.md index 39f00e24180d83dc3f58c6f868f6ed133fad6c72..cd08291627c8b09aeb6d47db1e6b36a968ac4fa1 100644 --- a/zh-cn/application-dev/ability-deprecated/stage-formextension.md +++ b/zh-cn/application-dev/ability-deprecated/stage-formextension.md @@ -12,7 +12,7 @@ - 卡片使用方：显示卡片内容的宿主应用，控制卡片在宿主中展示的位置。 - 卡片管理服务：用于管理系统中所添加卡片的常驻代理服务，包括卡片对象的管理与使用，以及卡片周期性刷新等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 卡片使用方和提供方不要求常驻运行，在需要添加/删除/请求更新卡片时，卡片管理服务会拉起卡片提供方获取卡片信息。 开发者仅需作为卡片提供方进行卡片内容的开发，卡片使用方和卡片管理服务由系统自动处理。 @@ -275,7 +275,7 @@ onUpdate(formId) { 开发者可以使用hml+css+json开发JS卡片页面： -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 当前仅支持JS扩展的类Web开发范式来实现卡片的UI页面。 - hml: diff --git a/zh-cn/application-dev/application-models/application-context-stage.md b/zh-cn/application-dev/application-models/application-context-stage.md index c854cf9ebc0a0959d4b85628399ce38dbc0d0b4f..5ec374fbeebce38f1881faf4e7c362dacbd1774f 100644 --- a/zh-cn/application-dev/application-models/application-context-stage.md +++ b/zh-cn/application-dev/application-models/application-context-stage.md @@ -173,7 +173,7 @@ export default class EntryAbility extends UIAbility { 基类Context提供创建其他应用或其他Module的Context的方法有[createBundleContext(bundleName:string)](../reference/apis/js-apis-inner-application-context.md#contextcreatebundlecontext)、[createModuleContext(moduleName:string)](../reference/apis/js-apis-inner-application-context.md#contextcreatemodulecontext)和[createModuleContext(bundleName:string, moduleName:string)](../reference/apis/js-apis-inner-application-context.md#contextcreatemodulecontext-1)接口，创建其他应用或者其他Module的Context，从而通过该Context获取相应的资源信息（例如获取其他Module的[获取应用开发路径](#获取应用开发路径)信息）。 - 调用createBundleContext(bundleName:string)方法，创建其他应用的Context信息。 - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** + > **说明：** > 当获取的是其他应用的Context时： > > - 申请`ohos.permission.GET_BUNDLE_INFO_PRIVILEGED`权限，配置方式请参阅[访问控制授权申请指导](../security/accesstoken-guidelines.md#stage模型)。 @@ -196,7 +196,7 @@ export default class EntryAbility extends UIAbility { ``` - 调用createModuleContext(bundleName:string, moduleName:string)方法，获取指定应用指定Module的上下文信息。获取到指定应用指定Module的Context之后，即可获取到相应应用Module的资源信息。 - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** + > **说明：** > 当获取的是其他应用的指定Module的Context时： > > - 申请`ohos.permission.GET_BUNDLE_INFO_PRIVILEGED`权限，配置方式请参阅[访问控制授权申请指导](../security/accesstoken-guidelines.md#stage模型)。 diff --git a/zh-cn/application-dev/application-models/component-startup-rules-fa.md b/zh-cn/application-dev/application-models/component-startup-rules-fa.md index 825dffece76a429fea1591616f4b8c8b6083d7ed..e5d4cb541b39af727c7721b9469cae606d9f56b2 100644 --- a/zh-cn/application-dev/application-models/component-startup-rules-fa.md +++ b/zh-cn/application-dev/application-models/component-startup-rules-fa.md @@ -38,7 +38,7 @@ - 只有系统预置应用才允许配置AssociateWakeUp字段，其余应用AssociateWakeUp默认为**false** -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 1. 组件启动管控自OpenHarmony v3.2 Release版本开始落地。 > > 2. 与原本的启动规则不同，新的组件启动规则较为严格，开发者需熟知启动规则，避免业务功能异常。 diff --git a/zh-cn/application-dev/application-models/component-startup-rules.md b/zh-cn/application-dev/application-models/component-startup-rules.md index 0994ebeec37440350e42c02685520d4394e0de03..259d40cde69a888200f9998244c9b057bfbf05a1 100644 --- a/zh-cn/application-dev/application-models/component-startup-rules.md +++ b/zh-cn/application-dev/application-models/component-startup-rules.md @@ -34,7 +34,7 @@ - 需校验`ohos.permission.ABILITY_BACKGROUND_COMMUNICATION`权限 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 1. 组件启动管控自OpenHarmony v3.2 Release版本开始落地。 > > 2. 与原本的启动规则不同，新的组件启动规则较为严格，开发者需熟知启动规则，避免业务功能异常。 diff --git a/zh-cn/application-dev/application-models/dataability-configuration.md b/zh-cn/application-dev/application-models/dataability-configuration.md index ef1f8583d77238414c0185d080bdfd9dce15d92a..88b57ca8f5b8b9f999adcdfc5b4eabe795eaa7f8 100644 --- a/zh-cn/application-dev/application-models/dataability-configuration.md +++ b/zh-cn/application-dev/application-models/dataability-configuration.md @@ -23,7 +23,7 @@ URI示例： - 本地设备：dataability:///_com.domainname.dataability.persondata_/_person_/_1_ -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本地设备的"device_id"字段为空，因此在"dataability:"后面有三个"/"。 diff --git a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md index ab6878dc57b170c1eac98c6482a497189a0b7765..2fcecb63c094190c71db81d3b703c888539a0e66 100644 --- a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md +++ b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md @@ -130,7 +130,7 @@ - 如果s_uri的pathRegex不为空，当w_uri满足s_uri**正则表达式**时匹配成功，否则匹配失败； -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 待匹配Ability的skills配置的uris中scheme、host、port、path、pathStartWith和pathRegex属性拼接，如果依次声明了path、pathStartWith和pathRegex属性时，uris将分别拼接为如下三种表达式： > > - **全路径表达式**：scheme://host:port/path @@ -142,7 +142,7 @@ ### type匹配规则 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 此小节所述的type匹配规则的适用性需建立在want参数内type不为空的基础上。当want参数内type为空时请参考[want参数的uri和type匹配规则](#want参数的uri和type匹配规则)。 这里为了简化描述，称want中传入的uri为w_type，待匹配Ability的skills数组中uris的type数据为s_type，具体的匹配规则如下： diff --git a/zh-cn/application-dev/application-models/extensionability-overview.md b/zh-cn/application-dev/application-models/extensionability-overview.md index 942341093d87fd1ef66c137c68e079d695eaafe2..db3de0998a110e639aee815e384cc964763cc8fa 100644 --- a/zh-cn/application-dev/application-models/extensionability-overview.md +++ b/zh-cn/application-dev/application-models/extensionability-overview.md @@ -44,7 +44,7 @@ ExtensionAbility组件是基于特定场景（例如服务卡片、输入法等 ![form_extension](figures/form_extension.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 同一应用内的所有同类型的ExtensionAbility运行在同一独立进程（除ServiceExtensionAbility、DataShareExtensionAbility外），跟UIAbility组件不在同一进程，Stage模型的进程模型请参见[进程模型](process-model-stage.md)。 > > 例如一个应用有1个UIAbility组件、1个ServiceExtensionAbility、1个DataShareExtensionAbility、2个FormExtensionAbility、1个ImeExtensionAbility。则该应用在运行时，有三个进程： diff --git a/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md b/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md index a4cafc5b9fe090ec94dc8386d1dcfbc1240449bc..ddbaa1f565cb4c1dfce7b67792752a49e12008a3 100644 --- a/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md +++ b/zh-cn/application-dev/application-models/hop-multi-device-collaboration.md @@ -53,13 +53,13 @@ ```ts requestPermission() { - let context = this.context - let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC'] - context.requestPermissionsFromUser(permissions).then((data) => { - console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)) - }).catch((error) => { - console.info("Failed to request permission from user with error: "+ JSON.stringify(error)) - }) + let context = this.context; + let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC']; + context.requestPermissionsFromUser(permissions).then((data) => { + console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)); + }).catch((error) => { + console.info("Failed to request permission from user with error: "+ JSON.stringify(error)); + }) } ``` @@ -135,13 +135,13 @@ ```ts requestPermission() { - let context = this.context - let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC'] - context.requestPermissionsFromUser(permissions).then((data) => { - console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)) - }).catch((error) => { - console.info("Failed to request permission from user with error: "+ JSON.stringify(error)) - }) + let context = this.context; + let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC']; + context.requestPermissionsFromUser(permissions).then((data) => { + console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)); + }).catch((error) => { + console.info("Failed to request permission from user with error: "+ JSON.stringify(error)); + }) } ``` @@ -218,31 +218,19 @@ ### 开发步骤 -1. 在module.json5配置数据同步权限，示例代码如下。 +1. 申请`ohos.permission.DISTRIBUTED_DATASYNC`权限，配置方式请参阅[访问控制授权申请指导](../security/accesstoken-guidelines.md#stage模型)。 - ```json - { - "module": { - "requestPermissions":[ - { - "name" : "ohos.permission.DISTRIBUTED_DATASYNC", - } - ] - } - } - ``` - 2. 申请数据同步权限，弹框示例代码。 ```ts requestPermission() { - let context = this.context - let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC'] - context.requestPermissionsFromUser(permissions).then((data) => { - console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)) - }).catch((error) => { - console.info("Failed to request permission from user with error: "+ JSON.stringify(error)) - }) + let context = this.context; + let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC']; + context.requestPermissionsFromUser(permissions).then((data) => { + console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)); + }).catch((error) => { + console.info("Failed to request permission from user with error: "+ JSON.stringify(error)); + }) } ``` @@ -291,10 +279,10 @@ }); }, onDisconnect(elementName) { - console.info('onDisconnect callback') + console.info('onDisconnect callback'); }, onFailed(code) { - console.info('onFailed callback') + console.info('onFailed callback'); } } // 建立连接后返回的Id需要保存下来，在解绑服务时需要作为参数传入 @@ -339,31 +327,19 @@ ### 开发步骤 -1. 在module.json5配置数据同步权限，示例代码如下。 +1. 申请`ohos.permission.DISTRIBUTED_DATASYNC`权限，配置方式请参阅[访问控制授权申请指导](../security/accesstoken-guidelines.md#stage模型)。 - ```json - { - "module": { - "requestPermissions":[ - { - "name" : "ohos.permission.DISTRIBUTED_DATASYNC", - } - ] - } - } - ``` - 2. 申请数据同步权限，弹框示例代码。 ```ts requestPermission() { - let context = this.context - let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC'] - context.requestPermissionsFromUser(permissions).then((data) => { - console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)) - }).catch((error) => { - console.info("Failed to request permission from user with error: "+ JSON.stringify(error)) - }) + let context = this.context; + let permissions: Array = ['ohos.permission.DISTRIBUTED_DATASYNC']; + context.requestPermissionsFromUser(permissions).then((data) => { + console.info("Succeed to request permission from user with data: "+ JSON.stringify(data)); + }).catch((error) => { + console.info("Failed to request permission from user with error: "+ JSON.stringify(error)); + }) } ``` @@ -394,7 +370,7 @@ 2. 导入UIAbility模块。 ```ts - import Ability from '@ohos.app.ability.UIAbility' + import Ability from '@ohos.app.ability.UIAbility'; ``` 3. 定义约定的序列化数据。 调用端及被调用端发送接收的数据格式需协商一致，如下示例约定数据由number和string组成。 @@ -402,24 +378,24 @@ ```ts export default class MySequenceable { - num: number = 0 - str: string = "" + num: number = 0; + str: string = ""; constructor(num, string) { - this.num = num - this.str = string + this.num = num; + this.str = string; } marshalling(messageParcel) { - messageParcel.writeInt(this.num) - messageParcel.writeString(this.str) - return true + messageParcel.writeInt(this.num); + messageParcel.writeString(this.str); + return true; } unmarshalling(messageParcel) { - this.num = messageParcel.readInt() - this.str = messageParcel.readString() - return true + this.num = messageParcel.readInt(); + this.str = messageParcel.readString(); + return true; } } ``` @@ -427,36 +403,36 @@ 如下示例在Ability的onCreate注册MSG_SEND_METHOD监听，在onDestroy取消监听，收到序列化数据后作相应处理并返回。应用开发者根据实际业务需要做相应处理。 ```ts - const TAG: string = '[CalleeAbility]' - const MSG_SEND_METHOD: string = 'CallSendMsg' + const TAG: string = '[CalleeAbility]'; + const MSG_SEND_METHOD: string = 'CallSendMsg'; function sendMsgCallback(data) { - console.info('CalleeSortFunc called') + console.info('CalleeSortFunc called'); // 获取Caller发送的序列化数据 - let receivedData = new MySequenceable(0, '') - data.readSequenceable(receivedData) - console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`) + let receivedData = new MySequenceable(0, ''); + data.readSequenceable(receivedData); + console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`); // 作相应处理 // 返回序列化数据result给Caller - return new MySequenceable(receivedData.num + 1, `send ${receivedData.str} succeed`) + return new MySequenceable(receivedData.num + 1, `send ${receivedData.str} succeed`); } export default class CalleeAbility extends Ability { onCreate(want, launchParam) { try { - this.callee.on(MSG_SEND_METHOD, sendMsgCallback) + this.callee.on(MSG_SEND_METHOD, sendMsgCallback); } catch (error) { - console.info(`${MSG_SEND_METHOD} register failed with error ${JSON.stringify(error)}`) + console.info(`${MSG_SEND_METHOD} register failed with error ${JSON.stringify(error)}`); } } onDestroy() { try { - this.callee.off(MSG_SEND_METHOD) + this.callee.off(MSG_SEND_METHOD); } catch (error) { - console.error(TAG, `${MSG_SEND_METHOD} unregister failed with error ${JSON.stringify(error)}`) + console.error(TAG, `${MSG_SEND_METHOD} unregister failed with error ${JSON.stringify(error)}`); } } } @@ -466,7 +442,7 @@ 1. 导入UIAbility模块。 ```ts - import Ability from '@ohos.app.ability.UIAbility' + import Ability from '@ohos.app.ability.UIAbility'; ``` 2. 获取Caller通信接口。 Ability的context属性实现了startAbilityByCall方法，用于获取指定通用组件的Caller通信接口。如下示例通过this.context获取Ability实例的context属性，使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口，注册Caller的onRelease监听。应用开发者根据实际业务需要做相应处理。 @@ -474,8 +450,8 @@ ```ts async onButtonGetRemoteCaller() { - var caller = undefined - var context = this.context + var caller = undefined; + var context = this.context; context.startAbilityByCall({ deviceId: getRemoteDeviceId(), @@ -483,16 +459,16 @@ abilityName: 'CalleeAbility' }).then((data) => { if (data != null) { - caller = data - console.info('get remote caller success') + caller = data; + console.info('get remote caller success'); // 注册caller的release监听 caller.onRelease((msg) => { - console.info(`remote caller onRelease is called ${msg}`) + console.info(`remote caller onRelease is called ${msg}`); }) - console.info('remote caller register OnRelease succeed') + console.info('remote caller register OnRelease succeed'); } }).catch((error) => { - console.error(`get remote caller failed with ${error}`) + console.error(`get remote caller failed with ${error}`); }) } ``` @@ -503,34 +479,34 @@ 1. 向被调用端发送Sequenceable数据有两种方式，一种是不带返回值，一种是获取被调用端返回的数据，method以及序列化数据需要与被调用端协商一致。如下示例调用Call接口，向Callee被调用端发送数据。 ```ts - const MSG_SEND_METHOD: string = 'CallSendMsg' + const MSG_SEND_METHOD: string = 'CallSendMsg'; async onButtonCall() { try { - let msg = new MySequenceable(1, 'origin_Msg') - await this.caller.call(MSG_SEND_METHOD, msg) + let msg = new MySequenceable(1, 'origin_Msg'); + await this.caller.call(MSG_SEND_METHOD, msg); } catch (error) { - console.info(`caller call failed with ${error}`) + console.info(`caller call failed with ${error}`); } } ``` 2. 如下示例调用CallWithResult接口，向Callee被调用端发送待处理的数据originMsg，并将’CallSendMsg’方法处理完毕的数据赋值给backMsg。 ```ts - const MSG_SEND_METHOD: string = 'CallSendMsg' - originMsg: string = '' - backMsg: string = '' + const MSG_SEND_METHOD: string = 'CallSendMsg'; + originMsg: string = ''; + backMsg: string = ''; async onButtonCallWithResult(originMsg, backMsg) { try { - let msg = new MySequenceable(1, originMsg) - const data = await this.caller.callWithResult(MSG_SEND_METHOD, msg) - console.info('caller callWithResult succeed') + let msg = new MySequenceable(1, originMsg); + const data = await this.caller.callWithResult(MSG_SEND_METHOD, msg); + console.info('caller callWithResult succeed'); - let result = new MySequenceable(0, '') - data.readSequenceable(result) - backMsg(result.str) - console.info(`caller result is [${result.num}, ${result.str}]`) + let result = new MySequenceable(0, ''); + data.readSequenceable(result); + backMsg(result.str); + console.info(`caller result is [${result.num}, ${result.str}]`); } catch (error) { - console.info(`caller callWithResult failed with ${error}`) + console.info(`caller callWithResult failed with ${error}`); } } ``` @@ -541,11 +517,11 @@ ```ts releaseCall() { try { - this.caller.release() + this.caller.release(); this.caller = undefined - console.info('caller release succeed') + console.info('caller release succeed'); } catch (error) { - console.info(`caller release failed with ${error}`) + console.info(`caller release failed with ${error}`); } } ``` diff --git a/zh-cn/application-dev/application-models/mission-management-launch-type.md b/zh-cn/application-dev/application-models/mission-management-launch-type.md index dec6697adb287c09cf28b7f024ad3c7270a965ca..713e62c3dfccc25ca1d9df56ab986c74ba30590d 100644 --- a/zh-cn/application-dev/application-models/mission-management-launch-type.md +++ b/zh-cn/application-dev/application-models/mission-management-launch-type.md @@ -8,12 +8,12 @@ - singleton：单实例模式，应用在运行时只存在一个该UIAbility实例。 **图1** 任务与singleton模式 -![mission-and-singleton](figures/mission-and-singleton.png) + ![mission-and-singleton](figures/mission-and-singleton.png) - standard：多实例模式，每次调用startAbility()方法，都会在应用进程中创建一个该Ability的实例。 **图2** 任务与standard模式 -![mission-and-standard](figures/mission-and-standard.png) + ![mission-and-standard](figures/mission-and-standard.png) - specified：指定实例模式，由[AbilityStage](abilitystage.md)的（[onAcceptWant](../reference/apis/js-apis-app-ability-abilityStage.md#abilitystageonacceptwant)）决定是否创建新的实例。 @@ -27,5 +27,5 @@ 每个UIAbility实例对应的Mission都保留有该UIAbility实例的快照（Snapshot），UIAbility实例销毁后，Mission信息（包括Ability信息和任务快照）依然会保留，直到用户删除该任务。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > specified模式只在Stage模型上支持，FA模型不支持。 diff --git a/zh-cn/application-dev/application-models/pageability-lifecycle.md b/zh-cn/application-dev/application-models/pageability-lifecycle.md index 5eca9285797be7d8c3791cf0ce0546c466962385..843b8824de6afe508cfc8e8e89301fbe5089a850 100644 --- a/zh-cn/application-dev/application-models/pageability-lifecycle.md +++ b/zh-cn/application-dev/application-models/pageability-lifecycle.md @@ -41,7 +41,7 @@ PageAbility生命周期回调与生命周期状态的关系如下图所示。 ![fa-pageAbility-lifecycle](figures/fa-pageAbility-lifecycle.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 1、PageAbility的生命周期回调均为同步接口。 -> -> 2、目前app.js环境中仅支持onCreate和onDestroy回调，app.ets环境支持全量生命周期回调。 +> **说明：** +> +> 1. PageAbility的生命周期回调均为同步接口。 +> 2. 目前app.js环境中仅支持onCreate和onDestroy回调，app.ets环境支持全量生命周期回调。 diff --git a/zh-cn/application-dev/application-models/serviceextensionability.md b/zh-cn/application-dev/application-models/serviceextensionability.md index 163ec6b69b3fe1c308ae68e2648e75f04b6e5097..77b67d880ca46844cf274f6b1b4f2995cf617f0c 100644 --- a/zh-cn/application-dev/application-models/serviceextensionability.md +++ b/zh-cn/application-dev/application-models/serviceextensionability.md @@ -25,7 +25,7 @@ - [连接一个后台服务](#连接一个后台服务) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 1. OpenHarmony当前不支持三方应用实现ServiceExtensionAbility。如果三方开发者想要实现后台处理相关事务的功能，可以使用后台任务，具体请参见[后台任务](../task-management/background-task-overview.md)。 > > 2. 三方应用的UIAbility组件可以通过Context连接系统提供的ServiceExtensionAbility。 @@ -43,7 +43,7 @@ - **onCreate** 服务被首次创建时触发该回调，开发者可以在此进行一些初始化的操作，例如注册公共事件监听等。 - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** + > **说明：** > 如果服务已创建，再次启动该ServiceExtensionAbility不会触发onCreate()回调。 - **onRequest** @@ -162,7 +162,7 @@ 系统应用通过[startServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstartserviceextensionability)方法启动一个后台服务，服务的[onRequest()](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md#serviceextensionabilityonrequest)回调就会被调用，并在该回调方法中接收到调用者传递过来的want对象。后台服务启动后，其生命周期独立于客户端，即使客户端已经销毁，该后台服务仍可继续运行。因此，后台服务需要在其工作完成时通过调用ServiceExtensionContext的[terminateSelf()](../reference/apis/js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextterminateself)来自行停止，或者由另一个组件调用[stopServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstopserviceextensionability)来将其停止。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > ServiceExtensionContext的[startServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstartserviceextensionability)、[stopServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstopserviceextensionability)和[terminateSelf()](../reference/apis/js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextterminateself)为系统接口，三方应用不支持调用。 1. 在系统应用中启动一个新的ServiceExtensionAbility。示例中的context的获取方式参见[获取UIAbility的Context属性](uiability-usage.md#获取uiability的上下文信息)。 @@ -207,7 +207,7 @@ ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 后台服务可以在后台长期运行，为了避免资源浪费，需要对后台服务的生命周期进行管理。即一个后台服务完成了请求方的任务，需要及时销毁。销毁已启动的后台服务有两种方式： > > - 后台服务自身调用[terminateSelf()](../reference/apis/js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextterminateself)方法来自行停止。 diff --git a/zh-cn/application-dev/application-models/thread-model-fa.md b/zh-cn/application-dev/application-models/thread-model-fa.md index 17efc76b93c69c2d4794fcad58ed80b0bb1015e2..fb97b7cd0b9969583a4b3256a8f72791ca823e0f 100644 --- a/zh-cn/application-dev/application-models/thread-model-fa.md +++ b/zh-cn/application-dev/application-models/thread-model-fa.md @@ -21,5 +21,5 @@ FA模型下的线程主要有如下三类： 基于OpenHarmony的线程模型，不同的业务功能运行在不同的线程上，业务功能的交互就需要线程间通信。线程间通信目前主要有Emitter和Worker两种方式，其中Emitter主要适用于线程间的事件同步， Worker主要用于新开一个线程执行耗时任务。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > FA模型每个ability都有一个独立的线程，Emiter可用于Ability线程内、Ability线程间、Ability线程与Worker线程的事件同步。 diff --git a/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md b/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md index b1269e79b7b90a9da7d6782ad405ff51182caa76..9c8edd0f194631026a93d353a0cdd89f0217cd81 100644 --- a/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md +++ b/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md @@ -410,7 +410,7 @@ export default class FuncAbility extends UIAbility { } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 当被调用方[Ability的启动模式](uiability-launch-type.md)设置为standard启动模式时，每次启动都会创建一个新的实例，那么[onNewWant()](../reference/apis/js-apis-app-ability-uiAbility.md#abilityonnewwant)回调就不会被用到。 @@ -448,7 +448,7 @@ Call调用示意图如下所示。 - CalleeAbility持有一个Callee对象，通过Callee的on方法注册回调函数，当接收到Caller发送的数据时将会调用对应的回调函数。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 1. 当前仅支持系统应用使用Call调用。 > > 2. CalleeAbility的启动模式需要为单实例。 diff --git a/zh-cn/application-dev/application-models/uiability-launch-type.md b/zh-cn/application-dev/application-models/uiability-launch-type.md index 6a9e4627f021908373eab8cd394bc558f9fb61f6..05b111d4b480122c4829a5897adbe1c806f27b0d 100644 --- a/zh-cn/application-dev/application-models/uiability-launch-type.md +++ b/zh-cn/application-dev/application-models/uiability-launch-type.md @@ -20,7 +20,7 @@ singleton启动模式为单实例模式，也是默认情况下的启动模式 **图1** 单实例模式演示效果 uiability-launch-type1 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 应用的UIAbility实例已创建，该UIAbility配置为单实例模式，再次调用startAbility()方法启动该UIAbility实例，此时只会进入该UIAbility的[onNewWant()](../reference/apis/js-apis-app-ability-uiAbility.md#abilityonnewwant)回调，不会进入其onCreate()和onWindowStageCreate()生命周期回调。 如果需要使用singleton启动模式，在[module.json5配置文件](../quick-start/module-configuration-file.md)中的"launchType"字段配置为"singleton"即可。 @@ -75,7 +75,7 @@ specified启动模式为指定实例模式，针对一些特殊场景使用（ **图3** 指定实例模式演示效果 uiability-launch-type2 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 应用的UIAbility实例已创建，该UIAbility配置为指定实例模式，再次调用startAbility()方法启动该UIAbility实例，且[AbilityStage](abilitystage.md)的[onAcceptWant()](../reference/apis/js-apis-app-ability-abilityStage.md#abilitystageonacceptwant)回调匹配到一个已创建的UIAbility实例。此时，再次启动该UIAbility时，只会进入该UIAbility的[onNewWant()](../reference/apis/js-apis-app-ability-uiAbility.md#abilityonnewwant)回调，不会进入其onCreate()和onWindowStageCreate()生命周期回调。 例如有两个UIAbility：EntryAbility和FuncAbility，FuncAbility配置为specified启动模式，需要从EntryAbility的页面中启动FuncAbility。 diff --git a/zh-cn/application-dev/application-models/uiability-lifecycle.md b/zh-cn/application-dev/application-models/uiability-lifecycle.md index 068b56748aef275ea1b3438911bf75f4a50eabdf..92c14fee24fc307bc840324939d12a7429c2f704 100644 --- a/zh-cn/application-dev/application-models/uiability-lifecycle.md +++ b/zh-cn/application-dev/application-models/uiability-lifecycle.md @@ -57,7 +57,7 @@ export default class EntryAbility extends UIAbility { } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > WindowStage的相关使用请参见[窗口开发指导](../windowmanager/application-window-stage.md)。 对应于onWindowStageCreate()回调。在UIAbility实例销毁之前，则会先进入onWindowStageDestroy()回调，可以在该回调中释放UI界面资源。例如在onWindowStageDestroy()中注销获焦/失焦等WindowStage事件。 diff --git a/zh-cn/application-dev/application-models/uiability-overview.md b/zh-cn/application-dev/application-models/uiability-overview.md index c14f0dc4c4a00e45c54a85a8082f607ee58201de..1ffe36134096e12816d10c14b2c476c5a3e7dae5 100644 --- a/zh-cn/application-dev/application-models/uiability-overview.md +++ b/zh-cn/application-dev/application-models/uiability-overview.md @@ -33,5 +33,5 @@ UIAbility组件是系统调度的基本单元，为应用提供绘制界面的 } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > Ability的组成请参见在[模块中添加Ability](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-adding-ability-0000001218280664-V3)。 diff --git a/zh-cn/application-dev/application-models/uiability-usage.md b/zh-cn/application-dev/application-models/uiability-usage.md index 457bb45f3ba2b0dee5224585b38e818d09faa134..15fbffbb0997f0197ea38266b591ba9476e95cea 100644 --- a/zh-cn/application-dev/application-models/uiability-usage.md +++ b/zh-cn/application-dev/application-models/uiability-usage.md @@ -25,7 +25,7 @@ export default class EntryAbility extends UIAbility { } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 在DevEco Studio中创建的UIAbility中，该UIAbility实例默认会加载Index页面，根据需要将Index页面路径替换为需要的页面路径即可。 diff --git a/zh-cn/application-dev/application-models/want-overview.md b/zh-cn/application-dev/application-models/want-overview.md index 6fae778dd8951cb648d0f4cb00612d3a136941d8..cefeef69ebce6b8d22aeabc1239dc3b9d1622d1e 100644 --- a/zh-cn/application-dev/application-models/want-overview.md +++ b/zh-cn/application-dev/application-models/want-overview.md @@ -38,7 +38,7 @@ }; ``` - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** + > **说明：** > - 根据系统中待匹配Ability的匹配情况不同，使用隐式Want启动Ability时会出现以下三种情况。 > - 未匹配到满足条件的Ability：启动失败。 > - 匹配到一个满足条件的Ability：直接启动该Ability。 diff --git a/zh-cn/application-dev/application-models/widget-development-fa.md b/zh-cn/application-dev/application-models/widget-development-fa.md index 9f1594fa80ba3d3ffad962d1c9515f1fb5aee8dc..d07ae553e7c22972e5decf194786205d4683ee4c 100644 --- a/zh-cn/application-dev/application-models/widget-development-fa.md +++ b/zh-cn/application-dev/application-models/widget-development-fa.md @@ -49,7 +49,7 @@ - 通信适配层：由OpenHarmony SDK提供，负责与卡片管理服务通信，用于将卡片的更新数据主动推送到卡片管理服务。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 实际开发时只需要作为卡片提供方进行卡片内容的开发，卡片使用方和卡片管理服务由系统自动处理。 @@ -166,7 +166,7 @@ FA卡片开发，即基于[FA模型](fa-model-development-overview.md)的卡片 } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > FormAbility不能常驻后台，即在卡片生命周期回调函数中无法处理长时间的任务。 ### 配置卡片配置文件 @@ -360,7 +360,7 @@ onUpdate(formId) { ![widget-development-fa](figures/widget-development-fa.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 当前仅支持JS扩展的类Web开发范式来实现卡片的UI界面。 - HML：使用类Web范式的组件描述卡片的页面信息。 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 52c7082a309b24975a7e55fd97381a500605b553..2064bf7b7175cf87f7777103686f41f46395ad58 100644 --- a/zh-cn/application-dev/application-models/widget-development-stage.md +++ b/zh-cn/application-dev/application-models/widget-development-stage.md @@ -49,7 +49,7 @@ FormExtensionAbility就是服务卡片扩展组件（以下简称“卡片”） - 通信适配层：由OpenHarmony SDK提供，负责与卡片管理服务通信，用于将卡片的更新数据主动推送到卡片管理服务。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 实际开发时只需要作为卡片提供方进行卡片内容的开发，卡片使用方和卡片管理服务由系统自动处理。 @@ -173,7 +173,7 @@ Stage卡片开发，即基于[Stage模型](stage-model-development-overview.md) } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > FormExtensionAbility不能常驻后台，即在卡片生命周期回调函数中无法处理长时间的任务。 ### 配置卡片配置文件 @@ -369,7 +369,7 @@ onUpdateForm(formId) { ![widget-development-stage](figures/widget-development-stage.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 当前仅支持JS扩展的类Web开发范式来实现卡片的UI界面。 - HML：使用类Web范式的组件描述卡片的页面信息。 diff --git a/zh-cn/application-dev/device/device-location-geocoding.md b/zh-cn/application-dev/device/device-location-geocoding.md index ac7f6ebc509ade083fa2f99d773b1d49598a8b0d..32892d089c9c587b1efcfd6aafcb62fa98e96d74 100644 --- a/zh-cn/application-dev/device/device-location-geocoding.md +++ b/zh-cn/application-dev/device/device-location-geocoding.md @@ -29,18 +29,18 @@ ## 开发步骤 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > GeoConvert需要访问后端服务，请确保设备联网，以进行信息获取。 1. 导入geoLocationManager模块，所有与（逆）地理编码转化能力相关的功能API，都是通过该模块提供的。 - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; ``` 2. 查询geoCoder服务是否可用。 - 调用isGeoServiceAvailable查询geoCoder服务是否可用，如果服务可用再继续进行步骤3。 - + ```ts import geoLocationManager from '@ohos.geoLocationManager'; try { @@ -52,7 +52,7 @@ 3. 获取转化结果。 - 调用getAddressesFromLocation，坐标转化地理位置信息。 - + ```ts var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1}; try { @@ -70,7 +70,7 @@ 参考接口API说明[位置服务](../reference/apis/js-apis-geoLocationManager.md)，应用可以获得与此坐标匹配的GeoAddress列表，应用可以根据实际使用需求，读取相应的参数数据。 - 调用getAddressesFromLocationName位置描述转化坐标。 - + ```ts var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1}; try { diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/adaptive-layout.md b/zh-cn/application-dev/key-features/multi-device-app-dev/adaptive-layout.md index a2469187c0cdab7b5640c9c67e3858f6cf59c797..460af3ee3593efe15f04bf76cac98cd17e797539 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/adaptive-layout.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/adaptive-layout.md @@ -34,7 +34,7 @@ | flexBasis | 'auto' \| [Length](../../reference/arkui-ts/ts-types.md#length) | 'auto' | 设置组件在Flex容器中主轴方向上基准尺寸。'auto'意味着使用组件原始的尺寸，不做修改。
flexBasis属性不是必须的，通过width或height也可以达到同样的效果。当flexBasis属性与width或height发生冲突时，以flexBasis属性为准。 | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 开发者期望将父容器的剩余空间全部分配给某空白区域时，也可以通过[Blank组件](../../reference/arkui-ts/ts-basic-components-blank.md)实现。注意仅当父组件为Row\Column\Flex组件时，Blank组件才会生效。 > > - 类Web开发范式也是通过flex-grow和flex-shrink实现拉伸能力，同时也支持配置flex-basis，详见[通用样式](../../reference/arkui-js/js-components-common-styles.md)。 @@ -170,7 +170,7 @@ struct FlexibleCapabilitySample2 { 均分能力可以通过将[Row组件](../../reference/arkui-ts/ts-container-row.md)、[Column组件](../../reference/arkui-ts/ts-container-column.md)或[Flex组件](../../reference/arkui-ts/ts-container-flex.md)的justifyContent属性设置为FlexAlign.SpaceEvenly实现，即子元素在父容器主轴方向等间距布局，相邻元素之间的间距、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 均分能力还可以通过其它方式实现，如使用[Grid网格组件](../../reference/arkui-ts/ts-container-grid.md)或在每个组件间添加Blank组件等。 > > - 类Web开发范式中，通过将[div组件](../../reference/arkui-js/js-components-container-div.md)的justify-content属性设置为space-evenly来实现均分布局。 @@ -276,7 +276,7 @@ struct EquipartitionCapabilitySample { layoutWeight存在使用限制，所以实际使用过程中大多通过将子组件宽高设置为父组件的百分比来实现占比能力。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 占比能力在实际开发中使用的非常广泛，可以通过很多不同的方式实现占比能力，如还可以通过[Grid组件](../../reference/arkui-ts/ts-container-grid.md)的columnsTemplate属性设置网格容器中列的数量及其宽度比例，或通过配置子组件在栅格（本章后文将详细介绍栅格系统）中占据不同的列数来实现占比能力。本小节仅介绍最基础和常用的实现方式，局限性较大或比非常小众的实现方式，本文不做展开介绍。 > > - 类Web开发范式同样支持以百分比的形式设置组件的宽高，详见[通用样式](../../reference/arkui-js/js-components-common-styles.md)中关于width和height的介绍以及[长度类型介绍](../../reference/arkui-js/js-appendix-types.md#长度类型)。 @@ -373,7 +373,7 @@ struct ProportionCapabilitySample { 可以访问[布局约束](../../reference/arkui-ts/ts-universal-attributes-layout-constraints.md)，了解aspectRatio属性的详细信息。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 类Web开发范式同样提供了[aspect-ratio样式](../../reference/arkui-js/js-components-common-atomic-layout.md#固定比例)，用于固定组件的宽高比。 @@ -450,7 +450,7 @@ struct ScaleCapabilitySample { - 通过[Scroll组件](../../reference/arkui-ts/ts-container-scroll.md)配合[Row组件](../../reference/arkui-ts/ts-container-row.md)或[Column组件](../../reference/arkui-ts/ts-container-column.md)实现。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - List、Row或Column组件中子节点的在页面显示时就已经全部完成了布局计算及渲染，只不过受限于父容器尺寸，用户只能看到一部分。随着父容器尺寸增大，用户可以看到的子节点数目也相应的增加。用户还可以通过手指滑动触发列表滑动，查看被隐藏的子节点。 > > - 类Web开发范式同样可以使用[list组件](../../reference/arkui-js/js-components-container-list.md)实现延伸能力。 @@ -603,7 +603,7 @@ struct ExtensionCapabilitySample2 { 可以访问[布局约束](../../reference/arkui-ts/ts-universal-attributes-layout-constraints.md)，了解displayPriority属性的详细信息。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 类Web开发范式同样支持[display-index样式](../../reference/arkui-js/js-components-common-atomic-layout.md#隐藏能力)，用于设置布局优先级。 **示例：** @@ -694,7 +694,7 @@ struct HiddenCapabilitySample { 可以访问[Flex组件](../../reference/arkui-ts/ts-container-flex.md)，了解Flex组件的详细用法。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 类Web开发范式通过将[div组件](../../reference/arkui-js/js-components-container-div.md)的flex-warp样式设置为wrap来使用折行能力。 **示例：** diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/case.md b/zh-cn/application-dev/key-features/multi-device-app-dev/case.md index d269597fcfdc618b5adfb619d03295594cb82272..0615998148d7b2c305025d73d22b2ad0caa857a2 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/case.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/case.md @@ -82,7 +82,7 @@ 接下来我们详细介绍各部分的实现。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 为了方便理解，我们对会话详情页面做了一定的精简，本小节仅介绍会话详情页面最基础的实现。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/design-delivery.md b/zh-cn/application-dev/key-features/multi-device-app-dev/design-delivery.md index 863233e230a40323ea6ad9fcb5b9f0650a6c4337..658db5e5e1a18a8a49be9f990a4badbddeb6f6d2 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/design-delivery.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/design-delivery.md @@ -43,7 +43,7 @@ ![4.8-效果示意图](figures/4.8-效果示意图.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 画板尺寸为不同宽度断点下的典型设备屏幕尺寸，可根据业务具体针对的设备选择其他画板尺寸。 > > - 画板尺寸以vp为单位提供，根据实际设计所需精度，可统一把设计文档中所有画板设置为1倍或多倍的px尺寸。 @@ -65,7 +65,7 @@ ![4.8-标注图](figures/4.8-标注图.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 如遇到分层参数覆盖不到的属性值，可按照具体设计效果标注。此时必须详细考虑不同场景下该元素的效果。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/design-resources.md b/zh-cn/application-dev/key-features/multi-device-app-dev/design-resources.md index 3a83dbeade1e5161f4c353bf7305fd0eeca27521..672ea89fa456f30e8da8c63255f44b44ee489595 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/design-resources.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/design-resources.md @@ -22,7 +22,7 @@ | 不透明度数值速查表 | 用于将不透明度在**百分比表示形式**和**十六进制表示形式**之间快速转换的速查表。 | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 推荐应用相关系统参数仅在应用开发场景中使用，卡片相关系统参数仅在卡片开发场景中使用。 > > - 同一系统参数在不同类型的设备上有不同的取值，当前仅提供了系统参数在默认设备上的取值，后续会针对不同设备类型做补充。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/development-intro.md b/zh-cn/application-dev/key-features/multi-device-app-dev/development-intro.md index 4b67d2d5e3a66be2e0ac18f05ccf52ff2b9fd754..acd20884d964ed47da68e1fbd3d2336d4fdfc8df 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/development-intro.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/development-intro.md @@ -25,7 +25,7 @@ 2. 在安装阶段，核心安装逻辑：安装的应用调用的系统能力是设备系统能力的子集。满足这个条件，用户才能安装该应用。 3. If/Else的动态逻辑判断。伪代码简单示例如下： - + ``` if (该设备有系统能力1) { 运行系统能力1相关的代码; @@ -64,7 +64,7 @@ IDE中提供了API的联想功能，方便开发者使用系统能力。当开 开发者可以通过canIUse接口，判断目标设备是否支持某系统能力，进而执行不同的业务逻辑。 - + ``` import geolocation from'@ohos.geolocation'; @@ -93,5 +93,5 @@ struct Index { } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 开发者通过 import 方式导入的模块，若当前设备不支持该模块，import 的结果为 undefined。故开发者在使用 API 时，需要判断其是否存在。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md b/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md index d433f8398b05754a555b61fd92c351f875299bda..eac761f3396c396c848e1c1c2c27aa1fae7223c7 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/ide-using.md @@ -4,7 +4,7 @@ DevEco Studio的基本使用，请参考[DevEco Studio使用指南](../../quick-start/deveco-studio-user-guide-for-openharmony.md)。本章主要介绍如何使用DevEco Studio进行多设备应用开发。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本章的内容基于[DevEco Studio 3.0 Beta3](https://developer.harmonyos.com/cn/develop/deveco-studio#download_beta_openharmony)版本进行介绍，如您使用DevEco Studio其它版本，可能存在文档与产品功能界面、操作不一致的情况，请以实际功能界面为准。 @@ -55,7 +55,7 @@ DevEco Studio的基本使用，请参考[DevEco Studio使用指南](../../quick- ![zh-cn_image_0000001315434285](figures/zh-cn_image_0000001315434285.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 在一个工程中同一个设备类型只支持一个Entry类型的模块。 > > - 当前的DevEco Studio（3.0 Beta3版本）在创建工程时，设备类型仅能选择dafault和tablet，默认该模块已经选择了entry类型，那么在创建wearable这个模块，只能选择feature类型。 @@ -139,7 +139,7 @@ DevEco Studio的基本使用，请参考[DevEco Studio使用指南](../../quick- 3. 在default模块中import和使用这些类和函数。注意提前在default模块的package.json文件中配置对common模块的依赖关系。 ![zh-cn_image_0000001267914120](figures/zh-cn_image_0000001267914120.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 如果需要将npm包发布供其他开发者使用，当前npm包可发布到npm官方中心仓和OpenHarmony npm专用仓，具体可参考[发布OpenHarmony npm包](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-development-npm-package-0000001222578434#section663116411397)。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/interaction-event-normalization.md b/zh-cn/application-dev/key-features/multi-device-app-dev/interaction-event-normalization.md index e57dccf4a80051478ba9a8368f5580cda71a47ba..d6dfbe141b2eda726e828874f167adfcab56cb47 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/interaction-event-normalization.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/interaction-event-normalization.md @@ -22,7 +22,7 @@ | 缩放 | [PinchGesture](../../reference/arkui-ts/ts-basic-gestures-pinchgesture.md) | √ | √ | √ | | 旋转 | [RotationGesture](../../reference/arkui-ts/ts-basic-gestures-rotationgesture.md) | √ | NA | √ | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 点击事件（onClick）其实是点击手势（TapGesture）的一个特殊场景（单指单次点击）。该场景使用的非常广泛，为了方便开发者使用及符合传统开发习惯，所以专门提供了开发接口。 > > - 触控板支持长按输入的功能正在开发中。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md b/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md index 368c27cf69aa158ddf7c0c61794a4c90f4d2d038..cb28e448d84b8ec4147c98ac6f9f634207a8d107 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/introduction.md @@ -24,7 +24,7 @@ 从第4章开始将从UX设计、系统能力等角度，详尽的解答上述问题。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 应用开发不仅包含应用页面开发，还包括应用后端功能开发以及服务器端开发等。 > > - 本文旨在指导开发者如何在OpenHarmony系统中开发“一多”应用，服务器端开发不在本文探讨范围内。 @@ -47,7 +47,7 @@ HAP包是OpenHarmony的安装包，一个HAP在工程目录中对应一个Module ![zh-cn_image_0000001266965046](figures/zh-cn_image_0000001266965046.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - Module是开发者开发的相对独立的功能模块，由代码、资源、第三方库及应用配置文件组成，属于IDE开发视图的概念。Module分为entry、feature及har三种类型，相应的可以编译生成entry类型的HAP包、feature类型的HAP包，以及har包。 > > - 如果需要了解应用程序包结构更多详情，可以查看[包结构说明](../../quick-start/application-package-structure-stage.md)。 @@ -71,7 +71,7 @@ OpenHarmony提供了方舟开发框架（简称：ArkUI），提供开发者进 | 声明式开发范式 | ArkTS语言 | 数据驱动更新 | 复杂度较大、团队合作度较高的程序 | 移动系统应用开发人员、系统应用开发人员 | | 类Web开发范式 | JS语言 | 数据驱动更新 | 界面较为简单的中小型应用和卡片 | Web前端开发人员 | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 声明式开发范式占用内存更少，**更推荐开发者选用声明式开发范式来搭建应用UI界面**。 > > - 可以查看[方舟开发框架概述](../../ui/arkui-overview.md)，了解方舟开发框架更多详情。 @@ -108,7 +108,7 @@ OpenHarmony提供了方舟开发框架（简称：ArkUI），提供开发者进 ![zh-cn_image_0000001400300617](figures/zh-cn_image_0000001400300617.png) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 页面导航逻辑是指应用内页面之间的跳转关系。假设默认设备上页面A跳转到页面B，平板设备上也是页面A跳转到页面B。因为两种设备屏幕大小不同，默认设备上页面B是覆盖显示在页面A上的，平板设备上页面B是在页面A的右边并且同时显示，但因为都是页面A跳转到页面B，那么我们认为它们的页面导航逻辑相同。 **工程结构** @@ -121,7 +121,7 @@ OpenHarmony提供了方舟开发框架（简称：ArkUI），提供开发者进 - product：产品层目录，通过引用common和feature目录中代码的方式做功能和特性的集成，同时也作为主入口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > features层可横向调用和依赖common层能力；product层不可横向调用，可依赖features层和common层，且不能有反向依赖。 部署模型不同，相应的代码工程结构也有差异。部署模型A和部署模型B的主要差异点集中在product层： @@ -132,7 +132,7 @@ OpenHarmony提供了方舟开发框架（简称：ArkUI），提供开发者进 部署模型A对应的代码工程结构抽象后一般如下所示： - + ``` /application ├── common # 可选。公共特性目录, har类型的module @@ -145,7 +145,7 @@ OpenHarmony提供了方舟开发框架（简称：ArkUI），提供开发者进 部署模型B对应的代码工程结构抽象后一般如下所示： - + ``` /application ├── common # 可选。公共特性目录, har类型的module @@ -159,5 +159,5 @@ OpenHarmony提供了方舟开发框架（简称：ArkUI），提供开发者进 └── ... ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 无论是用部署模型A还是部署模型B，在开发阶段，都应考虑**不同类型设备间最大程度的复用代码**，以减少开发及后续维护的工作量。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md b/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md index 5c54f556c809c56c2e85cae96bf602f03d421d96..0ea9287e72cb57e3213fe37976c53337b77cc65c 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/page-development-intro.md @@ -18,7 +18,7 @@ - [资源使用](resource-usage.md) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 开发多设备上同一页面时，建议开发者多使用自定义组件，既可以增加代码的可读性和可维护性，同时也可以尽可能的实现代码复用。 @@ -36,4 +36,3 @@ | [蔬菜百科首页](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/Vegetable) | 声明式开发范式 | 一多示例页面，以蔬菜百科首页为例，演示如何使用一多能力适配多设备（或多窗口尺寸）。 | | [天气](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/Weather) | 声明式开发范式 | 一多示例应用，以天气应用为例，演示如何使用一多能力实现包含多个页面的应用。 | - diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/polymorphic-controls.md b/zh-cn/application-dev/key-features/multi-device-app-dev/polymorphic-controls.md index 8367fdae021a1178e636f0fabf664657082534d6..df85095968ece3cafa6eb5e76f3e756e8214b999 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/polymorphic-controls.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/polymorphic-controls.md @@ -4,5 +4,5 @@ 方舟开发框架不仅提供了多种基础组件（如文本显示、图片显示、按键交互等），并且针对不同类型设备分别进行了适配。同一组件在不同的设备上会呈现出不同的形态（即视觉、交互、动效等可能有差异），称为“多态组件”。开发者在使用多态组件时，无需考虑设备差异，只需关注功能实现即可。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > OpenHarmony上的多态组件能力正在逐步补齐中。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/resource-usage.md b/zh-cn/application-dev/key-features/multi-device-app-dev/resource-usage.md index 00087b4de01593b4eb1e519c5e8b7f5d5c0fc765..621a5911bce8eb99dc181ca3a83af57411b56efe 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/resource-usage.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/resource-usage.md @@ -16,7 +16,7 @@ 应用开发中使用的各类自定义资源文件，需要统一存放于应用的resources目录下，便于使用和维护。resources目录包括两大类目录，一类为base目录与限定词目录，另一类为rawfile目录，其基础目录结构如下所示。 - + ``` resources |---base // 默认存在的目录 @@ -34,7 +34,7 @@ resources base目录默认存在，而限定词目录需要开发者自行创建，其名称可以由一个或多个表征应用场景或设备特征的限定词组合而成。应用使用某资源时，系统会根据当前设备状态优先从相匹配的限定词目录中寻找该资源。只有当resources目录中没有与设备状态匹配的限定词目录，或者在限定词目录中找不到该资源时，才会去base目录中查找。rawfile是原始文件目录，它不会根据设备状态去匹配不同的资源，故不在本文的讨论范文内。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 请访问[声明式开发范式资源文件分类](../../quick-start/resource-categories-and-access.md#资源分类)，了解限定词目录的命名规则、创建流程、匹配规则等，本文不展开介绍。 > > - 没有设备状态匹配的限定词目录，或者在限定词目录中找不到目标资源时，会继续在base目录中查找。**强烈建议对于所有应用自定义资源都在base目录中定义默认值**，防止出现找不到资源值的异常场景。 @@ -50,7 +50,7 @@ base目录与限定词目录下面可以创建资源组目录（包括element、 在element目录的各个资源文件中，以“name-value”的形式定义资源，如下所示。而在media目录中，直接以文件名作为name，故开发者将文件放入media目录即可，无需再额外定义name。 - + ``` // color.json { @@ -72,7 +72,7 @@ base目录与限定词目录下面可以创建资源组目录（包括element、 在工程中，通过 "$r('app.type.name')" 的形式引用应用资源。app代表是应用内resources目录中定义的资源；type 代表资源类型（或资源的存放位置），可以取 color、float、string、plural和media，name代表资源命名，由开发者添加资源时确定。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 可以查看[声明式范式访问应用资源](../../quick-start/resource-categories-and-access.md#应用资源)，了解资源访问的更多细节。 @@ -91,7 +91,7 @@ base目录与限定词目录下面可以创建资源组目录（包括element、 ![zh-cn_image_0000001325731389](figures/zh-cn_image_0000001325731389.png) - + ``` @Entry @Component @@ -120,7 +120,7 @@ struct Index { 可以查看本文[应用UX设计中关于资源的介绍](design-resources.md)，获取OpenHarmony支持的系统资源ID及其在不同配置下的取值。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 仅声明式开发范式支持使用分层参数，类Web开发范式不支持。 > > - 系统资源可以保证不同团队开发出的应用有较为一致的视觉风格。对于系统预置应用，强烈建议使用系统资源；对于三方应用，可以根据需要选择使用系统资源或自定义应用资源。 diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md b/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md index 2bd77dc689cee0587755f72176153fe8e99023b6..9f7df6a329a9c265a255b9bbdd0256b6a5a8e14b 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/responsive-layout.md @@ -28,7 +28,7 @@ | md | [520, 840) | | lg | [840, +∞) | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 以设备屏幕宽度作为参照物，也可以实现类似的效果。考虑到应用可能以非全屏窗口的形式显示，以应用窗口宽度为参照物更为通用。 > > - 开发者可以根据实际使用场景决定适配哪些断点。如xs断点对应的一般是智能穿戴类设备，如果确定某页面不会在智能穿戴设备上显示，则可以不适配xs断点。 @@ -129,7 +129,7 @@ OpenHarmony提供了多种方法，判断应用当前处于何种断点，进而 本小节仅介绍**媒体查询跟断点的结合**，即如何借助媒体查询能力，监听断点的变化，读者可以自行查阅官网中关于[媒体查询](../../ui/ui-ts-layout-mediaquery.md)的相关介绍了解更详细的用法。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 类Web开发范式，支持在js文件和css文件中使用媒体查询，请查看[js媒体查询](../../reference/apis/js-apis-mediaquery.md)和[css媒体查询](../../reference/arkui-js/js-components-common-mediaquery.md)了解详细用法。 @@ -275,7 +275,7 @@ struct MediaQuerySample { | -------- | -------- | | ![zh-cn_image_0000001336486244](figures/zh-cn_image_0000001336486244.jpg) | ![zh-cn_image_0000001386646685](figures/zh-cn_image_0000001386646685.jpg) | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - ArkUI在API 9对栅格组件做了重构，推出了新的栅格组件[GridRow](../../reference/arkui-ts/ts-container-gridrow.md)和[GridCol](../../reference/arkui-ts/ts-container-gridcol.md)，同时原有的[GridContainer组件](../../reference/arkui-ts/ts-container-gridcontainer.md)及[栅格设置](../../reference/arkui-ts/ts-universal-attributes-grid.md)已经废弃。 > > - 本文中提到的栅格组件，如无特别说明，都是指GridRow和GridCol组件。 @@ -291,7 +291,7 @@ struct MediaQuerySample { - 栅格组件支持开发者修改断点的取值范围，除了默认的四个断点，还支持开发者启用xl和xxl两个额外的断点。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 断点并非越多越好，通常每个断点都需要开发者“精心适配”以达到最佳显示效果。 **示例1：** diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/start-with-a-example.md b/zh-cn/application-dev/key-features/multi-device-app-dev/start-with-a-example.md index d218d9e0c3242c0862105d4cab33dab7e5d8c1bc..d9598a6b386ee0c938877affe56b5ddd0653a451 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/start-with-a-example.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/start-with-a-example.md @@ -19,7 +19,7 @@ | 中设备 | [520, 840) | | 大设备 | [840, +∞) | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - vp是virtual pixel（虚拟像素）的缩写，是OpenHarmony中常用的长度单位，详见本文[视觉基础](visual-basics.md)小节中的介绍。 > > - 此处基于设备屏幕宽度划分不同设备是为了读者方便理解。通常智能设备上的应用都是以全屏的形式运行，但随着移动技术的发展，当前部分智能设备支持应用以自由窗口模式运行（即用户可以通过拖拽等操作自由调整应用运行窗口的尺寸），故以应用窗口尺寸为基准进行划分更为合适，本文后续的响应式布局章节中将详细介绍相关内容。 @@ -114,7 +114,7 @@ 延伸能力是指容器组件内的子组件，按照其在列表中的先后顺序，随容器组件尺寸变化显示或隐藏。随着可用显示区域的增加，用户可以看到的“每小时天气”信息也不断增加，故“每小时天气”可以通过延伸能力实现，其核心代码如下所示。 - + ``` @Component export default struct HoursWeather { @@ -149,10 +149,10 @@ export default struct HoursWeather { | -------- | -------- | -------- | | ![zh-cn_image_0000001395631821](figures/zh-cn_image_0000001395631821.png) | ![zh-cn_image_0000001345312038](figures/zh-cn_image_0000001345312038.png) | ![zh-cn_image_0000001349454550](figures/zh-cn_image_0000001349454550.png) | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 为提升用户体验，大设备侧边栏隐藏状态下，每日天气与空气质量的相对顺序发生了改变。可以调整通过GridCol栅格子组件的order属性，实现目标效果。 - + ``` @Component export default struct HomeContent { diff --git a/zh-cn/application-dev/key-features/multi-device-app-dev/typical-layout-scenario.md b/zh-cn/application-dev/key-features/multi-device-app-dev/typical-layout-scenario.md index 49b1ad68ec4699fa5c3a817210e443815af5da8b..21080e5e0227ed97d60beacf4bd47390e04e3ec0 100644 --- a/zh-cn/application-dev/key-features/multi-device-app-dev/typical-layout-scenario.md +++ b/zh-cn/application-dev/key-features/multi-device-app-dev/typical-layout-scenario.md @@ -18,7 +18,7 @@ | [重复布局](#重复布局) | 栅格组件 | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 在本文[媒体查询](responsive-layout.md#媒体查询)小节中已经介绍了如何通过媒体查询监听断点变化，后续的示例中不再重复介绍此部分代码。 diff --git a/zh-cn/application-dev/notification/progress-bar-notification.md b/zh-cn/application-dev/notification/progress-bar-notification.md index 732cafe7b72298248236f59ab1c43b9006dfd812..099f260185aa04fd4c8604427243450a3776359a 100644 --- a/zh-cn/application-dev/notification/progress-bar-notification.md +++ b/zh-cn/application-dev/notification/progress-bar-notification.md @@ -40,7 +40,7 @@ }); ``` - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** + > **说明：** > 查询系统支持进度条模板后，再进行后续的步骤操作。 4. 构造进度条模板对象，并发布通知。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-Bundle-BundleStatusCallback.md b/zh-cn/application-dev/reference/apis/js-apis-Bundle-BundleStatusCallback.md index bc19287abd6bf80a3f78211e937207df1ab4c58f..1d578d24c253adc3913460f3e9008f4b66430cb6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-Bundle-BundleStatusCallback.md +++ b/zh-cn/application-dev/reference/apis/js-apis-Bundle-BundleStatusCallback.md @@ -1,6 +1,6 @@ # BundleStatusCallback -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 从API version 9开始不再支持。建议使用[bundleMonitor](js-apis-bundleMonitor.md)替代。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-arraylist.md b/zh-cn/application-dev/reference/apis/js-apis-arraylist.md index b65af8cd98ceb0cda80db811dfc04894a079eaa1..448575f862be54c617432c375f62e5b41ac23334 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-arraylist.md +++ b/zh-cn/application-dev/reference/apis/js-apis-arraylist.md @@ -1,6 +1,6 @@ # @ohos.util.ArrayList (线性容器ArrayList) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ArrayList是一种线性数据结构，底层基于数组实现。ArrayList会根据实际需要动态调整容量，每次扩容增加50%。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-buffer.md b/zh-cn/application-dev/reference/apis/js-apis-buffer.md index 357969ee1ee97dcc29ceb83aade972fd1e222c31..e4568281726e03a9d9a99ef8f534ea0bd92b6e60 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-buffer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-buffer.md @@ -1,6 +1,6 @@ # @ohos.buffer (Buffer) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 Buffer对象用于表示固定长度的字节序列,是专门存放二进制数据的缓存区。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md index a760b9dfc4d136b98a36cdcfebbb2c0580631a99..a03f5b352e1d055f408bbf0144f64c87971f0016 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-AbilityInfo.md @@ -1,6 +1,6 @@ # AbilityInfo -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md index 17cc30ad33e595826d96c51b421d175eb9b3a00d..0cafdce9479cf4f0b513af164c838f0224049fd6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-ApplicationInfo.md @@ -1,6 +1,6 @@ # ApplicationInfo -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 应用程序信息，未做特殊说明的属性，均通过[GET_BUNDLE_DEFAULT](js-apis-Bundle.md)获取。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md index 040e100b187e733919d436e781d250a9213a9244..3521b7df34e11e214ef23ec4b91613cc80609a1c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInfo.md @@ -1,6 +1,6 @@ # BundleInfo -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 应用包的信息，未做特殊说明的属性，均通过[GET_BUNDLE_DEFAULT](js-apis-Bundle.md)获取。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md index 0a1812363b419749311aadfbcbf61dba2650a499..f9b6507b22f9eb0138a419b396ce7d0733d6053f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-BundleInstaller.md @@ -1,6 +1,6 @@ # BundleInstaller -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 本模块提供设备上安装、升级和卸载应用的能力。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-CustomizeData.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-CustomizeData.md index 53b8d9d04b057801c9779069b0460effa11bee59..19b66ff1ed25d606ef3286b088dfc55f0ff897bf 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-CustomizeData.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-CustomizeData.md @@ -1,10 +1,8 @@ # CustomizeData -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - - 自定义元数据。 ## CustomizeData(deprecated) diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md index a683ca89db326168be4fafcecb0336af53a4ca3e..3bec9fa67ed900d215c855bbc14fe5ad6024b840 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md @@ -1,6 +1,6 @@ # ElementName -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ElementName信息，通过接口[Context.getElementName](js-apis-inner-app-context.md)获取。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md index c1feb97bc01f6880230e85743c0e31408e01ce91..f637a0933685b41e6db7e9e2249219a5ee8c6f91 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-HapModuleInfo.md @@ -1,10 +1,8 @@ # HapModuleInfo -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - - Hap模块信息，未做特殊说明的属性，均通过[GET_BUNDLE_DEFAULT](js-apis-Bundle.md)获取。 ## HapModuleInfo(deprecated) @@ -13,8 +11,6 @@ Hap模块信息，未做特殊说明的属性，均通过[GET_BUNDLE_DEFAULT](js **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework - - | 名称 | 类型 | 可读 | 可写 | 说明 | | --------------------------------- | ------------------------------------------------------------ | ---- | ---- | -------------------- | | name | string | 是 | 否 | 模块名称。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-LauncherAbilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-LauncherAbilityInfo.md index 668dd8073899dc4172d5872e45ae8fabbc642231..560a3362a8c9f2fc4f8dee442a2ae08116ae8a1d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-LauncherAbilityInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-LauncherAbilityInfo.md @@ -1,10 +1,8 @@ # LauncherAbilityInfo -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - - LauncherAbilityInfo信息，通过接口[innerBundleManager.getLauncherAbilityInfos](js-apis-Bundle-InnerBundleManager.md)获取。 ## LauncherAbilityInfo(deprecated) diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-PermissionDef.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-PermissionDef.md index 9a19fdb75aca7b4a19ef3e41cda15e7dbcaf5daf..cea742c810f683eb9d204efc6ca7f5dc2cfc5220 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-PermissionDef.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-PermissionDef.md @@ -1,10 +1,8 @@ # PermissionDef -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - - 配置文件中定义的权限详细信息。 ## **PermissionDef**(deprecated) diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md index 7eec5ec8d955dbe2503771a1e97ae47879823dea..a611d687ba77938c1da5a025e74bbc31abfa00ee 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-abilityInfo.md @@ -1,6 +1,6 @@ # AbilityInfo -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 Ability信息，系统应用可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)获取自身或其他应用的Ability信息，三方应用可以通过[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)获取自身的Ability信息，其中入参[BundleFlag](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md#bundleflag)需要使用GET_BUNDLE_INFO_WITH_ABILITY。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md index 5e29ca0192e9a59cf02c93956ab7f49ac74a692a..d073aef1b684f23ce8cdd03fdd5adbf6411be4e7 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-applicationInfo.md @@ -1,6 +1,6 @@ # ApplicationInfo -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 应用程序信息，系统应用可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)获取自身或其他应用的应用程序信息，三方应用可以通过[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)获取自身的应用程序信息，其中入参[BundleFlag](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md#bundleflag)需要使用GET_BUNDLE_INFO_WITH_APPLICATION。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md index 71e766906933dbff86f328f24dadc3ab50fb5590..8f37fe94f22c35e66c78b173e625afba336665ec 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md @@ -2,7 +2,7 @@ 本模块提供应用信息查询能力，支持BundleInfo、ApplicationInfo、Ability、ExtensionAbility等信息的查询 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationResult.md b/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationResult.md index 608ec710810faa67cbb48ad1ceae1f5c91e5bd10..f283caaa43b78b857f6cac42f1913fe1a2097f06 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationResult.md +++ b/zh-cn/application-dev/reference/apis/js-apis-continuation-continuationResult.md @@ -1,6 +1,6 @@ # ContinuationResult -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## ContinuationResult diff --git a/zh-cn/application-dev/reference/apis/js-apis-deque.md b/zh-cn/application-dev/reference/apis/js-apis-deque.md index 2e925579255313b11f4d28a6bb094a5c235e0a36..4ff01bbeb4e8be6eafacc03ed29eccb19f8f6b1b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-deque.md +++ b/zh-cn/application-dev/reference/apis/js-apis-deque.md @@ -1,6 +1,6 @@ # @ohos.util.Deque (线性容器Deque) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 Deque（double ended queue）根据循环队列的数据结构实现，符合先进先出以及先进后出的特点，支持两端的元素插入和移除。Deque会根据实际需要动态调整容量，每次进行两倍扩容。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-document.md b/zh-cn/application-dev/reference/apis/js-apis-document.md index 338c362ec9c3d980d1bdb6ea6be135eb6b28150b..0027cdcf91f0bbc82bcc28ebd2b7e28ac6502805 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-document.md +++ b/zh-cn/application-dev/reference/apis/js-apis-document.md @@ -1,6 +1,7 @@ # @ohos.document (文件交互) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > - 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块接口从API9开始废弃。不建议使用以下接口，调用以下接口将抛出异常。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-environment.md b/zh-cn/application-dev/reference/apis/js-apis-environment.md index e7e5e6ce6dfd165faae96c5a55d94872a5e1f869..a83abb68ab47e5646cbc54c9478ede8196a78fc9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-environment.md +++ b/zh-cn/application-dev/reference/apis/js-apis-environment.md @@ -2,7 +2,7 @@ 该模块提供环境目录能力，获取内存存储根目录、公共文件根目录的JS接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块接口为系统接口，三方应用不支持调用。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-fileio.md b/zh-cn/application-dev/reference/apis/js-apis-fileio.md index e07b14ed81facab4c52d1ee84de4d4314f3a75c0..394f00b25c4938c7858e26187554f44774dbff6c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-fileio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-fileio.md @@ -2,7 +2,7 @@ 该模块提供文件存储管理能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读写等常用功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -40,7 +40,7 @@ class MainAbility extends Ability { let pathDir = data; }) ``` - + FA模型context的具体获取方法参见[FA模型](js-apis-inner-app-context.md#Context模块)。 ## fileio.stat diff --git a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md index ee2f81b52a13ff7fe750a7d92720a0bc26115cf4..6ee361d755f192c2df7c34a569dfb4fd3f9f4b3f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md @@ -2,7 +2,7 @@ 位置服务提供GNSS定位、网络定位、地理编码、逆地理编码、国家码和地理围栏等基本功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 从API Version 9开始，该接口不再维护，推荐使用新接口[geoLocationManager](js-apis-geoLocationManager.md)。 @@ -61,11 +61,11 @@ on(type: 'locationChange', request: LocationRequest, callback: Callback<Locat | type | string | 是 | 设置事件类型。type为“locationChange”，表示位置变化。 | | request | [LocationRequest](#locationrequest) | 是 | 设置位置请求参数。 | | callback | Callback<[Location](#location)> | 是 | 接收位置变化状态变化监听。 | - + **示例** - + ```ts import geolocation from '@ohos.geolocation'; var requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0}; @@ -98,7 +98,7 @@ off(type: 'locationChange', callback?: Callback<Location>): void **示例** - + ```ts import geolocation from '@ohos.geolocation'; var requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0}; @@ -132,7 +132,7 @@ on(type: 'locationServiceState', callback: Callback<boolean>): void **示例** - + ```ts import geolocation from '@ohos.geolocation'; var locationServiceState = (state) => { @@ -164,7 +164,7 @@ off(type: 'locationServiceState', callback?: Callback<boolean>): void; **示例** - + ```ts import geolocation from '@ohos.geolocation'; var locationServiceState = (state) => { @@ -199,7 +199,7 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca **示例** - + ```ts import geolocation from '@ohos.geolocation'; var cachedLocationsCb = (locations) => { @@ -233,7 +233,7 @@ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Locati **示例** - + ```ts import geolocation from '@ohos.geolocation'; var cachedLocationsCb = (locations) => { @@ -268,7 +268,7 @@ on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>): voi **示例** - + ```ts import geolocation from '@ohos.geolocation'; var gnssStatusCb = (satelliteStatusInfo) => { @@ -300,7 +300,7 @@ off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>): v | callback | Callback<[SatelliteStatusInfo](#satellitestatusinfo)> | 否 | 需要取消订阅的回调函数。若无此参数，则取消当前类型的所有订阅。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var gnssStatusCb = (satelliteStatusInfo) => { @@ -334,7 +334,7 @@ on(type: 'nmeaMessageChange', callback: Callback<string>): void; **示例** - + ```ts import geolocation from '@ohos.geolocation'; var nmeaCb = (str) => { @@ -367,7 +367,7 @@ off(type: 'nmeaMessageChange', callback?: Callback<string>): void; **示例** - + ```ts import geolocation from '@ohos.geolocation'; var nmeaCb = (str) => { @@ -402,7 +402,7 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; **示例** - + ```ts import geolocation from '@ohos.geolocation'; import wantAgent from '@ohos.wantAgent'; @@ -450,7 +450,7 @@ off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; | want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; import wantAgent from '@ohos.wantAgent'; @@ -497,7 +497,7 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<L | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收位置信息的回调。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0}; @@ -534,7 +534,7 @@ getCurrentLocation(callback: AsyncCallback<Location>): void | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收位置信息的回调。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var locationChange = (err, location) => { @@ -576,7 +576,7 @@ getCurrentLocation(request?: CurrentLocationRequest): Promise<Location> **示例** - + ```ts import geolocation from '@ohos.geolocation'; var requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0}; @@ -607,7 +607,7 @@ getLastLocation(callback: AsyncCallback<Location>): void **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.getLastLocation((err, data) => { @@ -642,7 +642,7 @@ getLastLocation(): Promise<Location> **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.getLastLocation().then((result) => { @@ -671,7 +671,7 @@ isLocationEnabled(callback: AsyncCallback<boolean>): void | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.isLocationEnabled((err, data) => { @@ -705,7 +705,7 @@ isLocationEnabled(): Promise<boolean> | Promise<boolean> | boolean|NA|返回位置服务是否可用的状态。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.isLocationEnabled().then((result) => { @@ -734,7 +734,7 @@ requestEnableLocation(callback: AsyncCallback<boolean>): void | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.requestEnableLocation((err, data) => { @@ -768,7 +768,7 @@ requestEnableLocation(): Promise<boolean> | Promise<boolean> | boolean|NA|返回位置服务是否可用。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.requestEnableLocation().then((result) => { @@ -797,7 +797,7 @@ isGeoServiceAvailable(callback: AsyncCallback<boolean>): void | callback | AsyncCallback<boolean> | 是 | 用来接收地理编码服务状态的回调。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.isGeoServiceAvailable((err, data) => { @@ -831,7 +831,7 @@ isGeoServiceAvailable(): Promise<boolean> | Promise<boolean> |boolean|NA| 返回地理编码服务是否可用的状态。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.isGeoServiceAvailable().then((result) => { @@ -861,7 +861,7 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收逆地理编码请求的回调参数。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1}; @@ -902,7 +902,7 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise<Array<Ge | Promise<Array<[GeoAddress](#geoaddress)>> | Array<[GeoAddress](#geoaddress)>|NA|返回地理描述信息。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1}; @@ -933,7 +933,7 @@ getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback< | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收地理编码请求的回调参数。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1}; @@ -974,7 +974,7 @@ getAddressesFromLocationName(request: GeoCodeRequest): Promise<Array<GeoAd | Promise<Array<[GeoAddress](#geoaddress)>> | Array<[GeoAddress](#geoaddress)>|NA|设置接收地理编码请求的回调参数。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1}; @@ -1005,7 +1005,7 @@ getCachedGnssLocationsSize(callback: AsyncCallback<number>): void; | callback | AsyncCallback<number> | 是 | 用来接收GNSS芯片缓存位置个数的回调。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.getCachedGnssLocationsSize((err, size) => { @@ -1040,7 +1040,7 @@ getCachedGnssLocationsSize(): Promise<number>; | Promise<number> | number|NA|返回GNSS缓存位置的个数。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.getCachedGnssLocationsSize().then((result) => { @@ -1070,7 +1070,7 @@ flushCachedGnssLocations(callback: AsyncCallback<boolean>): void; | callback | AsyncCallback<boolean> | 是 | 用来接收清空GNSS芯片缓存位置操作的结果。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.flushCachedGnssLocations((err, result) => { @@ -1105,7 +1105,7 @@ flushCachedGnssLocations(): Promise<boolean>; | Promise<boolean> |boolean|NA| 清空所有GNSS缓存位置是否成功。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; geolocation.flushCachedGnssLocations().then((result) => { @@ -1136,7 +1136,7 @@ sendCommand(command: LocationCommand, callback: AsyncCallback<boolean>): v | callback | AsyncCallback<boolean> | 是 | 用来接收命令发送的结果。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var requestInfo = {'scenario': 0x301, 'command': "command_1"}; @@ -1178,7 +1178,7 @@ sendCommand(command: LocationCommand): Promise<boolean>; | Promise<boolean> |boolean|NA| 表示命令发送成功或失败。 | **示例** - + ```ts import geolocation from '@ohos.geolocation'; var requestInfo = {'scenario': 0x301, 'command': "command_1"}; diff --git a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md index 31ac9a44e52338e95e343844b0f2bd445a3f3e59..e1c1516f8d3ad3088cf73fba2b0c67b9dc7dffaa 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hashmap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hashmap.md @@ -1,6 +1,6 @@ # @ohos.util.HashMap (非线性容器HashMap) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 HashMap底层使用数组+链表+红黑树的方式实现，查询、插入和删除的效率都很高。HashMap存储内容基于key-value的键值对映射，不能有重复的key，且一个key只能对应一个value。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hashset.md b/zh-cn/application-dev/reference/apis/js-apis-hashset.md index 128eb01303ae8071d7b6390cd3dd780f5c6cd7bf..b7ac547de66e7b5eda4fc880ac8329dd7a818ac9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hashset.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hashset.md @@ -1,6 +1,6 @@ # @ohos.util.HashSet (非线性容器HashSet) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 HashSet基于[HashMap](js-apis-hashmap.md)实现。在HashSet中，只对value对象进行处理。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md b/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md index 78da72192d584ddae66984b8bee6bb91fc2caa3d..394a61c58f2034dd2e818c1a8561a6b12ec22496 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md @@ -2,7 +2,8 @@ 本模块提供了应用事件打点能力，包括对打点数据的落盘，以及对打点功能的管理配置。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > - 本模块接口从API version 9开始废弃，建议使用新接口[`@ohos.hiviewdfx.hiAppEvent`](js-apis-hiviewdfx-hiappevent.md)替代。 > - 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-installer.md b/zh-cn/application-dev/reference/apis/js-apis-installer.md index a4252ab66c14a1d2a81aa32cde455d57c84dd0ab..21f6661377d5a192e8ab444f7e883797cd2db7ee 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-installer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-installer.md @@ -1,6 +1,6 @@ # @ohos.bundle.installer (installer模块) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 在设备上安装、升级和卸载应用 diff --git a/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md b/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md index f61d8cc4b3e3a44b840177f5bc7fb97da612f6fd..efda7e6b1ec1bfc6f4bacac61e453cccbd8db45b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md @@ -1,6 +1,6 @@ # @ohos.util.LightWeightMap (非线性容器LightWeightMap) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 LightWeightMap可用于存储具有关联关系的key-value键值对集合，存储元素中key值唯一，每个key对应一个value。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md b/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md index 8809d3070b191ac6b449f087a6e55e9d8132afeb..bd5ad4dba470c1017bf6c9714d550a21af1e2c29 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md +++ b/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md @@ -1,6 +1,6 @@ # @ohos.util.LightWeightSet (非线性容器LightWeightSet)@ohos.util.LightWeightSet (非线性容器LightWeightSet) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 LightWeightSet可用于存储一系列值的集合，存储元素中value值唯一。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md b/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md index 59ec6e1719f5c98a58d0a07b4497703d586614c6..49e563ba232e8fb93d9a51dcf032972e3eca15a5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md +++ b/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md @@ -1,6 +1,6 @@ # @ohos.util.LinkedList (线性容器LinkedList) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 LinkedList底层通过双向链表实现，双向链表的每个节点都包含对前一个元素和后一个元素的引用。当需要查询元素时，可以从头遍历，也可以从尾部遍历，插入、删除效率高，查询效率低。LinkedList允许元素为null。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-list.md b/zh-cn/application-dev/reference/apis/js-apis-list.md index 1170793c3c2e11b5fac94bec61c7954756987910..e1da088b0ec3e656f2dd68d03a6769b6927d1503 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-list.md +++ b/zh-cn/application-dev/reference/apis/js-apis-list.md @@ -1,6 +1,6 @@ # @ohos.util.List (线性容器List) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 List底层通过单向链表实现，每个节点有一个指向后一个元素的引用。当需要查询元素时，必须从头遍历，插入、删除效率高，查询效率低。List允许元素为null。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md b/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md index 6d9c4956519fa1bf262b219d3b8173c53e6a6877..e2d95fca9f38d2f6a42a933a1f4a0d5ce5b11cb6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md +++ b/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md @@ -1,6 +1,6 @@ # @ohos.multimedia.medialibrary (媒体库管理) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 该组件从API Version 6开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 导入模块 @@ -999,7 +999,7 @@ async function example() { 提供封装文件属性的方法。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 1. title字段默认为去掉后缀的文件名，音频和视频文件会尝试解析文件内容，部分设备写入后在触发扫描时会被还原。 > 2. orientation字段部分设备可能不支持修改，建议使用image组件的[ModifyImageProperty](js-apis-image.md#modifyimageproperty9)接口。 @@ -2471,7 +2471,7 @@ async function example() { 枚举，文件关键信息。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > bucket_id字段在文件重命名或移动后可能会发生变化，开发者使用前需要重新获取。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core @@ -2585,4 +2585,3 @@ async function example() { | type | 'image' | 'video' | 'media' | 是 | 是 | 媒体类型，包括：image, video, media，当前仅支持media类型 | | count | number | 是 | 是 | 媒体选择，count = 1表示单选，count大于1表示多选。 | - diff --git a/zh-cn/application-dev/reference/apis/js-apis-plainarray.md b/zh-cn/application-dev/reference/apis/js-apis-plainarray.md index 8fe09c24839ba17856f98cbae632af31b584b01f..5d45c7c81ed18dcf8a887f61c0ef5035e58dc6bc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-plainarray.md +++ b/zh-cn/application-dev/reference/apis/js-apis-plainarray.md @@ -1,6 +1,6 @@ # @ohos.util.PlainArray (非线性容器PlainArray) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 PlainArray可用于存储具有关联关系的key-value键值对集合，存储元素中key值唯一，key值类型为number类型，每个key对应一个value。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-queue.md b/zh-cn/application-dev/reference/apis/js-apis-queue.md index 1ba5638e28fc37429639276698d8cd1eeb5a2a3e..d1867ea1928df30b69b67389aa62d249db9401c0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-queue.md +++ b/zh-cn/application-dev/reference/apis/js-apis-queue.md @@ -1,6 +1,6 @@ # @ohos.util.Queue (线性容器Queue) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 Queue的特点是先进先出，在尾部增加元素，在头部删除元素。根据循环队列的数据结构实现。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md b/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md index c221b64c540e94da3b3d9bcc24980f51c823a551..f19eb82021817eeebebd86c77d4c01cb0ab46183 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md +++ b/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md @@ -2,7 +2,7 @@ 该模块提供文件数据安全等级的相关功能：向应用程序提供查询、设置文件数据安全等级的JS接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-stack.md b/zh-cn/application-dev/reference/apis/js-apis-stack.md index 944abccaf1cc7d838d67dd3f56b4f8235c001c79..5e32474dc8af004c6e3bfb7d94fcaf8014ae67b5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-stack.md +++ b/zh-cn/application-dev/reference/apis/js-apis-stack.md @@ -1,6 +1,6 @@ # @ohos.util.Stack (线性容器Stack) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 Stack基于数组的数据结构实现，特点是先进后出，只能在一端进行数据的插入和删除。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-statfs.md b/zh-cn/application-dev/reference/apis/js-apis-statfs.md index e6f51899a61edfee7487cb373eb85e1394f4fb99..fcc6cf6a1ac53672ba40514403ef0b855a83815e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-statfs.md +++ b/zh-cn/application-dev/reference/apis/js-apis-statfs.md @@ -2,7 +2,7 @@ 该模块提供文件系统相关存储信息的功能，向应用程序提供获取文件系统总字节数、空闲字节数的JS接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-storage-statistics.md b/zh-cn/application-dev/reference/apis/js-apis-storage-statistics.md index 84bca648712cdc5f406af94beb745e0fb5c7f8b8..e86470534bc793102875be82b4afa91a333cb35b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-storage-statistics.md +++ b/zh-cn/application-dev/reference/apis/js-apis-storage-statistics.md @@ -2,7 +2,7 @@ 该模块提供空间查询相关的常用功能：包括对内外卡的空间查询，对应用分类数据统计的查询，对应用数据的查询等。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-app.md b/zh-cn/application-dev/reference/apis/js-apis-system-app.md index 444ecdd8032ae6f8f233868a98b233e374aaecbf..f7fab7f597de0c4da6359f8afc191d7927f373b4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-app.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-app.md @@ -1,6 +1,6 @@ # @system.app (应用上下文) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 7 开始，该接口不再维护，推荐使用新接口。 > > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-battery.md b/zh-cn/application-dev/reference/apis/js-apis-system-battery.md index 17967892eb76429700751046bc18e32a5aa25c88..f56300b43ae741066b0f693c16eb652fa02dbb62 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-battery.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-battery.md @@ -2,7 +2,7 @@ 该模块提供充电状态及剩余电量的查询功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 6开始不再维护，建议使用[`@ohos.batteryInfo`](js-apis-battery-info.md)替代。 > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-bluetooth.md b/zh-cn/application-dev/reference/apis/js-apis-system-bluetooth.md index e2ef4e666ff66899a8273c4b1996b9064d6e3fb3..7e4043be8c4c7b55404274d2c931e897324eeefb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-bluetooth.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-bluetooth.md @@ -1,7 +1,7 @@ # @system.bluetooth (蓝牙) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 从API Version 7 开始，该接口不再维护，推荐使用新接口[`@ohos.bluetooth`](js-apis-bluetooth.md)。 > diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md b/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md index e9039e94424ca59f0acb972f3bf15e5156ba5aee..2f019ad51b018cbde409f27d59c69b904f123aa9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md @@ -2,7 +2,7 @@ 该模块提供屏幕亮度和模式的查询、调节接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 7 开始不再维护，建议使用[`@ohos.brightness`](js-apis-brightness.md)替代。 > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-cipher.md b/zh-cn/application-dev/reference/apis/js-apis-system-cipher.md index fe5ae40dff9cd7e29ab3b523864d2dbb66dacba0..766b981ad11d3891b1b7e366f6c0c9c4cdd1157e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-cipher.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-cipher.md @@ -1,6 +1,6 @@ # @system.cipher (加密算法) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-configuration.md b/zh-cn/application-dev/reference/apis/js-apis-system-configuration.md index f41b78e15b0fa85f0e983acab1990c31f05f0a75..8d8cb562baa47c2bf9d8c988701de9c3baf0803a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-configuration.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-configuration.md @@ -1,6 +1,6 @@ # @system.configuration (应用配置) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 7 开始，该接口不再维护，推荐使用新接口[`@ohos.i18n`](js-apis-i18n.md)和[`@ohos.intl`](js-apis-intl.md)。 > > diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-device.md b/zh-cn/application-dev/reference/apis/js-apis-system-device.md index 540604926ed2d7cc96cad11b6eda81ee7708a3f3..4215cce99d6414f55b0a047139273a5c87a573a3 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-device.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-device.md @@ -2,14 +2,15 @@ 本模块提供当前设备的信息。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > - 从API Version 6开始，该接口不再维护，推荐使用新接口[`@ohos.deviceInfo`](js-apis-device-info.md)进行设备信息查询。 -> +> > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 -``` +```typescript import device from '@system.device'; ``` @@ -19,7 +20,7 @@ getInfo(Object): void 获取当前设备的信息。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 在首页的onShow生命周期之前不建议调用device.getInfo接口。 **系统能力：** SystemCapability.Startup.SystemInfo @@ -58,7 +59,7 @@ fail返回错误代码： **示例：** -``` +```typescript export default { getInfo() { device.getInfo({ diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-fetch.md b/zh-cn/application-dev/reference/apis/js-apis-system-fetch.md index 8a16136adffcacf8ca747af1ef4d502bdd622edc..a9448693b273ae3b3869747342b580e012f7d0c5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-fetch.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-fetch.md @@ -1,6 +1,6 @@ # @system.fetch (数据请求) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 6开始，该接口不再维护，推荐使用新接口[`@ohos.net.http`](js-apis-http.md)。 > > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -86,7 +86,7 @@ export default { ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 默认支持https，如果要支持http，需要在config.json里增加network标签，属性标识 "cleartextTraffic": true。即： > > ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-file.md b/zh-cn/application-dev/reference/apis/js-apis-system-file.md index 4888a361fa3d757d22361b502cb7b1172cda5563..6179b631024777df9525badae8a0ce86f9d52727 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-file.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-file.md @@ -1,6 +1,6 @@ # @system.file (文件存储) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 6开始，该接口不再维护，推荐使用新接口[`@ohos.fileio`](js-apis-fileio.md)。 > > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-location.md b/zh-cn/application-dev/reference/apis/js-apis-system-location.md index 58634c22b219d7c455e3c4586fb6a3b79da80b08..a0eef27362da1a659eafcb6f4211dfc6c116a73c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-location.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-location.md @@ -1,6 +1,6 @@ # @system.geolocation (地理位置) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 从API Version 9开始，该接口不再维护，推荐使用新接口[geoLocationManager](js-apis-geoLocationManager.md)。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md b/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md index 6a3f6c25fb4b703df432ba81243ea19ad1726255..8b57bdb2feae8b384b05003b4ce5440bc85ad721 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-mediaquery.md @@ -3,7 +3,7 @@ 提供根据不同媒体类型定义不同的样式。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 从API Version 7 开始，该接口不再维护，推荐使用新接口[`@ohos.mediaquery`](js-apis-mediaquery.md)。 > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-network.md b/zh-cn/application-dev/reference/apis/js-apis-system-network.md index 83a56198095b4d2690725e9509fb2a6dfa897bb0..f269ebc2d45d845eb1ddd7c8274598ac6476eb29 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-network.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-network.md @@ -1,6 +1,6 @@ # @system.network (网络状态) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 7 开始，该接口不再维护，推荐使用新接口[`@ohos.telephony.observer`](js-apis-observer.md)。 > > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-notification.md b/zh-cn/application-dev/reference/apis/js-apis-system-notification.md index db00c4997350484ffb9fa17e72259205272b24e8..000ec1077531a5c4766c61ac1f2692801f7169ff 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-notification.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-notification.md @@ -1,6 +1,6 @@ # @system.notification (通知消息) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 7 开始，该接口不再维护，推荐使用新接口[`@ohos.notification`](js-apis-notification.md)。 > > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-package.md b/zh-cn/application-dev/reference/apis/js-apis-system-package.md index 4369b30fd95a03067e618cd76200abcdd09b4d1f..45389b3307208a433dc7f1a9ba00cad35456a000 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-package.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-package.md @@ -1,7 +1,7 @@ # @system.package (应用管理) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 从API version 9开始不再维护，推荐使用该模块[@ohos.bundle.bundleManager](js-apis-bundleManager.md)。 > diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-parameter.md b/zh-cn/application-dev/reference/apis/js-apis-system-parameter.md index 145c978a7b6fd508ebdc774edbbab5587a64e696..d7a6269fca2d55fce28433cb4bf7a35a8a8d917d 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-system-parameter.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-parameter.md @@ -4,7 +4,7 @@ 详细的系统参数设计原理及定义可参考 [系统参数](../../../device-dev/subsystems/subsys-boot-init-sysparam.md)。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 本模块接口从API version 9开始不再维护，建议使用新接口[`@ohos.systemParameterV9`](js-apis-system-parameterV9.md)替代。 > - 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 本模块接口为系统接口。 @@ -162,7 +162,7 @@ setSync(key: string, value: string): void | key | string | 是 | 待设置的系统参数Key。 | | value | string | 是 | 待设置的系统参数值。 | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 此接口只能用于系统应用的参数设置。 > - 所授权的系统应用需要配置对应selinux和dac规则，具体配置方法请参照系统参数指导文档:[系统参数](../../../device-dev/subsystems/subsys-boot-init-sysparam.md)。 @@ -193,7 +193,7 @@ set(key: string, value: string, callback: AsyncCallback<void>): void | value | string | 是 | 待设置的系统参数值。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 此接口只能用于系统应用的参数设置。 > - 所授权的系统应用需要配置对应selinux和dac规则，具体配置方法请参照系统参数指导文档:[系统参数](../../../device-dev/subsystems/subsys-boot-init-sysparam.md)。 @@ -233,7 +233,7 @@ set(key: string, value: string): Promise<void> | -------- | -------- | | Promise<void> | Promise示例，用于异步获取结果。 | -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 此接口只能用于系统应用的参数设置。 > - 所授权的系统应用需要配置对应selinux和dac规则，具体配置方法请参照系统参数指导文档:[系统参数](../../../device-dev/subsystems/subsys-boot-init-sysparam.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-prompt.md b/zh-cn/application-dev/reference/apis/js-apis-system-prompt.md index 670148a734b120ace91ff4c42509ce9123395747..a79170a9ff826d0cab1199ef9869f0b663e91edc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-prompt.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-prompt.md @@ -2,7 +2,7 @@ 创建并显示文本提示框、对话框和操作菜单。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 从API Version 8 开始，该接口不再维护，推荐使用新接口[`@ohos.prompt`](js-apis-prompt.md)。 > diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-request.md b/zh-cn/application-dev/reference/apis/js-apis-system-request.md index a0af5a2680c52ec2d2cd60badd5b0249d41c41de..f1e799e9caf4d8845dbd8ade3f6624e312bb0079 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-request.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-request.md @@ -2,7 +2,7 @@ system.request部件主要给应用提供上传下载文件的基础能力。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 从API Version 9开始所有接口不再维护，推荐使用新接口[`@ohos.request`](js-apis-request.md)。 > > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -54,7 +54,7 @@ upload(options: UploadRequestOptions): void console.info(' upload err:' + err); } ``` - + ## UploadRequestOptions diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-router.md b/zh-cn/application-dev/reference/apis/js-apis-system-router.md index 1c4cf633e8dacc1000b2ddac850a801b430432d2..656a5052f7b8805577fb7c591bc7f9081046e7e2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-router.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-router.md @@ -67,7 +67,7 @@ export default { } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 页面路由栈支持的最大Page数量为32。 @@ -183,7 +183,7 @@ export default { } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 示例中的uri字段是页面路由，由配置文件中的pages列表指定。 ## router.getParams diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md b/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md index 545e00496d9d495c1421544bc2808a7f9c5936da..3ad1ecd1983a0849dca0c47b44303ae31b62c7da 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-sensor.md @@ -7,7 +7,7 @@ sensor模块提供订阅传感器数据基本能力，主要包含查询传感 根据传感器的用途，可以将传感器分为六大类：运动类传感器、环境类传感器、方向类传感器、光线类传感器、健康类传感器、其他类传感器（如霍尔传感器），每一大类传感器包含不同类型的传感器，某种类型的传感器可能是单一的物理传感器，也可能是由多个物理传感器复合而成。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 从API Version 8开始，该接口不再维护，推荐使用新接口[`@ohos.sensor`](js-apis-sensor.md)。 > - 本模块首批接口从API version 4开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -69,7 +69,7 @@ sensor.subscribeAccelerometer({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeAccelerometer @@ -122,7 +122,7 @@ sensor.subscribeCompass({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeCompass @@ -173,7 +173,7 @@ sensor.subscribeProximity({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeProximity @@ -224,7 +224,7 @@ sensor.subscribeLight({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeLight @@ -277,7 +277,7 @@ sensor.subscribeStepCounter({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeStepCounter @@ -331,7 +331,7 @@ sensor.subscribeBarometer({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 @@ -386,7 +386,7 @@ sensor.subscribeHeartRate({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 @@ -440,7 +440,7 @@ sensor.subscribeOnBodyState({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeOnBodyState @@ -533,7 +533,7 @@ sensor.subscribeDeviceOrientation({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeDeviceOrientation6+ @@ -594,7 +594,7 @@ sensor.subscribeGyroscope({ }); ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。 ## sensor.unsubscribeGyroscope6+ diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-vibrate.md b/zh-cn/application-dev/reference/apis/js-apis-system-vibrate.md index c77faf7b3978c263e41591c796e7bbb8fec4b8f5..0d8e3958c0847d20639ed13991919981a6bdcb84 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-vibrate.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-vibrate.md @@ -7,7 +7,7 @@ vibrator模块提供控制马达振动的能力，主要包含灯的列表查询 控制类小器件指的是设备上的LED灯和振动器。其中，LED灯主要用作指示（如充电状态）、闪烁功能（如三色灯）等；振动器主要用于闹钟、开关机振动、来电振动等场景。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > - 本模块首批接口从API version 4开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > - 从API Version 8开始，该接口不再维护，推荐使用新接口[`@ohos.vibrator`](js-apis-vibrator.md)。 > - 该功能使用需要对应硬件支持，仅支持真机调试。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-treemap.md b/zh-cn/application-dev/reference/apis/js-apis-treemap.md index 754b06b74c0fca2ae251bf0614eca7447b25cdcc..56c03ddbff147208b19e90763690eeb7e7377152 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-treemap.md +++ b/zh-cn/application-dev/reference/apis/js-apis-treemap.md @@ -1,6 +1,6 @@ # @ohos.util.TreeMap (非线性容器TreeMap) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 TreeMap可用于存储具有关联关系的key-value键值对集合，存储元素中key值唯一，每个key对应一个value。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-treeset.md b/zh-cn/application-dev/reference/apis/js-apis-treeset.md index 14eb865f921eb3f7338bd81705de3826193eaa10..6face00d64dcda42e9fbee451e924653b4f9b0c5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-treeset.md +++ b/zh-cn/application-dev/reference/apis/js-apis-treeset.md @@ -1,6 +1,6 @@ # @ohos.util.TreeSet (非线性容器TreeSet) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 TreeSet基于[TreeMap](js-apis-treemap.md)实现，在TreeSet中，只对value对象进行处理。TreeSet可用于存储一系列值的集合，元素中value唯一且有序。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md b/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md index cd29a284a88c4850609494477d769c2a77a2b272..24173587e3a1621593f8a91708bbbdc40f52f03b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md @@ -2,7 +2,7 @@ 该模块提供用户数据管理能力，包括访问、修改用户等用户公共媒体数据信息等常用功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > 本模块接口为系统接口。 @@ -19,7 +19,7 @@ getUserFileMgr(context: Context): UserFileManager 获取用户数据管理模块的实例，用于访问和修改用户等用户公共媒体数据信息（如音频、视频、图片、文档等）。 **模型约束：** 此接口仅可在Stage模型下使用。 - + **系统能力**：SystemCapability.FileManagement.UserFileManager.Core **参数：** @@ -2329,7 +2329,7 @@ async function example() { 成员类型。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.FileManagement.UserFileManager.Core - + | 名称 | 类型 | 可读 | 可写 | 说明 | | ----- | ---- | ---- | ---- | ---- | | number | number | 是 | 是 | number类型 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-vector.md b/zh-cn/application-dev/reference/apis/js-apis-vector.md index 01d6b9690fcf973d648fc66f06dcc7879305432e..dba118240389f2cd6df315f1410fb765fd8ab7a6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-vector.md +++ b/zh-cn/application-dev/reference/apis/js-apis-vector.md @@ -1,6 +1,6 @@ # @ohos.util.Vector (线性容器Vector) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 Vector是一种线性数据结构，底层基于数组实现。当Vector的内存用尽时，会自动分配更大的连续内存区，将原先的元素复制到新的内存区，并释放旧的内存区。使用Vector能够高效快速地访问元素。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md index a2d7595f0f0e2812c7667ef3fdf7b5a8590c1aeb..2199150d930523573e944d1720d9a10da69a30c9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md @@ -2,7 +2,7 @@ 该模块提供卷、磁盘查询和管理的相关功能：包括查询卷信息，对卷的挂载卸载、对磁盘分区以及卷的格式化等功能。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > - 本模块首批接口从API version 9开始支持。 > - 本模块接口为系统接口，三方应用不支持调用。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-wifiManager.md b/zh-cn/application-dev/reference/apis/js-apis-wifiManager.md index 0fc97a1c51125c25c0bd021458a53e2352cdf490..4d45951c2c928a087981d6b34e096f8289356d41 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wifiManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wifiManager.md @@ -1,7 +1,7 @@ # 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-wifiManagerExt.md b/zh-cn/application-dev/reference/apis/js-apis-wifiManagerExt.md index 53f20c258ec3d0fdeecaf69c55d788be0dcfc134..637f78a84d484b85fe27b31c49750b5d3eaab35a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wifiManagerExt.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wifiManagerExt.md @@ -1,7 +1,7 @@ # WLAN扩展接口 该模块主要提供WLAN扩展接口，供非通用类型产品使用。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 该文档中的接口只供非通用类型产品使用，如路由器等，对于常规类型产品，不应该使用这些接口。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-worker.md b/zh-cn/application-dev/reference/apis/js-apis-worker.md index e8a8dec36902396f6db9d6dc1b5667f7df44a19b..e4616aff5b3be8b9f25f487af558ba36d234273a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-worker.md +++ b/zh-cn/application-dev/reference/apis/js-apis-worker.md @@ -4,7 +4,7 @@ Worker是与主线程并行的独立线程。创建Worker的线程称之为宿 Worker主要作用是为应用程序提供一个多线程的运行环境，可满足应用程序在执行过程中与主线程分离，在后台线程中运行一个脚本操作耗时操作，极大避免类似于计算密集型或高延迟的任务阻塞主线程的运行。由于Worker一旦被创建则不会主动被销毁，若不处于任务状态一直运行，在一定程度上会造成资源的浪费，应及时关闭空闲的Worker。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> **说明：**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-xml.md b/zh-cn/application-dev/reference/apis/js-apis-xml.md index 1d9c7f0e7d1811cc97760ac0cd82b389a503d9d7..0282ae8d4503fb7187ff467d5953f34fd9ee8098 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-xml.md +++ b/zh-cn/application-dev/reference/apis/js-apis-xml.md @@ -1,6 +1,6 @@ # @ohos.xml (xml解析与生成) -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md index 07953a5d7f6e1bc9e7ee8dbefec000be6c398b45..ad82c9be8691370f9f8b75ab8f3e7e2375012d1e 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md @@ -1809,7 +1809,7 @@ transform(a: number, b: number, c: number, d: number, e: number, f: number): voi transform方法对应一个变换矩阵，想对一个图形进行变化的时候，只要设置此变换矩阵相应的参数，对图形的各个定点的坐标分别乘以这个矩阵，就能得到新的定点的坐标。矩阵变换效果可叠加。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 变换后的坐标计算方式（x和y为变换前坐标，x'和y'为变换后坐标）： > > - x' = scaleX \* x + skewY \* y + translateX diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md index 98b0c8b8401cce5c27349dd8baedc249f007cc70..26119ca3a3c1b23cc1e2933883886616b4958069 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md @@ -23,27 +23,27 @@ OffscreenCanvasRenderingContext2D(width: number, height: number, setting: Render ## 属性 -| 名称 | 类型 | 描述 | -| ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | -| [fillStyle](#fillstyle) | string \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | 指定绘制的填充色。
- 类型为string时，表示设置填充区域的颜色。
- 类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。
- 类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。 | -| [lineWidth](#linewidth) | number | 设置绘制线条的宽度。 | -| [strokeStyle](#strokestyle) | string \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | 设置描边的颜色。
- 类型为string时，表示设置描边使用的颜色。
- 类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。
- 类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。 | -| [lineCap](#linecap) | CanvasLineCap | 指定线端点的样式，可选值为：
- 'butt'：线端点以方形结束。
- 'round'：线端点以圆形结束。
- 'square'：线端点以方形结束，该样式下会增加一个长度和线段厚度相同，宽度是线段厚度一半的矩形。
- 默认值：'butt'。 | -| [lineJoin](#linejoin) | CanvasLineJoin | 指定线段间相交的交点样式，可选值为：
- 'round'：在线段相连处绘制一个扇形，扇形的圆角半径是线段的宽度。
- 'bevel'：在线段相连处使用三角形为底填充， 每个部分矩形拐角独立。
- 'miter'：在相连部分的外边缘处进行延伸，使其相交于一点，形成一个菱形区域，该属性可以通过设置miterLimit属性展现效果。
- 默认值：'miter'。 | -| [miterLimit](#miterlimit) | number | 设置斜接面限制值，该值指定了线条相交处内角和外角的距离。
- 默认值：10。 | -| [font](#font) | string | 设置文本绘制中的字体样式。
语法：ctx.font='font-size font-family'
- font-size(可选)，指定字号和行高，单位只支持px。
- font-family(可选)，指定字体系列。
语法：ctx.font='font-style font-weight font-size font-family'
- font-style(可选)，用于指定字体样式，支持如下几种样式：'normal','italic'。
- font-weight(可选)，用于指定字体的粗细，支持如下几种类型：'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。
- font-size(可选)，指定字号和行高，单位只支持px。
- font-family(可选)，指定字体系列，支持如下几种类型：'sans-serif', 'serif', 'monospace'。
- 默认值：'normal normal 14px sans-serif'。 | -| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制中的文本对齐方式，可选值为：
- 'left'：文本左对齐。
- 'right'：文本右对齐。
- 'center'：文本居中对齐。
- 'start'：文本对齐界线开始的地方。
- 'end'：文本对齐界线结束的地方。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> ltr布局模式下'start'和'left'一致，rtl布局模式下'start'和'right'一致·。
- 默认值：'left'。 | -| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制中的水平对齐方式，可选值为：
- 'alphabetic'：文本基线是标准的字母基线。
- 'top'：文本基线在文本块的顶部。
- 'hanging'：文本基线是悬挂基线。
- 'middle'：文本基线在文本块的中间。
- 'ideographic'：文字基线是表意字基线；如果字符本身超出了alphabetic基线，那么ideograhpic基线位置在字符本身的底部。
- 'bottom'：文本基线在文本块的底部。 与ideographic基线的区别在于ideographic基线不需要考虑下行字母。
- 默认值：'alphabetic'。 | -| [globalAlpha](#globalalpha) | number | 设置透明度，0.0为完全透明，1.0为完全不透明。 | -| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线偏移量，精度为float。
- 默认值：0.0。 | -| [globalCompositeOperation](#globalcompositeoperation) | string | 设置合成操作的方式。类型字段可选值有'source-over'，'source-atop'，'source-in'，'source-out'，'destination-over'，'destination-atop'，'destination-in'，'destination-out'，'lighter'，'copy'，'xor'。
- 默认值：'source-over'。 | -| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别，值越大越模糊，精度为float。
- 默认值：0.0。 | -| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。 | -| [shadowOffsetX](#shadowoffsetx) | number | 设置绘制阴影时和原有对象的水平偏移值。 | -| [shadowOffsetY](#shadowoffsety) | number | 设置绘制阴影时和原有对象的垂直偏移值。 | -| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是否进行图像平滑度调整，true为启用，false为不启用。
- 默认值：true。 | - -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +| 名称 | 类型 | 描述 | +| ----------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | +| [fillStyle](#fillstyle) | string \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | 指定绘制的填充色。
- 类型为string时，表示设置填充区域的颜色。
- 类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。
- 类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。 | +| [lineWidth](#linewidth) | number | 设置绘制线条的宽度。 | +| [strokeStyle](#strokestyle) | string \| [CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](#canvaspattern) | 设置描边的颜色。
- 类型为string时，表示设置描边使用的颜色。
- 类型为CanvasGradient时，表示渐变对象，使用[createLinearGradient](#createlineargradient)方法创建。
- 类型为CanvasPattern时，使用[createPattern](#createpattern)方法创建。 | +| [lineCap](#linecap) | CanvasLineCap | 指定线端点的样式，可选值为：
- 'butt'：线端点以方形结束。
- 'round'：线端点以圆形结束。
- 'square'：线端点以方形结束，该样式下会增加一个长度和线段厚度相同，宽度是线段厚度一半的矩形。
- 默认值：'butt'。 | +| [lineJoin](#linejoin) | CanvasLineJoin | 指定线段间相交的交点样式，可选值为：
- 'round'：在线段相连处绘制一个扇形，扇形的圆角半径是线段的宽度。
- 'bevel'：在线段相连处使用三角形为底填充， 每个部分矩形拐角独立。
- 'miter'：在相连部分的外边缘处进行延伸，使其相交于一点，形成一个菱形区域，该属性可以通过设置miterLimit属性展现效果。
- 默认值：'miter'。 | +| [miterLimit](#miterlimit) | number | 设置斜接面限制值，该值指定了线条相交处内角和外角的距离。
- 默认值：10。 | +| [font](#font) | string | 设置文本绘制中的字体样式。
语法：ctx.font='font-size font-family'
- font-size(可选)，指定字号和行高，单位只支持px。
- font-family(可选)，指定字体系列。
语法：ctx.font='font-style font-weight font-size font-family'
- font-style(可选)，用于指定字体样式，支持如下几种样式：'normal','italic'。
- font-weight(可选)，用于指定字体的粗细，支持如下几种类型：'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。
- font-size(可选)，指定字号和行高，单位只支持px。
- font-family(可选)，指定字体系列，支持如下几种类型：'sans-serif', 'serif', 'monospace'。
- 默认值：'normal normal 14px sans-serif'。 | +| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制中的文本对齐方式，可选值为：
- 'left'：文本左对齐。
- 'right'：文本右对齐。
- 'center'：文本居中对齐。
- 'start'：文本对齐界线开始的地方。
- 'end'：文本对齐界线结束的地方。
> **说明：**
> ltr布局模式下'start'和'left'一致，rtl布局模式下'start'和'right'一致·。
- 默认值：'left'。 | +| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制中的水平对齐方式，可选值为：
- 'alphabetic'：文本基线是标准的字母基线。
- 'top'：文本基线在文本块的顶部。
- 'hanging'：文本基线是悬挂基线。
- 'middle'：文本基线在文本块的中间。
- 'ideographic'：文字基线是表意字基线；如果字符本身超出了alphabetic基线，那么ideograhpic基线位置在字符本身的底部。
- 'bottom'：文本基线在文本块的底部。 与ideographic基线的区别在于ideographic基线不需要考虑下行字母。
- 默认值：'alphabetic'。 | +| [globalAlpha](#globalalpha) | number | 设置透明度，0.0为完全透明，1.0为完全不透明。 | +| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线偏移量，精度为float。
- 默认值：0.0。 | +| [globalCompositeOperation](#globalcompositeoperation) | string | 设置合成操作的方式。类型字段可选值有'source-over'，'source-atop'，'source-in'，'source-out'，'destination-over'，'destination-atop'，'destination-in'，'destination-out'，'lighter'，'copy'，'xor'。
- 默认值：'source-over'。 | +| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别，值越大越模糊，精度为float。
- 默认值：0.0。 | +| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。 | +| [shadowOffsetX](#shadowoffsetx) | number | 设置绘制阴影时和原有对象的水平偏移值。 | +| [shadowOffsetY](#shadowoffsety) | number | 设置绘制阴影时和原有对象的垂直偏移值。 | +| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是否进行图像平滑度调整，true为启用，false为不启用。
- 默认值：true。 | + +> **说明：** > fillStyle、shadowColor与 strokeStyle 中string类型格式为 'rgb(255, 255, 255)'，'rgba(255, 255, 255, 1.0)'，'\#FFFFFF'。 @@ -1919,8 +1919,8 @@ transform(a: number, b: number, c: number, d: number, e: number, f: number): voi transform方法对应一个变换矩阵，想对一个图形进行变化的时候，只要设置此变换矩阵相应的参数，对图形的各个定点的坐标分别乘以这个矩阵，就能得到新的定点的坐标。矩阵变换效果可叠加。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 变换后的坐标计算方式（x和y为变换前坐标，x'和y'为变换后坐标）： +> **说明：** +> 变换后的坐标计算方式（x和y为变换前坐标，x'和y'为变换后坐标)： > > - x' = scaleX \* x + skewY \* y + translateX > diff --git a/zh-cn/application-dev/ui/js-framework-multiple-languages.md b/zh-cn/application-dev/ui/js-framework-multiple-languages.md index 540b46aca1402b1572503e2094bc0afe1e6a8d9e..293f174c1f22b0ff8f7639a67aff9d0e9c857e9f 100644 --- a/zh-cn/application-dev/ui/js-framework-multiple-languages.md +++ b/zh-cn/application-dev/ui/js-framework-multiple-languages.md @@ -119,7 +119,7 @@ ar-AE.json {{ replaceObject }} {{ replaceArray }} - + @@ -150,9 +150,9 @@ ar-AE.json 表4 单复数格式化 - | 属性 | 类型 | 参数 | 必填 | 描述 | - | ---- | -------- | ----------- | ---- | ---------------------------------------- | - | $tc | Function | 请见表 $tc参数说明 | 是 | 根据系统语言完成单复数替换：this.$tc('strings.people')
> ![icon-note.gif](public_sys-resources/icon-note.gif) 说明：
> 定义资源的内容通过json格式的key为“zero”、“one”、“two”、“few”、“many”和“other”区分。 | + | 属性 | 类型 | 参数 | 必填 | 描述 | + | ---- | -------- | ------------------ | ---- | ------------------------------------------------------------ | + | $tc | Function | 请见表 $tc参数说明 | 是 | 根据系统语言完成单复数替换：this.$tc('strings.people')
> 说明：
> 定义资源的内容通过json格式的key为“zero”、“one”、“two”、“few”、“many”和“other”区分。 | 表5 $tc参数说明 diff --git a/zh-cn/application-dev/ui/js-framework-syntax-js.md b/zh-cn/application-dev/ui/js-framework-syntax-js.md index efd674d14cf76c6bab52c7deb19aacf385ff20ee..2a1c2d5664b44a1a6a3b87d0661f04df7be4fab7 100644 --- a/zh-cn/application-dev/ui/js-framework-syntax-js.md +++ b/zh-cn/application-dev/ui/js-framework-syntax-js.md @@ -25,9 +25,9 @@ JS文件用来定义HML页面的业务逻辑，支持ECMA规范的JavaScript语 ## 对象 - 应用对象 - | 属性 | 类型 | 描述 | - | ---- | ------ | ---------------------------------------- | - | $def | Object | 使用this.$app.$def获取在app.js中暴露的对象。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 应用对象不支持数据绑定，需主动触发UI更新。 | + | 属性 | 类型 | 描述 | + | ---- | ------ | ------------------------------------------------------------ | + | $def | Object | 使用this.$app.$def获取在app.js中暴露的对象。
> **说明：**
> 应用对象不支持数据绑定，需主动触发UI更新。 | 示例代码 @@ -103,7 +103,7 @@ JS文件用来定义HML页面的业务逻辑，支持ECMA规范的JavaScript语 getAppVersion() { this.$set('keyMap.Version', '3.0'); console.info("keyMap.Version = " + this.keyMap.Version); // keyMap.Version = 3.0 - + this.$delete('keyMap'); console.info("keyMap.Version = " + this.keyMap); // log print: keyMap.Version = undefined } diff --git a/zh-cn/application-dev/webgl/webgl-guidelines.md b/zh-cn/application-dev/webgl/webgl-guidelines.md index 69ae4645ce51af1eb43bc6c90caad7c7ff264ee7..b4456e87ca3331c61bf069d504508a02d0274e07 100644 --- a/zh-cn/application-dev/webgl/webgl-guidelines.md +++ b/zh-cn/application-dev/webgl/webgl-guidelines.md @@ -29,7 +29,7 @@ WebGL主要帮助开发者在前端开发中完成图形图像的相关处理， 以下分别展示无着色器绘制2D图形和着色器绘制彩色三角形的两个场景示例及开发过程。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 使用WebGL开发时，为保证界面图形显示效果，请使用真机运行。 diff --git a/zh-cn/device-dev/security/security-guidelines-overall.md b/zh-cn/device-dev/security/security-guidelines-overall.md index 4cae3f12b09363221ec0e43087657777815ad020..5b45af3062dfe7bf6783df0b29f57d52a602a4e5 100644 --- a/zh-cn/device-dev/security/security-guidelines-overall.md +++ b/zh-cn/device-dev/security/security-guidelines-overall.md @@ -207,6 +207,6 @@ HUKS本身不考虑多个应用同时调用的情况，因为HUKS只是一个lib 开发者在开发过程中需明确后续应用在运行时需要运行哪些权限，并在应用配置文件中进行注册，然后需要对应用进行签名，确保设备在安装这些应用时能对应用的完整性和来源进行校验。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > > 不同应用模型的应用配置文件不同，FA模型为config.json，Stage模型为module.json5。应用模型相关解释可参考[应用模型解读](../../application-dev/application-models/application-model-description.md)。 \ No newline at end of file diff --git a/zh-cn/device-dev/subsystems/subsys-ai-aiframework-devguide.md b/zh-cn/device-dev/subsystems/subsys-ai-aiframework-devguide.md index e456894a0672f3858ecff57f929358313d64af89..518a4ca6c88afc76912954f812386f64ee6ece5d 100644 --- a/zh-cn/device-dev/subsystems/subsys-ai-aiframework-devguide.md +++ b/zh-cn/device-dev/subsystems/subsys-ai-aiframework-devguide.md @@ -418,7 +418,7 @@ Response类的属性如下表所示。 上述代码为API接口的具体实现。在示例代码中，SDK中create接口的具体实现即为上述示例代码中create方法，该方法调用了AI引擎框架client端提供的AieClientInit及AieClientPrepare接口，从而实现与server端建立连接及加载算法模型的能力。 - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** + > **说明：** > > SDK调用AI引擎client端接口应遵循AieClientInit->AieClientPrepare->AieClientSyncProcess/AieClientAsyncProcess->AieClientRelease->AieClientDestroy顺序，否则调用接口会返回错误码。 diff --git a/zh-cn/device-dev/subsystems/subsys-boot-overview.md b/zh-cn/device-dev/subsystems/subsys-boot-overview.md index c8d02992b4cb304d3a1266712e7abccbf63d89b7..6c5907bac9d7fa59d79137a3efef1f614e42634f 100644 --- a/zh-cn/device-dev/subsystems/subsys-boot-overview.md +++ b/zh-cn/device-dev/subsystems/subsys-boot-overview.md @@ -57,8 +57,8 @@ - 新芯片平台移植时，平台相关的初始化配置需要增加平台相关的初始化配置文件/vendor/etc/init/init.{hardware}.cfg；该文件完成平台相关的初始化设置，如安装ko驱动，设置平台相关的/proc节点信息。 - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** - + > **说明：** +> > 配置文件init.cfg仅支持json格式。 - bootstrap服务启动组件：需要在链接脚本中配置zInit代码段。 @@ -188,8 +188,8 @@ 下面以OpenHarmony系统在Hi3516DV300平台启动过程中必要的system分区为例，详细介绍init进程启动后，从读取required fstab信息到创建required分区块设备节点再到最后完成required分区挂载的全部流程。其中会包含一些关键代码段和关键的log信息供开发者调试参考。 - > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** - + > **说明：** + > > 从此处开始出现的代码是按逻辑顺序展示的关键代码行，不代表其在源码当中真正的相邻关系。 1. 获取required设备信息 diff --git a/zh-cn/device-dev/subsystems/subsys-build-all.md b/zh-cn/device-dev/subsystems/subsys-build-all.md index 317f71ac5b816fb83582d798043c3e9cfea069f7..442f7ba0091615cad7e19198a088c192721418c4 100644 --- a/zh-cn/device-dev/subsystems/subsys-build-all.md +++ b/zh-cn/device-dev/subsystems/subsys-build-all.md @@ -328,7 +328,8 @@ optional arguments: -h, --help show this help message and exit ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> > - 设备开发过程中详细的编译环境搭建及编译步骤请参考[快速入门中的环境搭建及编译章节。](../quick-start/quickstart-overview.md) > - OpenHarmony还为开发者提供了Docker编译环境，可以省略编译工具的安装，具体使用请参考[Docker编译指导。](../get-code/gettools-acquire.md) diff --git a/zh-cn/device-dev/subsystems/subsys-build-chip_solution.md b/zh-cn/device-dev/subsystems/subsys-build-chip_solution.md index b4e39553e4a4a42e94672bfaecbf36136e571169..d7740444624c92978a2a2f1709a9559ccf45946d 100644 --- a/zh-cn/device-dev/subsystems/subsys-build-chip_solution.md +++ b/zh-cn/device-dev/subsystems/subsys-build-chip_solution.md @@ -19,7 +19,7 @@ └── config.gni # liteos_a版本编译配置 ``` -![icon-note.gif](public_sys-resources/icon-note.gif)**注意**：config.gni为开发板编译相关的配置，编译时会采用该配置文件中的参数编译所有OS部件，编译阶段系统全局可见。 +> **注意**：config.gni为开发板编译相关的配置，编译时会采用该配置文件中的参数编译所有OS部件，编译阶段系统全局可见。 - config.gni的关键字段介绍如下： diff --git a/zh-cn/device-dev/subsystems/subsys-build-component-building-rules.md b/zh-cn/device-dev/subsystems/subsys-build-component-building-rules.md index c256505552d4f8a3e741853516e1049adcef97ca..7b4c0ea74e43d12e29c0eefe31bd87274e6ac047 100644 --- a/zh-cn/device-dev/subsystems/subsys-build-component-building-rules.md +++ b/zh-cn/device-dev/subsystems/subsys-build-component-building-rules.md @@ -69,7 +69,7 @@ - 不超过63个有效英文字符。 - 使用小写加下划线的内核风格命名，例如：unix_like。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **例外：** 三方开源软件的使用对应社区的原生命名方式，比如：cJson。 +> **例外：** 三方开源软件的使用对应社区的原生命名方式，比如：cJson。 ### 规则1.2 特性名为部件名前缀+特性名称 @@ -160,13 +160,13 @@ bundle.json是定义部件的描述文件，包含了部件的根目录、名称 deps = [ "a" ] # Good, 依赖当前部件内的其他模块 ``` - > ![icon-note.gif](public_sys-resources/icon-note.gif) **例外：** 对三方开源软件的引用除外。 + > **例外：** 对三方开源软件的引用除外。 - public_deps public_deps只允许用于部件内模块的依赖，直接引用其他部件的模块可能会导致依赖其他部件的内部模块和接口。 - > ![icon-note.gif](public_sys-resources/icon-note.gif) **例外：** 对三方开源软件的引用除外。 + > **例外：** 对三方开源软件的引用除外。 看护手段：静态检查 @@ -249,7 +249,7 @@ ohos_shared_library("foo_a") { 部件是通用的系统能力，与特定产品无关。编译脚本中使用产品名称，将导致部件功能与产品绑定，不具备通用性。部件不同产品形态上的差异应抽象为特性或者运行时的插件。 -> ![icon-note.gif](public_sys-resources/icon-note.gif)**例外：** vendor和device目录下三方厂商部件的编译脚本例外。 +> **例外：** vendor和device目录下三方厂商部件的编译脚本例外。 看护手段：静态检查 @@ -257,7 +257,7 @@ ohos_shared_library("foo_a") { 部件内的gni文件用于声明部件内部编译变量和模板，import其他部件的gni文件等同于使用其他部件内部的变量和模板，即引入对其他部件的依赖。影响多个部件的变量、args和模板应定义在编译框架的gni文件中。 -> ![icon-note.gif](public_sys-resources/icon-note.gif)**例外：** build目录下编译框架定义全局的编译选项的gni可以被所有部件import。 +> **例外：** build目录下编译框架定义全局的编译选项的gni可以被所有部件import。 看护手段：静态检查 diff --git a/zh-cn/device-dev/subsystems/subsys-build-component.md b/zh-cn/device-dev/subsystems/subsys-build-component.md index f4d1e4277090ed78e21833f6b3fe37c669e3593d..82b55156b021634f437dbc1c5282e4398489cc89 100644 --- a/zh-cn/device-dev/subsystems/subsys-build-component.md +++ b/zh-cn/device-dev/subsystems/subsys-build-component.md @@ -47,7 +47,7 @@ } ``` -> ![icon-note.gif](public_sys-resources/icon-note.gif)**注意**：lite上旧的部件在build/lite/components目录下对应子系统的json文件中，路径规则为：**{领域}/{子系统}/{部件}**，部件目录树规则如下： +> **注意**：lite上旧的部件在build/lite/components目录下对应子系统的json文件中，路径规则为：**{领域}/{子系统}/{部件}**，部件目录树规则如下： ```shell component