Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
d2a43751
D
Docs
项目概览
OpenHarmony
/
Docs
接近 2 年 前同步成功
通知
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看板
未验证
提交
d2a43751
编写于
8月 25, 2023
作者:
O
openharmony_ci
提交者:
Gitee
8月 25, 2023
浏览文件
操作
浏览文件
下载
差异文件
!22750 资料新增
Merge pull request !22750 from Lotol/master
上级
b8092dcb
e2570607
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
205 addition
and
0 deletion
+205
-0
zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md
...plication-dev/reference/apis/js-apis-defaultAppManager.md
+205
-0
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-defaultAppManager.md
浏览文件 @
d2a43751
...
...
@@ -99,6 +99,39 @@ defaultAppMgr.isDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err,
});
```
## defaultAppMgr.isDefaultApplicationSync<sup>10+</sup>
isDefaultApplicationSync(type: string): boolean;
以同步方法根据系统已定义的应用类型判断当前应用是否是该应用类型的默认应用,使用boolean形式返回结果。
**系统能力:**
SystemCapability.BundleManager.BundleFramework.DefaultApp
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------| ------ | ---- | --------------------------------------- |
| type | string | 是 | 要查询的应用类型,取
[
ApplicationType
](
#defaultappmgrapplicationtype
)
中的值。 |
**返回值:**
| 类型 | 说明 |
| ------- | -------------------- |
| boolean | 返回当前应用是否是默认应用,true表示是默认应用,false表示不是默认应用。 |
**示例:**
```
ts
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
isDefaultApplicationSync
(
defaultAppMgr
.
ApplicationType
.
BROWSER
)
.
then
((
data
)
=>
{
console
.
info
(
'
Operation successful. IsDefaultApplicationSync ?
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
```
## defaultAppMgr.getDefaultApplication
getDefaultApplication(type: string, userId?: number): Promise
\<
BundleInfo>
...
...
@@ -255,6 +288,62 @@ defaultAppMgr.getDefaultApplication("image/png", (err, data) => {
});
```
## defaultAppMgr.getDefaultApplicationSync<sup>10+</sup>
getDefaultApplicationSync(type: string, userId?: number): BundleInfo;
以同步方法根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型获取默认应用信息,使用BundleInfo返回结果。
**需要权限:**
ohos.permission.GET_DEFAULT_APPLICATION
**系统能力:**
SystemCapability.BundleManager.BundleFramework.DefaultApp
**系统API:**
此接口为系统接口。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------| ------ | ---- | --------------------------------------- |
| type | string | 是 | 要查询的应用类型,取
[
ApplicationType
](
#defaultappmgrapplicationtype
)
中的值,或者符合媒体类型格式的文件类型。|
| userId | number | 否 | 用户ID。默认值:调用方所在用户。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------ | -------------------- |
|
[
BundleInfo
](
js-apis-bundle-BundleInfo.md
)
| 返回的默认应用包信息。|
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------------- |
| 17700004 | The specified user ID is not found. |
| 17700023 | The specified default app does not exist. |
| 17700025 | The specified type is invalid. |
**示例:**
```
ts
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
getDefaultApplicationSync
(
defaultAppMgr
.
ApplicationType
.
BROWSER
)
.
then
((
data
)
=>
{
console
.
info
(
'
Operation successful. bundleInfo:
'
+
JSON
.
stringify
(
data
));
})
.
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
defaultAppMgr
.
getDefaultApplicationSync
(
"
image/png
"
)
.
then
((
data
)
=>
{
console
.
info
(
'
Operation successful. bundleInfo:
'
+
JSON
.
stringify
(
data
));
})
.
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
```
## defaultAppMgr.setDefaultApplication
setDefaultApplication(type: string, elementName: ElementName, userId?: number): Promise
\<
void>
...
...
@@ -446,6 +535,72 @@ defaultAppMgr.setDefaultApplication("image/png", {
});
```
## defaultAppMgr.setDefaultApplicationSync<sup>10+</sup>
setDefaultApplicationSync(type: string, elementName: ElementName, userId?: number): void;
以同步方法根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型设置默认应用。
**需要权限:**
ohos.permission.SET_DEFAULT_APPLICATION
**系统能力:**
SystemCapability.BundleManager.BundleFramework.DefaultApp
**系统API:**
此接口为系统接口。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | --------------------------------------- |
| type | string | 是 | 要设置的应用类型,取
[
ApplicationType
](
#defaultappmgrapplicationtype
)
中的值,或者符合媒体类型格式的文件类型。|
| elementName |
[
ElementName
](
js-apis-bundle-ElementName.md
)
| 是 | 要设置为默认应用的组件信息。 |
| userId | number | 否 | 用户ID。默认值:调用方所在用户。 |
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------------- |
| 17700004 | The specified user ID is not found. |
| 17700025 | The specified type is invalid. |
| 17700028 | The specified ability does not match the type. |
**示例:**
```
ts
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
defaultAppMgr
.
setDefaultApplicationSync
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
{
bundleName
:
"
com.example.myapplication
"
,
moduleName
:
"
module01
"
,
abilityName
:
"
EntryAbility
"
}).
then
((
data
)
=>
{
console
.
info
(
'
Operation successful.
'
);
}).
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
let
userId
=
100
;
defaultAppMgr
.
setDefaultApplicationSync
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
{
bundleName
:
"
com.example.myapplication
"
,
moduleName
:
"
module01
"
,
abilityName
:
"
EntryAbility
"
},
userId
).
then
((
data
)
=>
{
console
.
info
(
'
Operation successful.
'
);
}).
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
defaultAppMgr
.
setDefaultApplicationSync
(
"
image/png
"
,
{
bundleName
:
"
com.example.myapplication
"
,
moduleName
:
"
module01
"
,
abilityName
:
"
EntryAbility
"
},
userId
).
then
((
data
)
=>
{
console
.
info
(
'
Operation successful.
'
);
}).
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
```
## defaultAppMgr.resetDefaultApplication
resetDefaultApplication(type: string, userId?: number): Promise
\<
void>
...
...
@@ -593,4 +748,54 @@ defaultAppMgr.resetDefaultApplication("image/png", (err, data) => {
}
console
.
info
(
'
Operation successful.
'
);
});
```
## defaultAppMgr.resetDefaultApplicationSync<sup>10+</sup>
resetDefaultApplicationSync(type: string, userId?: number): void;
以同步方法根据系统已定义的应用类型或者符合媒体类型格式(type/subtype)的文件类型重置默认应用。
**需要权限:**
ohos.permission.SET_DEFAULT_APPLICATION
**系统能力:**
SystemCapability.BundleManager.BundleFramework.DefaultApp
**系统API:**
此接口为系统接口。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | --------------------------------------- |
| type | string | 是 | 要重置的应用类型,取
[
ApplicationType
](
#defaultappmgrapplicationtype
)
中的值,或者符合媒体类型格式的文件类型。|
| userId | number | 否 | 用户ID。默认值:调用方所在用户。 |
**错误码:**
以下错误码的详细介绍请参见
[
ohos.bundle错误码
](
../errorcodes/errorcode-bundle.md
)
。
| 错误码ID | 错误信息 |
| -------- | ----------------------------------- |
| 17700004 | The specified user ID is not found. |
| 17700025 | The specified type is invalid. |
**示例:**
```
ts
import
defaultAppMgr
from
'
@ohos.bundle.defaultAppManager
'
;
let
userId
=
100
;
defaultAppMgr
.
resetDefaultApplicationSync
(
defaultAppMgr
.
ApplicationType
.
BROWSER
,
userId
)
.
then
((
data
)
=>
{
console
.
info
(
'
Operation successful.
'
);
})
.
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
defaultAppMgr
.
resetDefaultApplicationSync
(
"
image/png
"
,
userId
)
.
then
((
data
)
=>
{
console
.
info
(
'
Operation successful.
'
);
})
.
catch
((
error
)
=>
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
error
));
});
```
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录