功能開發的一多能力介紹

應用開發至少包含兩部分工作： UI頁面開發和底層功能開發（部分需要聯網的應用還會涉及服務端開發）。前面章節介紹了如何解決頁面適配的問題，本章節主要介紹應用如何解決設備系統能力差異的兼容問題。

系統能力

[系統能力]（即SystemCapability，縮寫為SysCap）指操作系統中每一個相對獨立的特性，如藍牙，WIFI，NFC，攝像頭等，都是系統能力之一。每個系統能力對應多個API，隨著目標設備是否支持該系統能力共同存在或消失。

與系統能力相關的，有支持能力集、聯想能力集和要求能力集三個核心概念。

支持能力集 ：設備具備的系統能力集合，在設備配置文件中配置。
要求能力集 ：應用需要的系統能力集合，在應用配置文件中配置。
聯想能力集 ：開發應用時IDE可聯想的API所在的系統能力集合，在應用配置文件中配置。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
只有當應用要求能力集是設備支持能力集的子集的時候，應用才可以在該設備上分發、安裝和運行。
可以訪問[系統能力列表]了解全量的系統能力。
支持的設備類型分為兩大類：典型設備和廠商自定義設備。默認設備、平板等常用的設備類型屬于典型設備，其它的屬于廠商自定義設備。對于典型設備，系統已經預定義了相應的系統能力集合；對于廠商自定義設備，需要廠商給出其系統能力集合的定義。

設備要求能力集的獲取及導入

對于廠商自定義設備，需要開發者自行從廠商處獲取該設備的要求能力集并導入到IDE中。

在IDE中點擊File->New->Import...后選擇“Import Product Compatibility ID”即可選擇及導入設備要求能力集，導入后的設備要求能力集會被寫入工程的syscap.json文件中。

20230920-103626

多設備應用開發

開發多設備應用時，工程中默認的要求能力集是多個設備支持能力集的交集，默認的聯想能力集是多個設備支持能力集的并集。

開發者可以在運行時動態判斷某設備是否支持特定的系統能力。
開發者可以自行修改聯想能力集和要求能力集。

動態邏輯判斷

如果某個系統能力沒有寫入應用的要求能力集中，那么在使用前需要判斷設備是否支持該系統能力。

方法1：canIUse接口幫助開發者來判斷該設備是否支持某個特定的syscap。

if (canIUse("SystemCapability.Communication.NFC.Core")) {
   console.log("該設備支持SystemCapability.Communication.NFC.Core");
} else {
   console.log("該設備不支持SystemCapability.Communication.NFC.Core");
}

方法2：開發者可通過import的方式將模塊導入，若當前設備不支持該模塊，import的結果為undefined，開發者在使用其API時，需要判斷其是否存在。

import controller from '@ohos.nfc.controller';
try {
    controller.enableNfc();
    console.log("controller enableNfc success");
} catch (busiError) {
    console.log("controller enableNfc busiError: " + busiError);
}

說明：
如果某系統能力是應用運行必須的，則要將其寫入到應用的要求能力集中，以確保應用不會分發和安裝到不符合要求的設備上。
如果某系統能力不是應用運行必須的，則可以在運行時做動態判斷，這樣可以最大程度擴大應用的適用范圍。

配置聯想能力集和要求能力集

IDE會根據創建的工程所支持的設備自動配置聯想能力集和要求能力集，同時也支持開發者修改。

// syscap.json
{
	"devices": {
		"general": [            // 每一個典型設備對應一個syscap支持能力集，可配置多個典型設備
			"default",
			"tablet"
		],
		"custom": [             // 廠家自定義設備
			{
				"某自定義設備": [
					"SystemCapability.Communication.SoftBus.Core"
				]
			}
		]
	},
	"development": {             // addedSysCaps內的sycap集合與devices中配置的各設備支持的syscap集合的并集共同構成聯想能力集
		"addedSysCaps": [
			"SystemCapability.Communication.NFC.Core"
		]
	},
	"production": {              // 用于生成rpcid，慎重添加，可能導致應用無法分發到目標設備上
		"addedSysCaps": [],      // devices中配置的各設備支持的syscap集合的交集，添加addedSysCaps集合再除去removedSysCaps集合，共同構成要求能力集
		"removedSysCaps": []     // 當該要求能力集為某設備的子集時，應用才可被分發到該設備上
	}
}

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`