項目結構介紹
module.json5
src > main > module.json5:Stage模型模塊配置文件。主要包含HAP包的配置信息、應用/服務在具體設備上的配置信息以及應用/服務的全局配置信息。具體的配置文件說明,詳見module.json5配置文件。
資源分類和訪問
關于src > main > resources下文件的更多信息都可以訪問:
資源分類與訪問
資源分類介紹
限定詞目錄的命名要求
開發者在創建限定詞目錄時,需要遵守限定詞目錄的命名規則。
- 限定詞的組合順序:移動國家碼_移動網絡碼-語言_文字_國家或地區-橫豎屏-設備類型-顏色模式-屏幕密度。開發者可以根據應用的使用場景和設備特征,選擇其中的一類或幾類限定詞組成目錄名稱。
- 限定詞的連接方式:語言、文字、國家或地區之間采用下劃線()連接,移動國家碼和移動網絡碼之間也采用下劃線()連接,除此之外的其他限定詞之間均采用中劃線(-)連接。例如:zh_Hant_CN、zh_CN-car-ldpi。
- 限定詞的取值范圍:每類限定詞的取值必須符合限定詞取值要求表中的條件,如表2。否則,將無法匹配目錄中的資源文件。
詳細見限定詞目錄的命名要求
資源組目錄
資源組目類型包括element、media、profile,用于存放特定類型的資源文件。
最新去官網看,點上面鏈接,還有媒體資源、音視頻資源介紹
創建資源目錄和資源組目錄和資源文件
在對應的文件夾下右鍵可以創建
詳細方法步驟
資源訪問
更詳細見資源訪問
應用資源
- 對于應用資源,在工程中,通過"$r(‘app.type.name’)"形式引用。其中,app為應用內resources目錄中定義的資源;type為資源類型或資源的存放位置,取值包含“color”、“float”、“string”、“plural”、“media”;name為資源命名,由開發者定義資源時確定。(在ets文件夾下需要app開頭,在resources文件下可以去掉app.)
- 對于rawfile目錄資源,通過"$rawfile(‘filename’)“形式引用。其中,filename為rawfile目錄下文件的相對路徑,文件名需要包含后綴,路徑開頭不可以以”/"開頭。
- 對于rawfile目錄的descriptor,可通過資源管理的getRawFd接口引用,其返回值descriptor.fd為hap包的fd。此時,訪問rawfile文件需要結合{fd,offset, length}一起使用。
系統資源
除了自定義資源,開發者也可以使用系統中預定義的資源,統一應用的視覺風格。
對于系統資源,可以通過“$r(‘sys.type.resource_id’)”的形式引用。其中,sys為系統資源;type為資源類型,取值包括“color”、“float”、“string”、“media”;resource_id為資源id。
資源匹配
應用使用某資源時,系統會根據當前設備狀態優先從相匹配的限定詞目錄中尋找該資源。只有當resources目錄中沒有與設備狀態匹配的限定詞目錄,或者在限定詞目錄中找不到該資源時,才會去base目錄中查找。rawfile是原始文件目錄,不會根據設備狀態去匹配不同的資源。
待學習概念
- 了解Ability
- 系統應用配置和三方應用配置什么意思
- 該Module對應的Hap,Module和Hap都是啥
- 用的entry類型Module的該字段配置為true時,該應用的feature類型的該字段也需要配置為true。什么意思?