Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
fed5d834
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看板
提交
fed5d834
编写于
5月 27, 2023
作者:
T
taiyi.pei
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add canIUse docs.
Signed-off-by:
N
taiyi.pei
<
peitaiyi@huawei.com
>
上级
4a141a3a
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
84 addition
and
23 deletion
+84
-23
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+1
-0
zh-cn/application-dev/reference/apis/js-apis-syscap.md
zh-cn/application-dev/reference/apis/js-apis-syscap.md
+42
-0
zh-cn/application-dev/reference/syscap.md
zh-cn/application-dev/reference/syscap.md
+41
-23
未找到文件。
zh-cn/application-dev/reference/apis/Readme-CN.md
100755 → 100644
浏览文件 @
fed5d834
...
...
@@ -336,6 +336,7 @@
-
[
@ohos.web.webview (Webview)
](
js-apis-webview.md
)
-
[
console (控制台)
](
js-apis-logs.md
)
-
[
Timer (定时器)
](
js-apis-timer.md
)
-
[
syscap (系统能力)
](
js-apis-syscap.md
)
-
application
-
[
AccessibilityExtensionContext (辅助功能扩展上下文)
](
js-apis-inner-application-accessibilityExtensionContext.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-syscap.md
0 → 100644
浏览文件 @
fed5d834
# SysCap (系统能力)
系统能力(SystemCapability,简称SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。
> **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## canIUse
canIUse(syscap: string): boolean
查询系统是否具备某个系统能力。
**系统能力:**
SystemCapability.ArkUI.ArkUI.Full
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| syscap | string | 是 | 待查询的系统能力名称。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| boolean | 系统能力查询结果,true表示系统具备该能力,false表示系统不具备。 |
**示例:**
```
js
import
geolocation
from
'
@ohos.geolocation
'
const
isLocationAvailable
=
canIUse
(
'
SystemCapability.Location.Location
'
);
if
(
isLocationAvailable
)
{
geolocation
.
getCurrentLocation
((
location
)
=>
{
console
.
log
(
location
.
latitude
,
location
.
longitue
);
});
}
else
{
console
.
log
(
'
Location not by this device.
'
)
}
```
\ No newline at end of file
zh-cn/application-dev/reference/syscap.md
浏览文件 @
fed5d834
...
...
@@ -93,29 +93,47 @@ DevEco Studio会根据创建的工程所支持的设置自动配置联想能力
### 判断 API 是否可以使用
-
方法1:OpenHarmony定义了API canIUse帮助开发者来判断该设备是否支持某个特定的syscap。
```
ts
if
(
canIUse
(
"
SystemCapability.ArkUI.ArkUI.Full
"
))
{
console
.
log
(
"
该设备支持SystemCapability.ArkUI.ArkUI.Full
"
);
}
else
{
console
.
log
(
"
该设备不支持SystemCapability.ArkUI.ArkUI.Full
"
);
}
```
-
方法2:开发者可通过import的方式将模块导入,若当前设备不支持该模块,import的结果为undefined,开发者在使用其API时,需要判断其是否存在。
```
ts
import
geolocation
from
'
@ohos.geolocation
'
;
if
(
geolocation
)
{
geolocation
.
getCurrentLocation
((
location
)
=>
{
console
.
log
(
location
.
latitude
,
location
.
longitude
);
});
}
else
{
console
.
log
(
'
该设备不支持位置信息
'
)
;
}
```
-
JS API
方法1:OpenHarmony定义了API canIUse帮助开发者来判断该设备是否支持某个特定的syscap。
```
ts
if
(
canIUse
(
"
SystemCapability.ArkUI.ArkUI.Full
"
))
{
console
.
log
(
"
该设备支持SystemCapability.ArkUI.ArkUI.Full
"
);
}
else
{
console
.
log
(
"
该设备不支持SystemCapability.ArkUI.ArkUI.Full
"
);
}
```
方法2:开发者可通过import的方式将模块导入,若当前设备不支持该模块,import的结果为undefined,开发者在使用其API时,需要判断其是否存在。
```
ts
import
geolocation
from
'
@ohos.geolocation
'
;
if
(
geolocation
)
{
geolocation
.
getCurrentLocation
((
location
)
=>
{
console
.
log
(
location
.
latitude
,
location
.
longitude
);
});
}
else
{
console
.
log
(
'
该设备不支持位置信息
'
)
;
}
```
-
Native API
```
c
#include <stdio.h>
#include <stdlib.h>
#include "syscap_ndk.h"
char
syscap
[]
=
"SystemCapability.ArkUI.ArkUI.Full"
;
bool
result
=
canIUse
(
syscap
);
if
(
result
)
{
printf
(
"SysCap: %s is supported!
\n
"
,
syscap
);
}
else
{
printf
(
"SysCap: %s is not supported!
\n
"
,
syscap
);
}
```
除此之外,开发者可以通过API参考文档查询API接口所属的SysCap。
### 不同设备相同能力的差异检查
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录