Android中資源限定符hdpi large等的優先順序和匹配關係
請參考
http://developer.android.com/intl/zh-cn/guide/topics/resources/providing-resources.html#BestMatch
配置 | 限定符值 | 描述 |
---|---|---|
MCC 和 MNC |
示例:mcc310 mcc310-mnc004 mcc208-mnc00 等等 |
移動國家程式碼 (MCC),(可選)後跟裝置 SIM 卡中的行動網路程式碼 (MNC)。例如, 如果裝置使用無線電連線(GSM 手機),則 MCC 和 MNC 值來自 SIM 卡。 也可以單獨使用 MCC(例如,將國家/地區特定的合法資源包括在應用中)。如果只需根據語言指定,則改用“語言和區域”限定符(稍後進行介紹)。 如果決定使用 MCC 和 MNC 限定符,請謹慎執行此操作並測試限定符是否按預期工作。 |
語言和區域 |
示例:en fr en-rUS fr-rFR fr-rCA 等等 |
語言通過由兩個字母組成的 ISO 639-1 語言程式碼定義,(可選)後跟兩個字母組成的 ISO
3166-1-alpha-2 區域碼(前帶小寫字母“ 這些程式碼不區分大小寫; 如果使用者更改系統設定中的語言,它有可能在應用生命週期中發生改變。 如需瞭解這會在執行期間給應用帶來哪些影響,請參閱處理執行時變更。 有關針對其他語言本地化應用的完整指南,請參閱本地化。 另請參閱 配置欄位,該欄位表示當前的區域設定。 |
佈局方向 |
ldrtl ldltr |
應用的佈局方向。 它適用於佈局、圖片或值等任何資源。 例如,若要針對阿拉伯語提供某種特定佈局,並針對任何其他“從右到左”語言(如波斯語或希伯來語)提供某種通用佈局,則可編碼如下: res/ layout/ main.xml
注:要為應用啟用從右到左的佈局功能,必須將 此項為API 級別 17 中新增配置。 |
smallestWidth |
sw<N>dp 示例: sw320dp sw600dp sw720dp 等等 |
螢幕的基本尺寸,由可用螢幕區域的最小尺寸指定。 具體來說,裝置的 smallestWidth 是螢幕可用高度和寬度的最小尺寸(您也可以將其視為螢幕的“最小可能寬度”)。無論螢幕的當前方向如何,您均可使用此限定符確保應用 UI 的可用寬度至少為 例如,如果佈局要求螢幕區域的最小尺寸始終至少為 600dp,則可使用此限定符建立佈局資源 裝置的 smallestWidth 將螢幕裝飾元素和系統 UI 考慮在內。例如,如果裝置的螢幕上有一些永久性 UI 元素佔據沿 smallestWidth 軸的空間,則系統會宣告 smallestWidth 小於實際螢幕尺寸,因為這些螢幕畫素不適用於您的 UI。因此,使用的值應該是佈局所需要的實際最小尺寸(通常,無論螢幕的當前方向如何,此值都是佈局支援的“最小寬度”)。 以下是一些可用於普通螢幕尺寸的值:
應用為多個資源目錄提供不同的 smallestWidth 限定符值時,系統會使用最接近(但未超出)裝置 smallestWidth 的值。 此項為 API 級別 13 中新增配置。 如需瞭解有關設計不同螢幕和使用此限定符的詳細資訊,請參閱支援多個螢幕開發者指南。 |
可用寬度 |
w<N>dp 示例: w720dp w1024dp 等等 |
指定資源應該使用的最小可用螢幕寬度,以 應用為多個資源目錄提供不同的此配置值時,系統會使用最接近(但未超出)裝置當前螢幕寬度的值。 此處的值考慮到了螢幕裝飾元素,因此如果裝置顯示屏的左邊緣或右邊緣上有一些永久性 UI 元素,考慮到這些 UI 元素,它會使用小於實際螢幕尺寸的寬度值,這樣會減少應用的可用空間。 此項為 API 級別 13 中新增配置。 另請參閱 配置欄位,該欄位存放當前螢幕寬度。 如需瞭解有關設計不同螢幕和使用此限定符的詳細資訊,請參閱支援多個螢幕開發者指南。 |
可用高度 |
h<N>dp 示例: h720dp h1024dp 等等 |
指定資源應該使用的最小可用螢幕高度,以“dp”為單位,由 應用為多個資源目錄提供不同的此配置值時,系統會使用最接近(但未超出)裝置當前螢幕高度的值。 此處的值考慮到了螢幕裝飾元素,因此如果裝置顯示屏的上邊緣或下邊緣有一些永久性 UI 元素,考慮到這些 UI 元素,同時為減少應用的可用空間,它會使用小於實際螢幕尺寸的高度值。 非固定的螢幕裝飾元素(例如,全屏時可隱藏的手機狀態列)並不在考慮範圍內,標題欄或操作欄等視窗裝飾也不在考慮範圍內,因此應用必須準備好處理稍小於其所指定值的空間。 此項為 API 級別 13 中新增配置。 另請參閱 配置欄位,該欄位存放當前螢幕寬度。 如需瞭解有關設計不同螢幕和使用此限定符的詳細資訊,請參閱支援多個螢幕開發者指南。 |
螢幕尺寸 |
small normal large xlarge |
注:使用尺寸限定符並不表示資源僅適用於該尺寸的螢幕。 如果沒有為備用資源提供最符合當前裝置配置的限定符,則系統可能使用其中最匹配的資源。
注意:如果所有資源均使用大於當前螢幕的尺寸限定符,則系統不會使用這些資源,並且應用在執行時將會崩潰(例如,如果所有佈局資源均用 此項為 API 級別 4 中新增配置。 如需瞭解詳細資訊,請參閱支援多個螢幕。 另請參閱 配置欄位,該欄位表示螢幕是小尺寸、標準尺寸還是大尺寸。 |
螢幕縱橫比 |
long notlong |
此項為 API 級別 4 中新增配置。 它完全基於螢幕的縱橫比(寬屏較寬),而與螢幕方向無關。 另請參閱 配置欄位,該欄位指示螢幕是否為寬屏。 |
螢幕方向 |
port land |
如果使用者旋轉螢幕,它有可能在應用生命週期中發生改變。 如需瞭解這會在執行期間給應用帶來哪些影響,請參閱處理執行時變更。 另請參閱 配置欄位,該欄位指示當前的裝置方向。 |
UI 模式 |
car desk television appliance watch |
此項為 API 級別 8 中新增配置,API 13 中新增電視配置,API 20 中新增手錶配置。 如需瞭解應用在裝置插入手機座或從中移除時的響應方式,請閱讀確定並監控插接狀態和型別。 如果使用者將裝置放入手機座中,它有可能在應用生命週期中發生改變。 可以使用 啟用或禁用其中某些模式。如需瞭解這會在執行期間給應用帶來哪些影響,請參閱處理執行時變更。 |
夜間模式 |
night notnight |
此項為 API 級別 8 中新增配置。 如果夜間模式停留在自動模式(預設),它有可能在應用生命週期中發生改變。在這種情況下,該模式會根據當天的時間進行調整。 可以使用 啟用或禁用此模式。如需瞭解這會在執行期間給應用帶來哪些影響,請參閱處理執行時變更。 |
螢幕畫素密度 (dpi) |
ldpi mdpi hdpi xhdpi xxhdpi xxxhdpi nodpi tvdpi |
六個主要密度之間的縮放比為 3:4:6:8:12:16(忽略 tvdpi 密度)。因此,9x9 (ldpi) 點陣圖相當於 12x12 (mdpi)、18x18 (hdpi)、24x24 (xhdpi) 點陣圖,依此類推。 如果您認為影象資源在電視或其他某些裝置上呈現的效果不夠好,而想嘗試使用 tvdpi 資源,則縮放比例為 1.33*mdpi。例如,mdpi 螢幕的 100px x 100px 影象應該相當於 tvdpi 的133px x 133px。 注:使用密度限定符並不表示資源僅適用於該密度的螢幕。 如果沒有為備用資源提供最符合當前裝置配置的限定符,則系統可能使用其中最匹配的資源。 如需瞭解有關如何處理不同螢幕密度以及 Android 如何縮放點陣圖以適應當前密度的詳細資訊,請參閱支援多個螢幕。 |
觸控式螢幕型別 |
notouch finger |
另請參閱 配置欄位,該欄位指示裝置上的觸控式螢幕型別。 |
鍵盤可用性 |
keysexposed keyshidden keyssoft |
如果提供了 如果使用者開啟硬鍵盤,它有可能在應用生命週期中發生改變。 如需瞭解這會在執行期間給應用帶來哪些影響,請參閱處理執行時變更。 |
主要文字輸入法 |
nokeys qwerty 12key |
另請參閱 配置欄位,該欄位指示可用的主要文字輸入法。 |
導航鍵可用性 |
navexposed navhidden |
如果使用者顯示導航鍵,它有可能在應用生命週期中發生改變。 如需瞭解這會在執行期間給應用帶來哪些影響,請參閱處理執行時變更。 另請參閱 配置欄位,該欄位指示導航鍵是否處於隱藏狀態。 |
主要非觸控導航方法 |
nonav dpad trackball wheel |
另請參閱 配置欄位,該欄位指示可用的導航方法型別。 |
平臺版本(API 級別) |
示例:v3 v4 v7 等等 |
裝置支援的 API 級別。例如, |
Android 如何找到最匹配資源
drawable/ drawable-en/ drawable-fr-rCA/ drawable-en-port/ drawable-en-notouch-12key/ drawable-port-ldpi/ drawable-port-notouch-12key/
同時,假設裝置配置如下:
區域設定 = en-GB
螢幕方向 = port
螢幕畫素密度 = hdpi
觸控式螢幕型別 = notouch
主要文字輸入法 = 12key
通過將裝置配置與可用的備用資源進行比較,Android 從 drawable-en-port
中選擇 Drawable。
系統使用以下邏輯決定要使用的資源:
- 淘汰與裝置配置衝突的資原始檔。
drawable-fr-rCA/
目錄與en-GB
區域設定衝突,因而被淘汰。drawable/ drawable-en/
drawable-fr-rCA/drawable-en-port/ drawable-en-notouch-12key/ drawable-port-ldpi/ drawable-port-notouch-12key/例外:螢幕畫素密度是唯一一個未因衝突而被淘汰的限定符。 儘管裝置的螢幕密度為 hdpi,但是
drawable-port-ldpi/
未被淘汰,因為此時每個螢幕密度均視為匹配。如需瞭解詳細資訊,請參閱支援多個螢幕文件。 - 選擇列表(表 2)中(下一個)優先順序最高的限定符。(先從 MCC 開始,然後下移。)
- 是否有資源目錄包括此限定符?
- 若無,請返回到第 2 步,看看下一個限定符。(在該示例中,除非達到語言限定符,否則答案始終為“否”。)
- 若有,請繼續執行第 4 步。
- 淘汰不含此限定符的資源目錄。在該示例中,系統會淘汰所有不含語言限定符的目錄。
drawable/drawable-en/ drawable-en-port/ drawable-en-notouch-12key/drawable-port-ldpi/ drawable-port-notouch-12key/例外:如果涉及的限定符是螢幕畫素密度,則 Android 會選擇最接近裝置螢幕密度的選項。通常,Android 傾向於縮小大型原始影象,而不是放大小型原始影象。請參閱支援多個螢幕。
- 返回並重復第 2 步、第 3 步和第 4 步,直到只剩下一個目錄為止。在此示例中,螢幕方向是下一個判斷是否匹配的限定符。因此,未指定螢幕方向的資源被淘汰:
drawable-en/drawable-en-port/drawable-en-notouch-12key/剩下的目錄是
drawable-en-port
。