提供可選的替代資源
乎每個應用程序都應該提供可選的替代資源,來支持特殊的設備配置。例如,應該針對不同的屏幕分辨率來包含可選的可描畫資源,並且為不同的語言環境提供可選的字符串資源。在運行時,Android系統會檢測當前設備配置,並給應用程序加載合適的資源。
以下是給特殊配置指定一組可選資源的步驟:
1. 用<resources_name>-<config_qualifier>的格式在res/目錄中創建一個新的目錄,<resources_name>是對應的默認資源的目錄名(表1中定義的);<qualifier>是給使用這些資源的設備所指定的一個單獨配置的名字(表2中定義的)。每個名稱可以用短劃線來添加多個<qualifier>
警告:在添加多個限定符時,必須按照表2中列出的順序來放置它們。如果限定符的順序錯瞭,資源就會被忽略。
2. 在這個新的目錄中分別保存可選的替代資源。這些資源文件必須像默認資源文件一樣被準確的命名。
例如,以下是默認和可選資源的定義:
res/
drawable/
icon.png
background.png
drawable-hdpi/
icon.png
background.png
hdpi限定符指示這個目錄中資源是給高分辨率屏幕使用的。每個可描畫目錄中圖片都是為特定分辨率的屏幕準備的,但是它們的文件名是完全相同的。這樣用於引用icon.png和background.png圖片的資源ID就會相同,Android系統會通過設備配置信息和資源目錄名中的限定符的比較結果,來選擇跟當前設備匹配最好的資源版本。
Android支持幾種配置限定符,並且可以在一個目錄名中通過用短劃線的分隔,來添加多個限定符。表2按照優先的順序列出瞭有效的配置限定符,如果要在資源目錄中使用多個限定符,一定要按照表2列出的順序把它們添加到目錄名中。
表2.配置限定符名稱
配置 | 限定符值 | 說明 |
MCC和MNC | 例如: mcc310 mcc310-mnc004 mcc208-mnc00 等 |
MCC是移動國傢代碼的英文首字母縮寫(The mobile country code),它的後面可選擇性的跟隨來自設備內的SIM卡的移動網絡代碼(MNC:mobile network code)。如在任何載體上,mcc310代表美國,mcc310-mnc004代表美國的Venizon公司,mcc208-mnc00代表法國的Orange公司。 如果設備使用音頻連接(GSM 電話),那麼MCC和MNC的值來自SIM卡。 也可以單獨使用MCC(例如,在應用程序中包含特殊國傢合法的資源)。如果僅需要指定語言環境,那麼可以使用language和region限定符來替代(稍後討論)。如果決定要使用MCC和MNC限定符,就要仔細測試,使它能夠滿足你所期望的工作。 還可以查看配置域mcc和mnc,它們分別指示瞭當前的移動國傢代碼和移動網絡代碼。 mcc:http://developer.android.com/reference/android/content/res/Configuration.html#mcc mnc:http://developer.android.com/reference/android/content/res/Configuration.html#mnc |
語言和地區 | 例如: en fr en-rUS fr-rFR fr-rCA |
語言是用兩個字母的ISO 639-1語言代碼定義的,緊跟其後的是可選的兩個ISO-3166-1-appha-2地區代碼字母(前面是小寫的“r”)。 這個編碼不區分大小寫,r前綴被用於區分地區部分,不能夠單獨指定地區。 如果用戶改變瞭系統中的語言設置,那麼在應用程序的運行期間也能夠改變為對應的語言。 |
最小寬度 | sw<N>dp 例如: sw320dp sw600dp sw720dp 等 |
屏幕的基本尺寸,是指最短的可用屏幕區域。具體的說,設備的最小寬度是屏幕可用的寬度和高度中最短的那個(也可以把它看做是屏幕的最小可能的寬度)。這樣就可以使用這個限定符來確保應用程序至少有<N>dp的寬度可用於UI界面,而不管屏幕的當前方向。 例如,如果佈局在任何時候都需要至少600dp的最小屏幕尺寸,那麼就能夠使用這個限定符,在res/layout-sw600dp/目錄中創建佈局資源。系統隻會在可用屏幕的尺寸至少是600dp的時候才會使用這些資源,而不管600dp是否是被用戶認知的高度或寬度。最小寬度是設備的固定屏幕尺寸特征,當屏幕的方向發生改變時,設備的最小寬度不改變。 設備的最小寬度需要考慮屏幕的裝飾和系統UI的占用。例如,如果設備有一些固定的UI元素要沿著最小寬度的軸向,占用一定的屏幕空間,那麼系統聲明的最小寬度要比實際的屏幕尺寸要小,因為被系統占用的像素部分對用戶應用程序的UI無效。因此,這個值應該是應用程序佈局所需要的最小的實際尺寸(通常,這個值是佈局支持的最小寬度,而不管屏幕的當前方向)。 以下是可以使用的通用屏幕尺寸的一些值: 1.320,針對以下屏幕配置的設備: 240x320ldpi(QVGA手持設備) 320x480mdpi(手持設備) 480x800hdpi(高分辨率手持設備) 2.480,針對480x800mdpi的屏幕(平板或手持設備) 3.600,針對600x1024mdip的屏幕(7英寸平板) 4.720,針對720x1280mdip的屏幕(10英寸平板) 當應用程序提供瞭多個帶有不同值的最小寬度限定符資源目錄時,系統會使用最接近(不超出)設備最小寬度的那個資源。 這個限定符被添加在API級別13中。 還要看android:requiresSmallestWidthDp屬性,它聲明瞭與你的應用程序兼容的最小的最小寬度,並且smallestScreenWidthDp配置字段會持有這個設備最小寬度的值。 |
可用寬度 | w<N>dp 例如: w720dp w1024dp 等 |
指定最小的可用屏幕寬度,在資源中應該以dp為單位來定義<N>的值。當方向在橫向和縱向之間改變時,這個配置值會跟當前的實際的寬度相匹配。 當應用程序給這個配置提供瞭多個不同值的資源目錄時,系統會使用最接近(不超過)設備當前屏幕寬度的那個配置。這個值需要考慮屏幕裝飾占據的空間,因此,如果設備在顯示的左邊或右邊有一些固定的UI元素,那麼使用的寬度值就要比實際的屏幕尺寸小,因為這些固定UI元素的占用,使得應用程序的可用空間減少。 這個特性被添加在API級別13中 還要看screenWidthDp配置字段,它持有當前的屏幕寬度。 |
可用高度 | h<N>dp 例如: h720dp h1024dp 等 |
指定最小的可用屏幕高度,在資源中應該以dp為單位來定義<N>的值,當方向在橫向和縱向直接改變時,這個配置值應該跟當前的實際高度匹配。 當應用程序給這個配置提供瞭不同值的多個資源目錄時,系統會使用最接近(不超過)設備當前屏幕高度的那個配置。這個要考慮屏幕裝飾的占用情況,因此,如果設備在顯示的上方或底部有一些固定的UI元素,那麼要使用的高度值要比實際的屏幕尺寸小,因為這些固定UI元素的占用,使得應用程序的可用空間減少。不固定的屏幕裝飾(如電話的狀態欄能夠在全屏時被隱藏)是不考慮的,像標題欄或操作欄這樣的窗口裝飾也不考慮,因此應用必須準備處理比它們指定的空間要小的情況。 這個限定符被添加在API級別13中。 還要看screenHeightDp配置字段,它持有當前屏幕的高度。 |
屏幕尺寸 | small normal large xlarge |
small:這種屏類似低分辨率的QVGA屏幕。對於小屏的最小佈局尺寸大約是320x426dp。例如QVGA低分辨率和VGA高分辨率。 normal:這種屏類似中等分辨率的HVGA屏幕。對於普通屏幕的最小佈局尺寸大約是320x470dp。如,WQVGA低分辨率屏、HVGA中等分辨率屏、WVGA高分辨率屏。 large:這種屏類似中等分辨率的VGA屏幕,對於大屏幕的最小佈局尺寸大約是480x640dp。例如VGA和WVGA的中等分辨率屏。 xlarge:這種屏被認為比傳統的中等分辨率的HVGA屏幕大。針對xlarge屏的最小佈局尺寸大約是720x960dp。在大多數情況下,這種超大屏幕的設備因為太大而要放到背包中來攜帶,而且最有可能的是平板樣式的設備。 註意:使用尺寸限定符不意味著資源僅用於這個尺寸的屏幕。如果沒有用限定符提供與當前設備配置相匹配的可選資源,那麼系統會使用與配置最接近的資源。 警告:如果所有使用尺寸限定符的資源都比當前屏幕大,那麼系統將不會使用它們,並且應用程序會在運行時崩潰(例如,如果所有的佈局都被標記瞭xlarge限定符,而設備卻是一個普通尺寸的屏幕)。 這個限定符被添加在API級別4以後的版本中。 |
屏幕外觀 | long notlong |
long:長屏幕,如WQVGA、WVGA、FWVGA notlong:非長屏幕,如QVGA、HVGA、VGA 這個限定符被添加在API級別4以後的版本中 這個限定符完全是基於屏幕的外觀比率,不相對屏幕的方向。 還要看screenLayout配置字段,它指示瞭屏幕是否是長屏。 |
屏幕方向 | port land |
port:縱向設備(垂直) land:橫向設備(水平) 如果用戶旋轉屏幕,這個限定能夠在應用程序運行期間改變。 orientation配置字段指示當前設備的方向。 |
泊位模式 | car desk |
car:設備停靠在汽車中 desk:設備停靠在書桌中 這個限定符被添加在API級別8以後的版本中 如果用戶改變瞭設備的停靠地點,那麼能夠在應用程序的運行期間改變這個限定。可以使用UiModeManager對象來啟用或禁止這種模式。 |
夜間模式 | night notnight |
night:夜間 notnight:白天 被添加在API級別8以後的版本中 如果夜間模式被保留在自動模式中(默認),那麼在應用程序運行期間,會基於白天的時間來進行模式的改變。可以使用UiModeManager對象來啟用或禁止這種模式。 |
屏幕像素密度(dpi) | ldpi mdpi hdpi xhdpi nodpi tvdpi |
ldpi:針對大約120dpi的低分辨率屏幕; mdpi:針對大約160dpi的中等分辨率屏幕(在傳統的HVGA上); hdpi:針對大約240dpi的高分辨率屏幕; xhdpi:針對大約320dpi的超高分辨率屏幕,被添加在API基本8以後的版本中; nodpi:這個限定被用於不想根據匹配的設備分辨率進行縮放的位圖資源。 tvdpi:在mdpi和hdpi之間的屏幕,大約是213dpi。這種分組不是主要的分辨率,大多數是為電視來考慮的,並且大多數應用不需要它—提供mdpi和hdpi資源就可以滿足大多數應用程序需要瞭,並且系統會適當的縮放它們。這個限定符在API級別13以後被引入。 四種主要的分辨率之間的縮放比例是:3:4:6:8(忽略tvdpi分辨率),因此一個9×9的ldpi位圖,在mdpi中是12×12、在hdpi中是18×18、在xhdpi中是24×24。 如果感覺在電視或其他某些設備上的圖片資源不好看,並且想要試用tvdpi資源,那麼縮放因子是1.33*mdpi。例如,一個100px x 100px的mdpi圖片的圖片應該被放大成133px x 133px的tvdpi圖片。 註意:使用分辨率限定符不意味著資源僅適用與對應分辨率的屏幕。如果沒有提供與當前設備配置匹配的可選資源,那麼系統會使用最接近的資源。 |
觸屏類型 | notouch stylus finger |
notouch:非觸屏設備 stylus:有適用手寫筆的電阻屏設備 finger:觸屏設備 touchscreen配置字段,指示到瞭設備上的觸屏類型。 |
鍵盤可用性 | keysexposed keyshidden keyssoft |
keysexposed:設備有可用的鍵盤。如果設備啟用瞭軟鍵盤,那麼即使在硬鍵盤沒有暴露給用戶時也可以使用這個限定符。如果沒有提供軟鍵盤或者軟鍵盤被禁用,那麼隻有在硬鍵盤被暴露給用戶時才能夠使用這個限定符。 keyshidden:設備有可用的硬鍵盤,但是被隱藏瞭,並且設備沒有可用的軟鍵盤。 keyssoft:設備有可用的軟鍵盤,不管它是否可見。 如果提供瞭keysexposed資源,但沒有keyssoft資源,那麼隻要系統有可用的軟鍵盤,系統就會使用keysexposed資源而不管鍵盤是否可見。 如果用戶打開瞭硬鍵盤,就可以在應用程序運行期間改變這個限定。 hardKeyboardHidden和keyboardHidden配置字段分別指明硬鍵盤的可見性以及可見的鍵盤類型(包括軟鍵盤)。 |
主要文本輸入法 | nokeys qwerty l2key |
nokeys:設備沒有用於文本輸入的硬鍵盤; qwerty:設備有標準的硬鍵盤,不管用戶是否可見; 12key:設備有12個鍵的硬鍵盤,不管用戶是否可見。 keyboard配置字段指明可用的主要文本輸入方法。 |
導航鍵的有效性 | navexposed navhidden |
navexposed:導航鍵對用戶可用; navhidden:導航鍵不可用。 如果用戶能夠看到導航鍵,那麼在應用程序運行時就能夠改變這個限定。 navigationHidden配置字段,指示導航鍵是否隱藏。 |
主要的非觸屏導航方法 | nonav dpad trackball wheel |
nonav:除瞭使用觸屏以外,設備沒有其他導航設施。 dpad:設備有用於導航的定向板(d-pad)。 trackball:設備有用於導航的軌跡球。 wheel:設備有用於導航的定向滾輪(不常見)。 navigation配置字段指明可用的導航方法類型。 |
平臺版本(API 級別) | 例如: v3 v4 v7 等 |
設備支持的API級別。如v1代表API級別1(帶有Android1.0或更高版的設備),v4代表API級別4(帶有Android1.6或更高版本的設備) 警告:Android1.5和1.6隻有在限定符跟平臺版本完全匹配時,才能匹配資源。 |
註意:某些配置限定符從Android1.0開始就被添加瞭,因此不是所有的Android版本都支持所有的限定符。使用一個新的限定符,就隱含著添加瞭平臺版本限定符,這樣舊的設備才能夠保證忽略這個限定符。如使用w600dp限定符,將自動的包含v13限定符。因為有效寬度限定符在API級別13以後才支持。要避免一些問題的發生,就要始終包含一組默認的資源(這組資源沒有限定符)。
限定符命名規則
以下是有關使用配置限定符的命名規則:
1. 能夠給單一的資源集合指定多個限定符,限定符用短橫線分開。例如,drawable-en-rUS-land指定資源要用於橫向的美式英語設備。
2. 限定符必須按照表2列出的順序來使用,如:
錯誤用法:drawable-hdpi-port
正確用法:drawable-port-hdpi
3. 可選資源目錄不能嵌套,如:不能用以下這樣的目錄結構:
res/drawable/drawable-en/
4. 值是大小寫敏感的。資源編譯器為瞭避免有關大小寫敏感的文件系統問題,會把目錄名轉換成小寫。命名中的任何大寫字母隻是為瞭方便閱讀。
5. 每個限定符類型隻能支持一種資源值。例如,如果想對西班牙和法國使用同一個可描畫文件,不能把目錄名命名成drawable-rES-rFR/。相反需要兩個目錄,如:drawable-rES和drawable-rFR/,每個目錄中包含對應的文件。但是實際上不需要在這兩個目錄中復制相同的文件,可以使用資源命名別名來解決,詳細請看下面的“創建資源別名”。
把這些可選資源保存到這些帶有限定符的命名目錄中後,Android會基於當前的設備配置在應用中自動的應用相應的資源。每次請求資源,Android都會檢查包含請求資源文件的可選資源目錄,然後查找最匹配的資源。如果沒有跟實際設備配置匹配的可選資源,那麼,Android會使用相應的默認資源(不包含配置限定符的一組資源)。
給資源創建別名
當要給多種設備配置使用同一個資源時(但不打算把這個資源作為默認資源),不需要把相同的資源放在多個可選資源目錄中,相反,在某些情況下,能夠像保存在默認資源目錄中一樣給可選資源創一個別名。
註意:不是所有的資源都提供能夠創建一個指向另外一個資源的別名的機制。實際上,animation/、menu/、raw/以及xml/目錄中的非特定資源不提供這中功能。。
例如,假設有一個應用程序圖標:icon.png,它在不同的地區需呀唯一的版本。但是,有兩個地區,加拿大英語去和加拿大法語區,它們需要使用相同的版本。可以假設需要把相同的圖片分別復制到加拿大英語區和加拿大法語區的資源目錄中,但實際上不需要這麼做。可以把使用icon_ca.png名字來保存這張圖片(icon.png以外的任意名稱),並且把它放到默認的res/drawabel/目錄中,然後在res/drawable-en-rCA/和res/drawable-fr-rCA/目錄中創建一個cion.xml文件,使用<bitmap>元素指向icon_ca.png資源。這樣就允許隻保存一個版本的PNG文件,並且有兩個小的XML文件指向它。
可描畫資源別名
使用<bitmap>元素,給一個既存的可描畫資源創建一個別名,例如:
?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
android:src="@drawable/icon_ca" />
如果把這個文件作為icon.xml來保存在一個可選資源目錄中,如res/drawable-en-rCA/,那麼它就會被編譯進能夠使用R.drawable.icon來引用的資源,但是實際上它是R.drawable.cion_ca資源的一個別名。
佈局資源別名
使用封裝在<merge>元素中的<include>元素來給一個既存的佈局創建別名,如:
<?xml version="1.0" encoding="utf-8"?>
<merge>
<include layout="@layout/main_ltr"/>
</merge>
如果把這個文件保存為main.xml,那麼它就會被編譯進能夠用R.layout.main來引用的一個資源,但是實際上它是R.layout.main_ltr資源的別名。
字符串和其他簡單值的資源別名
隻需簡單的使用被期望的字符串的資源ID作為新的字符串的值,就可以給一個既存的字符串創建一個別名,如:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="hello">Hello</string>
<string name="hi">@string/hello</string>
</resources>
R.string.hi資源現在是R.string.hello資源的一個別名。
其他簡單的值資源也是用同樣的方法,如一個顏色值:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<color name="yellow">#f00</color>
<color name="highlight">@color/red</color>
</resources>
摘自 FireOfStar的專欄