HarmonyOS應用配置文件config.json
一個工程中的配置文件有兩種，一種是主模塊entry的配置文件config.json，另一種是應用程序環境的配置文件build.gradle。其中config.json至少有2個，一個位于entry下，另一個位于應用根目錄下。每增加一個feature模塊，也會相應增加一個build.gradle文件。
1.config.json
DevEco Studio提供了兩種編輯“config.json”文件的方式。在“config.json”的編輯窗口中，可在右上角切換代碼編輯視圖或可視化編輯視圖(如下圖所示)。
“config.json”由“app”、“deviceConfig”和“module”三個部分組成，各部分含義如下表所示。
(1)app屬性對象的內部結構說明如下：
bundleName: 表示應用的包名，用于標識應用的唯一性。包名是由字母、數字、下劃線(_)和點號(.)組成的字符串，必須以字母開頭。支持的字符串長度為7~127字節。通常采用反域名形式表示。
vendor: 表示對應用開發廠商的描述。字符串長度不超過255字節。
version: 表示應用的版本信息。
apiVersion：(可不設置)表示應用依賴的HarmonyOS的API版本。compatible表示應用運行需要的API最小版本。取值為大于零的整數。(一旦添加了APIVersion屬性，則該子屬性不可缺省)。target表示應用運行需要的API目標版本。取值為大于零的整數。可缺省。releaseType表示應用運行需要的API目標版本的類型。取值為“CanaryN”(受限發布的版本)、“BetaN”(公開發布的Beta版本)或者“Release”(公開發布的正式版本)，其中，N代表大于零的整數。
app屬性定義示例如下所示：
- "app": {
- "bundleName": "com.huawei.hiworld.example",
- "vendor": "huawei",
- "version": {
- "code": 2,
- "name": "2.0"
- },
- "apiVersion": {
- "compatible": 3,
- "target": 3,
- "releaseType": "Beta1"
- }
- }
(2)deviceConfig屬性對象設置包含在具體設備上的應用配置信息，可以包含default、phone、tablet、tv、car、wearable、liteWearable和smartVision等屬性。default標簽內的配置是適用于所有設備通用，其他設備類型如果有特殊的需求，則需要在該設備類型的標簽下通過default(所有設備)、phone(手機)、tablet(平板)、tv(智慧屏)、car(車機)、wearable(智能穿戴設備)、liteWearable(輕量級智能穿戴設備)和smartVision(智能攝像頭)等子屬性對象進行配置。如果沒有對設備的特殊需求，可以設置該屬性對象為空，即"deviceConfig": {}。deviceConfig屬性對象的內部屬性結構說明如下：
default、phone、tablet、tv、car、wearable、liteWearable和smartVision等對象的內部結構說明如下所示：
其中network對象的內部屬性結構說明如下：
securityConfig對象的內部屬性結構說明如下：
deviceConfig屬性定義示例如下所示，該示例中主要對應用的進程名、是否支持備份、網絡安全進行配置。
- "deviceConfig": {
- "default": {
- "process": "com.huawei.hiworld.example",
- "supportBackup": false,
- "network": {
- "cleartextTraffic": true,
- "securityConfig": {
- "domainSettings": {
- "cleartextPermitted": true,
- "domains": [
- {
- "subdomains": true,
- "name": "example.ohos.com"
- }
- ]
- }
- }
- }
- }
- }
(3)module屬性對象包含HAP包的配置信息，其常用子屬性對象及含義說明如下：
1)mainAbility: 表示HAP包的入口ability名稱。
2)package: 表示HAP的包結構名稱，在應用內應保證唯一性。反向域名格式。
3)name: 表示HAP的類名。采用反向域名方式表示，前綴需要與同級的package標簽指定的包名一致，也可采用“.”開頭的命名方式。字符串長度不超過255字節。
4)description: 表示HAP的描述信息。字符串長度不超過255字節。如果字符串超出長度或者需要支持多語言，可以采用資源索引的方式添加描述內容。
5)supportedModes: 表示應用支持的運行模式。當前只定義了駕駛模式(drive)。該標簽僅適用于車機。
6)deviceType: 表示允許Ability運行的設備類型。系統預定義的設備類型包括：phone(手機)、tablet(平板)、tv(智慧屏)、car(車機)、wearable(智能穿戴)、liteWearable(輕量級智能穿戴)等。
7)distro: 表示HAP發布的具體描述。
deliveryWithInstall:表示當前HAP是否支持隨應用安裝。true：支持隨應用安裝。false：不支持隨應用安裝(可能導致最終應用上架應用市場異常)。
moduleName: 表示當前HAP的名稱。
moduleType: 表示當前HAP的類型，包括兩種類型：entry和feature。
8)abilities: 表示當前模塊內的所有Ability的配置信息。采用對象數組格式，其中每個元素表示一個Ability對象。其內部子屬性說明如下：
name：表示Ability名稱。取值可采用反向域名方式表示，由包名和類名組成。
description：表示對Ability的描述。取值可以是描述性內容，也可以是對描述性內容的資源索引，以支持多語言。
icon：表示Ability圖標資源文件的索引。如果在該Ability的“skills”屬性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，則該Ability的icon將同時作為應用的icon。如果存在多個符合條件的Ability，則取位置靠前的Ability的icon作為應用的icon。
label：表示Ability對用戶顯示的名稱。取值可以是Ability名稱，也可以是對該名稱的資源索引，以支持多語言。如果在該Ability的“skills”屬性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，則該Ability的label將同時作為應用的label。如果存在多個符合條件的Ability，則取位置靠前的Ability的label作為應用的label。
uri：表示Ability的統一資源標識符。格式為：
launchType：表示Ability的啟動模式，支持“standard”、“singleMission”和“singleton”三種模式：
standard：表示該Ability可以有多實例。“standard”模式適用于大多數應用場景。
singleMission：表示此Ability在每個任務棧中只能有一個實例。
singleton：表示該Ability在所有任務棧中僅可以有一個實例。例如，具有全局唯一性的呼叫來電界面即采用“singleton”模式。
shortcuts: (可缺省)表示應用的快捷方式信息。采用對象數組格式，其中的每個元素表示一個快捷方式對象。
visible：表示Ability是否可以被其他應用調用。
true：可以被其他應用調用。
false：不能被其他應用調用。
permissions：表示其他應用的Ability調用此Ability時需要申請的權限。通常采用反向域名格式，取值可以是系統預定義的權限，也可以是開發者自定義的權限。如果是自定義權限，取值必須與“defPermissions”標簽中定義的某個權限的“name”標簽值一致。
skills：表示Ability能夠接收的Intent的特征。
deviceCapability：表示Ability運行時要求設備具有的能力，采用字符串數組的格式表示。
metaData：表示Ability的元信息。
調用Ability時調用參數的元信息，例如：參數個數和類型。
Ability執行完畢返回值的元信息，例如：返回值個數和類型。
type：表示Ability的類型。取值范圍如下：
page：表示基于Page模板開發的FA，用于提供與用戶交互的能力。
service：表示基于Service模板開發的PA，用于提供后臺運行任務的能力。
data：表示基于Data模板開發的PA，用于對外部提供統一的數據訪問抽象。
CA：表示支持其他應用以窗口方式調起該Ability。
orientation：示該Ability的顯示模式。該標簽僅適用于page類型的Ability。取值范圍如下：
unspecified：由系統自動判斷顯示方向。
landscape：橫屏模式。
portrait：豎屏模式。
followRecent：跟隨棧中最近的應用。
backgroundModes：表示后臺服務的類型，可以為一個服務配置多個后臺服務類型。該標簽僅適用于service類型的Ability。取值范圍如下：
dataTransfer：通過網絡/對端設備進行數據下載、備份、分享、傳輸等業務。
audioPlayback：音頻輸出業務。
audioRecording：音頻輸入業務。
pictureInPicture：畫中畫、小窗口播放視頻業務。
voip：音視頻電話、VOIP業務。
location：定位、導航業務。
bluetoothInteraction：藍牙掃描、連接、傳輸業務。
wifiInteraction：WLAN掃描、連接、傳輸業務。
screenFetch：錄屏、截屏業務。
multiDeviceConnection：多設備互聯業務。
readPermission：表示讀取Ability的數據所需的權限。該標簽僅適用于data類型的Ability。取值為長度不超過255字節的字符串。
writePermission：表示向Ability寫數據所需的權限。該標簽僅適用于data類型的Ability。取值為長度不超過255字節的字符串。
mission：表示Ability指定的任務棧。該標簽僅適用于page類型的Ability。默認情況下應用中所有Ability同屬一個任務棧。
targetAbility：表示當前Ability重用的目標Ability。該標簽僅適用于page類型的Ability。如果配置了targetAbility屬性，則當前Ability(即別名Ability)的屬性中僅name、icon、label、visible、permissions、skills生效，其它屬性均沿用targetAbility中的屬性值。目標Ability必須與別名Ability在同一應用中，且在配置文件中目標Ability必須在別名之前進行聲明。
multiUserShared：表示Ability是否支持多用戶狀態進行共享，該標簽僅適用于data類型的Ability。配置為“true”時，表示在多用戶下只有一份存儲數據。需要注意的是，該屬性會使visible屬性失效。
supportPipMode：表示Ability是否支持用戶進入PIP模式(用于在頁面最上層懸浮小窗口，俗稱“畫中畫”，常見于視頻播放等場景)。該標簽僅適用于page類型的Ability。
formsEnabled：表示Ability是否支持卡片(forms)功能。該標簽僅適用于page類型的Ability。
true：支持卡片能力。
false：不支持卡片能力。
resizeable：表示Ability是否支持多窗口特性。
forms：表示服務卡片的屬性。該標簽僅當“formsEnabled”為“true”時，才能生效。該屬性有一系列子屬性詳細設置卡片的類型、主題樣式、外觀規格等;
9)js: (可缺省)表示基于JS UI框架開發的JS模塊集合，其中的每個元素代表一個JS模塊的信息。
10)reqPermissions: 表示應用運行時向系統申請的權限。
11)defPermissions: 表示應用定義的權限。應用調用者必須申請這些權限，才能正常調用該應用。
12)colorMode:表示應用自身的顏色模式。
dark：表示按照深色模式選取資源。
light：表示按照淺色模式選取資源。
auto：表示跟隨系統的顏色模式值選取資源。
module屬性對象定義示例如下所示：
- "module": {
- "mainAbility": "MainAbility",
- "package": "com.example.myapplication.entry",
- "name": ".MyOHOSAbilityPackage",
- "description": "$string:description_application",
- "supportedModes": [
- "drive"
- ],
- "deviceType": [
- "car"
- ],
- "distro": {
- "deliveryWithInstall": true,
- "moduleName": "ohos_entry",
- "moduleType": "entry"
- },
- "abilities": [
- ...
- ],
- "shortcuts": [
- ...
- ],
- "js": [
- ...
- ],
- "reqPermissions": [
- ...
- ],
- "defPermissions": [
- ...
- ],
- "colorMode": "light"
- }
