HarmonyOS服務(wù)卡片開發(fā)-資源訪問學(xué)習(xí)

1、HarmonyOS服務(wù)卡片開發(fā)-資源訪問學(xué)習(xí)卡片工程可以訪問的資源，包括JS模塊的 HYPERLINK /cn/docs/documentation/doc-references/js-service-widget-file-0000001153028529 resources資源， HYPERLINK /cn/docs/documentation/doc-guides/basic-resource-file-categories-0000001052066099 t /cn/docs/documentation/doc-references/_blank 應(yīng)用resources資源（所有JS

2、模塊共享）和系統(tǒng)預(yù)置資源。資源限定詞資源限定詞可以由一個(gè)或多個(gè)表征應(yīng)用場景或設(shè)備特征的限定詞組合而成，包括深色模式、屏幕密度等維度，限定詞之間通過中劃線（-）連接。開發(fā)者在resources目錄下創(chuàng)建限定詞文件時(shí)，需要掌握限定詞文件的命名要求以及與限定詞文件與設(shè)備狀態(tài)的匹配規(guī)則。資源限定詞的命名要求限定詞的組合順序：深色模式-屏幕密度。開發(fā)者可以根據(jù)應(yīng)用的使用場景和設(shè)備特征，選擇其中的一類或幾類限定詞組成目錄名稱，順序不可顛倒。限定詞的連接方式：限定詞之間均采用中劃線（-）連接。例如：res-dark-ldpi.json 。限定詞的取值范圍：每類限定詞的取值必須符合下表的條件，否則，將無法匹配

3、目錄中的資源文件，限定詞大小寫敏感。限定詞前綴：resources資源文件的資源限定詞有前綴res，例如res-ldpi.json。默認(rèn)資源限定文件：resources資源文件的默認(rèn)資源限定文件為res-defaults.json。資源限定文件中不支持使用枚舉格式的顏色來設(shè)置資源。類型含義與取值說明深色模式表示設(shè)備的深色模式，取值如下：dark屏幕密度表示設(shè)備的屏幕密度（單位為dpi），取值如下：ldpi：表示低密度屏幕（120dpi）（0.75基準(zhǔn)密度）mdpi：表示中密度屏幕（160dpi）（基準(zhǔn)密度）hdpi：表示高密度屏幕（240dpi）（1.5基準(zhǔn)密度）xhdpi：表示加高密度屏幕（

4、320dpi）（2.0基準(zhǔn)密度）xxhdpi：表示超超高密度屏幕（480dpi）（3.0基準(zhǔn)密度）xxxhdpi：表示超超超高密度屏幕（640dpi）（4.0基準(zhǔn)密度）說明如果當(dāng)前設(shè)備的DPI不完全匹配定義的DPI，那么將選取更接近當(dāng)前設(shè)備DPI的資源文件。比如當(dāng)前設(shè)備為2.7*基準(zhǔn)密度，會(huì)選擇res-xxhdpi.json中定義的資源；開發(fā)者還可以定義一個(gè)res-defaults.json資源文件，用于當(dāng)對(duì)應(yīng)密度資源文件中沒有對(duì)應(yīng)的資源詞條時(shí)，應(yīng)用將嘗試在res-defaults.json中匹配對(duì)應(yīng)的資源詞條，如果仍未查找到對(duì)應(yīng)詞條，則圖片加載失敗。限定詞與設(shè)備狀態(tài)的匹配規(guī)則在為設(shè)備匹配對(duì)應(yīng)

5、的資源文件時(shí)，限定詞目錄匹配的優(yōu)先級(jí)從高到低依次為：深色模式 屏幕密度。在資源限定詞目錄均未匹配的情況下，則匹配默認(rèn)資源限定文件。如果限定詞目錄中包含資源限定詞，則對(duì)應(yīng)限定詞的取值必須與當(dāng)前的設(shè)備狀態(tài)完全一致，該目錄才能夠參與設(shè)備的資源匹配。例如：資源限定文件res-hdpi.json與當(dāng)前設(shè)備密度xhdpi無法匹配。引用JS模塊內(nèi)resources資源在應(yīng)用開發(fā)的hml和js文件中使用$r的語法，可以對(duì)JS模塊內(nèi)的resources目錄下的json資源進(jìn)行格式化，獲取相應(yīng)的資源內(nèi)容。屬性類型描述$r(key: string) = string獲取資源限定下具體的資源內(nèi)容。例如：this.$r(strings.hello)。參數(shù)說明：key：定義在資源限定文件中的鍵值，如strings.hello。res-defaults.json示例：示例resources/re