• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 功能开发的一多能力介绍
2
3
4应用开发至少包含两部分工作：UI页面开发和底层功能开发（部分需要联网的应用还会涉及服务端开发）。如“打开设备NFC”功能，除了开发页面，还需要调用系统API开启NFC。前面章节主要介绍了如何解决页面适配的问题，本章节主要介绍应用如何解决设备系统能力差异的兼容问题。
5
6
7我们以一个简单例子说明：一个具有NFC功能的应用，如何兼容运行在有NFC和无NFC系统能力的设备上。
8
9
10应用从开发到用户可以使用，一般要经历几个阶段：应用分发和下载->应用安装->应用运行，要解决上面提到的兼容问题，一般有如下几种解决思路：
11
12
131. 分发和下载：有NFC设备的用户才能在应用市场可见该应用，提供用户下载能力。
14
152. 安装：有NFC能力的设备才允许安装该应用。
16
173. 运行：在运行阶段通过动态判断方式，在NFC设备上功能运行正常，在无NFC设备上运行不发生Crash。
18
19
20所以，对应的解决方案就有：
21
22
231. 在分发阶段，核心分发逻辑：上架的应用使用的系统能力是设备系统能力的子集。满足这个条件，用户才能在应用市场看到该应用。
24
252. 在安装阶段，核心安装逻辑：安装的应用调用的系统能力是设备系统能力的子集。满足这个条件，用户才能安装该应用。
26
273. If/Else的动态逻辑判断。伪代码简单示例如下：
28
29   ```
30   if (该设备有系统能力1) {
31       运行系统能力1相关的代码;
32   } else {
33       提示用户该设备不支持;
34   }
35   ```
36
37
38OpenHarmony支持的设备类型分为两大类：
39
40
411. 典型设备类型，如默认设备、平板等。系统已经定义好了这些设备的系统能力集合，对应用开发者来说，只需要感知在IDE中创建Module时设备类型的选择，如下图所示：
42   ![zh-cn_image_0000001267573986](figures/zh-cn_image_0000001267573986.png)
43
44   或者module.json文件中的deviceTypes，如下图所示：
45
46   ![zh-cn_image_0000001266934142](figures/zh-cn_image_0000001266934142.png)
47
48   简单来说，应用开发者基于典型设备类型的应用开发，仅需选择设备类型，系统完成分发或者安装的匹配逻辑。
49
502. 厂家自定义设备类型。由于厂家提供的系统能力千差万别，OpenHarmony允许厂家自己自定义设备的系统能力，但需要通过标准的格式形成一个ID，称为PCID（产品兼容性标识，Product Compatibility ID），并对外发布这个PCID，一般通过设备认证中心发布。应用开发者如果希望应用可以分发和安装到厂家自定义的设备上，就必须拿到对应的自定义设备PCID，否则就无法声明应用使用或调用的系统能力集（也是通过一个ID表示，称为RPCID，英文全名：Required Product Compatibility ID，中文名：要求的产品兼容性标识）。
51
52
53鉴于当前OpenHarmony版本还不具备设备认证中心，本章节仅讨论典型设备类型下多设备应用开发的场景。
54
55
56## 编码时的API联想
57
58IDE中提供了API的联想功能，方便开发者使用系统能力。当开发者选择多个设备类型时，API的联想范围就是选择类型设备提供的API的并集，如同时支撑默认设备和平板，API的联想范围就是默认设备和平板支持的API的并集。API的联想效果如下：
59
60![Video_20220408101413](figures/Video_20220408101413.gif)
61
62
63## 动态逻辑判断
64
65开发者可以通过canIUse接口，判断目标设备是否支持某系统能力，进而执行不同的业务逻辑。
66
67
68```
69import geolocation from'@ohos.geolocation';
70
71@Entry
72@Component
73struct Index {
74  @State message: string = 'unknown';
75  aboutToAppear() {
76    if (canIUse('SystemCapability.Location.Location')) {
77      geolocation.getCurrentLocation().then((location) => {
78        this.message = 'current location: ' + JSON.stringify(location)
79      })
80    } else {
81      this.message = 'This device does not have the ability to get location.'
82    }
83  }
84
85  build() {
86    Row() {
87      Text(this.message).fontSize(24)
88    }
89    .justifyContent(FlexAlign.Center)
90    .width('100%')
91    .height('100%')
92  }
93}
94```
95
96> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
97> 开发者通过 import 方式导入的模块，若当前设备不支持该模块，import 的结果为 undefined。故开发者在使用 API 时，需要判断其是否存在。
98