未验证 提交 f0e69ce9 编写于 作者: Z zengyawen 提交者: Gitee

修改 syscap 文档

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>
上级 06596530
......@@ -37,6 +37,6 @@ if (isLocationAvailable) {
console.log(location.latitude, location.longitue);
});
} else {
console.log('Location not by this device.')
console.log('Location not by this device.');
}
```
\ No newline at end of file
......@@ -21,6 +21,7 @@
- [HuksKeyApi](_huks_key_api.md)
- [HuksParamSetApi](_huks_param_set_api.md)
- [HuksTypeApi](_huks_type_api.md)
- [Init](init.md)
- 头文件
- [drawing_bitmap.h](drawing__bitmap_8h.md)
- [drawing_brush.h](drawing__brush_8h.md)
......@@ -62,6 +63,7 @@
- [native_huks_api.h](native__huks__api_8h.md)
- [native_huks_param.h](native__huks__param_8h.md)
- [native_huks_type.h](native__huks__type_8h.md)
- [syscap_ndk.h](syscap__ndk_8h.md)
- 结构体
- [OH_Drawing_BitmapFormat](_o_h___drawing___bitmap_format.md)
- [OH_NativeBuffer_Config](_o_h___native_buffer___config.md)
......
# Init
## 概述
提供系统能力查询接口。
通过读取系统能力参数文件,返回指定的某个系统能力是否被支持。
**起始版本:**
8
## 汇总
### 文件
| 名称 | 描述 |
| -------- | -------- |
| [syscap_ndk.h](syscap__ndk_8h.md) | 查询单个系统能力是否被支持的API。 |
### 函数
| 名称 | 描述 |
| -------- | -------- |
| [canIUse](#caniuse) (const char \*cap) | 查询指定的系统能力是否被支持。 系统能力(SystemCapability,简称SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。 |
## 函数说明
### canIUse()
```
bool canIUse (const char * cap)
```
**描述:**
查询指定的系统能力是否被支持。 系统能力(SystemCapability,简称SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。
**参数:**
| 名称 | 描述 |
| -------- | -------- |
| cap | 待查询的系统能力名称。 |
**返回:**
系统能力查询结果,true表示系统具备该能力,false表示系统不具备。
# syscap_ndk.h
## 概述
查询单个系统能力是否被支持的API。
**起始版本:**
8
**相关模块:**
[Init](init.md)
## 汇总
### 函数
| 名称 | 描述 |
| -------- | -------- |
| [canIUse](init.md#caniuse) (const char \*cap) | 查询指定的系统能力是否被支持。 <br>系统能力(SystemCapability,简称SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。 |
......@@ -93,31 +93,33 @@ DevEco Studio会根据创建的工程所支持的设置自动配置联想能力
### 判断 API 是否可以使用
- JS API
当前提供了ArtTS API和Native API用于帮助判断某个API是否可以使用。
方法1:OpenHarmony定义了API canIUse帮助开发者来判断该设备是否支持某个特定的syscap。
- ArkTS API
```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时,需要判断其是否存在。
- 方法1:OpenHarmony定义了API canIUse帮助开发者来判断该设备是否支持某个特定的syscap。
```ts
import geolocation from '@ohos.geolocation';
if (geolocation) {
geolocation.getCurrentLocation((location) => {
console.log(location.latitude, location.longitude);
});
} else {
console.log('该设备不支持位置信息')
}
```
```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
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册