Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
30e4ba83
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
30e4ba83
编写于
12月 26, 2022
作者:
zyjhandsome
浏览文件
操作
浏览文件
下载
差异文件
Merge branch 'master' of
https://gitee.com/openharmony/docs
上级
a47b9b2d
c13a5bfb
变更
28
展开全部
隐藏空白更改
内联
并排
Showing
28 changed file
with
477 addition
and
461 deletion
+477
-461
zh-cn/application-dev/quick-start/arkts-state-mgmt-page-level.md
...pplication-dev/quick-start/arkts-state-mgmt-page-level.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
...application-dev/reference/apis/js-apis-ability-context.md
+11
-10
zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
...cation-dev/reference/apis/js-apis-ability-dataUriUtils.md
+19
-19
zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
...plication-dev/reference/apis/js-apis-ability-errorCode.md
+4
-6
zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md
...tion-dev/reference/apis/js-apis-ability-featureAbility.md
+67
-59
zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md
...ion-dev/reference/apis/js-apis-ability-particleAbility.md
+22
-32
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
...dev/reference/apis/js-apis-app-ability-abilityConstant.md
+6
-2
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
...-dev/reference/apis/js-apis-app-ability-abilityManager.md
+6
-6
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
...tion-dev/reference/apis/js-apis-app-ability-appManager.md
+6
-6
zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md
...n-dev/reference/apis/js-apis-app-ability-configuration.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-app-ability-dataUriUtils.md
...on-dev/reference/apis/js-apis-app-ability-dataUriUtils.md
+20
-20
zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md
...-dev/reference/apis/js-apis-app-ability-missionManager.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
...ation-dev/reference/apis/js-apis-app-ability-uiAbility.md
+47
-46
zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md
...ation-dev/reference/apis/js-apis-app-ability-wantAgent.md
+3
-3
zh-cn/application-dev/reference/apis/js-apis-application-ability.md
...ication-dev/reference/apis/js-apis-application-ability.md
+5
-4
zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
...dev/reference/apis/js-apis-application-abilityConstant.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
...-dev/reference/apis/js-apis-application-abilityManager.md
+6
-6
zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md
...apis/js-apis-application-accessibilityExtensionAbility.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-application-appManager.md
...tion-dev/reference/apis/js-apis-application-appManager.md
+7
-7
zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md
...plication-dev/reference/apis/js-apis-inner-app-context.md
+37
-36
zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md
...erence/apis/js-apis-inner-application-uiAbilityContext.md
+6
-5
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
+28
-28
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-url.md
zh-cn/application-dev/reference/apis/js-apis-url.md
+17
-149
zh-cn/application-dev/reference/arkui-js/js-components-common-customizing-font.md
...ference/arkui-js/js-components-common-customizing-font.md
+5
-5
zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
...application-dev/reference/arkui-ts/ts-container-swiper.md
+2
-0
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-ability.md
...tes/changelogs/OpenHarmony_3.2.10.1/changelogs-ability.md
+94
-1
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-notification.md
...hangelogs/OpenHarmony_3.2.10.1/changelogs-notification.md
+48
-0
未找到文件。
zh-cn/application-dev/quick-start/arkts-state-mgmt-page-level.md
浏览文件 @
30e4ba83
...
...
@@ -82,7 +82,7 @@ struct MyComponent {
## @Prop
@Prop与@State有相同的语义,但初始化方式不同。@Prop装饰的变量必须使用其父组件提供的@State变量进行初始化,允许组件内部修改@Prop变量,但变量的更改不会通知给父组件,即@Prop属于单向数据绑定。
@Prop与@State有相同的语义,但初始化方式不同。@Prop装饰的变量必须使用其父组件提供的@State变量进行初始化,允许组件内部修改@Prop变量,但变量的更改不会通知给父组件,
父组件变量的更改会同步到@prop装饰的变量,
即@Prop属于单向数据绑定。
@Prop状态数据具有以下特征:
...
...
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
浏览文件 @
30e4ba83
...
...
@@ -30,8 +30,8 @@ class MainAbility extends Ability {
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| abilityInfo |
AbilityInfo
| 是 | 否 | Abilityinfo相关信息 |
| currentHapModuleInfo |
HapModuleInfo | 是 | 否 | 当前HAP
的信息 |
| abilityInfo |
[
AbilityInfo
](
js-apis-bundleManager-abilityInfo.md
)
| 是 | 否 | Abilityinfo相关信息 |
| currentHapModuleInfo |
[
HapModuleInfo
](
js-apis-bundleManager-hapModuleInfo.md
)
| 是 | 否 | 当前hap包
的信息 |
| config |
[
Configuration
](
js-apis-application-configuration.md
)
| 是 | 否 | 表示配置信息。 |
## AbilityContext.startAbility
...
...
@@ -198,7 +198,7 @@ startAbility(want: Want, options?: StartOptions): Promise<void>;
startAbilityForResult(want: Want, callback: AsyncCallback
<
AbilityResult
>
): void;
启动
Ability并在该Ability退出的时候返回执行结果
(callback形式)。
启动
一个Ability。Ability被启动后,正常情况下可通过调用
[
terminateSelfWithResult
](
#abilitycontextterminateselfwithresult
)
接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者
(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -248,7 +248,7 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>):
startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
<
AbilityResult
>
): void;
启动
Ability并在该Ability退出的时候返回执行结果
(callback形式)。
启动
一个Ability。Ability被启动后,正常情况下可通过调用
[
terminateSelfWithResult
](
#abilitycontextterminateselfwithresult
)
接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者
(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -303,7 +303,7 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
startAbilityForResult(want: Want, options?: StartOptions): Promise
<
AbilityResult
>
;
启动
Ability并在该Ability退出的时候返回执行结果
(promise形式)。
启动
一个Ability。Ability被启动后,正常情况下可通过调用
[
terminateSelfWithResult
](
#abilitycontextterminateselfwithresult
)
接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者
(promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -375,7 +375,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID,详情参考
[
getCreatedOsAccountsCount
](
js-apis-osAccount.md#getosaccountlocalidfromprocess
)
。 |
| callback | AsyncCallback
\<
AbilityResult
\>
| 是 | 启动Ability的回调函数,返回Ability结果。 |
| callback | AsyncCallback
\<
[
AbilityResult
](
js-apis-inner-ability-abilityResult.md
)
\>
| 是 | 启动Ability的回调函数,返回Ability结果。 |
**错误码:**
...
...
@@ -499,7 +499,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
AbilityResult
>
| 返回一个Promise,包含Ability结果。 |
| Promise
<
[AbilityResult](js-apis-inner-ability-abilityResult.md)
>
| 返回一个Promise,包含Ability结果。 |
**错误码:**
...
...
@@ -1034,7 +1034,7 @@ terminateSelf(): Promise<void>;
terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback
<
void
>
): void;
停止
Ability,配合startAbilityForResult使用,返回给接口调用方AbilityResult信息
(callback形式)。
停止
当前的Ability。如果该Ability是通过调用
[
startAbilityForResult
](
#abilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时会将结果返回给调用者,如果该Ability不是通过调用
[
startAbilityForResult
](
#abilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时不会有结果返回给调用者
(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -1090,6 +1090,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<voi
terminateSelfWithResult(parameter: AbilityResult): Promise
<
void
>
;
停止Ability,配合startAbilityForResult使用,返回给接口调用方AbilityResult信息(promise形式)。
停止当前的Ability。如果该Ability是通过调用
[
startAbilityForResult
](
#abilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时会将结果返回给调用者,如果该Ability不是通过调用
[
startAbilityForResult
](
#abilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时不会有结果返回给调用者(promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -1685,7 +1686,7 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| icon |
image.PixelMap
| 是 | 在最近的任务中显示的ability图标。 |
| icon |
[
image.PixelMap
](
js-apis-image.md#pixelmap7
)
| 是 | 在最近的任务中显示的ability图标。 |
| callback | AsyncCallback
\<
void> | 是 | 指定的回调函数的结果。 |
**示例:**
...
...
@@ -1727,7 +1728,7 @@ setMissionIcon(icon: image.PixelMap): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| icon |
image.PixelMap
| 是 | 在最近的任务中显示的ability图标。 |
| icon |
[
image.PixelMap
](
js-apis-image.md#pixelmap7
)
| 是 | 在最近的任务中显示的ability图标。 |
**返回值:**
...
...
zh-cn/application-dev/reference/apis/js-apis-ability-dataUriUtils.md
浏览文件 @
30e4ba83
# @ohos.ability.dataUriUtils (DataUriUtils模块)
DataUriUtils模块提供用于处理
使用DataAbilityHelper方案的对象的实用程序类的能力,包括获取,添加,更新给定uri的路径组件末尾的ID。本模块将被app.ability.dataUriUtils模块
,建议优先使用
[
@ohos.app.ability.dataUriUtils
](
js-apis-app-ability-dataUriUtils.md
)
模块。
DataUriUtils模块提供用于处理
uri对象的能力,包括获取、绑定、删除和更新指定uri对象的路径末尾的ID。本模块将被app.ability.dataUriUtils模块替代
,建议优先使用
[
@ohos.app.ability.dataUriUtils
](
js-apis-app-ability-dataUriUtils.md
)
模块。
> **说明:**
>
...
...
@@ -16,7 +16,7 @@ import dataUriUtils from '@ohos.ability.dataUriUtils';
getId(uri: string): number
获取
附加到给定uri的路径组件
末尾的ID。
获取
指定uri路径
末尾的ID。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -24,13 +24,13 @@ getId(uri: string): number
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 |
指示要从中获取ID的
uri对象。 |
| uri | string | 是 |
表示
uri对象。 |
**返回值:**
| 类型 | 说明 |
| ------ | ------------------------ |
| number |
附加到路径组件
末尾的ID。 |
| number |
返回uri路径
末尾的ID。 |
**示例:**
...
...
@@ -44,7 +44,7 @@ dataUriUtils.getId("com.example.dataUriUtils/1221")
attachId(uri: string, id: number): string
将
给定ID附加到给定uri的路径组件的
末尾。
将
ID附加到uri的路径
末尾。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -52,22 +52,22 @@ attachId(uri: string, id: number): string
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 |
指示要从中获取ID的
uri对象。 |
| id | number | 是 |
指
示要附加的ID。 |
| uri | string | 是 |
表示
uri对象。 |
| id | number | 是 |
表
示要附加的ID。 |
**返回值:**
| 类型 | 说明 |
| ------ | --------------------- |
| string |
附加给定ID
的uri对象。 |
| string |
返回附加ID之后
的uri对象。 |
**示例:**
```
ts
var
id
int
=
1122
;
var
id
=
1122
;
dataUriUtils
.
attachId
(
"
com.example.dataUriUtils
"
,
id
int
,
id
,
)
```
...
...
@@ -77,7 +77,7 @@ dataUriUtils.attachId(
deleteId(uri: string): string
从给定uri的路径组件的末尾删除
ID。
删除指定uri路径末尾的
ID。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -85,13 +85,13 @@ deleteId(uri: string): string
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 |
指
示要从中删除ID的uri对象。 |
| uri | string | 是 |
表
示要从中删除ID的uri对象。 |
**返回值:**
| 类型 | 说明 |
| ------ | ------------------- |
| string |
ID已删除
的uri对象。 |
| string |
返回删除ID之后
的uri对象。 |
**示例:**
...
...
@@ -113,22 +113,22 @@ updateId(uri: string, id: number): string
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ------------------- |
| uri | string | 是 |
指示要更新的
uri对象 |
| id | number | 是 |
指示新
ID |
| uri | string | 是 |
表示
uri对象 |
| id | number | 是 |
表示要更新的
ID |
**返回值:**
| 类型 | 说明 |
| ------ | --------------- |
| string |
更新
的uri对象。 |
| string |
返回更新ID之后
的uri对象。 |
**示例:**
```
ts
var
id
int
=
1122
;
var
id
=
1122
;
dataUriUtils
.
updateId
(
"
com.example.dataUriUtils
"
,
id
int
"
com.example.dataUriUtils
/1221
"
,
id
)
```
zh-cn/application-dev/reference/apis/js-apis-ability-errorCode.md
浏览文件 @
30e4ba83
# @ohos.ability.errorCode (ErrorCode)
ErrorCode是定义启动功能时使用的错误代码。
本模块提供使用的错误代码的能力,包括没有错误,无效的参数等。
ErrorCode定义启动Ability时返回的错误码,包括无效的参数、权限拒绝等。
> **说明:**
>
...
...
@@ -16,13 +14,13 @@ import errorCode from '@ohos.ability.errorCode'
## ErrorCode
定义启动
功能时使用的错误代
码。
定义启动
Ability时返回的错误
码。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 |
| ------------------------------ | ---- | ---------------------------------------- |
| NO_ERROR | 0 | 没有
错误
。 |
| NO_ERROR | 0 | 没有
异常
。 |
| INVALID_PARAMETER | -1 | 无效的参数。 |
| ABILITY_NOT_FOUND | -2 | 找不到ABILITY。 |
| PERMISSION_DENY | -3 | 拒绝许可。 |
\ No newline at end of file
| PERMISSION_DENY | -3 | 权限拒绝。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-ability-featureAbility.md
浏览文件 @
30e4ba83
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-ability-particleAbility.md
浏览文件 @
30e4ba83
# @ohos.ability.particleAbility (ParticleAbility模块)
particleAbility模块提供了
Service类型Ability的能力,包括启动、停止指定的particleAbility,获取dataAbilityHelper,连接、断开当前Ability与指定
ServiceAbility等。
particleAbility模块提供了
操作Service类型的Ability的能力,包括启动、停止指定的particleAbility,获取dataAbilityHelper,连接、断连指定的
ServiceAbility等。
> **说明:**
>
...
...
@@ -21,7 +21,7 @@ import particleAbility from '@ohos.ability.particleAbility'
startAbility(parameter: StartAbilityParameter, callback: AsyncCallback
\<
void>): void
使用此方法
启动指定的particleAbility(callback形式)。
启动指定的particleAbility(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -29,8 +29,8 @@ startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\<void>):
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ----------------------------------------------- | ---- | ----------------- |
| parameter |
[
StartAbilityParameter
](
js-apis-inner-ability-startAbilityParameter.md
)
| 是 |
指
示启动的ability |
| callback | AsyncCallback
\<
void> | 是 |
被指定的回调方法
|
| parameter |
[
StartAbilityParameter
](
js-apis-inner-ability-startAbilityParameter.md
)
| 是 |
表
示启动的ability |
| callback | AsyncCallback
\<
void> | 是 |
以callback的形式返回启动Ability的结果
|
**示例:**
...
...
@@ -62,7 +62,7 @@ particleAbility.startAbility(
startAbility(parameter: StartAbilityParameter): Promise
\<
void>;
使用此方法
启动指定的particleAbility(Promise形式)。
启动指定的particleAbility(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -70,13 +70,13 @@ startAbility(parameter: StartAbilityParameter): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ----------------------------------------------- | ---- | ----------------- |
| parameter |
[
StartAbilityParameter
](
js-apis-inner-ability-startAbilityParameter.md
)
| 是 |
指
示启动的ability |
| parameter |
[
StartAbilityParameter
](
js-apis-inner-ability-startAbilityParameter.md
)
| 是 |
表
示启动的ability |
**返回值:**
| 类型 | 说明 |
| -------------- | ------------------------- |
| Promise
\<
void> |
使用Promise形式返回
结果。 |
| Promise
\<
void> |
Promise形式返回启动Ability的
结果。 |
**示例:**
...
...
@@ -107,7 +107,7 @@ particleAbility.startAbility(
terminateSelf(callback: AsyncCallback
\<
void>): void
终止
particleAbility(callback形式)。
销毁当前
particleAbility(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -115,7 +115,7 @@ terminateSelf(callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | -------------------- |
| callback | AsyncCallback
\<
void> | 是 |
表示被指定的回调方法
|
| callback | AsyncCallback
\<
void> | 是 |
以callback的形式返回停止当前Ability结果
|
**示例:**
...
...
@@ -133,7 +133,7 @@ particleAbility.terminateSelf(
terminateSelf(): Promise
\<
void>
终止
particleAbility(Promise形式)。
销毁当前
particleAbility(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -141,7 +141,7 @@ terminateSelf(): Promise\<void>
| 类型 | 说明 |
| -------------- | ------------------------- |
| Promise
\<
void> | 使用Promise形式返回结果。 |
| Promise
\<
void> | 使用Promise形式返回
停止当前Ability
结果。 |
**示例:**
...
...
@@ -159,7 +159,7 @@ particleAbility.terminateSelf().then((data) => {
acquireDataAbilityHelper(uri: string): DataAbilityHelper
获取dataAbilityHelper。
获取dataAbilityHelper
对象
。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -167,13 +167,13 @@ acquireDataAbilityHelper(uri: string): DataAbilityHelper
| 参数名 | 类型 | 必填 | 说明 |
| :--- | ------ | ---- | ------------------------ |
| uri | string | 是 |
指
示要打开的文件的路径。 |
| uri | string | 是 |
表
示要打开的文件的路径。 |
**返回值:**
| 类型 | 说明 |
| ----------------- | -------------------------------------------- |
|
DataAbilityHelper
| 用来协助其他Ability访问DataAbility的工具类。 |
|
[
DataAbilityHelper
](
js-apis-inner-ability-dataAbilityHelper.md
)
| 用来协助其他Ability访问DataAbility的工具类。 |
**示例:**
...
...
@@ -270,7 +270,7 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise<voi
| 类型 | 说明 |
| -------------- | ------------------------- |
| Promise
\<
void> | 使用Promise形式返回结果。 |
| Promise
\<
void> | 使用Promise形式返回
启动长时任务的
结果。 |
**示例**
:
...
...
@@ -326,7 +326,7 @@ cancelBackgroundRunning(callback: AsyncCallback<void>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
void
>
| 是 | callback形式返回
启动
长时任务的结果 |
| callback | AsyncCallback
<
void
>
| 是 | callback形式返回
取消
长时任务的结果 |
**示例**
:
...
...
@@ -357,7 +357,7 @@ cancelBackgroundRunning(): Promise<void>;
| 类型 | 说明 |
| -------------- | ------------------------- |
| Promise
\<
void> | 使用Promise形式返回结果。 |
| Promise
\<
void> | 使用Promise形式返回
取消长时任务的
结果。 |
**示例**
:
...
...
@@ -376,7 +376,7 @@ particleAbility.cancelBackgroundRunning().then(() => {
connectAbility(request: Want, options:ConnectOptions): number
将当前ability
连接到指定ServiceAbility
(callback形式)。
将当前ability
与指定的ServiceAbility进行连接
(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -385,18 +385,8 @@ connectAbility(request: Want, options:ConnectOptions): number
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------------- | ---- | ---------------------------- |
| request |
[
Want
](
js-apis-application-want.md
)
| 是 | 表示被连接的ServiceAbility。 |
| options | ConnectOptions | 是 | 被指定的回调方法。 |
**ConnectOptions类型说明:**
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| options |
[
ConnectOptions
](
js-apis-inner-ability-connectOptions.md
)
| 是 | 连接回调方法。 |
| 名称 | 类型 | 必填 | 说明 |
| ------------ | -------- | ---- | ------------------------- |
| onConnect | function | 是 | 连接成功时的回调函数。 |
| onDisconnect | function | 是 | 连接失败时的回调函数。 |
| onFailed | function | 是 | ConnectAbility调用失败时的回调函数。 |
**示例**
:
...
...
@@ -439,7 +429,7 @@ particleAbility.disconnectAbility(connId).then((data) => {
disconnectAbility(connection: number, callback:AsyncCallback
\<
void>): void;
将功能与服务功能断开连接
。
断开当前ability与指定ServiceAbility的连接(callback形式)
。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -489,7 +479,7 @@ var result = particleAbility.disconnectAbility(connId).then((data) => {
disconnectAbility(connection: number): Promise
\<
void>;
将功能与服务功能断开连接
。
断开当前ability与指定ServiceAbility的连接(Promise形式)
。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
@@ -538,7 +528,7 @@ particleAbility.disconnectAbility(connId).then((data) => {
## ErrorCode
获取错误代
码。
表示错误
码。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @
30e4ba83
...
...
@@ -15,12 +15,16 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
## 属性
## AbilityConstant.LaunchParam
启动参数。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| launchReason |
LaunchReason
| 是 | 是 | 指示启动原因。 |
| lastExitReason |
LastExitReason
| 是 | 是 | 表示最后退出原因。 |
| launchReason |
[
LaunchReason
](
#abilityconstantlaunchreason
)
| 是 | 是 | 指示启动原因。 |
| lastExitReason |
[
LastExitReason
](
#abilityconstantlastexitreason
)
| 是 | 是 | 表示最后退出原因。 |
## AbilityConstant.LaunchReason
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
浏览文件 @
30e4ba83
...
...
@@ -118,7 +118,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback
\<
Array
\<
AbilityRunningInfo
>> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
Array
\<
[
AbilityRunningInfo
](
js-apis-inner-application-abilityRunningInfo.md
)
>> | 是 | 被指定的回调方法。 |
**示例**
:
...
...
@@ -147,7 +147,7 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| Promise
\<
Array
\<
AbilityRunningInfo
>> | 返回执行结果。 |
| Promise
\<
Array
\<
[
AbilityRunningInfo
](
js-apis-inner-application-abilityRunningInfo.md
)
>> | 返回执行结果。 |
**示例**
:
...
...
@@ -179,7 +179,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
| callback | AsyncCallback
\<
Array
\<
AbilityRunningInfo
>> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
Array
\<
[
ExtensionRunningInfo
](
js-apis-inner-application-extensionRunningInfo.md
)
>> | 是 | 被指定的回调方法。 |
**示例**
:
...
...
@@ -216,7 +216,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| Promise
\<
Array
\<
AbilityRunningInfo
>> | 返回执行结果。 |
| Promise
\<
Array
\<
[
ExtensionRunningInfo
](
js-apis-inner-application-extensionRunningInfo.md
)
>> | 返回执行结果。 |
**示例**
:
...
...
@@ -247,7 +247,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback
\<
ElementName
> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
> | 是 | 被指定的回调方法。 |
**示例**
:
...
...
@@ -269,7 +269,7 @@ getTopAbility(): Promise\<ElementName>;
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| Promise
\<
ElementName
>| 返回执行结果。 |
| Promise
\<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>| 返回执行结果。 |
**示例**
:
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
浏览文件 @
30e4ba83
...
...
@@ -391,7 +391,7 @@ off(type: "applicationState", observerId: number): Promise\<void>;
getForegroundApplications(callback: AsyncCallback
\<
Array
\<
AppStateData>>): void;
获取
前台进程的应用程序
。
获取
所有当前处于前台的应用信息。该应用信息由
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
定义
。
**需要权限**
:ohos.permission.GET_RUNNING_INFO
...
...
@@ -403,7 +403,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
\<
Array
\<
AppStateData>> | 是 | 表示应用的状态数据
。 |
| callback | AsyncCallback
\<
Array
\<
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
>> | 是 | callback形式返回所有当前处于前台的应用信息
。 |
**示例:**
...
...
@@ -465,7 +465,7 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>;
getForegroundApplications(callback: AsyncCallback
\<
Array
\<
AppStateData>>): void;
获取
前台进程的应用程序
。
获取
所有当前处于前台的应用信息。该应用信息由
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
定义
。
**需要权限**
:ohos.permission.GET_RUNNING_INFO
...
...
@@ -477,7 +477,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
\<
Array
\<
AppStateData>> | 是 | 表示应用的状态数据
。 |
| callback | AsyncCallback
\<
Array
\<
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
>> | 是 | callback形式返回所有当前处于前台的应用信息
。 |
**示例:**
...
...
@@ -500,7 +500,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
getForegroundApplications(): Promise
\<
Array
\<
AppStateData>>;
获取
前台进程的应用程序
。
获取
所有当前处于前台的应用信息。该应用信息由
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
定义
。
**需要权限**
:ohos.permission.GET_RUNNING_INFO
...
...
@@ -512,7 +512,7 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
| 类型 | 说明 |
| -------- | -------- |
| Promise
\<
Array
\<
ProcessRunningInfo>> | 返回进程运行信息的数组
。 |
| Promise
\<
Array
\<
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
>> | Promise形式返回所有当前处于前台的应用信息
。 |
**示例:**
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-configuration.md
浏览文件 @
30e4ba83
...
...
@@ -18,8 +18,8 @@ import Configuration from '@ohos.app.ability.Configuration'
| -------- | -------- | -------- | -------- | -------- |
| language | string | 是 | 是 | 表示应用程序的当前语言。 |
| colorMode |
[
ColorMode
](
js-apis-app-ability-configurationConstant.md#configurationconstantcolormode
)
| 是 | 是 | 表示深浅色模式,取值范围:浅色模式(COLOR_MODE_LIGHT),深色模式(COLOR_MODE_DARK)。默认为浅色。 |
| direction |
Direction
| 是 | 否 | 表示屏幕方向,取值范围:水平方向(DIRECTION_HORIZONTAL),垂直方向(DIRECTION_VERTICAL)。 |
| screenDensity |
ScreenDensity
| 是 | 否 | 表示屏幕分辨率,取值范围:SCREEN_DENSITY_SDPI(120)、SCREEN_DENSITY_MDPI(160)、SCREEN_DENSITY_LDPI(240)、SCREEN_DENSITY_XLDPI(320)、SCREEN_DENSITY_XXLDPI(480)、SCREEN_DENSITY_XXXLDPI(640)。 |
| direction |
[
Direction
](
js-apis-app-ability-configurationConstant.md#configurationconstantdirection
)
| 是 | 否 | 表示屏幕方向,取值范围:水平方向(DIRECTION_HORIZONTAL),垂直方向(DIRECTION_VERTICAL)。 |
| screenDensity |
[
ScreenDensity
](
js-apis-app-ability-configurationConstant.md#configurationconstantscreendensity
)
| 是 | 否 | 表示屏幕分辨率,取值范围:SCREEN_DENSITY_SDPI(120)、SCREEN_DENSITY_MDPI(160)、SCREEN_DENSITY_LDPI(240)、SCREEN_DENSITY_XLDPI(320)、SCREEN_DENSITY_XXLDPI(480)、SCREEN_DENSITY_XXXLDPI(640)。 |
| displayId | number | 是 | 否 | 表示应用所在的物理屏幕Id。 |
| hasPointerDevice | boolean | 是 | 否 | 指示指针类型设备是否已连接,如键鼠、触控板等。 |
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-dataUriUtils.md
浏览文件 @
30e4ba83
# ohos.app.ability.dataUriUtils (DataUriUtils模块)
#
@
ohos.app.ability.dataUriUtils (DataUriUtils模块)
DataUriUtils模块提供用于处理
使用DataAbilityHelper方案的对象的实用程序类的能力,包括获取,添加,更新给定uri
的路径末尾的ID。
DataUriUtils模块提供用于处理
uri对象的能力,包括获取、绑定、删除和更新指定uri对象
的路径末尾的ID。
> **说明:**
>
...
...
@@ -16,7 +16,7 @@ import dataUriUtils from '@ohos.app.ability.dataUriUtils';
getId(uri: string): number
获取
附加到给定uri的
路径末尾的ID。
获取
指定uri
路径末尾的ID。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -24,13 +24,13 @@ getId(uri: string): number
| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 |
指示要从中获取ID的
uri对象。 |
| uri | string | 是 |
表示
uri对象。 |
**返回值:**
| 类型 | 说明 |
| ------ | ------------------------ |
| number |
附加到
uri路径末尾的ID。 |
| number |
返回
uri路径末尾的ID。 |
**示例:**
...
...
@@ -49,7 +49,7 @@ try {
attachId(uri: string, id: number): string
将
给定ID附加到给定uri的路径末尾。可用于生成新的uri
。
将
ID附加到uri的路径末尾
。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -57,23 +57,23 @@ attachId(uri: string, id: number): string
| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 |
指示要从中获取ID的
uri对象。 |
| id | number | 是 |
指
示要附加的ID。 |
| uri | string | 是 |
表示
uri对象。 |
| id | number | 是 |
表
示要附加的ID。 |
**返回值:**
| 类型 | 说明 |
| ------ | --------------------- |
| string |
附加给定ID
的uri对象。 |
| string |
返回附加ID之后
的uri对象。 |
**示例:**
```
ts
var
id
int
=
1122
;
var
id
=
1122
;
try
{
var
uri
=
dataUriUtils
.
attachId
(
"
com.example.dataUriUtils
"
,
id
int
,
id
,
)
console
.
info
(
'
attachId the uri is:
'
+
uri
)
}
catch
(
err
)
{
...
...
@@ -88,7 +88,7 @@ try {
deleteId(uri: string): string
从给定uri的路径的末尾删除
ID。
删除指定uri路径末尾的
ID。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -96,13 +96,13 @@ deleteId(uri: string): string
| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | --------------------------- |
| uri | string | 是 |
指
示要从中删除ID的uri对象。 |
| uri | string | 是 |
表
示要从中删除ID的uri对象。 |
**返回值:**
| 类型 | 说明 |
| ------ | ------------------- |
| string |
ID已删除
的uri对象。 |
| string |
返回删除ID之后
的uri对象。 |
**示例:**
...
...
@@ -130,24 +130,24 @@ updateId(uri: string, id: number): string
| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | ------------------- |
| uri | string | 是 |
指示要更新的uri对象。
|
| id | number | 是 |
指示新ID。
|
| uri | string | 是 |
表示uri对象
|
| id | number | 是 |
表示要更新的ID
|
**返回值:**
| 类型 | 说明 |
| ------ | --------------- |
| string |
更新
的uri对象。 |
| string |
返回更新ID之后
的uri对象。 |
**示例:**
```
ts
try
{
var
id
int
=
1122
;
var
id
=
1122
;
var
uri
=
dataUriUtils
.
updateId
(
"
com.example.dataUriUtils
"
,
id
int
"
com.example.dataUriUtils
/1221
"
,
id
)
}
catch
(
err
)
{
console
.
error
(
'
delete uri err, check the input uri
'
+
err
)
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-missionManager.md
浏览文件 @
30e4ba83
...
...
@@ -32,7 +32,7 @@ on(type:"mission", listener: MissionListener): number;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| listener |
MissionListener
| 是 | 系统任务监听器。 |
| listener |
[
MissionListener
](
js-apis-inner-application-missionListener.md
)
| 是 | 系统任务监听器。 |
**返回值:**
...
...
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
浏览文件 @
30e4ba83
...
...
@@ -18,7 +18,7 @@ import UIAbility from '@ohos.app.ability.UIAbility';
## 属性
**系统能力**
:以下各项对应的系统能力均为SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:以下各项对应的系统能力均为SystemCapability.
Ability.AbilityRuntime.
AbilityCore
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
...
...
@@ -29,18 +29,18 @@ import UIAbility from '@ohos.app.ability.UIAbility';
## UIAbility.onCreate
onCreate(want: Want, param:
UI
AbilityConstant.LaunchParam): void;
onCreate(want: Want, param: AbilityConstant.LaunchParam): void;
UIAbility创建时回调,执行初始化业务逻辑操作。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 当前UIAbility的Want类型信息,包括ability名称、bundle名称等。 |
| param |
UIAbilityConstant.LaunchParam
| 是 | 创建
ability、上次异常退出的原因信息。 |
| param |
[
AbilityConstant.LaunchParam
](
js-apis-app-ability-abilityConstant.md#abilityconstantlaunchparam
)
| 是 | 创建
ability、上次异常退出的原因信息。 |
**示例:**
...
...
@@ -59,13 +59,13 @@ onWindowStageCreate(windowStage: window.WindowStage): void
当WindowStage创建后调用。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| windowStage |
window.WindowStage
| 是 | WindowStage相关信息。 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | WindowStage相关信息。 |
**示例:**
...
...
@@ -84,7 +84,7 @@ onWindowStageDestroy(): void
当WindowStage销毁后调用。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**示例:**
...
...
@@ -103,13 +103,13 @@ onWindowStageRestore(windowStage: window.WindowStage): void
当迁移多实例ability时,恢复WindowStage后调用。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| windowStage |
window.WindowStage
| 是 | WindowStage相关信息。 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | WindowStage相关信息。 |
**示例:**
...
...
@@ -128,7 +128,7 @@ onDestroy(): void;
UIAbility生命周期回调,在销毁时回调,执行资源清理等操作。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**示例:**
...
...
@@ -147,7 +147,7 @@ onForeground(): void;
UIAbility生命周期回调,当应用从后台转到前台时触发。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**示例:**
...
...
@@ -166,7 +166,7 @@ onBackground(): void;
UIAbility生命周期回调,当应用从前台转到后台时触发。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**示例:**
...
...
@@ -181,11 +181,11 @@ UIAbility生命周期回调,当应用从前台转到后台时触发。
## UIAbility.onContinue
onContinue(wantParam : {[key: string]: any}):
UI
AbilityConstant.OnContinueResult;
onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult;
当ability迁移准备迁移时触发,保存数据。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
...
...
@@ -197,17 +197,17 @@ onContinue(wantParam : {[key: string]: any}): UIAbilityConstant.OnContinueResult
| 类型 | 说明 |
| -------- | -------- |
|
UIAbilityConstant.OnContinueResult
| 继续的结果。 |
|
[
AbilityConstant.OnContinueResult
](
js-apis-app-ability-abilityConstant.md#abilityconstantoncontinueresult
)
| 继续的结果。 |
**示例:**
```
ts
import
UIAbilityConstant
from
"
@ohos.app.ability.UI
AbilityConstant
"
import
AbilityConstant
from
"
@ohos.app.ability.
AbilityConstant
"
class
MyUIAbility
extends
UIAbility
{
onContinue
(
wantParams
)
{
console
.
log
(
'
onContinue
'
);
wantParams
[
"
myData
"
]
=
"
my1234567
"
;
return
UI
AbilityConstant
.
OnContinueResult
.
AGREE
;
return
AbilityConstant
.
OnContinueResult
.
AGREE
;
}
}
```
...
...
@@ -215,25 +215,26 @@ onContinue(wantParam : {[key: string]: any}): UIAbilityConstant.OnContinueResult
## UIAbility.onNewWant
onNewWant(want: Want, launchParams:
UI
AbilityConstant.LaunchParam): void;
onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
当ability的启动模式设置为单例时回调会被调用
。
启动模式为单例的ability再次被拉起时会回调执行该方法
。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | Want类型参数,如
Ability名称,Bundle名称
等。 |
| launchParams |
UIAbilityConstant.LaunchParam
| 是 | UIAbility启动的原因、上次异常退出的原因信息。 |
| want |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | Want类型参数,如
ability名称,包名
等。 |
| launchParams |
[
AbilityConstant.LaunchParam
](
js-apis-app-ability-abilityConstant.md#abilityconstantlaunchparam
)
| 是 | UIAbility启动的原因、上次异常退出的原因信息。 |
**示例:**
```
ts
class
MyUIAbility
extends
UIAbility
{
onNewWant
(
want
)
{
onNewWant
(
want
,
launchParams
)
{
console
.
log
(
'
onNewWant, want:
'
+
want
.
abilityName
);
console
.
log
(
'
onNewWant, launchParams:
'
+
JSON
.
stringify
(
launchParams
));
}
}
```
...
...
@@ -244,7 +245,7 @@ onDump(params: Array\<string>): Array\<string>;
转储客户端信息时调用。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
...
...
@@ -266,35 +267,35 @@ onDump(params: Array\<string>): Array\<string>;
## UIAbility.onSaveState
onSaveState(reason:
UIAbilityConstant.StateType, wantParam : {[key: string]: any}): UI
AbilityConstant.OnSaveResult;
onSaveState(reason:
AbilityConstant.StateType, wantParam : {[key: string]: any}):
AbilityConstant.OnSaveResult;
该API配合
[
appRecovery
](
js-apis-app-ability-appRecovery.md
)
使用。在应用故障时,如果使能了自动保存状态,框架将回调onSaveState保存UIAbility状态。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reason |
[
UI
AbilityConstant.StateType
](
js-apis-app-ability-abilityConstant.md#abilityconstantstatetype
)
| 是 | 回调保存状态的原因。 |
| reason |
[
AbilityConstant.StateType
](
js-apis-app-ability-abilityConstant.md#abilityconstantstatetype
)
| 是 | 回调保存状态的原因。 |
| wantParam | {[key:
string]:
any} | 是 | want相关参数。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
|
UIAbilityConstant.OnSaveResult
| 是否同意保存当前UIAbility的状态。 |
|
[
AbilityConstant.OnSaveResult
](
js-apis-app-ability-abilityConstant.md#abilityconstantonsaveresult
)
| 是否同意保存当前UIAbility的状态。 |
**示例:**
```
ts
import
UIAbilityConstant
from
'
@ohos.app.ability.UI
AbilityConstant
'
import
AbilityConstant
from
'
@ohos.app.ability.
AbilityConstant
'
class
MyUIAbility
extends
UIAbility
{
onSaveState
(
reason
,
wantParam
)
{
console
.
log
(
'
onSaveState
'
);
wantParam
[
"
myData
"
]
=
"
my1234567
"
;
return
UI
AbilityConstant
.
OnSaveResult
.
RECOVERY_AGREE
;
return
AbilityConstant
.
OnSaveResult
.
RECOVERY_AGREE
;
}
}
```
...
...
@@ -311,14 +312,14 @@ call(method: string, data: rpc.Sequenceable): Promise<void>;
向通用组件服务端发送约定序列化数据。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| method | string | 是 | 约定的服务端注册事件字符串。 |
| data |
rpc.Sequenceable
| 是 | 由开发者实现的Sequenceable可序列化数据。 |
| data |
[
rpc.Sequenceable
](
js-apis-rpc.md#sequenceabledeprecated
)
| 是 | 由开发者实现的Sequenceable可序列化数据。 |
**返回值:**
...
...
@@ -391,20 +392,20 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise<rpc.MessagePa
向通用组件服务端发送约定序列化数据, 并将服务端返回的约定序列化数据带回。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| method | string | 是 | 约定的服务端注册事件字符串。 |
| data |
rpc.Sequenceable
| 是 | 由开发者实现的Sequenceable可序列化数据。 |
| data |
[
rpc.Sequenceable
](
js-apis-rpc.md#sequenceabledeprecated
)
| 是 | 由开发者实现的Sequenceable可序列化数据。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
rpc.MessageParcel
>
| Promise形式返回通用组件服务端应答数据。 |
| Promise
<
[rpc.MessageParcel](js-apis-rpc.md#sequenceabledeprecated)
>
| Promise形式返回通用组件服务端应答数据。 |
**错误码:**
...
...
@@ -473,7 +474,7 @@ release(): void;
主动释放通用组件服务端的通信接口。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**错误码:**
...
...
@@ -516,13 +517,13 @@ release(): void;
注册通用组件服务端Stub(桩)断开监听通知。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback |
OnReleaseCallBack
| 是 | 返回onRelease回调结果。 |
| callback |
[
OnReleaseCallBack
](
#onreleasecallback
)
| 是 | 返回onRelease回调结果。 |
**示例:**
...
...
@@ -558,14 +559,14 @@ release(): void;
注册通用组件服务端Stub(桩)断开监听通知。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 监听releaseCall事件,固定为'release'。 |
| callback |
OnReleaseCallback
| 是 | 返回onRelease回调结果。 |
| callback |
[
OnReleaseCallBack
](
#onreleasecallback
)
| 是 | 返回onRelease回调结果。 |
**错误码:**
...
...
@@ -613,14 +614,14 @@ on(method: string, callback: CalleeCallback): void;
通用组件服务端注册消息通知callback。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| method | string | 是 | 与客户端约定的通知消息字符串。 |
| callback |
CalleeCallback | 是 | 一个rpc.MessageParcel类型入参的js通知同步回调函数,
回调函数至少要返回一个空的rpc.Sequenceable
数据对象,
其他视为函数执行错误。 |
| callback |
[
CalleeCallback
](
#calleecallback
)
| 是 | 一个
[
rpc.MessageParcel
](
js-apis-rpc.md#messageparceldeprecated
)
类型入参的js通知同步回调函数,
回调函数至少要返回一个空的[rpc.Sequenceable](js-apis-rpc.md#sequenceabledeprecated)
数据对象,
其他视为函数执行错误。 |
**错误码:**
...
...
@@ -679,7 +680,7 @@ off(method: string): void;
解除通用组件服务端注册消息通知callback。
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
**参数:**
...
...
@@ -716,7 +717,7 @@ off(method: string): void;
(msg: string): void;
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
| 名称 | 可读 | 可写 | 类型 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
...
...
@@ -726,8 +727,8 @@ off(method: string): void;
(indata: rpc.MessageParcel): rpc.Sequenceable;
**系统能力**
:SystemCapability.
UIAbility.UIAbilityRuntime.UI
AbilityCore
**系统能力**
:SystemCapability.
Ability.AbilityRuntime.
AbilityCore
| 名称 | 可读 | 可写 | 类型 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| (indata:
rpc.MessageParcel) | 是 | 否 | rpc.Sequenceable
| 被调用方注册的消息侦听器函数接口的原型。 |
| (indata:
[
rpc.MessageParcel
](
js-apis-rpc.md#messageparceldeprecated
)
) | 是 | 否 |
[
rpc.Sequenceable
](
js-apis-rpc.md#sequenceabledeprecated
)
| 被调用方注册的消息侦听器函数接口的原型。 |
zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md
浏览文件 @
30e4ba83
...
...
@@ -117,7 +117,7 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ------------- | ---- | ------------- |
| info |
WantAgentInfo
| 是 | WantAgent信息。 |
| info |
[
WantAgentInfo
](
js-apis-inner-wantAgent-wantAgentInfo.md
)
| 是 | WantAgent信息。 |
**返回值:**
...
...
@@ -632,7 +632,7 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| callback | AsyncCallback
\<
Want
\>
| 是 | 获取WantAgent对象want的回调方法。 |
| callback | AsyncCallback
\<
[
Want
](
js-apis-app-ability-want.md
)
\>
| 是 | 获取WantAgent对象want的回调方法。 |
**错误码:**
|错误码ID |错误信息 |
...
...
@@ -1056,7 +1056,7 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co
| ----------- | ----------------------------- | ---- | ------------------------------- |
| agent | WantAgent | 是 | WantAgent对象。 |
| triggerInfo |
[
TriggerInfo
](
js-apis-inner-wantAgent-triggerInfo.md
)
| 是 | TriggerInfo对象。 |
| callback | AsyncCallback
\<
CompleteData
\>
| 否 | 主动激发WantAgent实例的回调方法。 |
| callback | AsyncCallback
\<
[
CompleteData
](
#completedata
)
\>
| 否 | 主动激发WantAgent实例的回调方法。 |
**错误码:**
| 错误码ID | 错误信息 |
...
...
zh-cn/application-dev/reference/apis/js-apis-application-ability.md
浏览文件 @
30e4ba83
...
...
@@ -67,7 +67,7 @@ onWindowStageCreate(windowStage: window.WindowStage): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| windowStage |
window.WindowStage
| 是 | WindowStage相关信息。 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | WindowStage相关信息。 |
**示例:**
...
...
@@ -111,7 +111,7 @@ onWindowStageRestore(windowStage: window.WindowStage): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| windowStage |
window.WindowStage
| 是 | WindowStage相关信息。 |
| windowStage |
[
window.WindowStage
](
js-apis-window.md#windowstage9
)
| 是 | WindowStage相关信息。 |
**示例:**
...
...
@@ -219,7 +219,7 @@ onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult;
onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
当ability的启动模式设置为单例时回调会被调用
。
启动模式为单例的ability再次被拉起时会回调执行该方法
。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.AbilityCore
...
...
@@ -234,8 +234,9 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
```
ts
class
myAbility
extends
Ability
{
onNewWant
(
want
)
{
onNewWant
(
want
,
launchParams
)
{
console
.
log
(
'
onNewWant, want:
'
+
want
.
abilityName
);
console
.
log
(
'
onNewWant, launchParams:
'
+
JSON
.
stringify
(
launchParams
));
}
}
```
...
...
zh-cn/application-dev/reference/apis/js-apis-application-abilityConstant.md
浏览文件 @
30e4ba83
...
...
@@ -19,8 +19,8 @@ import AbilityConstant from '@ohos.application.AbilityConstant';
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| launchReason |
LaunchReason
| 是 | 是 | 指示启动原因。 |
| lastExitReason |
LastExitReason
| 是 | 是 | 表示最后退出原因。 |
| launchReason |
[
LaunchReason
](
#abilityconstantlaunchreason
)
| 是 | 是 | 指示启动原因。 |
| lastExitReason |
[
LastExitReason
](
#abilityconstantlastexitreason
)
| 是 | 是 | 表示最后退出原因。 |
## AbilityConstant.LaunchReason
...
...
zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
浏览文件 @
30e4ba83
...
...
@@ -108,7 +108,7 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback
\<
Array
\<
AbilityRunningInfo
>> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
Array
\<
[
AbilityRunningInfo
](
js-apis-inner-application-abilityRunningInfo.md
)
>> | 是 | 被指定的回调方法。 |
**示例**
:
...
...
@@ -132,7 +132,7 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| Promise
\<
Array
\<
AbilityRunningInfo
>> | 返回执行结果。 |
| Promise
\<
Array
\<
[
AbilityRunningInfo
](
js-apis-inner-application-abilityRunningInfo.md
)
>> | 返回执行结果。 |
**示例**
:
...
...
@@ -159,7 +159,7 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 |
| callback | AsyncCallback
\<
Array
\<
AbilityRunningInfo
>> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
Array
\<
[
ExtensionRunningInfo
](
js-apis-inner-application-extensionRunningInfo.md
)
>> | 是 | 被指定的回调方法。 |
**示例**
:
...
...
@@ -191,7 +191,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| Promise
\<
Array
\<
AbilityRunningInfo
>> | 返回执行结果。 |
| Promise
\<
Array
\<
[
ExtensionRunningInfo
](
js-apis-inner-application-extensionRunningInfo.md
)
>> | 返回执行结果。 |
**示例**
:
...
...
@@ -217,7 +217,7 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback
\<
ElementName
> | 是 | 被指定的回调方法。 |
| callback | AsyncCallback
\<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
> | 是 | 被指定的回调方法。 |
**示例**
:
...
...
@@ -239,7 +239,7 @@ getTopAbility(): Promise\<ElementName>;
| 类型 | 说明 |
| ---------------------------------------- | ------- |
| Promise
\<
ElementName
>| 返回执行结果。 |
| Promise
\<
[
ElementName
](
js-apis-bundleManager-elementName.md
)
>| 返回执行结果。 |
**示例**
:
...
...
zh-cn/application-dev/reference/apis/js-apis-application-accessibilityExtensionAbility.md
浏览文件 @
30e4ba83
...
...
@@ -31,7 +31,7 @@ import AccessibilityExtensionAbility from '@ohos.application.AccessibilityExtens
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------- | ---------------------------------------- | ---- | ---- | ---------- |
| eventType |
[
accessibility.EventType
](
js-apis-accessibility.md#EventType
)
\|
[
accessibility.WindowUpdateType
](
js-apis-accessibility.md#WindowUpdateType
)
\|
[
TouchGuideType
](
#touchguidetype
)
\|
[
GestureType
](
#gesturetype
)
\|
[
PageUpdateType
](
#pageupdatetype
)
| 是 | 否 | 具体事件类型。 |
| target |
AccessibilityElement
| 是 | 否 | 发生事件的目标组件。 |
| target |
[
AccessibilityElement
](
js-apis-inner-application-accessibilityExtensionContext.md#accessibilityelement9
)
| 是 | 否 | 发生事件的目标组件。 |
| timeStamp | number | 是 | 否 | 事件时间戳。 |
## GestureType
...
...
zh-cn/application-dev/reference/apis/js-apis-application-appManager.md
浏览文件 @
30e4ba83
...
...
@@ -170,7 +170,7 @@ getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
| 类型 | 说明 |
| -------- | -------- |
| Promise
\<
Array
\<
ProcessRunningInfo
>> | 获取有关运行进程的信息。 |
| Promise
\<
Array
\<
[
ProcessRunningInfo
](
js-apis-inner-application-processRunningInfo.md
)
>> | 获取有关运行进程的信息。 |
**示例:**
...
...
@@ -198,7 +198,7 @@ getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): vo
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
\<
Array
\<
ProcessRunningInfo
>> | 是 | 获取有关运行进程的信息。 |
| callback | AsyncCallback
\<
Array
\<
[
ProcessRunningInfo
](
js-apis-inner-application-processRunningInfo.md
)
>> | 是 | 获取有关运行进程的信息。 |
**示例:**
...
...
@@ -419,8 +419,8 @@ unregisterApplicationStateObserver(observerId: number): Promise\<void>;
getForegroundApplications(callback: AsyncCallback
\<
Array
\<
AppStateData>>): void;
获取
前台进程的应用程序
。
获取
所有当前处于前台的应用信息。该应用信息由
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
定义
。
**需要权限**
:ohos.permission.GET_RUNNING_INFO
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -431,7 +431,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
\<
Array
\<
AppStateData>> | 是 | 表示应用的状态数据
。 |
| callback | AsyncCallback
\<
Array
\<
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
>> | 是 | callback形式返回所有当前处于前台的应用信息
。 |
**示例:**
...
...
@@ -450,7 +450,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
getForegroundApplications(): Promise
\<
Array
\<
AppStateData>>;
获取
前台进程的应用程序
。
获取
所有当前处于前台的应用信息。该应用信息由
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
定义
。
**需要权限**
:ohos.permission.GET_RUNNING_INFO
...
...
@@ -462,7 +462,7 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
| 类型 | 说明 |
| -------- | -------- |
| Promise
\<
Array
\<
ProcessRunningInfo>> | 返回进程运行信息的数组
。 |
| Promise
\<
Array
\<
[
AppStateData
](
js-apis-inner-application-appStateData.md
)
>> | Promise形式返回所有当前处于前台的应用信息
。 |
**示例:**
...
...
zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md
浏览文件 @
30e4ba83
...
...
@@ -5,7 +5,7 @@ Context模块提供了ability或application的上下文的能力,包括允许
> **说明:**
>
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口
仅可在FA模型
下使用。
> 本模块接口
**仅可在FA模型**
下使用。
## 使用说明
...
...
@@ -93,7 +93,7 @@ verifyPermission(permission: string, options: PermissionOptions, callback: Async
```
ts
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
import
bundle
from
'
@ohos.bundle
'
;
import
bundle
from
'
@ohos.bundle
.bundleManager
'
;
var
context
=
featureAbility
.
getContext
();
bundle
.
getBundleInfo
(
'
com.context.test
'
,
1
,
(
err
,
datainfo
)
=>
{
context
.
verifyPermission
(
"
com.example.permission
"
,
{
uid
:
datainfo
.
uid
},
(
err
,
data
)
=>
{
...
...
@@ -101,6 +101,7 @@ bundle.getBundleInfo('com.context.test', 1, (err, datainfo) =>{
});
});
```
示例代码中出现的getBundleInfo相关描述可参考对应
[
文档
](
js-apis-bundleManager.md
)
。
...
...
@@ -250,7 +251,7 @@ getApplicationInfo(callback: AsyncCallback\<ApplicationInfo>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------- | ---- | ------------ |
| callback | AsyncCallback
\<
[
ApplicationInfo
](
js-apis-bundle
-A
pplicationInfo.md
)
> | 是 | 返回当前应用程序的信息。 |
| callback | AsyncCallback
\<
[
ApplicationInfo
](
js-apis-bundle
Manager-a
pplicationInfo.md
)
> | 是 | 返回当前应用程序的信息。 |
**示例:**
...
...
@@ -294,7 +295,7 @@ context.getApplicationInfo().then((data) => {
getBundleName(callback: AsyncCallback
\<
string>): void
获取当前ability的
捆绑包
名称(callback形式)。
获取当前ability的
Bundle
名称(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -302,7 +303,7 @@ getBundleName(callback: AsyncCallback\<string>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------------ |
| callback | AsyncCallback
\<
string> | 是 | 返回当前ability的
捆绑包
名称。 |
| callback | AsyncCallback
\<
string> | 是 | 返回当前ability的
Bundle
名称。 |
**示例:**
...
...
@@ -320,7 +321,7 @@ context.getBundleName((err, data) => {
getBundleName(): Promise
\<
string>
获取当前ability的
捆绑包
名称(Promise形式)。
获取当前ability的
Bundle
名称(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -328,7 +329,7 @@ getBundleName(): Promise\<string>
| 类型 | 说明 |
| ---------------- | ---------------- |
| Promise
\<
string> | 当前ability的
捆绑包
名称。 |
| Promise
\<
string> | 当前ability的
Bundle
名称。 |
**示例:**
...
...
@@ -344,7 +345,7 @@ context.getBundleName().then((data) => {
getDisplayOrientation(callback: AsyncCallback
\<
bundle.DisplayOrientation>): void
获取
此能力的当前
显示方向(callback形式)。
获取
当前ability的
显示方向(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -352,7 +353,7 @@ getDisplayOrientation(callback: AsyncCallback\<bundle.DisplayOrientation>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------ |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-
Bundle
.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-
bundleManager
.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
**示例:**
...
...
@@ -376,7 +377,7 @@ getDisplayOrientation(): Promise\<bundle.DisplayOrientation>;
| 类型 | 说明 |
| ---------------------------------------- | --------- |
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-
Bundle
.md#displayorientation
)
> | 表示屏幕显示方向。 |
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-
bundleManager
.md#displayorientation
)
> | 表示屏幕显示方向。 |
**示例:**
...
...
@@ -448,7 +449,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCal
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------------------- | ---- | ------------ |
| orientation |
[
bundle.DisplayOrientation
](
js-apis-
Bundle.md#displayorientation
)
| 是 | 指示当前能力的新方向。
。 |
| orientation |
[
bundle.DisplayOrientation
](
js-apis-
bundleManager.md#displayorientation
)
| 是 | 指示当前能力的新方向
。 |
| callback | AsyncCallback
\<
void> | 是 | 表示屏幕显示方向。 |
**示例:**
...
...
@@ -457,7 +458,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCal
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
import
bundle
from
'
@ohos.bundle
'
;
var
context
=
featureAbility
.
getContext
();
var
orientation
=
bundle
.
DisplayOrientation
.
UNSPECIFIED
var
orientation
=
bundle
.
DisplayOrientation
.
UNSPECIFIED
;
context
.
setDisplayOrientation
(
orientation
,
(
err
)
=>
{
console
.
info
(
"
setDisplayOrientation err:
"
+
JSON
.
stringify
(
err
));
});
...
...
@@ -475,7 +476,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation): Promise\<void>;
| 类型 | 说明 |
| ---------------------------------------- | ---------------------------------------- |
| orientation |
[
bundle.DisplayOrientation
](
js-apis-
Bundle
.md#displayorientation
)
|
| orientation |
[
bundle.DisplayOrientation
](
js-apis-
bundleManager
.md#displayorientation
)
|
| Promise
\<
void> | 表示屏幕显示方向。 |
**示例:**
...
...
@@ -484,7 +485,7 @@ setDisplayOrientation(orientation: bundle.DisplayOrientation): Promise\<void>;
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
import
bundle
from
'
@ohos.bundle
'
;
var
context
=
featureAbility
.
getContext
();
var
orientation
=
bundle
.
DisplayOrientation
.
UNSPECIFIED
var
orientation
=
bundle
.
DisplayOrientation
.
UNSPECIFIED
;
context
.
setDisplayOrientation
(
orientation
).
then
((
data
)
=>
{
console
.
info
(
"
setDisplayOrientation data:
"
+
JSON
.
stringify
(
data
));
});
...
...
@@ -510,7 +511,7 @@ setShowOnLockScreen(show: boolean, callback: AsyncCallback\<void>): void
```
ts
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
var
context
=
featureAbility
.
getContext
();
var
show
=
true
var
show
=
true
;
context
.
setShowOnLockScreen
(
show
,
(
err
)
=>
{
console
.
info
(
"
setShowOnLockScreen err:
"
+
JSON
.
stringify
(
err
));
});
...
...
@@ -541,7 +542,7 @@ setShowOnLockScreen(show: boolean): Promise\<void>;
```
ts
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
var
context
=
featureAbility
.
getContext
();
var
show
=
true
var
show
=
true
;
context
.
setShowOnLockScreen
(
show
).
then
((
data
)
=>
{
console
.
info
(
"
setShowOnLockScreen data:
"
+
JSON
.
stringify
(
data
));
});
...
...
@@ -551,7 +552,7 @@ context.setShowOnLockScreen(show).then((data) => {
setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback
\<
void>): void
设置恢复此功能时是否唤醒屏幕
。
(callback形式)。
设置恢复此功能时是否唤醒屏幕(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -567,7 +568,7 @@ setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback\<void>): void
```
ts
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
var
context
=
featureAbility
.
getContext
();
var
wakeUp
=
true
var
wakeUp
=
true
;
context
.
setWakeUpScreen
(
wakeUp
,
(
err
)
=>
{
console
.
info
(
"
setWakeUpScreen err:
"
+
JSON
.
stringify
(
err
));
});
...
...
@@ -577,7 +578,7 @@ context.setWakeUpScreen(wakeUp, (err) => {
setWakeUpScreen(wakeUp: boolean): Promise
\<
void>;
设置恢复此功能时是否唤醒屏幕
。
(Promise形式)。
设置恢复此功能时是否唤醒屏幕(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -598,7 +599,7 @@ setWakeUpScreen(wakeUp: boolean): Promise\<void>;
```
ts
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
var
context
=
featureAbility
.
getContext
();
var
wakeUp
=
true
var
wakeUp
=
true
;
context
.
setWakeUpScreen
(
wakeUp
).
then
((
data
)
=>
{
console
.
info
(
"
setWakeUpScreen data:
"
+
JSON
.
stringify
(
data
));
});
...
...
@@ -673,7 +674,7 @@ getElementName(callback: AsyncCallback\<ElementName>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | -------------------------------------- |
| callback | AsyncCallback
\<
[
ElementName
](
js-apis-bundle
-E
lementName.md
)
> | 是 | 返回当前ability的ohos.bundle.ElementName对象。 |
| callback | AsyncCallback
\<
[
ElementName
](
js-apis-bundle
Manager-e
lementName.md
)
> | 是 | 返回当前ability的ohos.bundle.ElementName对象。 |
**示例:**
...
...
@@ -701,7 +702,7 @@ getElementName(): Promise\<ElementName>
| 类型 | 说明 |
| --------------------- | ------------------------------------ |
| Promise
\<
[
ElementName
](
js-apis-bundle
-E
lementName.md
)
> | 当前ability的ohos.bundle.ElementName对象。 |
| Promise
\<
[
ElementName
](
js-apis-bundle
Manager-e
lementName.md
)
> | 当前ability的ohos.bundle.ElementName对象。 |
**示例:**
...
...
@@ -769,7 +770,7 @@ context.getProcessName().then((data) => {
getCallingBundle(callback: AsyncCallback
\<
string>): void
获取
调用ability的包
名称(callback形式)。
获取
ability调用方的Bundle
名称(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -777,7 +778,7 @@ getCallingBundle(callback: AsyncCallback\<string>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---------------- |
| callback | AsyncCallback
\<
string> | 是 | 返回
调用ability的包
名称。 |
| callback | AsyncCallback
\<
string> | 是 | 返回
ability调用方的Bundle
名称。 |
**示例:**
...
...
@@ -795,7 +796,7 @@ context.getCallingBundle((err, data) => {
getCallingBundle(): Promise
\<
string>
获取
调用ability的包
名称(Promise形式)。
获取
ability调用方的Bundle
名称(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -803,7 +804,7 @@ getCallingBundle(): Promise\<string>
| 类型 | 说明 |
| ---------------- | -------------- |
| Promise
\<
string> |
调用ability的包
名称。 |
| Promise
\<
string> |
返回ability调用方的Bundle
名称。 |
**示例:**
...
...
@@ -851,7 +852,7 @@ getCacheDir(): Promise\<string>
| 类型 | 说明 |
| ---------------- | --------------- |
| Promise
\<
string> |
获取
该应用程序的内部存储目录。 |
| Promise
\<
string> |
返回
该应用程序的内部存储目录。 |
**示例:**
...
...
@@ -925,7 +926,7 @@ getOrCreateDistributedDir(callback: AsyncCallback\<string>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---------------------------------------- |
| callback | AsyncCallback
\<
string> | 是 |
回调函数,可以在回调函数中处理接口返回值,返回Ability或应用的分布式文件路径。如果分布式文件
路径不存在,系统将创建一个路径并返回创建的路径。 |
| callback | AsyncCallback
\<
string> | 是 |
返回Ability或应用的分布式文件路径。
<br>
若
路径不存在,系统将创建一个路径并返回创建的路径。 |
**示例:**
...
...
@@ -951,7 +952,7 @@ getOrCreateDistributedDir(): Promise\<string>
| 类型 | 说明 |
| ---------------- | ----------------------------------- |
| Promise
\<
string> |
Ability或应用的分布式文件路径。如果是第一
次调用,则将创建目录。 |
| Promise
\<
string> |
返回Ability或应用的分布式文件路径。若为首
次调用,则将创建目录。 |
**示例:**
...
...
@@ -975,7 +976,7 @@ getAppType(callback: AsyncCallback\<string>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | -------------------------------- |
| callback | AsyncCallback
\<
string> | 是 |
回调函数,可以在回调函数中处理接口返回值,
返回此应用程序的类型。 |
| callback | AsyncCallback
\<
string> | 是 | 返回此应用程序的类型。 |
**示例:**
...
...
@@ -999,7 +1000,7 @@ getAppType(): Promise\<string>
| 类型 | 说明 |
| ---------------- | ------------------ |
| Promise
\<
string> |
Promise形式
返回此应用的类型。 |
| Promise
\<
string> | 返回此应用的类型。 |
**示例:**
...
...
@@ -1023,7 +1024,7 @@ getHapModuleInfo(callback: AsyncCallback\<HapModuleInfo>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | --------------------------------------- |
| callback | AsyncCallback
\<
[
HapModuleInfo
](
js-apis-bundle
-HapModuleInfo.md
)
> | 是 | 回调函数,可以在回调函数中处理接口返回值,
返回应用的ModuleInfo对象。 |
| callback | AsyncCallback
\<
[
HapModuleInfo
](
js-apis-bundle
Manager-hapModuleInfo.md
)
> | 是 |
返回应用的ModuleInfo对象。 |
**示例:**
...
...
@@ -1047,7 +1048,7 @@ getHapModuleInfo(): Promise\<HapModuleInfo>
| 类型 | 说明 |
| ---------------------------------------- | ------------------ |
| Promise
\<
[
HapModuleInfo
](
js-apis-bundle
-H
apModuleInfo.md
)
> | 返回应用的ModuleInfo对象。 |
| Promise
\<
[
HapModuleInfo
](
js-apis-bundle
Manager-h
apModuleInfo.md
)
> | 返回应用的ModuleInfo对象。 |
**示例:**
...
...
@@ -1071,7 +1072,7 @@ getAppVersionInfo(callback: AsyncCallback\<AppVersionInfo>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------ |
| callback | AsyncCallback
\<
[
AppVersionInfo
](
js-apis-inner-app-appVersionInfo.md
)
> | 是 |
回调函数,可以在回调函数中处理接口返回值,
返回应用版本信息。 |
| callback | AsyncCallback
\<
[
AppVersionInfo
](
js-apis-inner-app-appVersionInfo.md
)
> | 是 | 返回应用版本信息。 |
**示例:**
...
...
@@ -1119,7 +1120,7 @@ getAbilityInfo(callback: AsyncCallback\<AbilityInfo>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | --------------------------------------- |
| callback | AsyncCallback
\<
[
AbilityInfo
](
js-apis-bundle
-AbilityInfo.md
)
> | 是 | 回调函数,可以在回调函数中处理接口返回值,
返回当前归属Ability详细信息。 |
| callback | AsyncCallback
\<
[
AbilityInfo
](
js-apis-bundle
Manager-abilityInfo.md
)
> | 是 |
返回当前归属Ability详细信息。 |
**示例:**
...
...
@@ -1143,7 +1144,7 @@ getAbilityInfo(): Promise\<AbilityInfo>
| 类型 | 说明 |
| ---------------------------------------- | ------------------ |
| Promise
\<
[
AbilityInfo
](
js-apis-bundle
-A
bilityInfo.md
)
> | 返回当前归属Ability详细信息。 |
| Promise
\<
[
AbilityInfo
](
js-apis-bundle
Manager-a
bilityInfo.md
)
> | 返回当前归属Ability详细信息。 |
**示例:**
...
...
zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md
浏览文件 @
30e4ba83
...
...
@@ -233,7 +233,7 @@ startAbility(want: Want, options?: StartOptions): Promise<void>;
startAbilityForResult(want: Want, callback: AsyncCallback
<
AbilityResult
>
): void;
启动
Ability并在该Ability退出的时候返回执行结果
(callback形式)。
启动
一个Ability。Ability被启动后,正常情况下可通过调用
[
terminateSelfWithResult
](
#uiabilitycontextterminateselfwithresult
)
接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者
(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -300,7 +300,8 @@ startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>):
startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
<
AbilityResult
>
): void;
启动Ability并在该Ability退出的时候返回执行结果(callback形式)。
启动一个Ability。Ability被启动后,正常情况下可通过调用
[
terminateSelfWithResult
](
#uiabilitycontextterminateselfwithresult
)
接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -372,7 +373,7 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
startAbilityForResult(want: Want, options?: StartOptions): Promise
<
AbilityResult
>
;
启动
Ability并在该Ability退出的时候返回执行结果
(promise形式)。
启动
一个Ability。Ability被启动后,正常情况下可通过调用
[
terminateSelfWithResult
](
#uiabilitycontextterminateselfwithresult
)
接口使之终止并且返回结果给调用者。异常情况下比如杀死Ability会返回异常信息给调用者
(promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -1264,7 +1265,7 @@ terminateSelf(): Promise<void>;
terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback
<
void
>
): void;
停止
Ability,配合startAbilityForResult使用,返回给接口调用方AbilityResult信息
(callback形式)。
停止
当前的Ability。如果该Ability是通过调用
[
startAbilityForResult
](
#uiabilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时会将结果返回给调用者,如果该Ability不是通过调用
[
startAbilityForResult
](
#uiabilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时不会有结果返回给调用者
(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -1323,7 +1324,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<voi
terminateSelfWithResult(parameter: AbilityResult): Promise
<
void
>
;
停止
Ability,配合startAbilityForResult使用,返回给接口调用方AbilityResult信息
(promise形式)。
停止
当前的Ability。如果该Ability是通过调用
[
startAbilityForResult
](
#uiabilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时会将结果返回给调用者,如果该Ability不是通过调用
[
startAbilityForResult
](
#uiabilitycontextstartabilityforresult
)
接口被拉起的,调用terminateSelfWithResult接口时不会有结果返回给调用者
(promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
浏览文件 @
30e4ba83
...
...
@@ -29,7 +29,7 @@ import pasteboard from '@ohos.pasteboard';
用于表示允许的数据字段类型。
**系统能力:**
以下各项对应的系统能力均为
SystemCapability.MiscServices.Pasteboard
**系统能力:**
SystemCapability.MiscServices.Pasteboard
| 类型 | 说明 |
| -------- | -------- |
...
...
@@ -120,11 +120,11 @@ let systemPasteboard = pasteboard.getSystemPasteboard();
**系统能力:**
SystemCapability.MiscServices.Pasteboard
| 名称
| 说明
|
| ----
- | -----------------------
|
| InApp
|表示仅允许同应用内粘贴。
|
| LocalDevice
|
表示允许在此设备中任何应用内粘贴。 |
| CrossDevice
|表示允许跨设备在任何应用内粘贴。
|
| 名称
| 值 | 说明
|
| ----
|---|-------------------
|
| InApp
| 0 | 表示仅允许同应用内粘贴。
|
| LocalDevice
| 1 |
表示允许在此设备中任何应用内粘贴。 |
| CrossDevice
| 2 | 表示允许跨设备在任何应用内粘贴。
|
## pasteboard.createHtmlData<sup>(deprecated)</sup>
...
...
@@ -418,7 +418,7 @@ convertToTextV9(callback: AsyncCallback<string>): void
**示例:**
```
js
let
record
=
pasteboard
.
create
UriRecord
(
'
dataability:///com.example.myapplication1/user.txt
'
);
let
record
=
pasteboard
.
create
Record
(
pasteboard
.
MIMETYPE_TEXT_URI
,
'
dataability:///com.example.myapplication1/user.txt
'
);
record
.
convertToTextV9
((
err
,
data
)
=>
{
if
(
err
)
{
console
.
error
(
`Failed to convert to text. Cause:
${
err
.
message
}
`
);
...
...
@@ -445,7 +445,7 @@ convertToTextV9(): Promise<string>
**示例:**
```
js
let
record
=
pasteboard
.
create
UriRecord
(
'
dataability:///com.example.myapplication1/user.txt
'
);
let
record
=
pasteboard
.
create
Record
(
pasteboard
.
MIMETYPE_TEXT_URI
,
'
dataability:///com.example.myapplication1/user.txt
'
);
record
.
convertToTextV9
().
then
((
data
)
=>
{
console
.
info
(
`Succeeded in converting to text. Data:
${
data
}
`
);
}).
catch
((
err
)
=>
{
...
...
@@ -536,7 +536,7 @@ getPrimaryText(): string
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
plainText
=
pasteData
.
getPrimaryText
();
```
...
...
@@ -558,7 +558,7 @@ getPrimaryHtml(): string
```
js
let
html
=
"
<!DOCTYPE html>
\n
"
+
"
<html>
\n
"
+
"
<head>
\n
"
+
"
<meta charset=
\"
utf-8
\"
>
\n
"
+
"
<title>HTML-PASTEBOARD_HTML</title>
\n
"
+
"
</head>
\n
"
+
"
<body>
\n
"
+
"
<h1>HEAD</h1>
\n
"
+
"
<p></p>
\n
"
+
"
</body>
\n
"
+
"
</html>
"
;
let
pasteData
=
pasteboard
.
create
HtmlData
(
html
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_HTML
,
html
);
let
htmlText
=
pasteData
.
getPrimaryHtml
();
```
...
...
@@ -583,7 +583,7 @@ let object = {
bundleName
:
"
com.example.aafwk.test
"
,
abilityName
:
"
com.example.aafwk.test.TwoAbility
"
};
let
pasteData
=
pasteboard
.
create
WantData
(
object
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_WANT
,
object
);
let
want
=
pasteData
.
getPrimaryWant
();
```
...
...
@@ -604,7 +604,7 @@ getPrimaryUri(): string
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
UriData
(
'
dataability:///com.example.myapplication1/user.txt
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_URI
,
'
dataability:///com.example.myapplication1/user.txt
'
);
let
uri
=
pasteData
.
getPrimaryUri
();
```
...
...
@@ -636,7 +636,7 @@ let opt = {
scaleMode
:
1
};
image
.
createPixelMap
(
buffer
,
opt
).
then
((
pixelMap
)
=>
{
let
pasteData
=
pasteboard
.
createData
(
'
app/xml
'
,
pixelMap
);
let
pasteData
=
pasteboard
.
createData
(
MIMETYPE_PIXELMAP
,
pixelMap
);
let
PixelMap
=
pasteData
.
getPrimaryPixelMap
();
});
```
...
...
@@ -660,10 +660,10 @@ addRecord(record: PasteDataRecord): void
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
UriData
(
'
dataability:///com.example.myapplication1/user.txt
'
);
let
textRecord
=
pasteboard
.
create
PlainTextRecord
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_URI
,
'
dataability:///com.example.myapplication1/user.txt
'
);
let
textRecord
=
pasteboard
.
create
Record
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
html
=
"
<!DOCTYPE html>
\n
"
+
"
<html>
\n
"
+
"
<head>
\n
"
+
"
<meta charset=
\"
utf-8
\"
>
\n
"
+
"
<title>HTML-PASTEBOARD_HTML</title>
\n
"
+
"
</head>
\n
"
+
"
<body>
\n
"
+
"
<h1>HEAD</h1>
\n
"
+
"
<p></p>
\n
"
+
"
</body>
\n
"
+
"
</html>
"
;
let
htmlRecord
=
pasteboard
.
create
HtmlTextRecord
(
html
);
let
htmlRecord
=
pasteboard
.
create
Record
(
pasteboard
.
MIMETYPE_TEXT_HTML
,
html
);
pasteData
.
addRecord
(
textRecord
);
pasteData
.
addRecord
(
htmlRecord
);
```
...
...
@@ -695,7 +695,7 @@ addRecord(mimeType: string, value: ValueType): void
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
UriData
(
'
dataability:///com.example.myapplication1/user.txt
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_URI
,
'
dataability:///com.example.myapplication1/user.txt
'
);
let
dataXml
=
new
ArrayBuffer
(
256
);
pasteData
.
addRecord
(
'
app/xml
'
,
dataXml
);
```
...
...
@@ -717,7 +717,7 @@ getMimeTypes(): Array<string>
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
types
=
pasteData
.
getMimeTypes
();
```
...
...
@@ -738,7 +738,7 @@ getPrimaryMimeType(): string
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
type
=
pasteData
.
getPrimaryMimeType
();
```
...
...
@@ -759,7 +759,7 @@ getProperty(): PasteDataProperty
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
property
=
pasteData
.
getProperty
();
```
...
...
@@ -780,7 +780,7 @@ setProperty(property: PasteDataProperty): void
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
HtmlData
(
'
application/xml
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_HTML
,
'
application/xml
'
);
let
prop
=
pasteData
.
getProperty
();
prop
.
shareOption
=
pasteboard
.
ShareOption
.
InApp
;
pasteData
.
setProperty
(
prop
);
...
...
@@ -817,7 +817,7 @@ getRecord(index: number): PasteDataRecord
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
record
=
pasteData
.
getRecord
(
0
);
```
...
...
@@ -838,7 +838,7 @@ getRecordCount(): number
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
count
=
pasteData
.
getRecordCount
();
```
...
...
@@ -859,7 +859,7 @@ getTag(): string
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
tag
=
pasteData
.
getTag
();
```
...
...
@@ -886,7 +886,7 @@ hasType(mimeType: string): boolean
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
hasType
=
pasteData
.
hasType
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
);
```
...
...
@@ -915,7 +915,7 @@ removeRecord(index: number): void
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
pasteData
.
removeRecord
(
0
);
```
...
...
@@ -945,8 +945,8 @@ replaceRecord(index: number, record: PasteDataRecord): void
**示例:**
```
js
let
pasteData
=
pasteboard
.
create
PlainTextData
(
'
hello
'
);
let
record
=
pasteboard
.
create
UriRecord
(
'
dataability:///com.example.myapplication1/user.txt
'
);
let
pasteData
=
pasteboard
.
create
Data
(
pasteboard
.
MIMETYPE_TEXT_PLAIN
,
'
hello
'
);
let
record
=
pasteboard
.
create
Record
(
pasteboard
.
MIMETYPE_TEXT_URI
,
'
dataability:///com.example.myapplication1/user.txt
'
);
pasteData
.
replaceRecord
(
0
,
record
);
```
### addHtmlRecord<sup>(deprecated)</sup>
...
...
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
浏览文件 @
30e4ba83
...
...
@@ -266,7 +266,7 @@ try {
## screenlock.sendScreenLockEvent<sup>9+</sup>
sendScreenLockEvent(event:
S
tring, parameter: number, callback: AsyncCallback
<
boolean
>
): void
sendScreenLockEvent(event:
s
tring, parameter: number, callback: AsyncCallback
<
boolean
>
): void
应用发送事件到锁屏服务。使用callback异步回调。
...
...
@@ -278,7 +278,7 @@ sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback<
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------------ | ---- | -------------------- |
| event |
S
tring | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "lockScreenResult",表示锁屏结果。
<br/>
- "screenDrawDone",表示屏幕绘制完成。 |
| event |
s
tring | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "lockScreenResult",表示锁屏结果。
<br/>
- "screenDrawDone",表示屏幕绘制完成。 |
| parameter | number | 是 | 事件结果。
<br/>
- parameter为0,表示成功。例如解锁成功或锁屏成功。
<br/>
- parameter为1,表示失败。例如解锁失败或锁屏失败。
<br/>
- parameter为2,表示取消。例如锁屏取消或解锁取消。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数。返回true表示发送事件成功;返回false表示发送事件失败。 |
...
...
@@ -304,7 +304,7 @@ screenlock.sendScreenLockEvent('unlockScreenResult', 0, (err, result) => {
## screenlock.sendScreenLockEvent<sup>9+</sup>
sendScreenLockEvent(event:
S
tring, parameter: number): Promise
<
boolean
>
sendScreenLockEvent(event:
s
tring, parameter: number): Promise
<
boolean
>
应用发送事件到锁屏服务。使用Promise异步回调。
...
...
@@ -316,7 +316,7 @@ sendScreenLockEvent(event: String, parameter: number): Promise<boolean>
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | --------------------------------------- |
| event |
S
tring | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "lockScreenResult",表示锁屏结果。
<br/>
- "screenDrawDone",表示屏幕绘制完成。 |
| event |
s
tring | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "lockScreenResult",表示锁屏结果。
<br/>
- "screenDrawDone",表示屏幕绘制完成。 |
| parameter | number | 是 | 事件结果。
<br/>
- parameter为0,表示成功。例如解锁成功或锁屏成功。
<br/>
- parameter为1,表示失败。例如解锁失败或锁屏失败。
<br/>
- parameter为2,表示取消。例如锁屏取消或解锁取消。 |
**返回值:**
...
...
zh-cn/application-dev/reference/apis/js-apis-url.md
浏览文件 @
30e4ba83
...
...
@@ -11,7 +11,6 @@ import Url from '@ohos.url'
```
## URLParams<sup>9+</sup>
### constructor<sup>9+</sup>
constructor(init?: string
[][]
| Record
<
string, string
>
| string | URLSearchParams)
...
...
@@ -384,20 +383,20 @@ console.log(params.toString());
| port | string | 是 | 是 | 获取和设置URL的端口部分。 |
| protocol | string | 是 | 是 | 获取和设置URL的协议部分。 |
| search | string | 是 | 是 | 获取和设置URL的序列化查询部分。 |
| searchParams
| URLSearchParams | 是 | 否 | 获取URLSearchParams表示URL查询参数的对象
。 |
|
URLParams | URLParams
| 是 | 否 | 获取URLParams表示URL查询参数的对象。 |
| searchParams
<sup>
(deprecated)
</sup>
|
[
URLSearchParams
](
#urlsearchparamsdeprecated
)
| 是 | 否 | 获取URLSearchParams表示URL查询参数的对象。
<br/>
-
**说明:**
此属性从API version 7开始支持,从API version 9开始被废弃。建议使用params
<sup>
9+
</sup>
替代
。 |
|
params
<sup>
9+
</sup>
|
[
URLParams
](
#urlparams9
)
| 是 | 否 | 获取URLParams表示URL查询参数的对象。 |
| username | string | 是 | 是 | 获取和设置URL的用户名部分。 |
### constructor<sup>(deprecated)</sup>
constructor(url: string, base?: string | URL)
URL的构造函数。
> **说明:**
>
> 从API version 7开始支持,从API version 9开始废弃,建议使用[parseURL<sup>9+</sup>](#parseurl9)替代。
constructor(url: string, base?: string | URL)
URL的构造函数。
**系统能力:**
SystemCapability.Utils.Lang
**参数:**
...
...
@@ -410,13 +409,13 @@ URL的构造函数。
**示例:**
```
js
let
mm
=
'
http://username:password@host:8080
'
;
let
a
=
new
Url
.
URL
(
"
/
"
,
mm
);
// Output 'http://username:password@host:8080/';
let
b
=
new
Url
.
URL
(
mm
);
// Output 'http://username:password@host:8080/';
new
Url
.
URL
(
'
path/path1
'
,
b
);
// Output 'http://username:password@host:8080/path/path1';
let
c
=
new
Url
.
URL
(
'
/path/path1
'
,
b
);
// Output 'http
://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
c
);
// Output 'http://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
a
);
// Output 'http://username:password@host:8080/path/path1';
let
mm
=
'
http
s
://username:password@host:8080
'
;
let
a
=
new
Url
.
URL
(
"
/
"
,
mm
);
// Output 'http
s
://username:password@host:8080/';
let
b
=
new
Url
.
URL
(
mm
);
// Output 'http
s
://username:password@host:8080/';
new
Url
.
URL
(
'
path/path1
'
,
b
);
// Output 'http
s
://username:password@host:8080/path/path1';
let
c
=
new
Url
.
URL
(
'
/path/path1
'
,
b
);
// Output 'http
s://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
c
);
// Output 'http
s
://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
a
);
// Output 'http
s
://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
"
https://www.exampleUrl/fr-FR/toto
"
);
// Output https://www.exampleUrl/path/path1
new
Url
.
URL
(
'
/path/path1
'
,
''
);
// Raises a TypeError exception as '' is not a valid URL
new
Url
.
URL
(
'
/path/path1
'
);
// Raises a TypeError exception as '/path/path1' is not a valid URL
...
...
@@ -439,19 +438,11 @@ URL静态成员函数。
| url | string | 是 | 入参对象。 |
| base | string
\|
URL | 否 | 入参字符串或者对象。
<br/>
- string:字符串
<br/>
- URL:字符串或对象 |
**错误码:**
以下错误码的详细介绍请参见
[
语言基础类库错误码
](
../errorcodes/errorcode-utils.md
)
。
| 错误码ID | 错误信息 |
| -------- | -------- |
| 10200002 | Invalid url string. |
**示例:**
```
js
let
mm
=
'
http://username:password@host:8080
'
;
Url
.
URL
.
parseURL
(
mm
);
// Output 'http://username:password@host:8080/';
let
mm
=
'
http
s
://username:password@host:8080
'
;
Url
.
URL
.
parseURL
(
mm
);
// Output 'http
s
://username:password@host:8080/';
```
### tostring
...
...
@@ -471,11 +462,10 @@ toString(): string
**示例:**
```
js
const
url
=
new
Url
.
URL
(
'
http://username:password@host:8080/directory/file?query=pppppp#qwer=da
'
);
const
url
=
new
Url
.
URL
(
'
http
s
://username:password@host:8080/directory/file?query=pppppp#qwer=da
'
);
url
.
toString
();
```
### toJSON
toJSON(): string
...
...
@@ -492,7 +482,7 @@ toJSON(): string
**示例:**
```
js
const
url
=
new
Url
.
URL
(
'
http://username:password@host:8080/directory/file?query=pppppp#qwer=da
'
);
const
url
=
new
Url
.
URL
(
'
http
s
://username:password@host:8080/directory/file?query=pppppp#qwer=da
'
);
url
.
toJSON
();
```
...
...
@@ -902,126 +892,4 @@ let params = new Url.URLSearchParams(url.search.slice(1));
params
.
append
(
'
fod
'
,
'
3
'
);
console
.
log
(
params
.
toString
());
```
## URL
### 属性
**系统能力:**
以下各项对应的系统能力均为SystemCapability.Utils.Lang
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| hash | string | 是 | 是 | 获取和设置URL的片段部分。 |
| host | string | 是 | 是 | 获取和设置URL的主机部分。 |
| hostname | string | 是 | 是 | 获取和设置URL的主机名部分,不带端口。 |
| href | string | 是 | 是 | 获取和设置序列化的URL。 |
| origin | string | 是 | 否 | 获取URL源的只读序列化。 |
| password | string | 是 | 是 | 获取和设置URL的密码部分。 |
| pathname | string | 是 | 是 | 获取和设置URL的路径部分。 |
| port | string | 是 | 是 | 获取和设置URL的端口部分。 |
| protocol | string | 是 | 是 | 获取和设置URL的协议部分。 |
| search | string | 是 | 是 | 获取和设置URL的序列化查询部分。 |
| searchParams | URLSearchParams | 是 | 否 | 获取URLSearchParams表示URL查询参数的对象。 |
| URLParams | URLParams | 是 | 否 | 获取URLParams表示URL查询参数的对象。 |
| username | string | 是 | 是 | 获取和设置URL的用户名部分。 |
### constructor<sup>(deprecated)</sup>
> **说明:**
>
> 从API version 7开始支持,从API version 9开始废弃,建议使用[parseURL<sup>9+</sup>](#parseurl9)替代。
constructor(url: string, base?: string | URL)
URL的构造函数。
**系统能力:**
SystemCapability.Utils.Lang
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| url | string | 是 | 入参对象。 |
| base | string
\|
URL | 否 | 入参字符串或者对象。
<br/>
- string:字符串
<br/>
- URL:字符串或对象 |
**示例:**
```
js
let
mm
=
'
https://username:password@host:8080
'
;
let
a
=
new
Url
.
URL
(
"
/
"
,
mm
);
// Output 'https://username:password@host:8080/';
let
b
=
new
Url
.
URL
(
mm
);
// Output 'https://username:password@host:8080/';
new
Url
.
URL
(
'
path/path1
'
,
b
);
// Output 'https://username:password@host:8080/path/path1';
let
c
=
new
Url
.
URL
(
'
/path/path1
'
,
b
);
// Output 'https://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
c
);
// Output 'https://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
a
);
// Output 'https://username:password@host:8080/path/path1';
new
Url
.
URL
(
'
/path/path1
'
,
"
https://www.exampleUrl/fr-FR/toto
"
);
// Output https://www.exampleUrl/path/path1
new
Url
.
URL
(
'
/path/path1
'
,
''
);
// Raises a TypeError exception as '' is not a valid URL
new
Url
.
URL
(
'
/path/path1
'
);
// Raises a TypeError exception as '/path/path1' is not a valid URL
new
Url
.
URL
(
'
https://www.example.com
'
,
);
// Output https://www.example.com/
new
Url
.
URL
(
'
https://www.example.com
'
,
b
);
// Output https://www.example.com/
```
### parseURL<sup>9+</sup>
static parseURL(url : string, base?: string | URL): URL
URL静态成员函数。
**系统能力:**
SystemCapability.Utils.Lang
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| url | string | 是 | 入参对象。 |
| base | string
\|
URL | 否 | 入参字符串或者对象。
<br/>
- string:字符串
<br/>
- URL:字符串或对象 |
**示例:**
```
js
let
mm
=
'
https://username:password@host:8080
'
;
Url
.
URL
.
parseURL
(
mm
);
// Output 'https://username:password@host:8080/';
```
### tostring
toString(): string
将解析过后的URL转化为字符串。
**系统能力:**
SystemCapability.Utils.Lang
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| string | 用于返回网址的字符串序列化。 |
**示例:**
```
js
const
url
=
new
Url
.
URL
(
'
https://username:password@host:8080/directory/file?query=pppppp#qwer=da
'
);
url
.
toString
();
```
### toJSON
toJSON(): string
将解析过后的URL转化为JSON字符串。
**系统能力:**
SystemCapability.Utils.Lang
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| string | 用于返回网址的字符串序列化。 |
**示例:**
```
js
const
url
=
new
Url
.
URL
(
'
https://username:password@host:8080/directory/file?query=pppppp#qwer=da
'
);
url
.
toJSON
();
```
<!--no_check-->
\ No newline at end of file
zh-cn/application-dev/reference/arkui-js/js-components-common-customizing-font.md
浏览文件 @
30e4ba83
...
...
@@ -11,8 +11,8 @@
```
@font-face {
font-family:
HW
font;
src: url('/common/
HW
font.ttf');
font-family: font;
src: url('/common/font.ttf');
}
```
...
...
@@ -48,10 +48,10 @@
```
css
/*xxx.css*/
@font-face
{
font-family
:
HW
font
;
src
:
url("/common/
HW
font.ttf")
;
font-family
:
font
;
src
:
url("/common/font.ttf")
;
}
.demo-text
{
font-family
:
HW
font
;
font-family
:
font
;
}
```
zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
浏览文件 @
30e4ba83
...
...
@@ -88,6 +88,8 @@ onChange(event: (index: number) => void)
当前显示的子组件索引变化时触发该事件,返回值为当前显示的子组件的索引值。
**说明**
:Swiper组件结合LazyForEach使用时,不能在onChange事件里触发子页面UI的刷新。
**返回值:**
| 名称 | 类型 | 参数描述 |
...
...
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-ability.md
浏览文件 @
30e4ba83
...
...
@@ -44,4 +44,97 @@ onWindowStageCreate() {
console
.
error
(
'
Failed to start ability
'
,
err
.
code
);
})
}
```
\ No newline at end of file
```
## cl.ability.2 删除标记为废弃的API9接口
[
元能力异常处理整改
](
../OpenHarmony_3.2.8.3/changelogs-ability.md
)
将部分API9接口标记为了废弃,根据OpenHarmony接口规范,需要删除标记为废弃的API9接口。
**变更影响**
基于此前版本开发的应用,需要将被删除的接口替换为新接口,否则会影响应用编译。
**关键接口/组件变更**
接口文件被删除:
| 被删除接口 | 新接口 |
| ----------------------------------------------- | ----------------------------------------------- |
| @ohos.application.Ability.d.ts | @ohos.app.ability.UIAbility.d.ts |
| @ohos.application.AbilityConstant.d.ts | @ohos.app.ability.AbilityConstant.d.ts |
| @ohos.application.AbilityLifecycleCallback.d.ts | @ohos.app.ability.AbilityLifecycleCallback.d.ts |
| @ohos.application.AbilityStage.d.ts | @ohos.app.ability.AbilityStage.d.ts |
| @ohos.application.EnvironmentCallback.d.ts | @ohos.app.ability.EnvironmentCallback.d.ts |
| @ohos.application.ExtensionAbility.d.ts | @ohos.app.ability.ExtensionAbility.d.ts |
| @ohos.application.FormExtension.d.ts | @ohos.app.form.FormExtensionAbility.d.ts |
| @ohos.application.ServiceExtensionAbility.d.ts | @ohos.app.ability.ServiceExtensionAbility.d.ts |
| @ohos.application.StartOptions.d.ts | @ohos.app.ability.StartOptions.d.ts |
| @ohos.application.context.d.ts | @ohos.app.ability.common.d.ts |
| @ohos.application.errorManager.d.ts | @ohos.app.ability.errorManager.d.ts |
接口、属性被删除:
-
@ohos.application.Configuration.d.ts
-
Configuration 的 direction、screenDensity、displayId、hasPointerDevice 被删除。可以使用 @ohos.app.ability.Configuration.d.ts 的 Configuration替换。
-
@ohos.application.ConfigurationConstant.d.ts
-
枚举 Direction 和 ScreenDensity 被删除。可以使用 @ohos.app.ability.ConfigurationConstant.d.ts 的枚举 Direction 和 ScreenDensity 替换。
-
@ohos.application.abilityManager.d.ts
-
方法 getExtensionRunningInfos 和 getTopAbility 被删除。可以使用 @ohos.app.ability.abilityManager.d.ts 的同名方法替换。
-
@ohos.application.appManager.d.ts
-
枚举 ApplicationState 和 ProcessState 被删除。可以使用 @ohos.app.ability.appManager.d.ts 的枚举 ApplicationState 和 ProcessState 替换。
-
方法 registerApplicationStateObserver 和 getProcessRunningInformation被删除。可以使用 @ohos.app.ability.appManager.d.ts 的同名方法替换。
-
@ohos.application.formHost.d.ts
-
方法 shareForm 和 notifyFormsPrivacyProtected 被删除。可以使用 @ohos.app.form.formHost.d.ts 的同名方法替换。
-
@ohos.application.formInfo.d.ts
-
枚举 FormType 的 eTS 被删除,可以使用 @ohos.app.form.formInfo.d.ts 的 FormType 中的 eTS 替换。
-
枚举 FormParam 的 IDENTITY_KEY、BUNDLE_NAME_KEY、ABILITY_NAME_KEY、DEVICE_ID_KEY 被删除,可以使用 @ohos.app.form.formInfo.d.ts 的 FormParam 中的同名枚举替换。
-
接口 FormInfoFilter 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 FormInfoFilter 替换。
-
枚举 FormDimension 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 FormDimension 替换。
-
枚举 VisibilityType 被删除。可以使用 @ohos.app.form.formInfo.d.ts 的 VisibilityType 替换。
-
@ohos.wantAgent.d.ts
-
方法 trigger 和 getOperationType 被删除。可以使用 @ohos.app.ability.wantAgent.d.ts 的同名方法替换。
-
application/ApplicationContext.d.ts
-
方法 registerAbilityLifecycleCallback、unregisterAbilityLifecycleCallback、registerEnvironmentCallback、unregisterEnvironmentCallback 被删除。可以使用 on、off 替换。
-
application/ServiceExtensionContext.d.ts
-
方法 connectAbility、connectAbilityWithAccount、disconnectAbility 被删除。可以使用 connectServiceExtensionAbility、connectServiceExtensionAbilityWithAccount、disconnectServiceExtensionAbility 替换。
-
@ohos.application.ExtensionAbility.d.ts
-
生命周期onCreate、onCastToNormal、onUpdate、onVisibilityChange、onEvent、onDestroy、onAcquireFormState、onShare 被删除。可以使用@ohos.app.form.FormExtensionAbility.d.ts的onAddForm、onCastToNormalForm、onUpdateForm、onChangeFormVisibility、onFormEvent、onRemoveForm、onAcquireFormState、onShareForm
-
@ohos.application.abilityDelegatorRegistry.d.ts
-
导出类 AbilityDelegator、AbilityDelegatorArgs、AbilityMonitor、ShellCmdResult 被删除。可以使用@ohos.app.ability.abilityDelegatorRegistry.d.ts中的同名导出类替换。
-
@ohos.application.abilityManager.d.ts
-
导出类 AbilityRunningInfo、ExtensionRunningInfo 被删除。可以使用@ohos.app.ability.abilityManager.d.ts中的同名导出类替换。
-
@ohos.application.appManager.d.ts
-
导出类 AbilityStateData、AppStateData、ApplicationStateObserver、ProcessRunningInfo、ProcessRunningInformation 被删除。可以使用@ohos.app.ability.appManager.d.ts中的同名导出类替换。
-
@ohos.application.missionManager.d.ts
-
导出类 MissionInfo、MissionListener、MissionSnapshot 被删除。可以使用@ohos.app.ability.missionManager.d.ts中的同名导出类替换。
-
@ohos.wantAgent.d.ts
-
导出类 TriggerInfo、WantAgentInfo 被删除。可以使用@ohos.app.ability.wantAgent.d.ts中的同名导出类替换。
**适配指导**
如上所述,仅少数接口修改了接口名的如注册回调函数(registerAbilityLifecycleCallback、unregisterAbilityLifecycleCallback、registerEnvironmentCallback、unregisterEnvironmentCallback)和连接断开 ServiceExtensionAbility(connectAbility、connectAbilityWithAccount、disconnectAbility),卡片生命周期等需要替换成新的接口名。
绝大多数接口平移到了新的namespace中,所以可以通过修改import来解决适配问题:
如原先接口使用了@ohos.application.Ability
```
js
import
Ability
from
'
@ohos.application.Ability
'
;
```
可以通过直接修改import,来切换到新的namespace上:
```
js
import
Ability
from
'
@ohos.app.ability.UIAbility
'
;
```
此外还需要适配异常处理,具体参考新接口的接口文档。
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.1/changelogs-notification.md
0 → 100644
浏览文件 @
30e4ba83
# 事件通知子系统ChangeLog
## cl.notification.1 删除标记为废弃的API9接口
[
事件通知异常处理整改
](
../OpenHarmony_3.2.8.3/changelogs-notification.md
)
将部分API9接口标记为了废弃,根据OpenHarmony接口规范,需要删除标记为废弃的API9接口。
**变更影响**
基于此前版本开发的应用,需要将被删除的接口替换为新接口,否则会影响应用编译。
**关键接口/组件变更**
原接口中标记为废弃的API9接口将被删除,可以使用新接口中的同名接口替换。
| 原接口 | 新接口 |
| ----------------------- | -------------------------------- |
| @ohos.commonEvent.d.ts | @ohos.commonEventManager.d.ts |
| @ohos.notification.d.ts | @ohos.notificationManager.d.ts |
| @ohos.notification.d.ts | @ohos.notificationSubscribe.d.ts |
接口、属性被删除:
-
@ohos.notification.d.ts
-
接口 publishAsBundle、cancelAsBundle、isNotificationSlotEnabled、setSyncNotificationEnabledWithoutApp、getSyncNotificationEnabledWithoutApp 被删除。可以使用 api/@ohos.notificationManager.d.ts 的同名接口替换。
-
接口 enableNotificationSlot 被删除。可以使用 api/@ohos.notificationManager.d.ts 的接口 setNotificationEnableSlot 替换。
-
导出类 NotificationActionButton、NotificationBasicContent、NotificationContent、NotificationLongTextContent、NotificationMultiLineContent、NotificationPictureContent、NotificationFlags、NotificationFlagStatus、NotificationRequest、DistributedOptions、NotificationSlot、NotificationSorting、NotificationTemplate、NotificationUserInput 被删除。可以使用 api/@ohos.notificationManager.d.ts 的同名导出类替换。
-
导出类 NotificationSubscribeInfo、NotificationSubscriber、SubscribeCallbackData、EnabledNotificationCallbackData 被删除。可以使用 api/@ohos.notificationSubscribe.d.ts 的同名导出类替换。
**适配指导**
如上所述,仅将老接口平移到了新的namespace中,所以可以通过修改import来解决适配问题:
如原先接口使用了@ohos.commonEvent
```
js
import
commonEvent
from
'
@ohos.commonEvent
'
;
```
可以通过直接修改import,来切换到新的namespace上:
```
js
import
commonEvent
from
'
@ohos.commonEventManager
'
;
```
@ohos.notification拆分成了两个namespace,需要根据接口情况选择需要的新namespace进行适配。
此外还需要适配异常处理,具体参考新接口的接口文档。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录