1# 功能开发的一多能力介绍
2应用开发至少包含两部分工作： UI页面开发和底层功能开发（部分需要联网的应用还会涉及服务端开发）。前面章节介绍了如何解决页面适配的问题，本章节主要介绍应用如何解决设备系统能力差异的兼容问题。
3
4## 系统能力
5
6<!--RP1-->
7[系统能力](../../reference/syscap.md)<!--RP1End-->（即SystemCapability，缩写为SysCap）指操作系统中每一个相对独立的特性，如蓝牙，WIFI，NFC，摄像头等，都是系统能力之一。每个系统能力对应多个API，随着目标设备是否支持该系统能力共同存在或消失。
8
9与系统能力相关的，有支持能力集、联想能力集和要求能力集三个核心概念。
10
11- **支持能力集**：设备具备的系统能力集合，在设备配置文件中配置。
12- **要求能力集**：应用需要的系统能力集合，在应用配置文件中配置。
13- **联想能力集**：开发应用时DevEco Studio可联想的API所在的系统能力集合，在应用配置文件中配置。
14
15>  **说明：**
16>
17>  - 只有当应用要求能力集是设备支持能力集的子集的时候，应用才可以在该设备上分发、安装和运行。
18>  - 可以访问<!--RP2-->[系统能力列表](../../reference/syscap-list.md)<!--RP2End-->了解全量的系统能力。<!--Del-->
19>  - 支持的设备类型分为两大类： 典型设备和厂商自定义设备。默认设备、平板等常用的设备类型属于典型设备，其它的属于厂商自定义设备。对于典型设备，系统已经预定义了相应的系统能力集合；对于厂商自定义设备，需要厂商给出其系统能力集合的定义。<!--DelEnd-->
20
21<!--Del-->
22## 设备要求能力集的获取及导入
23
24对于厂商自定义设备，需要开发者自行从厂商处获取该设备的要求能力集并导入到DevEco Studio中。
25
26在DevEco Studio中点击File->New->Import...后选择“Import Product Compatibility ID”即可选择及导入设备要求能力集，导入后的设备要求能力集会被写入工程的syscap.json文件中。
27
28![20230920-103626](figures/20230920-103626.gif)
29<!--DelEnd-->
30
31## 多设备应用开发
32开发多设备应用时，工程中默认的要求能力集是多个设备支持能力集的交集，默认的联想能力集是多个设备支持能力集的并集。
33
34- 开发者可以在运行时动态判断某设备是否支持特定的系统能力。
35
36- 开发者可以自行修改联想能力集和要求能力集。
37
38**动态逻辑判断**
39
40如果某个系统能力没有写入应用的要求能力集中，那么在使用前需要判断设备是否支持该系统能力。
41
42- 方法1：canIUse接口帮助开发者来判断该设备是否支持某个特定的syscap。
43
44  ```ts
45  if (canIUse("SystemCapability.Communication.NFC.Core")) {
46     console.log("该设备支持SystemCapability.Communication.NFC.Core");
47  } else {
48     console.log("该设备不支持SystemCapability.Communication.NFC.Core");
49  }
50  ```
51
52
53- 方法2：开发者可通过import的方式将模块导入，若当前设备不支持该模块，import的结果为undefined，开发者在使用其API时，需要判断其是否存在。
54
55  ```ts
56  import { nfcController } from '@kit.ConnectivityKit';
57  try {
58      nfcController.enableNfc();
59      console.log("nfcController enableNfc success");
60  } catch (busiError) {
61      console.log("nfcController enableNfc busiError: " + busiError);
62  }
63  ```
64
65> **说明：**
66>
67> - 如果某系统能力是应用运行必须的，则要将其写入到应用的要求能力集中，以确保应用不会分发和安装到不符合要求的设备上。
68> - 如果某系统能力不是应用运行必须的，则可以在运行时做动态判断，这样可以最大程度扩大应用的适用范围。
69
70**配置联想能力集和要求能力集**
71
72DevEco Studio会根据创建的工程所支持的设备自动配置联想能力集和要求能力集，同时也支持开发者修改。
73
74```json
75// syscap.json
76{
77	"devices": {
78		"general": [            // 每一个典型设备对应一个syscap支持能力集，可配置多个典型设备
79			"default",
80			"tablet"
81		],
82		"custom": [             // 厂家自定义设备
83			{
84				"某自定义设备": [
85					"SystemCapability.Communication.SoftBus.Core"
86				]
87			}
88		]
89	},
90	"development": {             // addedSysCaps内的sycap集合与devices中配置的各设备支持的syscap集合的并集共同构成联想能力集
91		"addedSysCaps": [
92			"SystemCapability.Communication.NFC.Core"
93		]
94	},
95	"production": {              // 用于生成rpcid，慎重添加，可能导致应用无法分发到目标设备上
96		"addedSysCaps": [],      // devices中配置的各设备支持的syscap集合的交集，添加addedSysCaps集合再除去removedSysCaps集合，共同构成要求能力集
97		"removedSysCaps": []     // 当该要求能力集为某设备的子集时，应用才可被分发到该设备上
98	}
99}
100```
101
102> **说明：**
103>
104> - 对于要求能力集，开发者修改时要十分慎重，修改不当会导致应用无法分发和安装到目标设备上。
105> - 对于联想能力集，通过增加系统能力可以扩大DevEco Studio可联想的API范围。但要注意这些API可能在某些设备上不支持，使用前需要判断。
106
107## 总结
108
109从应用开发到用户使用，通常要经历应用分发和下载、应用安装、应用运行等环节。借助SysCap机制，可以在各个环节中加以拦截或管控，保证应用可以在设备上正常安装和使用。
110
111- 应用分发和下载：只有当应用要求能力集是设备支持能力集的子集时（即设备满足应用运行要求），应用才可以分发到该设备。
112- 应用安装：只有当应用要求能力集是设备支持能力集的子集时，应用才可以安装到该设备。
113- 应用运行：应用在使用要求能力集之外的能力前，需要动态判断相应系统能力的有效性，防止崩溃或功能异常等问题。
114
115SysCap机制可以帮助开发者仅关注设备的系统能力，而不用考虑成百上千种具体的设备类型，降低多设备应用开发难度。
116