建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OS配置文件的元素
此部分提供“config.json”文件中所有屬性的詳細(xì)解釋。
配置文件的內(nèi)部結(jié)構(gòu)
應(yīng)用的配置文件“config.json”中由“app”、“deviceConfig”和“module”三個部分組成，缺一不可。配置文件的內(nèi)部結(jié)構(gòu)說明參見表1。
表1 配置文件的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
| [app] | 表示應(yīng)用的全局配置信息。同一個應(yīng)用的不同 HAP 包的“app”配置必須保持一致。 | 對象 | 否 |
| [deviceConfig] | 表示應(yīng)用在具體設(shè)備上的配置信息。 | 對象 | 否 |
| [module] | 表示 HAP 包的配置信息。該標(biāo)簽下的配置只對當(dāng)前 HAP 包生效。 | 對象 | 否 |
app對象的內(nèi)部結(jié)構(gòu)
app對象包含應(yīng)用的全局配置信息，內(nèi)部結(jié)構(gòu)說明參見表2。
表2 app對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 子屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|---|
bundleName | - | 表示應(yīng)用的包名，用于標(biāo)識應(yīng)用的唯一性。采用反域名形式的字符串表示（例如，com.huawei.himusic）。建議第一級為域名后綴“com”，第二級為廠商/個人名，第三級為應(yīng)用名，也可以采用多級。支持的字符串長度為7~127字節(jié)。 | 字符串 | 否 |
vendor | - | 表示對應(yīng)用開發(fā)廠商的描述。字符串長度不超過255字節(jié)。 | 字符串 | 可缺省，缺省值為空。 |
version | - | 表示應(yīng)用的版本信息。 | 對象 | 否 |
code | 表示應(yīng)用的版本號，僅用于 HarmonyOS 管理該應(yīng)用，對用戶不可見。取值為大于零的整數(shù)。 | 數(shù)值 | 否 | |
name | 表示應(yīng)用的版本號，用于向用戶呈現(xiàn)。取值可以自定義。 | 字符串 | 否 | |
apiVersion | - | 表示應(yīng)用依賴的 HarmonyOS 的 API 版本。 | 對象 | 否 |
compatible | 表示應(yīng)用運(yùn)行需要的API最小版本。取值為大于零的整數(shù)。 | 數(shù)值 | 否 | |
target | 表示應(yīng)用運(yùn)行需要的 API 目標(biāo)版本。取值為大于零的整數(shù)。 | 數(shù)值 | 可缺省，缺省值為應(yīng)用所在設(shè)備的當(dāng)前 API 版本。 |
app示例：
"app": {
"bundleName": "com.huawei.hiworld.example",
"vendor": "huawei",
"version": {
"code": 2,
"name": "2.0"
}
"apiVersion": {
"compatible": 3,
"target": 3
}
}deviceConfig對象的內(nèi)部結(jié)構(gòu)
deviceConfig包含在具體設(shè)備上的應(yīng)用配置信息，可以包含default、car、tv、wearable、liteWearable、smartVision等屬性。default標(biāo)簽內(nèi)的配置是適用于所有設(shè)備通用，其他設(shè)備類型如果有特殊的需求，則需要在該設(shè)備類型的標(biāo)簽下進(jìn)行配置。內(nèi)部結(jié)構(gòu)說明參見表3。
表3 deviceConfig對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
default | 表示所有設(shè)備通用的應(yīng)用配置信息。 | 對象 | 否 |
car | 表示車機(jī)特有的應(yīng)用配置信息。 | 對象 | 可缺省，缺省為空。 |
tv | 表示智慧屏特有的應(yīng)用配置信息。 | 對象 | 可缺省，缺省為空。 |
wearable | 表示智能穿戴特有的應(yīng)用配置信息。 | 對象 | 可缺省，缺省為空。 |
liteWearable | 表示輕量級智能穿戴特有的應(yīng)用配置信息。 | 對象 | 可缺省，缺省為空。 |
smartVision | 表示智能攝像頭特有的應(yīng)用配置信息。 | 對象 | 可缺省，缺省為空。 |
default、car、tv、wearable、liteWearable、smartVision等對象的內(nèi)部結(jié)構(gòu)說明，可參見表4。
表4 default/car/tv/wearable等對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
process | 表示應(yīng)用或者 Ability 的進(jìn)程名。如果在“deviceConfig”標(biāo)簽下配置了“process”標(biāo)簽，則該應(yīng)用的所有 Ability 都運(yùn)行在這個進(jìn)程中。 如果在“abilities”標(biāo)簽下也為某個 Ability 配置了“process”標(biāo)簽，則該 Ability 就運(yùn)行在這個進(jìn)程中。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 可缺省，缺省為應(yīng)用的軟件包名。 |
directLaunch | 表示應(yīng)用是否支持在設(shè)備未解鎖狀態(tài)直接啟動。如果配置為“true”，則表示應(yīng)用支持在設(shè)備未解鎖狀態(tài)下啟動。使用場景舉例：應(yīng)用支持在設(shè)備未解鎖情況下接聽來電。 該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 布爾類型 | 可缺省，缺省為false。 |
supportBackup | 表示應(yīng)用是否支持備份和恢復(fù)。如果配置為“false”，則不支持為該應(yīng)用執(zhí)行備份或恢復(fù)操作。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 布爾類型 | 可缺省，缺省為false。 |
compressNativeLibs | 表示libs庫是否以壓縮存儲的方式打包到 HAP 包。如果配置為“false”，則libs庫以不壓縮的方式存儲，HAP 包在安裝時無需解壓libs，運(yùn)行時會直接從 HAP 內(nèi)加載libs庫。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 布爾類型 | 可缺省，缺省為true。 |
[network] | 表示網(wǎng)絡(luò)安全性配置。 該標(biāo)簽允許應(yīng)用通過配置文件的安全聲明來自定義其網(wǎng)絡(luò)安全，無需修改應(yīng)用代碼。 | 對象 | 可缺省，缺省為空。 |
表5 network對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
usesCleartext | 表示是否允許應(yīng)用使用明文網(wǎng)絡(luò)流量（例如，明文 HTTP）。默認(rèn)值為“false”。true：允許應(yīng)用使用明文流量的請求。false：拒絕應(yīng)用使用明文流量的請求。 | 布爾類型 | 可缺省，缺省為空。 |
[securityConfig] | 表示應(yīng)用的網(wǎng)絡(luò)安全配置信息。 | 對象 | 可缺省，缺省為空。 |
表6 securityConfig對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 子屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|---|
domainSettings | - | 表示自定義的網(wǎng)域范圍的安全配置，支持多層嵌套，即一個domainSettings對象中允許嵌套更小網(wǎng)域范圍的domainSettings對象。 | 對象 | 可缺省，缺省為空。 |
cleartextPermitted | 表示自定義的網(wǎng)域范圍內(nèi)是否允許明文流量傳輸。當(dāng)useCleartext和securityConfig同時存在時，自定義網(wǎng)域是否允許明文流量傳輸以cleartextPermitted的取值為準(zhǔn)。- true：允許明文流量傳輸。- false：拒絕明文流量傳輸。 | 布爾類型 | ||
domains | 表示域名配置信息，包含兩個參數(shù)：subDomains和name。subDomains（布爾類型）：表示是否包含子域名。如果為 “ true”，此網(wǎng)域規(guī)則將與相應(yīng)網(wǎng)域及所有子網(wǎng)域（包括子網(wǎng)域的子網(wǎng)域）匹配。否則，該規(guī)則僅適用于精確匹配項(xiàng)。name（字符串）：表示域名名稱。 | 對象數(shù)組 | 否 |
deviceConfig示例：
"deviceConfig": {
"default": {
"process": "com.huawei.hiworld.example",
"directLaunch": false,
"supportBackup": false,
"network": {
"usesCleartext": true,
"securityConfig": {
"domainSettings": {
"cleartextPermitted": true,
"domains": [
{
"subDomains": true,
"name": "example.ohos.com"
}
]
}
}
}
}
}module對象的內(nèi)部結(jié)構(gòu)
module對象包含 HAP 包的配置信息，內(nèi)部結(jié)構(gòu)說明參見表7。
表7 module對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
package | 表示 HAP 的包結(jié)構(gòu)名稱，在應(yīng)用內(nèi)應(yīng)保證唯一性。采用反向域名格式（建議與 HAP 的工程目錄保持一致）。字符串長度不超過 127字節(jié)。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 否 |
name | 表示 HAP 的類名。采用反向域名方式表示，前綴需要與同級的 package 標(biāo)簽指定的包名一致，也可采用“.”開頭的命名方式。字符串長度不超過 255字節(jié)。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 否 |
description | 表示 HAP 的描述信息。字符串長度不超過 255字節(jié)。如果字符串超出長度或者需要支持多語言，可以采用資源索引的方式添加描述內(nèi)容。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 可缺省，缺省值為空。 |
supportedModes | 表示應(yīng)用支持的運(yùn)行模式。當(dāng)前只定義了駕駛模式（drive）。該標(biāo)簽僅適用于車機(jī)。 | 字符串?dāng)?shù)組 | 可缺省，缺省值為空。 |
deviceType | 表示允許 Ability 運(yùn)行的設(shè)備類型。系統(tǒng)預(yù)定義的設(shè)備類型包括：tv（智慧屏）、car（車機(jī)）、wearable（智能穿戴）、liteWearable（輕量級智能穿戴）等。 | 字符串?dāng)?shù)組 | 否 |
[distro] | 表示 HAP 發(fā)布的具體描述。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 對象 | 否 |
[abilities] | 表示當(dāng)前模塊內(nèi)的所有 Ability。采用對象數(shù)組格式，其中每個元素表示一個 Ability 對象。 | 對象數(shù)組 | 可缺省，缺省值為空。 |
[js] | 表示基于 JS UI 框架開發(fā)的 JS 模塊集合，其中的每個元素代表一個 JS 模塊的信息。 | 對象 | 可缺省，缺省值為空。 |
[shortcuts] | 表示應(yīng)用的快捷方式信息。采用對象數(shù)組格式，其中的每個元素表示一個快捷方式對象。 | 對象數(shù)組 | 可缺省，缺省值為空。 |
defPermissions | 表示應(yīng)用定義的權(quán)限。應(yīng)用調(diào)用者必須申請這些權(quán)限，才能正常調(diào)用該應(yīng)用。 | 對象數(shù)組 | 可缺省，缺省值為空。 |
reqPermissions | 表示應(yīng)用運(yùn)行時向系統(tǒng)申請的權(quán)限。 | 對象數(shù)組 | 可缺省，缺省值為空。 |
module示例：
"module": {
"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": [
...
]
} 表8 distro 對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
deliveryWithInstall | 表示當(dāng)前 HAP 是否在支持隨應(yīng)用安裝。true：支持隨應(yīng)用安裝。false：不支持隨應(yīng)用安裝。 | 布爾類型 | 否 |
moduleName | 表示當(dāng)前 HAP 的名稱。 | 字符串 | 否 |
moduleType | 表示當(dāng)前 HAP 的類型，包括兩種類型：entry和feature。 | 字符串 | 否 |
distro示例：
"distro": {
"deliveryWithInstall": true,
"moduleName": "ohos_entry",
"moduleType": "entry"
} 表9 abilities對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
name | 表示 Ability 名稱。 取值可采用反向域名方式表示，由包名和類名組成，如“ com.example.myapplication.MainAbility”；也可采用“.”開頭的類名方式表示，如“.MainAbility”。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 否 |
description | 表示對 Ability 的描述。 取值可以是描述性內(nèi)容，也可以是對描述性內(nèi)容的資源索引，以支持多語言。 | 字符串 | 可缺省，缺省值為空。 |
icon | 表示 Ability 圖標(biāo)資源文件的索引。 取值示例： $media:ability_icon。如果在該 Ability 的“ skills”屬性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，則該 Ability 的icon將同時作為應(yīng)用的icon。如果存在多個符合條件的 Ability，則取位置靠前的 Ability 的 icon作為應(yīng)用的icon。 | 字符串 | 可缺省，缺省值為空。 |
label | 表示 Ability 對用戶顯示的名稱。 取值可以是 Ability 名稱，也可以是對該名稱的資源索引，以支持多語言。 如果在該 Ability 的“ skills”屬性中，“actions”的取值包含 “action.system.home”，“entities”取值中包含“entity.system.home”，則該 Ability 的label將同時作為應(yīng)用的label。如果存在多個符合條件的 Ability，則取位置靠前的 Ability 的 label作為應(yīng)用的label。 | 字符串 | 可缺省，缺省值為空。 |
uri | 表示 Ability 的統(tǒng)一資源標(biāo)識符。格式為[scheme:] [//authority] [path] [?query] [#fragment] | 字符串 | 可缺省，對于data類型的Ability不可缺省。 |
launchType | 表示 Ability 的啟動模式，支持“standard”和“singleton”兩種模式：standard：表示該 Ability 可以有多實(shí)例?！?code>standard”模式適用于大多數(shù)應(yīng)用場景。singleton：表示該 Ability 只可以有一個實(shí)例。例如，具有全局唯一性的呼叫來電界面即采用“ singleton”模式。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 可缺省，缺省值為standard。 |
visible | 表示 Ability 是否可以被其他應(yīng)用調(diào)用。true：可以被其他應(yīng)用調(diào)用。false：不能被其他應(yīng)用調(diào)用。 | 布爾類型 | 可缺省，缺省值為false。 |
permissions | 表示其他應(yīng)用的 Ability 調(diào)用此 Ability 時需要申請的權(quán)限。通常采用反向域名格式，取值可以是系統(tǒng)預(yù)定義的權(quán)限，也可以是開發(fā)者自定義的權(quán)限。如果是自定義權(quán)限，取值必須與“defPermissions”標(biāo)簽中定義的某個權(quán)限的“name”標(biāo)簽值一致。 | 字符串?dāng)?shù)組 | 可缺省，缺省值為空。 |
[skills] | 表示 Ability 能夠接收的 Intent 的特征。 | 對象數(shù)組 | 可缺省，缺省值為空。 |
deviceCapability | 表示 Ability 運(yùn)行時要求設(shè)備具有的能力，采用字符串?dāng)?shù)組的格式表示。 | 字符串?dāng)?shù)組 | 可缺省，缺省值為空。 |
type | 表示 Ability 的類型。 取值范圍如下： page：表示基于 Page 模板開發(fā)的 FA，用于提供與用戶交互的能力。service：表示基于 Service 模板開發(fā)的PA，用于提供后臺運(yùn)行任務(wù)的能力。data：表示基于 Data 模板開發(fā)的 PA，用于對外部提供統(tǒng)一的數(shù)據(jù)訪問抽象。 | 字符串 | 否 |
formEnabled | 表示 FA 類型的 Ability 是否提供卡片（form）能力。該標(biāo)簽僅適用于page類型的 Ability。true：提供卡片能力。false：不提供卡片能力。 | 布爾類型 | 可缺省，缺省值為false。 |
[form] | 表示 AbilityForm 的屬性。 該標(biāo)簽僅當(dāng)“ formEnabled”為“true”時，才能生效。 | 對象 | 可缺省，缺省值為空。 |
orientation | 表示該 Ability 的顯示模式。該標(biāo)簽僅適用于page類型的 Ability。取值范圍如下： unspecified：由系統(tǒng)自動判斷顯示方向。landscape：橫屏模式。portrait：豎屏模式。followRecent：跟隨棧中最近的應(yīng)用。 | 字符串 | 可缺省，缺省值為unspecified。 |
backgroundModes | 表示后臺服務(wù)的類型，可以為一個服務(wù)配置多個后臺服務(wù)類型。該標(biāo)簽僅適用于service類型的 Ability。取值范圍如下：dataTransfer：通過網(wǎng)絡(luò)/對端設(shè)備進(jìn)行數(shù)據(jù)下載、備份、分享、傳輸?shù)葮I(yè)務(wù)。audioPlayback：音頻輸出業(yè)務(wù)。audioRecording：音頻輸入業(yè)務(wù)。pictureInPicture：畫中畫、小窗口播放視頻業(yè)務(wù)。voip：音視頻電話、VOIP 業(yè)務(wù)。location：定位、導(dǎo)航業(yè)務(wù)。bluetoothInteraction：藍(lán)牙掃描、連接、傳輸業(yè)務(wù)。wifiInteraction：WLAN 掃描、連接、傳輸業(yè)務(wù)。screenFetch：錄屏、截屏業(yè)務(wù)。 | 字符串?dāng)?shù)組 | 可缺省，缺省值為空。 |
readPermission | 表示讀取 Ability 的數(shù)據(jù)所需的權(quán)限。 該標(biāo)簽僅適用于 data類型的 Ability。取值為長度不超過 255字節(jié)的字符串。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 可缺省，缺省為空。 |
writePermission | 表示向 Ability 寫數(shù)據(jù)所需的權(quán)限。 該標(biāo)簽僅適用于 data類型的 Ability。取值為長度不超過 255字節(jié)的字符串。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 可缺省，缺省為空。 |
directLaunch | 表示 Ability 是否支持在設(shè)備未解鎖狀態(tài)直接啟動。如果配置為“true”，則表示 Ability 支持在設(shè)備未解鎖狀態(tài)下啟動。如果“ deviceConfig”和“abilities”中同時配置了“directLaunch”，則采用 Ability 對應(yīng)的取值；如果同時未配置，則采用系統(tǒng)默認(rèn)值。 | 布爾值 | 可缺省，缺省為false。 |
configChanges | 表示 Ability 關(guān)注的系統(tǒng)配置集合。當(dāng)已關(guān)注的配置發(fā)生變更后，Ability 會收到onConfigurationUpdated回調(diào)。取值范圍： locale：表示語言區(qū)域發(fā)生變更。layout：表示屏幕布局發(fā)生變更。fontSize：表示字號發(fā)生變更。orientation：表示屏幕方向發(fā)生變更。density：表示顯示密度發(fā)生變更。 | 字符串?dāng)?shù)組 | 可缺省，缺省為空。 |
mission | 表示Ability指定的任務(wù)棧。該標(biāo)簽僅適用于page類型的Ability。默認(rèn)情況下應(yīng)用中所有Ability同屬一個任務(wù)棧。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 可缺省，缺省為應(yīng)用的包名。 |
targetAbility | 表示當(dāng)前 Ability 重用的目標(biāo) Ability。該標(biāo)簽僅適用于page類型的 Ability。如果配置了targetAbility屬性，則當(dāng)前 Ability（即別名 Ability）的屬性中僅“name”、“icon”、“label”、“visible”、“permissions”、“skills”生效，其它屬性均沿用targetAbility中的屬性值。目標(biāo) Ability 必須與別名 Ability 在同一應(yīng)用中，且在配置文件中目標(biāo) Ability 必須在別名之前進(jìn)行聲明。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 字符串 | 可缺省，缺省值為空。表示當(dāng)前 Ability 不是一個別名 Ability。 |
multiUserShared | 表示 Ability 是否支持多用戶狀態(tài)進(jìn)行共享，該標(biāo)簽僅適用于data類型的 Ability。配置為“true”時，表示在多用戶下只有一份存儲數(shù)據(jù)。需要注意的是，該屬性會使visible屬性失效。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 布爾類型 | 可缺省，缺省值為false。 |
supportPipMode | 表示 Ability 是否支持用戶進(jìn)入 PIP 模式（用于在在頁面最上層懸浮小窗口，俗稱“畫中畫”，常見于視頻播放等場景）。該標(biāo)簽僅適用于page類型的 Ability。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 布爾類型 | 可缺省，缺省值為false。 |
abilities示例：
"abilities": [
{
"name": ".MainAbility",
"description": "$string:description_main_ability",
"icon": "$media:hiworld.png",
"label": "HiMusic",
"type": "page",
"formEnabled": false,
"launchType": "standard",
"orientation": "unspecified",
"permissions": [
],
"visible": false,
"skills": [
{
"actions": [
"action.system.home"
],
"entities": [
"entity.system.home"
]
}
],
"configChanges": [
"locale",
"layout",
"fontSize",
"orientation"
],
"directLaunch": false,
"process": "string",
"backgroundModes": [
"dataTransfer",
"audioPlayback",
"audioRecording",
"pictureInPicture",
"voip",
"location",
"bluetoothInteraction",
"wifiInteraction",
"screenFetch"
],
}
] 表10 skills對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 子屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|---|
actions | - | 表示能夠接收的 Intent 的action值，可以包含一個或多個action。取值通常為系統(tǒng)預(yù)定義的action值，詳見《API 參考》中的ohos.aafwk.content.Intent類。 | 字符串?dāng)?shù)組 | 可缺省，缺省值為空。 |
entities | - | 表示能夠接收的 Intent 的 Ability 的類別（如視頻、桌面應(yīng)用等），可以包含一個或多個entity。取值通常為系統(tǒng)預(yù)定義的類別，詳見《API 參考》中的ohos.aafwk.content.Intent類，也可以自定義。 | 字符串?dāng)?shù)組 | 可缺省，缺省值為空。 |
uris | - | 表示能夠接收的Intent的uri，可以包含一個或者多個uri。 | 對象數(shù)組 | 可缺省，缺省值為空。 |
scheme | 表示uri的scheme值。 | 字符串 | 不可缺省。 | |
host | 表示uri的host值。 | 字符串 | 可缺省，缺省值為空。 | |
port | 表示uri的port值。 | 字符串 | 可缺省，缺省值為空。 | |
path | 表示uri的path值。 | 字符串 | 可缺省，缺省值為空。 | |
type | 表示uri的type值。 | 字符串 | 可缺省，缺省值為空。 |
skills示例：
"skills": [
{
"actions": [
"action.system.home"
],
"entities": [
"entity.system.home"
],
"uris": [
{
"scheme": "http",
"host": "www.xxx.com",
"port": "8080",
"path": "query/student/name",
"type": "text"
}
]
}
] 表11 form對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|
formEntity | 表示AbilityForm支持的顯示方式，當(dāng)前支持的位置包括：homeScreen：以桌面圖標(biāo)顯示。searchbox：在全局搜索顯示。 | 字符串?dāng)?shù)組 | 可缺省，缺省值為空。 |
minHeight | 表示AbilityForm縮放時能達(dá)到的最小高度，單位：像素。 | 數(shù)值 | 可缺省，缺省值為0。 |
defaultHeight | 表示AbilityForm的默認(rèn)高度，單位：像素。Form 使用方應(yīng)當(dāng)根據(jù)該值為 Form 申請相應(yīng)高度的容器布局。 | 數(shù)值 | 可缺省，缺省值為0。 |
minWidth | 表示AbilityForm縮放時能達(dá)到的最小寬度，單位：像素。 | 數(shù)值 | 可缺省，缺省值為0。 |
defaultWidth | 表示AbilityForm的默認(rèn)寬度，單位：像素。Form使用方應(yīng)當(dāng)根據(jù)該值為Form申請相應(yīng)寬度的容器布局。 | 數(shù)值 | 可缺省，缺省值為0。 |
form示例：
"form": {
"formEntity": [
"homeScreen",
"searchbox"
],
"minHeight": 100,
"maxHeight": 200,
"minWidth": 100,
"maxWidth": 200
} 表12 js對象的內(nèi)部結(jié)構(gòu)說明
| 屬性名稱 | 子屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|---|
name | - | 表示 JS Module 的名字。該標(biāo)簽不可缺省，默認(rèn)值為default。 | 字符串 | 否 |
pages | - | 表示 JS Module 的頁面用于列舉 JS Module 中每個頁面的路由信息[頁面路徑+頁面名稱]。該標(biāo)簽不可缺省，取值為數(shù)組，數(shù)組第一個元素代表 JS FA 首頁。 | 數(shù)組 | 否 |
window | - | 用于定義與顯示窗口相關(guān)的配置。該標(biāo)簽僅適用于智慧屏、智能穿戴、車機(jī)。 | 對象 | 可缺省。 |
designWidth | 表示頁面設(shè)計(jì)基準(zhǔn)寬度。以此為基準(zhǔn)，根據(jù)實(shí)際設(shè)備寬度來縮放元素大小。 | 數(shù)值 | 可缺省，缺省值為750px。 | |
autoDesignWidth | 表示頁面設(shè)計(jì)基準(zhǔn)寬度是否自動計(jì)算。當(dāng)配置為true時，designWidth將會被忽略，設(shè)計(jì)基準(zhǔn)寬度由設(shè)備寬度與屏幕密度計(jì)算得出。 | 布爾類型 | 可缺省，缺省值為false。 |
js示例：
"js": [
{
"name": "default",
"pages": [
"pages/index/index",
"pages/detail/detail"
],
"window": {
"designWidth": 750,
"autoDesignWidth": false
}
}
]| 屬性名稱 | 子屬性名稱 | 含義 | 數(shù)據(jù)類型 | 是否可缺省 |
|---|---|---|---|---|
shortcutId | - | 表示快捷方式的 ID。字符串的最大長度為 63字節(jié)。 | 字符串 | 否 |
label | - | 表示快捷方式的標(biāo)簽信息，即快捷方式對外顯示的文字描述信息。取值可以是描述性內(nèi)容，也可以是標(biāo)識label的資源索引。字符串最大長度為 63字節(jié)。 | 字符串 | 可缺省，缺省為空。 |
intents | - | 表示快捷方式內(nèi)定義的目標(biāo)intent信息集合，每個intent可配置兩個子標(biāo)簽，targetClass, targetBundle。 | - | 可缺省，缺省為空。 |
targetClass | 表示快捷方式目標(biāo)類名。 | 字符串 | 可缺省，缺省值為空。 | |
targetBundle | 表示快捷方式目標(biāo) Ability 所在應(yīng)用的包名。 | 字符串 | 可缺省，缺省值為空。 |
示例：
"shortcuts": [
{
"shortcutId": "id",
"label": "$string:shortcut",
"intents": [
{
"targetBundle": "com.huawei.hiworld.himusic",
"targetClass": "com.huawei.hiworld.himusic.entry.MainAbility"
}
]
}
]網(wǎng)頁名稱：創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OS配置文件的元素
文章地址：http://m.fisionsoft.com.cn/article/ccegios.html
