Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
56cfebfa
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
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看板
未验证
提交
56cfebfa
编写于
7月 12, 2022
作者:
O
openharmony_ci
提交者:
Gitee
7月 12, 2022
浏览文件
操作
浏览文件
下载
差异文件
!6648 Fix sample code problems of ability
Merge pull request !6648 from yuyaozhi/master
上级
7946c539
f9a0790b
变更
13
隐藏空白更改
内联
并排
Showing
13 changed file
with
28 addition
and
119 deletion
+28
-119
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
...application-dev/reference/apis/js-apis-ability-context.md
+1
-7
zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
...cation-dev/reference/apis/js-apis-ability-wantConstant.md
+3
-5
zh-cn/application-dev/reference/apis/js-apis-application-ability.md
...ication-dev/reference/apis/js-apis-application-ability.md
+1
-4
zh-cn/application-dev/reference/apis/js-apis-application-abilityManager.md
...-dev/reference/apis/js-apis-application-abilityManager.md
+0
-0
zh-cn/application-dev/reference/apis/js-apis-application-context.md
...ication-dev/reference/apis/js-apis-application-context.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-appmanager.md
zh-cn/application-dev/reference/apis/js-apis-appmanager.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-dataAbilityHelper.md
...plication-dev/reference/apis/js-apis-dataAbilityHelper.md
+6
-6
zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
.../application-dev/reference/apis/js-apis-featureAbility.md
+4
-4
zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
...cation-dev/reference/apis/js-apis-formextensioncontext.md
+2
-0
zh-cn/application-dev/reference/apis/js-apis-formhost.md
zh-cn/application-dev/reference/apis/js-apis-formhost.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-formprovider.md
zh-cn/application-dev/reference/apis/js-apis-formprovider.md
+2
-0
zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
...n-dev/reference/apis/js-apis-service-extension-context.md
+4
-5
zh-cn/application-dev/reference/apis/js-apis-uripermissionmanager.md
...cation-dev/reference/apis/js-apis-uripermissionmanager.md
+0
-83
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
浏览文件 @
56cfebfa
...
...
@@ -40,8 +40,6 @@ startAbility(want: Want, callback: AsyncCallback<void>): void
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -71,8 +69,6 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void&
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -106,8 +102,6 @@ startAbility(want: Want, options?: StartOptions): Promise<void>;
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -239,7 +233,7 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityRes
## AbilityContext.startAbilityForResultWithAccount
startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback
<AbilityResult>
): void;
startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback
\
<
AbilityResult>): void;
启动一个Ability并在该Ability帐号销毁时返回执行结果(callback形式)。
...
...
zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
浏览文件 @
56cfebfa
...
...
@@ -34,7 +34,7 @@ want操作的常数。
| ACTION_SEND_SMS | ohos.want.action.sendSms | 指示启动发送sms的页面功能的操作。 |
| ACTION_CHOOSE | ohos.want.action.choose | 指示启动页面功能以打开联系人或图片的操作。 |
| ACTION_IMAGE_CAPTURE
<sup>
8+
</sup>
| ohos.want.action.imageCapture | 指示启动页面拍照功能的操作。 |
| ACTION_VIDEO_CAPTUR
<sup>
8+
</sup>
| ohos.want.action.videoCapture | 指示启动页面功能以拍摄视频的操作。 |
| ACTION_VIDEO_CAPTUR
E
<sup>
8+
</sup>
| ohos.want.action.videoCapture | 指示启动页面功能以拍摄视频的操作。 |
| ACTION_SELECT | ohos.want.action.select | 指示显示应用程序选择对话框的操作。 |
| ACTION_SEND_DATA | ohos.want.action.sendData | 指示发送单个数据记录的操作。 |
| ACTION_SEND_MULTIPLE_DATA | ohos.want.action.sendMultipleData | 指示发送多个数据记录的操作。 |
...
...
@@ -46,8 +46,6 @@ want操作的常数。
| ACTION_FILE_SELECT
<sup>
7+
</sup>
| ohos.action.fileSelect | 指示选择文件的操作。 |
| PARAMS_STREAM
<sup>
7+
</sup>
| ability.params.stream | 指示与连接发送数据一起使用时,包含与意图相关联的数据流的URI。 |
| ACTION_APP_ACCOUNT_OAUTH
<sup>
8+
</sup>
| ohos.account.appAccount.action.oauth | 指示提供oauth服务的操作。 |
| ACTION_MARKER_DOWNLOAD | ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的行为。
<br>
**系统API**
: 此接口为系统接口,三方应用不支持调用。 |
## wantConstant.Entity
...
...
@@ -81,8 +79,8 @@ Flags说明。
| FLAG_AUTH_PERSISTABLE_URI_PERMISSION | 0x00000040 | 指示URI上可能持久化的授权。
<br>
**系统API**
: 此接口为系统接口,三方应用不支持调用。 |
| FLAG_AUTH_PREFIX_URI_PERMISSION | 0x00000080 | 按照前缀匹配的方式验证URI权限。
<br>
**系统API**
: 此接口为系统接口,三方应用不支持调用。 |
| FLAG_ABILITYSLICE_MULTI_DEVICE | 0x00000100 | 支持分布式调度系统中的多设备启动。 |
| FLAG_START_FOREGROUND_ABILITY | 0x00000200 | 指示无论主机应用程序是否已启动,都将启动使用服务模板的功能。
<br>
**系统API**
: 此接口为系统接口,三方应用不支持调用。
|
| FLAG_ABILITY_CONTINUATION_REVERSIBLE | 0x00000400 | 表示迁移是可拉回的。 |
| FLAG_START_FOREGROUND_ABILITY | 0x00000200 | 指示无论主机应用程序是否已启动,都将启动使用服务模板的功能。 |
| FLAG_ABILITY_CONTINUATION_REVERSIBLE | 0x00000400 | 表示迁移是可拉回的。
<br>
**系统API**
: 此接口为系统接口,三方应用不支持调用。
|
| FLAG_INSTALL_ON_DEMAND | 0x00000800 | 如果未安装指定的功能,请安装该功能。 |
| FLAG_INSTALL_WITH_BACKGROUND_MODE | 0x80000000 | 如果未安装,使用后台模式安装该功能。 |
| FLAG_ABILITY_CLEAR_MISSION | 0x00008000 | 指示清除其他任务的操作。可以为传递给
**[ohos.app.Context](js-apis-ability-context.md)**
中
**startAbility**
方法的
**Want**
设置此标志,并且必须与
**flag_ABILITY_NEW_MISSION**
一起使用。 |
...
...
zh-cn/application-dev/reference/apis/js-apis-application-ability.md
浏览文件 @
56cfebfa
...
...
@@ -234,11 +234,8 @@ onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
```
js
class
myAbility
extends
Ability
{
onNewWant
(
want
,
launchParams
)
{
onNewWant
(
want
)
{
console
.
log
(
'
onNewWant, want:
'
+
want
.
abilityName
);
if
(
launchParams
.
launchReason
===
AbilityConstant
.
LaunchReason
.
CONTINUATION
)
{
console
.
log
(
'
onNewWant, launchReason is continuation
'
);
}
}
}
```
...
...
zh-cn/application-dev/reference/apis/js-apis-abilityManager.md
→
zh-cn/application-dev/reference/apis/js-apis-a
pplication-a
bilityManager.md
浏览文件 @
56cfebfa
文件已移动
zh-cn/application-dev/reference/apis/js-apis-application-context.md
浏览文件 @
56cfebfa
...
...
@@ -29,7 +29,7 @@ import AbilityContext from '@ohos.application.Ability'
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| resourceManager |
ResourceManager
| 是 | 否 | ResourceManager对象。 |
| resourceManager |
resmgr.ResourceManager;
| 是 | 否 | ResourceManager对象。 |
| applicationInfo | ApplicationInfo | 是 | 否 | 当前应用信息。 |
| cacheDir | string | 是 | 否 | 应用在内部存储上的缓存路径。 |
| tempDir | string | 是 | 否 | 应用的临时文件路径。 |
...
...
zh-cn/application-dev/reference/apis/js-apis-appmanager.md
浏览文件 @
56cfebfa
...
...
@@ -518,7 +518,7 @@ app.killProcessesByBundleName(bundleName)
## appManager.clearUpApplicationData<sup>8+</sup>
clearUpApplicationData(bundleName: string, callback: AsyncCallback
<void>
);
clearUpApplicationData(bundleName: string, callback: AsyncCallback
\
<
void>);
通过包名清除应用数据。
...
...
@@ -552,7 +552,7 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback<void>);
## appManager.clearUpApplicationData<sup>8+</sup>
clearUpApplicationData(bundleName: string): Promise
<void>
;
clearUpApplicationData(bundleName: string): Promise
\
<
void>;
通过包名清除应用数据。
...
...
zh-cn/application-dev/reference/apis/js-apis-dataAbilityHelper.md
浏览文件 @
56cfebfa
...
...
@@ -647,7 +647,7 @@ delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: Asy
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
ohos_data_ability
from
'
@ohos.data.data
a
bility
'
import
ohos_data_ability
from
'
@ohos.data.data
A
bility
'
var
DAHelper
=
featureAbility
.
acquireDataAbilityHelper
(
"
dataability:///com.example.DataAbility
"
);
...
...
@@ -685,7 +685,7 @@ delete(uri: string, predicates: dataAbility.DataAbilityPredicates): Promise\<num
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
ohos_data_ability
from
'
@ohos.data
.dataa
bility
'
import
ohos_data_ability
from
'
@ohos.data
A
bility
'
var
DAHelper
=
featureAbility
.
acquireDataAbilityHelper
(
"
dataability:///com.example.DataAbility
"
);
...
...
@@ -719,7 +719,7 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.Data
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
ohos_data_ability
from
'
@ohos.data.data
a
bility
'
import
ohos_data_ability
from
'
@ohos.data.data
A
bility
'
var
DAHelper
=
featureAbility
.
acquireDataAbilityHelper
(
"
dataability:///com.example.DataAbility
"
);
...
...
@@ -765,7 +765,7 @@ update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.Data
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
ohos_data_ability
from
'
@ohos.data.data
a
bility
'
import
ohos_data_ability
from
'
@ohos.data.data
A
bility
'
var
DAHelper
=
featureAbility
.
acquireDataAbilityHelper
(
"
dataability:///com.example.DataAbility
"
);
...
...
@@ -806,7 +806,7 @@ query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityP
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
ohos_data_ability
from
'
@ohos.data.data
a
bility
'
import
ohos_data_ability
from
'
@ohos.data.data
A
bility
'
var
DAHelper
=
featureAbility
.
acquireDataAbilityHelper
(
"
dataability:///com.example.DataAbility
"
);
...
...
@@ -849,7 +849,7 @@ query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityP
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
ohos_data_ability
from
'
@ohos.data.data
a
bility
'
import
ohos_data_ability
from
'
@ohos.data.data
A
bility
'
var
DAHelper
=
featureAbility
.
acquireDataAbilityHelper
(
"
dataability:///com.example.DataAbility
"
);
...
...
zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
浏览文件 @
56cfebfa
...
...
@@ -369,7 +369,7 @@ hasWindowFocus(): Promise\<boolean>
**示例:**
```
javascript
import
featureAbility
from
'
@ohos.ability.feature
a
bility
'
;
import
featureAbility
from
'
@ohos.ability.feature
A
bility
'
;
featureAbility
.
hasWindowFocus
().
then
((
data
)
=>
{
console
.
info
(
"
==========================>hasWindowFocus=======================>
"
);
});
...
...
@@ -528,9 +528,9 @@ ConnectOptions类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ------------ | ---- | -------- | ---- | ------------------------- |
| onConnect | 只读 | function | 是 | 连接成功时的回调函数。 |
| onDisconnect | 只读 | function | 是 | 连接失败时的回调函数。 |
| onFailed | 只读 | function | 是 | ConnectAbility调用失败时的回调函数。 |
| onConnect
<sup>
7+
</sup>
| 只读 | function | 是 | 连接成功时的回调函数。 |
| onDisconnect
<sup>
7+
</sup>
| 只读 | function | 是 | 连接失败时的回调函数。 |
| onFailed
<sup>
7+
</sup>
| 只读 | function | 是 | ConnectAbility调用失败时的回调函数。 |
**返回值:**
...
...
zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
浏览文件 @
56cfebfa
...
...
@@ -33,6 +33,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData, cal
```
js
import
formBindingData
from
'
@ohos.application.formBindingData
'
import
FormExtension
from
'
@ohos.application.FormExtension
'
export
default
class
MyFormExtension
extends
FormExtension
{
onUpdate
(
formId
)
{
console
.
log
(
'
FormExtension onUpdate, formId:
'
+
formId
);
...
...
@@ -71,6 +72,7 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
```
js
import
formBindingData
from
'
@ohos.application.formBindingData
'
import
FormExtension
from
'
@ohos.application.FormExtension
'
export
default
class
MyFormExtension
extends
FormExtension
{
onUpdate
(
formId
)
{
console
.
log
(
'
FormExtension onUpdate, formId:
'
+
formId
);
...
...
zh-cn/application-dev/reference/apis/js-apis-formhost.md
浏览文件 @
56cfebfa
...
...
@@ -857,7 +857,7 @@ acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo&g
获取卡片状态
**需要权限**
:ohos.permission.REQUIRE_FORM
and ohos.permission.GET_BUNDLE_INFO_PRIVILEGED.
**需要权限**
:ohos.permission.REQUIRE_FORM
和 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力**
:SystemCapability.Ability.Form
...
...
@@ -898,7 +898,7 @@ acquireFormState(want: Want): Promise<formInfo.FormStateInfo>;
获取卡片状态。
**需要权限**
:ohos.permission.REQUIRE_FORM
**需要权限**
:ohos.permission.REQUIRE_FORM
和 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力**
:SystemCapability.Ability.Form
...
...
zh-cn/application-dev/reference/apis/js-apis-formprovider.md
浏览文件 @
56cfebfa
...
...
@@ -189,6 +189,7 @@ getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback<Array&l
**示例:**
```
js
import
formInfo
from
'
@ohos.application.formInfo
'
;
const
filter
:
formInfo
.
FormInfoFilter
=
{
moduleName
:
"
entry
"
};
...
...
@@ -224,6 +225,7 @@ getFormsInfo(filter?: formInfo.FormInfoFilter): Promise<Array<formInfo.For
**示例:**
```
js
import
formInfo
from
'
@ohos.application.formInfo
'
;
const
filter
:
formInfo
.
FormInfoFilter
=
{
moduleName
:
"
entry
"
};
...
...
zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
浏览文件 @
56cfebfa
...
...
@@ -15,13 +15,11 @@ ServiceExtensionContext模块是ServiceExtension的上下文环境,继承自Ex
## 属性
表示访问应用程序资源的能力。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
|
resourceManager | resmgr.ResourceManager; | 是 | 否 | ResourceManager对象
。 |
|
extensionAbilityInfo |
[
ExtensionAbilityInfo
](
js-apis-bundle-ExtensionAbilityInfo.md
)
| 是 | 否 | 服务扩展信息
。 |
## startAbility
...
...
@@ -59,7 +57,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void;
## startAbility
startAbility(want: Want
): Promise
<
void
>
;
startAbility(want: Want
, options?: StartOptions): Promise
\<
void>
;
启动Ability。通过Promise返回结果。
...
...
@@ -72,6 +70,7 @@ startAbility(want: Want): Promise<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| options |
[
StartOptions
](
js-apis-application-StartOptions.md
)
| 是 | 启动Ability所携带的参数。 |
**返回值:**
...
...
zh-cn/application-dev/reference/apis/js-apis-uripermissionmanager.md
已删除
100644 → 0
浏览文件 @
7946c539
# uriPermissionManager
uriPermissionManager模块提供了Uri权限管理的能力。
> **说明:**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import UriPermissionManager from '@ohos.application.uriPermissionManager';
```
## uriPermissionManager.verifyUriPermission
verifyUriPermission(uri: string, flag: wantConstant.Flags, accessTokenId: number, callback: AsyncCallback
<
number
>
): void
检验某个应用是否对指定的uri有flag指定的权限。
**系统能力:**
SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| uri | string | 是 | 指向文件的uri,例如fileshare:///com.samples.filesharetest.FileShare/person/10。 |
| flag | wantConstant.Flags | 是 | uri的读权限或写权限。 |
| accessTokenId | number | 是 | 每个应用的唯一标识ID,开发者通过包管理接口自行获取。 |
| callback | AsyncCallback
<
number
>
| 是 | callback形式返回检验结果,返回0表示有权限,返回-1表示无权限。 |
**示例:**
```
js
import
WantConstant
from
'
@ohos.ability.wantConstant
'
;
let
accessTokenId
=
1
let
uri
=
"
fileshare:///com.samples.filesharetest.FileShare/person/10
"
UriPermissionManager
.
verifyUriPermission
(
uri
,
WantConstant
.
Flags
.
FLAG_AUTH_READ_URI_PERMISSION
,
accessTokenId
,
(
result
)
=>
{
console
.
log
(
"
result.code =
"
+
result
.
code
)
})
// accessTokenId开发者通过包管理接口自行获取
```
## uriPermissionManager.verifyUriPermission
verifyUriPermission(uri: string, flag: wantConstant.Flags, accessTokenId: number): Promise
<
number
>
检验某个应用是否对指定的uri有flag指定的权限。
**系统能力:**
SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| uri | string | 是 | 指向文件的uri,例如fileshare:///com.samples.filesharetest.FileShare/person/10。 |
| flag | wantConstant.Flags | 是 | uri的读权限或写权限。 |
| accessTokenId | number | 是 | 每个应用的唯一标识ID,开发者通过包管理接口自行获取。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 返回0表示有权限,返回-1表示无权限。 |
**示例:**
```
js
import
WantConstant
from
'
@ohos.ability.wantConstant
'
;
let
accessTokenId
=
1
let
uri
=
"
fileshare:///com.samples.filesharetest.FileShare/person/10
"
UriPermissionManager
.
verifyUriPermission
(
uri
,
WantConstant
.
Flags
.
FLAG_AUTH_READ_URI_PERMISSION
,
accessTokenId
)
.
then
((
data
)
=>
{
console
.
log
(
'
Verification succeeded.
'
+
data
)
}).
catch
((
error
)
=>
{
console
.
log
(
'
Verification failed.
'
);
})
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录