Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
8670efde
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
提交
8670efde
编写于
9月 29, 2021
作者:
Z
zhaoyuan
1
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add develop guaid
Signed-off-by:
N
zhaoyuan
<
zhaoyuan17@huawei.com
>
上级
e4b2f4fa
变更
13
展开全部
显示空白变更内容
内联
并排
Showing
13 changed file
with
6665 addition
and
0 deletion
+6665
-0
zh-cn/application-dev/js-reference/Bundle.md
zh-cn/application-dev/js-reference/Bundle.md
+1328
-0
zh-cn/application-dev/js-reference/CommonEvent.md
zh-cn/application-dev/js-reference/CommonEvent.md
+508
-0
zh-cn/application-dev/js-reference/Context.md
zh-cn/application-dev/js-reference/Context.md
+542
-0
zh-cn/application-dev/js-reference/DataUriUtils.md
zh-cn/application-dev/js-reference/DataUriUtils.md
+131
-0
zh-cn/application-dev/js-reference/FeatureAbility.md
zh-cn/application-dev/js-reference/FeatureAbility.md
+913
-0
zh-cn/application-dev/js-reference/Notification.md
zh-cn/application-dev/js-reference/Notification.md
+1676
-0
zh-cn/application-dev/js-reference/ParticleAbility.md
zh-cn/application-dev/js-reference/ParticleAbility.md
+411
-0
zh-cn/application-dev/js-reference/dataAbilityHelper.md
zh-cn/application-dev/js-reference/dataAbilityHelper.md
+837
-0
zh-cn/application-dev/quick-start/CommonEvent开发指南.md
zh-cn/application-dev/quick-start/CommonEvent开发指南.md
+0
-0
zh-cn/application-dev/quick-start/Notification开发指南.md
zh-cn/application-dev/quick-start/Notification开发指南.md
+0
-0
zh-cn/application-dev/quick-start/PageAbility开发说明.md
zh-cn/application-dev/quick-start/PageAbility开发说明.md
+130
-0
zh-cn/application-dev/quick-start/ServiceAbility开发说明.md
zh-cn/application-dev/quick-start/ServiceAbility开发说明.md
+189
-0
zh-cn/application-dev/quick-start/基于Native的DataAbility创建与访问.md
.../application-dev/quick-start/基于Native的DataAbility创建与访问.md
+0
-0
未找到文件。
zh-cn/application-dev/js-reference/Bundle.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
zh-cn/application-dev/js-reference/CommonEvent.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
zh-cn/application-dev/js-reference/Context.md
0 → 100644
浏览文件 @
8670efde
### Context模块(JS端SDK接口)
#### 支持设备
| API | 手机 | 平板 | 智慧屏 | 智能穿戴 | 轻量级智能穿戴 | 智慧视觉设备 |
| ------------------------------------------------------------ | ---- | ---- | ------ | -------- | -------------- | ------------ |
| Context.getOrCreateLocalDir(callback: AsyncCallback
\<
string>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getOrCreateLocalDir() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.verifyPermission(permission: string, options: PermissionOptions, callback: AsyncCallback
\<
number>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.verifyPermission(permission: string, callback: AsyncCallback
\<
number>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.verifyPermission(permission: string, options?: PermissionOptions) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.requestPermissionsFromUser(permissions: Array
\<
string>, requestCode: number, resultCallback: AsyncCallback
\<
PermissionRequestResult>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getApplicationInfo(callback: AsyncCallback
\<
ApplicationInfo>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getApplicationInfo() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getBundleName(callback: AsyncCallback
\<
string>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getBundleName() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getProcessInfo(callback: AsyncCallback
\<
ProcessInfo>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getProcessInfo() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getElementName(callback: AsyncCallback
\<
ElementName>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getElementName() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getProcessName(callback: AsyncCallback
\<
string>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getProcessName() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getCallingBundle(callback: AsyncCallback
\<
string>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Context.getCallingBundle() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
#### 权限列表
**ohos.permission.RUNNING_LOCK permission**
#### 导入模块
```
import featureAbility from '@ohos.ability.featureAbility'
import bundle from '@ohos.bundle'
```
#### Context.getOrCreateLocalDir(callback: AsyncCallback\<string>)
-
接口说明
获取应用程序的本地根目录。如果是第一次调用,将创建目录(callback形式)
-
getOrCreateLocalDir参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | ----------------------- | ---- | ---------------- |
| callback | 只读 | AsyncCallback
\<
string>) | 是 | 被指定的回调方法 |
-
返回值
根目录
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getOrCreateLocalDir
()
```
#### Context.getOrCreateLocalDir()
-
接口说明
获取应用程序的本地根目录。如果是第一次调用,将创建目录(Promise形式)
-
返回值
根目录
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getOrCreateLocalDir
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>getOrCreateLocalDirCallback=======================>
"
);
});
```
#### Context.verifyPermission(permission: string, options: PermissionOptions, callback: AsyncCallback\<number>)
-
接口说明
验证系统中运行的特定pid和uid是否允许指定的权限(callback形式)
-
verifyPermission参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---------- | -------- | ---------------------- | ---- | ---------------- |
| permission | 只读 | string | 是 | 指定权限的名称 |
| options | 只读 | PermissionOptions | 是 | 进程id |
| callback | 只读 | AsyncCallback
\<
number> | 是 | 被指定的回调方法 |
-
PermissionOptions类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---- | -------- | ------ | ---- | ------ |
| pid | 只读 | number | 否 | 进程id |
| uid | 只读 | number | 否 | 用户id |
-
返回值
如果PID和UID具有权限,则使用{@code 0}进行异步回调;否则使用{@code-1}回调。
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
bundle
from
'
@ohos.bundle
'
var
context
=
featureAbility
.
getContext
();
var
datainfo
=
await
bundle
.
getBundleInfo
(
'
com.context.test
'
,
1
);
context
.
verifyPermission
(
"
com.example.permission
"
,
datainfo
.
uid
,)
```
#### Context.verifyPermission(permission: string, callback: AsyncCallback\<number>)
-
接口说明
验证系统中运行的特定pid和uid是否允许指定的权限(callback形式)
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---------- | -------- | ----------------------- | ---- | ---------------- |
| permission | 只读 | string | 是 | 指定权限的名称 |
| callback | 只读 | AsyncCallback
\<
number>) | 是 | 被指定的回调方法 |
-
返回值
如果PID和UID具有权限,则使用{@code 0}进行异步回调;否则使用{@code-1}回调。
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
verifyPermission
(
"
com.example.permission
"
)
```
#### Context.verifyPermission(permission: string, options?: PermissionOptions)
-
接口说明
验证系统中运行的特定pid和uid是否允许指定的权限(Promise形式)
-
verifyPermission参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---------- | -------- | ----------------- | ---- | -------------- |
| permission | 只读 | string | 是 | 指定权限的名称 |
| options | 只读 | PermissionOptions | 否 | 进程id |
-
PermissionOptions类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---- | -------- | ------ | ---- | ------ |
| pid | 只读 | number | 否 | 进程id |
| uid | 只读 | number | 否 | 用户id |
-
返回值
如果PID和UID具有权限,则使用{@code 0}进行异步回调;否则使用{@code-1}回调。
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
var
Permission
=
context
.
PermissionOptions
(
1
,
1
);
context
.
getOrCreateLocalDir
(
'
com.context.permission
'
,
Permission
).
then
((
void
)
=>
{
console
.
info
(
"
==========================>verifyPermissionCallback=======================>
"
);
});
```
#### Context.requestPermissionsFromUser(permissions: Array\<string>, requestCode: number, resultCallback: AsyncCallback\<PermissionRequestResult>)
-
接口说明
从系统请求某些权限(callback形式)
-
requestPermissionsFromUser参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------------- | -------- | ---------------------------------------- | ---- | --------------------------------------------- |
| permissions | 只读 | Array
\<
string> | 是 | 指示要请求的权限列表。此参数不能为null |
| requestCode | 只读 | number | 是 | 指示要传递给PermissionRequestResult的请求代码 |
| resultCallback | 只读 | AsyncCallback
\<
PermissionRequestResult>) | 是 | 被指定的回调方法 |
-
PermissionRequestResult类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ----------- | -------- | -------------- | ---- | ------------------ |
| requestCode | 只读 | number | 是 | 用户传入的请求代码 |
| permissions | 只读 | Array
\<
string> | 是 | 用户传入的权限 |
| authResults | 只读 | Array
\<
number> | 是 | 求权限的结果 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getOrCreateLocalDir
(
[
"
com.example.permission1
"
,
"
com.example.permission2
"
,
"
com.example.permission3
"
,
"
com.example.permission4
"
,
"
com.example.permission5
"
],
1
,
)
```
#### Context.getApplicationInfo(callback: AsyncCallback\<ApplicationInfo>)
-
接口说明
获取有关当前应用程序的信息(callback形式)
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | ------------------------------- | ---- | -------------------- |
| callback | 只读 | AsyncCallback
\<
ApplicationInfo> | 是 | 表示被指定的回调方法 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getApplicationInfo
()
```
#### Context.getApplicationInfo()
-
接口说明
获取有关当前应用程序的信息(Promise形式)
-
参数描述
Null
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getApplicationInfo
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>getApplicationInfoCallback=======================>
"
);
});
```
#### Context.getBundleName(callback: AsyncCallback\<string>)
-
接口说明
获取当前ability的捆绑包名称(callback形式)
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | ---------------------- | ---- | -------------------- |
| callback | 只读 | AsyncCallback
\<
string> | 是 | 表示被指定的回调方法 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getBundleName
()
```
#### Context.getBundleName()
-
接口说明
获取当前ability的捆绑包名称(Promise形式)
-
参数描述
Null
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getBundleName
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>getBundleNameCallback=======================>
"
);
});
```
#### Context.getProcessInfo(callback: AsyncCallback\<ProcessInfo>)
-
接口说明
获取有关当前进程的信息,包括进程ID和名称(callback形式)
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | --------------------------- | ---- | -------------------- |
| callback | 只读 | AsyncCallback
\<
ProcessInfo> | 是 | 表示被指定的回调方法 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getProcessInfo
()
```
#### Context.getProcessInfo()
-
接口说明
获取有关当前进程的信息,包括进程ID和名称(Promise形式)
-
参数描述
Null
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getProcessInfo
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>getProcessInfoCallback=======================>
"
);
});
```
#### Context.getElementName(callback: AsyncCallback\<ElementName>)
-
接口说明
获取当前能力的ohos.bundle.ElementName对象。此方法仅适用于页面功能(callback形式)
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | --------------------------- | ---- | -------------------- |
| callback | 只读 | AsyncCallback
\<
ElementName> | 是 | 表示被指定的回调方法 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getElementName
()
```
#### Context.getElementName()
-
接口说明
获取当前能力的ohos.bundle.ElementName对象。此方法仅适用于页面功能(Promise形式)
-
参数描述
Null
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getElementName
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>getElementNameCallback=======================>
"
);
});
```
####
#### Context.getProcessName(callback: AsyncCallback\<string>)
-
接口说明
获取当前进程的名称(callback形式)
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | ---------------------- | ---- | -------------------- |
| callback | 只读 | AsyncCallback
\<
string> | 是 | 表示被指定的回调方法 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getProcessName
()
```
#### Context.getProcessName()
-
接口说明
获取当前进程的名称(Promise形式)
-
参数描述
Null
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getProcessName
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>getProcessNameCallback=======================>
"
);
});
```
#### Context.getCallingBundle(callback: AsyncCallback\<string>)
-
接口说明
获取调用当前能力的能力的捆绑包名称(callback形式)
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | ---------------------- | ---- | -------------------- |
| callback | 只读 | AsyncCallback
\<
string> | 是 | 表示被指定的回调方法 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getCallingBundle
()
```
#### Context.getCallingBundle()
-
接口说明
获取调用当前能力的能力的捆绑包名称(Promise形式)
-
参数描述
Null
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getCallingBundle
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>getCallingBundleCallback=======================>
"
);
});
```
zh-cn/application-dev/js-reference/DataUriUtils.md
0 → 100644
浏览文件 @
8670efde
### DataUriUtils模块(JS端SDK接口)
#### 支持设备
| API | 手机 | 平板 | 智慧屏 | 智能穿戴 | 轻量级智能穿戴 | 智慧视觉设备 |
| ---------------------------------------------- | ---- | ---- | ------ | -------- | -------------- | ------------ |
| DataUriUtils.getId(uri: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| DataUriUtils.attachId(uri: string, id: number) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| DataUriUtils.deleteId(uri: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| DataUriUtils.updateId(uri: string, id: number) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
#### 权限列表
ohos.permission.RUNNING_LOCK permission
#### 导入模块
```
js
import
notify
from
'
@ohos.ability.dataUriUtils
'
;
```
#### DataUriUtils.getId(uri: string)
-
接口说明
获取附加到给定uri的路径组件末尾的ID
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---- | -------- | ------ | ---- | ------------------------- |
| uri | 只读 | string | 是 | 指示要从中获取ID的uri对象 |
-
返回值
附加到路径组件末尾的ID
-
示例
```
js
import
dataUriUtils
from
'
@ohos.ability.datauriutils
'
dataUriUtils
.
getIdSync
(
"
com.example.dataUriUtils/1221
"
)
```
#### DataUriUtils.attachId(uri: string, id: number)
-
接口说明
将给定ID附加到给定uri的路径组件的末尾
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---- | -------- | ------ | ---- | ------------------------- |
| uri | 只读 | string | 是 | 指示要从中获取ID的uri对象 |
| id | 只读 | number | 是 | 指示要附加的ID |
-
返回值
附加给定ID的uri对象
-
示例
```
js
import
dataUriUtils
from
'
@ohos.ability.datauriutils
'
var
idint
=
1122
;
dataUriUtils
.
attachId
(
"
com.example.dataUriUtils
"
idint
,
)
```
#### DataUriUtils.deleteId(uri: string)
-
接口说明
从给定uri的路径组件的末尾删除ID
-
参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---- | -------- | ------ | ---- | ------------------------- |
| uri | 只读 | string | 是 | 指示要从中删除ID的uri对象 |
-
返回值
ID已删除的uri对象
-
示例
```
js
import
dataUriUtils
from
'
@ohos.ability.datauriutils
'
dataUriUtils
.
deleteId
(
"
com.example.dataUriUtils/1221
"
)
```
#### DataUriUtils.updateId(uri: string, id: number)
-
接口说明
更新指定uri中的ID
-
updateId参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---- | -------- | ------ | ---- | ------------------- |
| uri | 只读 | string | 是 | 指示要更新的uri对象 |
| id | 只读 | number | 是 | 指示新ID |
-
返回值
更新的uri对象
-
示例
```
js
import
dataUriUtils
from
'
@ohos.ability.datauriutils
'
var
idint
=
1122
;
dataUriUtils
.
updateId
(
"
com.example.dataUriUtils
"
idint
,
)
```
zh-cn/application-dev/js-reference/FeatureAbility.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
zh-cn/application-dev/js-reference/Notification.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
zh-cn/application-dev/js-reference/ParticleAbility.md
0 → 100644
浏览文件 @
8670efde
### ParticleAbility模块(JS端SDK接口)
#### 支持设备
| API | 手机 | 平板 | 智慧屏 | 智能穿戴 | 轻量级智能穿戴 | 智慧视觉设备 |
| ------------------------------------------------------------ | ---- | ---- | ------ | -------- | -------------- | ------------ |
| ParticleAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback
\<
void> | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| ParticleAbility.startAbility(parameter: StartAbilityParameter) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| ParticleAbility.terminateSelf(callback: AsyncCallback
\<
void>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| ParticleAbility.terminateSelf() | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| ParticleAbility.acquireDataAbilityHelper(uri: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
#### 权限列表
ohos.permission.RUNNING_LOCK permission
#### 使用限制
ParticleAbility模块的接口只能在Ability为Data和Service类型的时候进行调用
#### 导入模块
```
import featureAbility from '@ohos.ability.featureAbility'
```
#### ParticleAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\<void>
-
接口说明
服务ability使用此方法启动特定ability(callback形式)
-
startAbility参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| --------- | -------- | --------------------- | ---- | ----------------- |
| parameter | 只读 | StartAbilityParameter | 是 | 指示启动的ability |
| callback | 只读 | AsyncCallback
\<
void> | 是 | 被指定的回调方法 |
-
StartAbilityParameter类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ------------------- | -------- | ------ | ---- | ---------------------------------- |
| want | 只读 | want | 是 | 表示需要包含有关目标启动能力的信息 |
| abilityStartSetting | 只读 | string | 否 | 指示启动能力中使用的特殊启动设置 |
-
want类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ----------- | -------- | ------ | ---- | -------------------------- |
| deviceId | 只读 | string | 否 | 设备id |
| bundleName | 只读 | string | 否 | 捆绑包名称 |
| abilityName | 只读 | string | 否 | ability 名字 |
| uri | 只读 | string | 否 | 请求中URI的描述 |
| type | 只读 | string | 否 | 此文件中类型的说明 |
| flags | 只读 | number | 否 | 此文件中标志的选项是必需的 |
| action | 只读 | string | 否 | 需求中对操作的描述 |
| parameters | 只读 | string | 否 | Want中WantParams对象的描述 |
| entities | 只读 | string | 否 | 对象中实体的描述 |
-
flags类型说明
| 名称 | 参数 | 描述 |
| ------------------------------------ | ---------- | ------------------------------------------------------------ |
| FLAG_AUTH_READ_URI_PERMISSION | 0x00000001 | 指示对URI执行读取操作的授权 |
| FLAG_AUTH_WRITE_URI_PERMISSION | 0x00000002 | 指示对URI执行写入操作的授权 |
| FLAG_ABILITY_FORWARD_RESULT | 0x00000004 | 将结果返回给源异能 |
| FLAG_ABILITY_CONTINUATION | 0x00000008 | 确定是否可以将本地设备上的功能迁移到远程设备 |
| FLAG_NOT_OHOS_COMPONENT | 0x00000010 | 指定组件是否不属于OHOS |
| FLAG_ABILITY_FORM_ENABLED | 0x00000020 | 指定是否启动某个能力 |
| FLAG_AUTH_PERSISTABLE_URI_PERMISSION | 0x00000040 | 指示URI上可能持久化的授权 |
| FLAG_AUTH_PREFIX_URI_PERMISSION | 0x00000080 | 将结果返回到源能力片 |
| FLAG_ABILITYSLICE_MULTI_DEVICE | 0x00000100 | 支持分布式调度系统中的多设备启动 |
| FLAG_START_FOREGROUND_ABILITY | 0x00000200 | 指示无论主机应用程序是否已启动,都将启动使用服务模板的功能 |
| FLAG_ABILITY_CONTINUATION_REVERSIBLE | 0x00000400 | 表示延续是可逆的。 |
| FLAG_INSTALL_ON_DEMAND | 0x00000800 | 如果未安装指定的功能,请安装该功能 |
| FLAG_INSTALL_WITH_BACKGROUND_MODE | 0x80000000 | 如果未安装,请使用后台模式安装指定的DI功能。 |
| FLAG_ABILITY_CLEAR_MISSION | 0x00008000 | 指示清除其他任务的操作。可以为传递给{@link ohos.app.Context#startAbility}的{@code Intent}设置此标志,并且必须与{@link flag_ABILITY_NEW_MISSION}一起使用 |
| FLAG_ABILITY_NEW_MISSION | 0x10000000 | 指示在历史任务堆栈上创建任务的操作。 |
| FLAG_ABILITY_MISSION_TOP | 0x20000000 | 指示如果启动能力的现有实例已位于任务堆栈的顶部,则将重用该实例。否则,将创建一个新的能力实例。 |
-
返回值
void
-
示例
```
js
import
particleAbility
from
'
@ohos.ability.particleAbility
'
particleAbility
.
startAbility
(
{
want
:
{
action
:
"
action.system.home
"
,
entities
:
[
"
entity.system.home
"
],
type
:
"
MIMETYPE
"
,
flags
:
FLAG_AUTH_READ_URI_PERMISSION
;
deviceId
:
""
,
bundleName
:
"
com.example.Data
"
,
abilityName
:
"
com.jstest.startabilitytest5.MainAbility
"
,
uri
:
""
},
},
)
```
#### ParticleAbility.startAbility(parameter: StartAbilityParameter)
-
接口说明
服务ability使用此方法启动特定ability((Promise形式)
-
startAbility参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| --------- | -------- | --------------------- | ---- | ----------------- |
| parameter | 只读 | StartAbilityParameter | 是 | 指示启动的ability |
-
StartAbilityParameter类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ------------------- | -------- | ------ | ---- | ---------------------------------- |
| want | 只读 | want | 是 | 表示需要包含有关目标启动能力的信息 |
| abilityStartSetting | 只读 | string | 否 | 指示启动能力中使用的特殊启动设置 |
-
want类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ----------- | -------- | ------ | ---- | -------------------------- |
| deviceId | 只读 | string | 否 | 设备id |
| bundleName | 只读 | string | 否 | 捆绑包名称 |
| abilityName | 只读 | string | 否 | ability 名字 |
| uri | 只读 | string | 否 | 请求中URI的描述 |
| type | 只读 | string | 否 | 此文件中类型的说明 |
| flags | 只读 | number | 否 | 此文件中标志的选项是必需的 |
| action | 只读 | string | 否 | 需求中对操作的描述 |
| parameters | 只读 | string | 否 | Want中WantParams对象的描述 |
| entities | 只读 | string | 否 | 对象中实体的描述 |
-
flags类型说明
| 名称 | 参数 | 描述 |
| ------------------------------------ | ---------- | ------------------------------------------------------------ |
| FLAG_AUTH_READ_URI_PERMISSION | 0x00000001 | 指示对URI执行读取操作的授权 |
| FLAG_AUTH_WRITE_URI_PERMISSION | 0x00000002 | 指示对URI执行写入操作的授权 |
| FLAG_ABILITY_FORWARD_RESULT | 0x00000004 | 将结果返回给源异能 |
| FLAG_ABILITY_CONTINUATION | 0x00000008 | 确定是否可以将本地设备上的功能迁移到远程设备 |
| FLAG_NOT_OHOS_COMPONENT | 0x00000010 | 指定组件是否不属于OHOS |
| FLAG_ABILITY_FORM_ENABLED | 0x00000020 | 指定是否启动某个能力 |
| FLAG_AUTH_PERSISTABLE_URI_PERMISSION | 0x00000040 | 指示URI上可能持久化的授权 |
| FLAG_AUTH_PREFIX_URI_PERMISSION | 0x00000080 | 将结果返回到源能力片 |
| FLAG_ABILITYSLICE_MULTI_DEVICE | 0x00000100 | 支持分布式调度系统中的多设备启动 |
| FLAG_START_FOREGROUND_ABILITY | 0x00000200 | 指示无论主机应用程序是否已启动,都将启动使用服务模板的功能 |
| FLAG_ABILITY_CONTINUATION_REVERSIBLE | 0x00000400 | 表示延续是可逆的。 |
| FLAG_INSTALL_ON_DEMAND | 0x00000800 | 如果未安装指定的功能,请安装该功能 |
| FLAG_INSTALL_WITH_BACKGROUND_MODE | 0x80000000 | 如果未安装,请使用后台模式安装指定的DI功能。 |
| FLAG_ABILITY_CLEAR_MISSION | 0x00008000 | 指示清除其他任务的操作。可以为传递给{@link ohos.app.Context#startAbility}的{@code Intent}设置此标志,并且必须与{@link flag_ABILITY_NEW_MISSION}一起使用 |
| FLAG_ABILITY_NEW_MISSION | 0x10000000 | 指示在历史任务堆栈上创建任务的操作。 |
| FLAG_ABILITY_MISSION_TOP | 0x20000000 | 指示如果启动能力的现有实例已位于任务堆栈的顶部,则将重用该实例。否则,将创建一个新的能力实例。 |
-
返回值
void
-
示例
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
import
particleAbility
from
'
@ohos.ability.particleAbility
'
var
windowMode
=
featureAbility
.
AbilityStartSetting
.
WINDOW_MODE_KEY
;
particleAbility
.
startAbility
(
want
:
{
bundleName
:
"
com.jstest.featureabilitytest
"
,
abilityName
:
"
com.jstest.startabilitytest1.MainAbility
"
,
},
abilityStartSetting
:
{
windowMode
:
featureAbility
.
AbilityWindowConfiguration
.
WINDOW_MODE_FLOATING
,
},
}
).
then
((
void
)
=>
{
console
.
info
(
"
==========================>startAbilityCallback=======================>
"
);
});
```
#### ParticleAbility.terminateSelf(callback: AsyncCallback\<void>)
-
接口说明
摧毁服务ability(callback形式)
-
terminateSelf参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------- | -------- | -------------------- | ---- | -------------------- |
| callback | 只读 | AsyncCallback
\<
void> | 是 | 表示被指定的回调方法 |
-
返回值
void
-
示例
```
js
import
particleAbility
from
'
@ohos.ability.particleAbility
'
ParticleAbility
.
terminateSelf
()
```
#### ParticleAbility.terminateSelf()
-
接口说明
摧毁服务ability(Promise形式)
-
返回值
void
-
示例
```
js
import
particleAbility
from
'
@ohos.ability.particleAbility
'
particleAbility
.
terminateSelf
().
then
((
void
)
=>
{
console
.
info
(
"
==========================>terminateSelfCallback=======================>
"
);
});
```
#### ParticleAbility.acquireDataAbilityHelper(uri: string)
-
接口说明
获取dataAbilityHelper
-
acquireDataAbilityHelper参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| :--- | -------- | ------ | ---- | ---------------------- |
| uri | 只读 | string | 是 | 指示要打开的文件的路径 |
-
返回值
返回dataAbilityHelper
-
示例
```
js
import
particleAbility
from
'
@ohos.ability.particleAbility
'
var
uri
=
""
;
ParticleAbility
.
acquireDataAbilityHelper
(
uri
)
```
#### ParticleAbility.connectAbility(*request*: Want, *options*:ConnectOptions): number
*
接口说明
将当前ability连接到指定ServiceAbility(callback形式)
*
connectAbility参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ------- | -------- | -------------- | ---- | -------------------------- |
| request | 只读 | Want | 是 | 表示被连接的ServiceAbility |
| options | 只读 | ConnectOptions | 是 | 被指定的回调方法 |
-
ConnectOptions类型说明
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ------------ | -------- | -------- | ---- | ---------------------------------- |
| onConnect | 只读 | function | 是 | 连接成功时的回调函数 |
| onDisconnect | 只读 | function | 是 | 连接失败时的回调函数 |
| onFailed | 只读 | function | 是 | ConnectAbility调用失败时的回调函数 |
*
返回值
连接的ServiceAbilityID。
*
示例
```
javascript
import
particleAbility
from
'
@ohos.ability.particleAbility
'
var
mRemote
;
var
connId
;
function
onConnectCallback
(
element
,
remote
){
mRemote
=
remote
;
console
.
log
(
'
ConnectAbility onConnect remote is proxy:
'
+
(
remote
instanceof
rpc
.
RemoteProxy
));
}
function
onDisconnectCallback
(
element
){
console
.
log
(
'
ConnectAbility onDisconnect element.deviceId :
'
+
element
.
deviceId
)
}
function
onFailedCallback
(
code
){
console
.
log
(
'
particleAbilityTest ConnectAbility onFailed errCode :
'
+
code
)
}
var
connId
=
particleAbility
.
connectAbility
(
{
bundleName
:
"
com.ix.ServiceAbility
"
,
abilityName
:
"
ServiceAbilityA
"
,
},
{
onConnect
:
onConnectCallback
,
onDisconnect
:
onDisconnectCallback
,
onFailed
:
onFailedCallback
,
},
);
```
#### ParticleAbility.disconnectAbility(connection: number, callback:AsyncCallback<void>): void
*
接口说明
断开与指定ServiceAbility的连接(callback形式)
*
disconnectAbility参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---------- | -------- | ------------- | ---- | ------------------------------ |
| connection | 只读 | number | 是 | 指定断开连接的ServiceAbilityID |
| callback | 只读 | AsyncCallback | 是 | 被指定的回调方法 |
*
返回值
无
*
示例
```
javascript
import
particleAbility
from
'
@ohos.ability.particleAbility
'
var
mRemote
;
var
connId
;
function
onConnectCallback
(
element
,
remote
){
mRemote
=
remote
;
console
.
log
(
'
ConnectAbility onConnect remote is proxy:
'
+
(
remote
instanceof
rpc
.
RemoteProxy
));
}
function
onDisconnectCallback
(
element
){
console
.
log
(
'
ConnectAbility onDisconnect element.deviceId :
'
+
element
.
deviceId
)
}
function
onFailedCallback
(
code
){
console
.
log
(
'
particleAbilityTest ConnectAbility onFailed errCode :
'
+
code
)
}
var
connId
=
particleAbility
.
connectAbility
(
{
bundleName
:
"
com.ix.ServiceAbility
"
,
abilityName
:
"
ServiceAbilityA
"
,
},
{
onConnect
:
onConnectCallback
,
onDisconnect
:
onDisconnectCallback
,
onFailed
:
onFailedCallback
,
},
);
var
result
=
particleAbility
.
disconnectAbility
(
connId
,
(
error
,
data
)
=>
{
console
.
log
(
'
particleAbilityTest DisConnectJsSameBundleName result errCode :
'
+
error
.
code
+
"
data:
"
+
data
)
},
);
```
#### ParticleAbility.disconnectAbility(connection: number): Promise<void>;
*
接口说明
断开与指定ServiceAbility的连接(promise形式)
*
disconnectAbility参数描述
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ---------- | -------- | ------ | ---- | ------------------------------ |
| connection | 只读 | number | 是 | 指定断开连接的ServiceAbilityID |
*
返回值
无
*
示例
```
javascript
import
particleAbility
from
'
@ohos.ability.particleAbility
'
var
mRemote
;
var
connId
;
function
onConnectCallback
(
element
,
remote
){
mRemote
=
remote
;
console
.
log
(
'
ConnectAbility onConnect remote is proxy:
'
+
(
remote
instanceof
rpc
.
RemoteProxy
));
}
function
onDisconnectCallback
(
element
){
console
.
log
(
'
ConnectAbility onDisconnect element.deviceId :
'
+
element
.
deviceId
)
}
function
onFailedCallback
(
code
){
console
.
log
(
'
particleAbilityTest ConnectAbility onFailed errCode :
'
+
code
)
}
var
connId
=
particleAbility
.
connectAbility
(
{
bundleName
:
"
com.ix.ServiceAbility
"
,
abilityName
:
"
ServiceAbilityA
"
,
},
{
onConnect
:
onConnectCallback
,
onDisconnect
:
onDisconnectCallback
,
onFailed
:
onFailedCallback
,
},
);
var
result
=
await
particleAbility
.
disconnectAbility
(
connId
);
```
zh-cn/application-dev/js-reference/dataAbilityHelper.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
zh-cn/application-dev/quick-start/CommonEvent开发指南.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
zh-cn/application-dev/quick-start/Notification开发指南.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
zh-cn/application-dev/quick-start/PageAbility开发说明.md
0 → 100644
浏览文件 @
8670efde
# PageAbility开发说明
## PageAbility介绍
Page模板(以下简称“Page”)是FA唯一支持的模板,用于提供与用户交互的能力。
## PageAbility的生命周期
**Ability生命周期介绍**
(Ability Life Cycle)是Ability被调度到INACTIVE、ACTIVE、BACKGROUND等各个状态的统称(主要涉及PageAbility类型和ServiceAbility类型的Ability)。
-
**PageAbility类型的Ability生命周期流转如下图所示**

**Ability生命周期状态说明:**
-
**UNINITIALIZED**
:未初始状态,为临时状态,Ability被创建后会由UNINITIALIZED状态进入INITIAL状态。
-
**INITIAL**
:初始化状态,也表示停止状态,表示当前Ability未运行,Ability被启动后由INITIAL态进入INACTIVE状态。
-
**INACTIVE**
:未激活状态,表示当前窗口已显示但是无焦点状态,由于Window暂未支持焦点的概念,当前状态与ACTIVE一致。
-
**ACTIVE**
:前台激活状态,表示当前窗口已显示,并获取焦点,Ability在退到后台之前先由ACTIVE状态进入INACTIVE状态。
-
**BACKGROUND**
: 后台状态,表示当前Ability退到后台,Ability在被销毁后由BACKGROUND状态进入INITIAL状态,或者重新被激活后由BACKGROUND状态进入ACTIVE状态。
**PageAbility类型Ability生命周期回调如下图所示:**

## 启动本地PageAbility
导入模块
```
import featureAbility from '@ohos.ability.featureAbility'
```
```
FeatureAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback<number>)
```
*
接口说明
启动新的ability(callback形式)
*
示例
```
javascript
import
featureAbility
from
'
@ohos.ability.featureAbility
'
featureAbility
.
startAbility
(
{
want
:
{
action
:
""
,
entities
:
[
""
],
type
:
""
,
options
:
{
// indicates the grant to perform read operations on the URI
authReadUriPermission
:
true
,
// indicates the grant to perform write operations on the URI
authWriteUriPermission
:
true
,
// support forward intent result to origin ability
abilityForwardResult
:
true
,
// used for marking the ability start-up is triggered by continuation
abilityContinuation
:
true
,
// specifies whether a component does not belong to ohos
notOhosComponent
:
true
,
// specifies whether an ability is started
abilityFormEnabled
:
true
,
// indicates the grant for possible persisting on the URI.
authPersistableUriPermission
:
true
,
// indicates the grant for possible persisting on the URI.
authPrefixUriPermission
:
true
,
// support distributed scheduling system start up multiple devices
abilitySliceMultiDevice
:
true
,
// indicates that an ability using the service template is started regardless of whether the
// host application has been started.
startForegroundAbility
:
true
,
// install the specified ability if it's not installed.
installOnDemand
:
true
,
// return result to origin ability slice
abilitySliceForwardResult
:
true
,
// install the specified ability with background mode if it's not installed.
installWithBackgroundMode
:
true
},
deviceId
:
""
,
bundleName
:
"
com.example.startability
"
,
abilityName
:
"
com.example.startability.MainAbility
"
,
uri
:
""
},
},
);
)
```
## 启动远程PageAbility
导入模块
```
import featureAbility from '@ohos.ability.featureAbility'
```
```
FeatureAbility.startAbility(parameter: StartAbilityParameter)
```
*
接口说明
启动远程的ability(promise形式)
前提:通过deviceManager获取远程deviceid
*
示例
```
javascript
var
promise
=
await
ability
.
startAbility
(
{
want
:
{
deviceId
:
this
.
deviceId
,
bundleName
:
"
com.example.test
"
,
abilityName
:
"
com.example.test.MainAbility
"
,
},
}
);
```
\ No newline at end of file
zh-cn/application-dev/quick-start/ServiceAbility开发说明.md
0 → 100644
浏览文件 @
8670efde
# ServiceAbility开发说明
-
[
创建Service
](
#section17436202895812
)
-
[
启动Service
](
#section944219415599
)
-
[
连接Service
](
#section126857614018
)
## 创建Service<a name="section17436202895812"></a>
1.
Service也是一种Ability,Ability为Service提供了以下生命周期方法,开发者可以重写这些方法,来添加其他Ability请求与Service Ability交互时的处理方法。
-
onStart()
该方法在创建Service的时候调用,用于Service的初始化。在Service的整个生命周期只会调用一次,调用时传入的Want应为空。
-
onCommand()
在Service创建完成之后调用,该方法在客户端每次启动该Service时都会调用,开发者可以在该方法中做一些调用统计、初始化类的操作。
-
onConnect()
在Ability和Service连接时调用,该方法返回IRemoteObject对象,开发者可以在该回调函数中生成对应Service的IPC通信通道,以便Ability与Service交互。Ability可以多次连接同一个Service,系统会缓存该Service的IPC通信对象,只有第一个客户端连接Service时,系统才会调用Service的onConnect方法来生成IRemoteObject对象,而后系统会将同一个RemoteObject对象传递至其他连接同一个Service的所有客户端,而无需再次调用onConnect方法。
-
onDisconnect()
在Ability与绑定的Service断开连接时调用。
-
onStop()
在Service销毁时调用。Service应通过实现此方法来清理任何资源,如关闭线程、注册的侦听器等。
创建Service的代码示例如下:
```
javascript
export
default
{
onStart
(
want
)
{
console
.
log
(
'
SerivceAbility onStart
'
);
},
onCommand
(
want
,
restart
,
startId
)
{
console
.
log
(
'
SerivceAbility onCommand
'
);
},
onConnect
(
want
)
{
console
.
log
(
'
SerivceAbility OnConnect
'
);
},
onDisconnect
()
{
console
.
log
(
'
SerivceAbility OnDisConnect
'
);
},
onStop
()
{
console
.
log
(
'
SerivceAbility onStop
'
);
},
}
```
2.
注册Service。
Service也需要在应用配置文件config.json中进行注册,注册类型type需要设置为service。
```javascript
{
"module": {
"abilities": [
{
"name": ".ServiceAbility",
"type": "service",
"visible": true
...
}
]
...
}
...
}
```
## 启动Service<a name="section944219415599"></a>
Ability为开发者提供了startAbility()方法来启动另外一个Ability。因为Service也是Ability的一种,开发者同样可以通过将Want传递给该方法来启动Service。
开发者可以通过构造包含BundleName与AbilityName的Want对象来设置目标Service信息。参数的含义如下:
-
BundleName:表示包名称。
-
AbilityName:表示待启动的Ability名称。
启动本地设备Service的代码示例如下:
```
javascript
import
featureAbility
from
'
@ohos.ability.featureability
'
;
var
promise
=
await
featureAbility
.
startAbility
(
{
want
:
{
bundleName
:
"
com.jstest.serviceability
"
,
abilityName
:
"
com.jstest.serviceability.MainAbility
"
,
},
}
);
```
-
执行上述代码后,Ability将通过startAbility() 方法来启动Service。
-
如果Service尚未运行,则系统会先调用onStart()来初始化Service,再回调Service的onCommand()方法来启动Service。
-
如果Service正在运行,则系统会直接回调Service的onCommand()方法来启动Service。
-
停止Service
Service一旦创建就会一直保持在后台运行,除非必须回收内存资源,否则系统不会停止或销毁Service。开发者可以在Service中通过terminateAbility()停止本Service或在其他Ability调用stopAbility()来停止Service。
## 连接Service<a name="section126857614018"></a>
如果Service需要与Page Ability或其他应用的Service Ability进行交互,则须创建用于连接的Connection。Service支持其他Ability通过connectAbility()方法与其进行连接。
在使用connectAbility()处理回调时,需要传入目标Service的Want与IAbilityConnection的实例。IAbilityConnection提供了以下方法供开发者实现:onConnect()是用来处理连接Service成功的回调,onDisconnect()是用来处理Service异常死亡的回调,onFailed()是用来处理连接Service失败的回调。
创建连接Service回调实例的代码示例如下:
```
javascript
var
mRemote
;
function
onConnectCallback
(
element
,
remote
){
console
.
log
(
'
ConnectAbility onConnect Callback
'
)
mRemote
=
remote
;
}
function
onDisconnectCallback
(
element
){
console
.
log
(
'
ConnectAbility onDisconnect Callback
'
)
}
function
onFailedCallback
(
code
){
console
.
log
(
'
ConnectAbility onFailed Callback
'
)
}
```
连接Service的代码示例如下:
```
javascript
import
featureAbility
from
'
@ohos.ability.featureability
'
;
var
connId
=
featureAbility
.
connectAbility
(
{
bundleName
:
"
com.jstest.serviceability
"
,
abilityName
:
"
com.jstest.serviceability.MainAbility
"
,
},
{
onConnect
:
onConnectCallback
,
onDisconnect
:
onDisconnectCallback
,
onFailed
:
onFailedCallback
,
},
);
```
同时,Service侧也需要在onConnect()时返回IRemoteObject,从而定义与Service进行通信的接口。onConnect()需要返回一个IRemoteObject对象,HarmonyOS提供了IRemoteObject的默认实现,用户可以通过继承rpc.RemoteObject来创建自定义的实现类。
Service侧把自身的实例返回给调用侧的代码示例如下:
```
javascript
import
rpc
from
"
@ohos.rpc
"
;
var
mMyStub
;
export
default
{
onStart
(
want
)
{
class
MyStub
extends
rpc
.
RemoteObject
{
constructor
(
des
)
{
if
(
typeof
des
===
'
string
'
)
{
super
(
des
,
des
.
length
);
}
return
null
;
}
onRemoteRequest
(
code
,
message
,
reply
,
option
)
{
}
}
mMyStub
=
new
MyStub
(
"
ServiceAbility-test
"
);
},
onCommand
(
want
,
restart
,
startId
)
{
console
.
log
(
'
SerivceAbility onCommand
'
);
},
onConnect
(
want
)
{
console
.
log
(
'
SerivceAbility OnConnect
'
);
return
mMyStub
;
},
onDisconnect
()
{
console
.
log
(
'
SerivceAbility OnDisConnect
'
);
},
onStop
()
{
console
.
log
(
'
SerivceAbility onStop
'
);
},
}
```
zh-cn/application-dev/quick-start/基于Native的DataAbility创建与访问.md
0 → 100644
浏览文件 @
8670efde
此差异已折叠。
点击以展开。
Miykael_xxm
🚴
@xiongjiamu
mentioned in commit
7b4a5b21
·
10月 01, 2021
mentioned in commit
7b4a5b21
mentioned in commit 7b4a5b2119bce1bc8d43214c0cf5cff99f269b35
开关提交列表
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录