app.json5配置文件

bundleName

標(biāo)識應(yīng)用的Bundle名稱，用于標(biāo)識應(yīng)用的唯一性。該標(biāo)簽不可缺省。標(biāo)簽的值命名規(guī)則 ：

- 字符串以字母、數(shù)字、下劃線和符號“.”組成。

- 以字母開頭。

- 最小長度7個字節(jié)，最大長度127個字節(jié)。

推薦采用反域名形式命名（如com.example.demo，建議第一級為域名后綴com，第二級為廠商/個人名，第三級為應(yīng)用名，也可以多級）。

字符串

該標(biāo)簽不可缺省。

bundleType

標(biāo)識應(yīng)用的Bundle類型，用于區(qū)分應(yīng)用或者原子化服務(wù)。該標(biāo)簽可選值為app和atomicService ：

- app：當(dāng)前Bundle為普通應(yīng)用。

- atomicService：當(dāng)前Bundle為元服務(wù)。

字符串

該標(biāo)簽可以缺省，缺省為app。

debug

標(biāo)識應(yīng)用是否可調(diào)試，該標(biāo)簽由IDE編譯構(gòu)建時生成。

- true：可調(diào)試。

- false：不可調(diào)試。

布爾值

該標(biāo)簽可以缺省，缺省為false。

icon

標(biāo)識應(yīng)用的圖標(biāo)，標(biāo)簽值為圖標(biāo)資源文件的索引。

字符串

該標(biāo)簽不可缺省。

label

標(biāo)識應(yīng)用的名稱，標(biāo)簽值為字符串資源的索引。

字符串

該標(biāo)簽不可缺省。

description

標(biāo)識應(yīng)用的描述信息，標(biāo)簽值是字符串類型（最大255個字節(jié)）或?qū)γ枋鰞?nèi)容的字符串資源索引。

字符串

該標(biāo)簽可缺省，缺省值為空。

vendor

標(biāo)識對應(yīng)用開發(fā)廠商的描述。該標(biāo)簽的值是字符串類型（最大255個字節(jié)）。

字符串

該標(biāo)簽可以缺省，缺省為空。

versionCode

標(biāo)識應(yīng)用的版本號，該標(biāo)簽值為32位非負(fù)整數(shù)。此數(shù)字僅用于確定某個版本是否比另一個版本更新，數(shù)值越大表示版本越高。開發(fā)者可以將該值設(shè)置為任何正整數(shù)，但是必須確保應(yīng)用的新版本都使用比舊版本更大的值。該標(biāo)簽不可缺省，versionCode值應(yīng)小于2^31次方。

數(shù)值

該標(biāo)簽不可缺省。

versionName

標(biāo)識應(yīng)用版本號的文字描述，用于向用戶展示。

該標(biāo)簽僅由數(shù)字和點構(gòu)成，推薦采用“A.B.C.D”四段式的形式。四段式推薦的含義如下所示。

第一段：主版本號/Major，范圍0-99，重大修改的版本，如實現(xiàn)新的大功能或重大變化。

第二段：次版本號/Minor，范圍0-99，表示實現(xiàn)較突出的特點，如新功能添加或大問題修復(fù)。

第三段：特性版本號/Feature，范圍0-99，標(biāo)識規(guī)劃的新版本特性。

第四段：修訂版本號/Patch，范圍0-999，表示維護版本，修復(fù)bug。

標(biāo)簽最大字節(jié)長度為127。

字符串

該標(biāo)簽不可缺省。

minCompatibleVersionCode

標(biāo)識應(yīng)用能夠兼容的最低歷史版本號，用于跨設(shè)備兼容性判斷。

數(shù)值

該標(biāo)簽可缺省，缺省值等于versionCode標(biāo)簽值。

minAPIVersion

標(biāo)識應(yīng)用運行需要的SDK的API最小版本。

數(shù)值

由build-profile.json5中的compatibleSdkVersion生成。

targetAPIVersion

標(biāo)識應(yīng)用運行需要的API目標(biāo)版本。

數(shù)值

由build-profile.json5中的compileSdkVersion生成。

apiReleaseType

標(biāo)識應(yīng)用運行需要的API目標(biāo)版本的類型，采用字符串類型表示。取值為“CanaryN”、“BetaN”或者“Release”，其中，N代表大于零的整數(shù)。

- Canary：受限發(fā)布的版本。

- Beta：公開發(fā)布的Beta版本。

- Release：公開發(fā)布的正式版本。

該字段由DevEco Studio讀取當(dāng)前使用的SDK的Stage來生成。

字符串

該標(biāo)簽可缺省，由IDE生成并覆蓋。

multiProjects

標(biāo)識當(dāng)前工程是否支持多個工程的聯(lián)合開發(fā)。

- true：當(dāng)前工程支持多個工程的聯(lián)合開發(fā)。

- false：當(dāng)前工程不支持多個工程的聯(lián)合開發(fā)。多工程開發(fā)可以參考文檔：多工程構(gòu)建。

布爾值

可缺省，缺省值為false。

tablet

標(biāo)識對tablet設(shè)備做的特殊配置，可以配置的屬性字段有上文提到的：minAPIVersion、distributedNotificationEnabled。

如果使用該屬性對tablet設(shè)備做了特殊配置，則應(yīng)用在tablet設(shè)備中會采用此處配置的屬性值，并忽略在app.json5公共區(qū)域配置的屬性值。

對象

該標(biāo)簽可缺省，缺省時tablet設(shè)備使用app.json5公共區(qū)域配置的屬性值。

tv

標(biāo)識對tv設(shè)備做的特殊配置，可以配置的屬性字段有上文提到的：minAPIVersion、distributedNotificationEnabled。

如果使用該屬性對tv設(shè)備做了特殊配置，則應(yīng)用在tv設(shè)備中會采用此處配置的屬性值，并忽略在app.json5公共區(qū)域配置的屬性值。

對象

該標(biāo)簽可缺省，缺省時tv設(shè)備使用app.json5公共區(qū)域配置的屬性值。

wearable

標(biāo)識對wearable設(shè)備做的特殊配置，可以配置的屬性字段有上文提到的：minAPIVersion、distributedNotificationEnabled。

如果使用該屬性對wearable設(shè)備做了特殊配置，則應(yīng)用在wearable設(shè)備中會采用此處配置的屬性值，并忽略在app.json5公共區(qū)域配置的屬性值。

對象

該標(biāo)簽可缺省，缺省時wearable設(shè)備使用app.json5公共區(qū)域配置的屬性值。

car

標(biāo)識對car設(shè)備做的特殊配置，可以配置的屬性字段有上文提到的：minAPIVersion、distributedNotificationEnabled。

如果使用該屬性對car設(shè)備做了特殊配置，則應(yīng)用在car設(shè)備中會采用此處配置的屬性值，并忽略在app.json5公共區(qū)域配置的屬性值。

對象

該標(biāo)簽可缺省，缺省時car設(shè)備使用app.json5公共區(qū)域配置的屬性值。

phone

標(biāo)識對phone設(shè)備做的特殊配置，可以配置的屬性字段有上文提到的：minAPIVersion、distributedNotificationEnabled。

如果使用該屬性對phone設(shè)備做了特殊配置，則應(yīng)用在phone設(shè)備中會采用此處配置的屬性值，并忽略在app.json5公共區(qū)域配置的屬性值。

對象

該標(biāo)簽可缺省，缺省時phone設(shè)備使用app.json5公共區(qū)域配置的屬性值。