位圖文件（.png、.9.png、.jpg、.gif）或編譯為以下可繪制對象資源子類型的 XML 文件：

• 位圖文件
• 九宮格（可調(diào)整大小的位圖）
• 狀態(tài)列表
• 形狀
• 動畫可繪制對象
• 其他可繪制對象

請參閱 Drawable 資源。

需以原始形式保存的任意文件。如要使用原始 InputStream 打開這些資源，請使用資源 ID（即 R.raw.filename）調(diào)用 Resources.openRawResource()。

但是，如需訪問原始文件名和文件層次結(jié)構(gòu)，則可以考慮將某些資源保存在 assets/ 目錄（而非 res/raw/）下。assets/ 中的文件沒有資源 ID，因此您只能使用 AssetManager 讀取這些文件。

包含字符串、整型數(shù)和顏色等簡單值的 XML 文件。

其他 res/ 子目錄中的 XML 資源文件會根據(jù) XML 文件名定義單個資源，而 values/ 目錄中的文件可描述多個資源。對于此目錄中的文件，<resources> 元素的每個子元素均會定義一個資源。例如，<string> 元素會創(chuàng)建 R.string 資源，<color> 元素會創(chuàng)建 R.color 資源。

由于每個資源均使用自己的 XML 元素進行定義，因此您可以隨意命名文件，并在某個文件中放入不同的資源類型。但是，您可能需要將獨特的資源類型放在不同的文件中，使其一目了然。例如，對于可在此目錄中創(chuàng)建的資源，下面給出了相應(yīng)的文件名約定：

• arrays.xml：資源數(shù)組（類型數(shù)組）。
• colors.xml：顏色值。
• dimens.xml：尺寸值。
• strings.xml：字符串值。
• styles.xml：樣式。

請參閱字符串資源、樣式資源和更多資源類型。

移動設(shè)備國家代碼 (MCC)，（可選）后跟設(shè)備 SIM 卡中的移動設(shè)備網(wǎng)絡(luò)代碼 (MNC)。例如，mcc310 是指美國的任一運營商，mcc310-mnc004 是指美國的 Verizon 公司，mcc208-mnc00 是指法國的 Orange 公司。

如果設(shè)備使用無線裝置連接（GSM 手機），則 MCC 和 MNC 值均來自 SIM 卡。

您也可以單獨使用 MCC（例如，將國家/地區(qū)特定的合法資源加入應(yīng)用）。如果只需根據(jù)語言指定，則改用語言和地區(qū)限定符（稍后進行介紹）。如果決定使用 MCC 和 MNC 限定符，請謹慎執(zhí)行此操作并測試限定符是否按預(yù)期工作。

另請參閱配置字段 mcc 和 mnc，二者分別表示當前的移動設(shè)備國家代碼和移動設(shè)備網(wǎng)絡(luò)代碼。

語言通過由兩個字母組成的 ISO 639-1 語言代碼進行定義，可以選擇后跟兩個字母組成的 ISO 3166-1-alpha-2 區(qū)域碼（前綴用小寫字母 r）。

這些代碼不區(qū)分大小寫；r 前綴用于區(qū)分區(qū)域碼。您不能單獨指定區(qū)域。

Android 7.0（API 級別 24）引入對 BCP 47 語言標記的支持，可供您用來限定特定語言和區(qū)域的資源。語言標記由一個或多個子標記序列組成，每個子標記都能優(yōu)化或縮小由整體標記標識的語言范圍。如需了解有關(guān)語言標記的詳細信息，請參閱用于標識語言的標記。

如要使用 BCP 47 語言標記，請將 b+ 和兩個字母的 ISO 639-1 語言代碼連接；其后還可選擇使用其他子標記，用 + 分隔即可。

如果用戶在系統(tǒng)設(shè)置中更改語言，則語言標記可能會在應(yīng)用的生命周期中發(fā)生變更。如需了解運行時應(yīng)用會因此受到何種影響，請參閱處理運行時變更。

有關(guān)針對其他語言本地化應(yīng)用的完整指南，請參閱本地化。

另請參閱 getLocales() 方法，了解該方法提供的已定義語言區(qū)域列表。此列表包含主要的語言區(qū)域。

應(yīng)用的布局方向。ldrtl 是指“布局方向從右到左”。ldltr 是指“布局方向從左到右”（默認的隱式值）。

此配置適用于布局、可繪制資源或值等任何資源。

例如，若要針對阿拉伯語提供某種特定布局，并針對任何其他“從右到左”的語言（如波斯語或希伯來語）提供某種通用布局，則可提供以下資源：

請注意：如要為應(yīng)用啟用從右到左的布局功能，則必須將 supportsRtl 設(shè)置為 "true"，并將 targetSdkVersion 設(shè)置為 17 或更高版本。

此項為 API 級別 17 中的新增配置。

屏幕的基本尺寸，由可用屏幕區(qū)域的最小尺寸指定。具體而言，設(shè)備的 smallestWidth 是屏幕可用高度和寬度的最小尺寸（您也可將其視為屏幕的“最小可能寬度”）。無論屏幕的當前方向如何，您均可使用此限定符確保應(yīng)用界面的可用寬度至少為 <N> dp。

例如，如果布局要求屏幕區(qū)域的最小尺寸始終至少為 600dp，則可使用此限定符創(chuàng)建布局資源 res/layout-sw600dp/。僅當可用屏幕的最小尺寸至少為 600dp（無論 600dp 表示的邊是用戶所認為的高度還是寬度）時，系統(tǒng)才會使用這些資源。最小寬度為設(shè)備的固定屏幕尺寸特征；即使屏幕方向發(fā)生變化，設(shè)備的最小寬度仍會保持不變。

使用最小寬度確定一般屏幕尺寸非常有用，因為寬度通常是設(shè)計布局時的驅(qū)動因素。界面經(jīng)常會垂直滾動，但對其水平方向所需要的最小空間具有非常硬性的限制?？捎脤挾纫彩谴_定是否對手持式設(shè)備使用單窗格布局，或?qū)ζ桨咫娔X使用多窗格布局的關(guān)鍵因素。因此，您可能最關(guān)注每臺設(shè)備上的最小可能寬度。

設(shè)備的最小寬度會將屏幕裝飾元素和系統(tǒng)界面考慮在內(nèi)。例如，如果設(shè)備屏幕上的某些永久性界面元素沿著最小寬度軸占據(jù)空間，則系統(tǒng)會聲明最小寬度小于實際屏幕尺寸，因為這些屏幕像素不適用于您的界面。

以下是一些可用于常見屏幕尺寸的值：

• 320，適用于屏幕配置如下的設(shè)備：
  • 240x320 ldpi（QVGA 手機）
  • 320x480 mdpi（手機）
  • 480x800 hdpi（高密度手機）
• 480，適用于 480x800 mdpi 之類的屏幕（平板電腦/手機）。
• 600，適用于 600x1024 mdpi 之類的屏幕（7 英寸平板電腦）。
• 720，適用于 720x1280 mdpi 之類的屏幕（10 英寸平板電腦）。

當應(yīng)用為多個資源目錄提供不同的 smallestWidth 限定符值時，系統(tǒng)會使用最接近（但未超出）設(shè)備 smallestWidth 的值。

此項為 API 級別 13 中的新增配置。

另請參閱 android:requiresSmallestWidthDp 屬性（聲明與應(yīng)用兼容的最小 smallestWidth）和 smallestScreenWidthDp 配置字段（存放設(shè)備的 smallestWidth 值）。

如需了解有關(guān)不同屏幕設(shè)計和使用此限定符的詳細信息，請參閱支持多種屏幕開發(fā)者指南。

指定資源應(yīng)使用的最小可用屏幕寬度（以 dp 為單位，由 <N> 值定義）。當屏幕方向在橫向和縱向之間切換時，此配置值也會隨之變化，以匹配當前的實際寬度。

此功能往往有助于確定是否使用多窗格布局，因為即便在使用平板電腦設(shè)備時，您通常也不希望豎屏以橫屏的方式使用多窗格布局。因此，您可以使用此功能指定布局所需的最小寬度，而無需同時使用屏幕尺寸和屏幕方向限定符。

應(yīng)用為此配置提供具有不同值的多個資源目錄時，系統(tǒng)會使用最接近（但未超出）設(shè)備當前屏幕寬度的值。此處的值會考慮屏幕裝飾元素，因此如果設(shè)備顯示屏的左邊緣或右邊緣上有一些永久性 UI 元素，考慮到這些 UI 元素，同時為減少應(yīng)用的可用空間，設(shè)備會使用小于實際屏幕尺寸的寬度值。

此項為 API 級別 13 中的新增配置。

另請參閱 screenWidthDp 配置字段，該字段存放當前屏幕寬度。

如需了解有關(guān)不同屏幕設(shè)計和使用此限定符的詳細信息，請參閱支持多種屏幕開發(fā)者指南。

指定資源應(yīng)使用的最小可用屏幕高度（以“dp”為單位，由 <N> 值定義）。當屏幕方向在橫向和縱向之間切換時，此配置值也會隨之變化，以匹配當前的實際高度。

對比使用此方式定義布局所需高度與使用 w<N>dp 定義所需寬度，二者均非常有用，且都無需同時使用屏幕尺寸和方向限定符。但大多數(shù)應(yīng)用不需要此限定符，因為界面經(jīng)常垂直滾動，所以高度需更有彈性，而寬度則應(yīng)更固定。

當應(yīng)用為此配置提供具有不同值的多個資源目錄時，系統(tǒng)會使用最接近（但未超出）設(shè)備當前屏幕高度的值。此處的值會考慮屏幕裝飾元素，因此如果設(shè)備顯示屏的上邊緣或下邊緣上有一些永久性 UI 元素，考慮到這些 UI 元素，同時為減少應(yīng)用的可用空間，設(shè)備會使用小于實際屏幕尺寸的高度值。非固定的屏幕裝飾元素（例如，全屏時可隱藏的手機狀態(tài)欄）并不在考慮范圍內(nèi)，標題欄或操作欄等窗口裝飾亦如此，因此應(yīng)用必須準備好處理稍小于其指定值的空間。

此項為 API 級別 13 中的新增配置。

另請參閱 screenHeightDp 配置字段，該字段存放當前屏幕寬度。

如需了解有關(guān)不同屏幕設(shè)計和使用此限定符的詳細信息，請參閱支持多種屏幕開發(fā)者指南。

• small：尺寸類似于低密度 VGA 屏幕的屏幕。小屏幕的最小布局尺寸約為 320x426 dp。例如，QVGA 低密度屏幕和 VGA 高密度屏幕。
• normal：尺寸類似于中等密度 HVGA 屏幕的屏幕。標準屏幕的最小布局尺寸約為 320x470 dp。例如，WQVGA 低密度屏幕、HVGA 中等密度屏幕、WVGA 高密度屏幕。
• large：尺寸類似于中等密度 VGA 屏幕的屏幕。大屏幕的最小布局尺寸約為 480x640 dp。例如，VGA 和 WVGA 中等密度屏幕。
• xlarge：明顯大于傳統(tǒng)中等密度 HVGA 屏幕的屏幕。超大屏幕的最小布局尺寸約為 720x960 dp。在大多數(shù)情況下，屏幕超大的設(shè)備體積太大，不能放進口袋，最常見的是平板式設(shè)備。此項為 API 級別 9 中的新增配置。

請注意：使用尺寸限定符并不表示資源僅適用于該尺寸的屏幕。如果沒有為備用資源提供最符合當前設(shè)備配置的限定符，則系統(tǒng)可能會使用其中最匹配的資源。

注意：如果所有資源均使用大于當前屏幕的尺寸限定符，則系統(tǒng)不會使用這些資源，并且應(yīng)用將在運行時崩潰（例如，如果所有布局資源均以 xlarge 限定符標記，但設(shè)備是標準尺寸的屏幕）。

此項為 API 級別 4 中的新增配置。

如需了解詳細信息，請參閱支持多種屏幕。

另請參閱 screenLayout 配置字段，該字段指示屏幕是小尺寸、標準尺寸還是大尺寸。

• long：寬屏，如 WQVGA、WVGA、FWVGA
• notlong：非寬屏，如 QVGA、HVGA 和 VGA

此項為 API 級別 4 中新增配置。

此配置完全基于屏幕的縱橫比（寬屏較寬），并且與屏幕方向無關(guān)。

另請參閱 screenLayout 配置字段，該字段指示屏幕是否為寬屏。

• round：圓形屏幕，例如圓形可穿戴式設(shè)備
• notround：方形屏幕，例如手機或平板電腦

此項為 API 級別 23 中的新增配置。

另請參閱 isScreenRound() 配置方法，該方法指示屏幕是否為圓形屏幕。

• {@code widecg}：顯示廣色域，如 Display P3 或 AdobeRGB
• {@code nowidecg}：顯示窄色域，如 sRGB

此項為 API 級別 26 中的新增配置。

另請參閱 isScreenWideColorGamut() 配置方法，該方法指示屏幕是否具有廣色域。

• {@code highdr}：顯示高動態(tài)范圍
• {@code lowdr}：顯示低/標準動態(tài)范圍

此項為 API 級別 26 中的新增配置。

另請參閱 isScreenHdr() 配置方法，該方法指示屏幕是否具有 HDR 功能。

• port：設(shè)備處于縱向（垂直）
• land：設(shè)備處于橫向狀態(tài)（水平）

如果用戶旋轉(zhuǎn)屏幕，此配置可能會在應(yīng)用生命周期中發(fā)生變化。如需了解這會在運行時期間給應(yīng)用帶來哪些影響，請參閱處理運行時變更。

另請參閱 orientation 配置字段，該字段指示當前的設(shè)備方向。

• car：設(shè)備正在車載手機座上顯示
• desk：設(shè)備正在桌面手機座上顯示
• television：設(shè)備正在通過電視顯示內(nèi)容，通過將界面投影到離用戶較遠的大屏幕上，為用戶提供“十英尺”體驗。主要面向遙控交互或其他非觸控式交互
• appliance：設(shè)備正在用作沒有顯示屏的裝置
• watch：設(shè)備配有顯示屏，并且可戴在手腕上
• vrheadset：設(shè)備正在通過虛擬現(xiàn)實耳機顯示內(nèi)容

此項為 API 級別 8 中的新增配置，API 13 中的新增電視配置，API 20 中的新增手表配置。

如需了解應(yīng)用在設(shè)備插入基座或從中移除時的響應(yīng)方式，請閱讀確定并監(jiān)控插接狀態(tài)和類型。

如果用戶將設(shè)備插入基座，此配置可能會在應(yīng)用生命周期中發(fā)生變化。您可以使用 UiModeManager 啟用或禁用其中的部分模式。如需了解這會在運行時期間給應(yīng)用帶來哪些影響，請參閱處理運行時變更。

• night：夜間
• notnight：白天

此項為 API 級別 8 中的新增配置。

如果夜間模式停留在自動模式（默認），此配置可能會在應(yīng)用生命周期中發(fā)生變化。在此情況下，該模式會根據(jù)當天的時間進行調(diào)整。您可以使用 UiModeManager 啟用或禁用此模式。如需了解這會在運行時期間給應(yīng)用帶來哪些影響，請參閱處理運行時變更。

• ldpi：低密度屏幕；約為 120dpi。
• mdpi：中等密度（傳統(tǒng) HVGA）屏幕；約為 160dpi。
• hdpi：高密度屏幕；約為 240dpi。
• xhdpi：超高密度屏幕；約為 320dpi。此項為 API 級別 8 中的新增配置
• xxhdpi：絕高密度屏幕；約為 480dpi。此項為 API 級別 16 中的新增配置
• xxxhdpi：極高密度屏幕使用（僅限啟動器圖標，請參閱支持多種屏幕中的注釋）；約為 640dpi。此項為 API 級別 18 中的新增配置
• nodpi：可用于您不希望為匹配設(shè)備密度而進行縮放的位圖資源。
• tvdpi：密度介于 mdpi 和 hdpi 之間的屏幕；約為 213dpi。此限定符并非指“基本”密度的屏幕。它主要用于電視，且大多數(shù)應(yīng)用都不使用該密度 — 大多數(shù)應(yīng)用只會使用 mdpi 和 hdpi 資源，而且系統(tǒng)將根據(jù)需要對這些資源進行縮放。此項為 API 級別 13 中的新增配置
• anydpi：此限定符適合所有屏幕密度，其優(yōu)先級高于其他限定符。這非常適用于矢量可繪制對象。此項為 API 級別 21 中的新增配置
• nnndpi：用于表示非標準密度，其中 nnn 是正整數(shù)屏幕密度。此限定符不適用于大多數(shù)情況。使用標準密度存儲分區(qū)，可顯著減少因支持市場上各種設(shè)備屏幕密度而產(chǎn)生的開銷。

六個基本密度之間的縮放比為 3:4:6:8:12:16（忽略 tvdpi 密度）。因此，9x9 (ldpi) 位圖相當于 12x12 (mdpi)、18x18 (hdpi)、24x24 (xhdpi) 位圖，依此類推。

如果您認為圖像資源在電視或其他某些設(shè)備上的呈現(xiàn)效果不夠好，進而想嘗試使用 tvdpi 資源，則縮放系數(shù)應(yīng)為 1.33*mdpi。例如，mdpi 屏幕的 100px x 100px 圖像應(yīng)相當于 tvdpi 屏幕的 133px x 133px 圖像。

請注意：使用密度限定符并不表示資源僅適用于該密度的屏幕。如果沒有為備用資源提供最符合當前設(shè)備配置的限定符，則系統(tǒng)可能使用其中最匹配的資源。

如需詳細了解如何處理不同屏幕密度以及 Android 如何縮放位圖以適應(yīng)當前密度，請參閱支持多種屏幕。

• notouch：設(shè)備沒有觸摸屏。
• finger：設(shè)備有一個專供用戶通過手指直接進行交互的觸摸屏。

另請參閱 touchscreen 配置字段，該字段指示設(shè)備上的觸摸屏類型。

• keysexposed：設(shè)備擁有可用的鍵盤。如果設(shè)備啟用了軟鍵盤（不無可能），那么即使用戶未找到硬鍵盤，或者該設(shè)備沒有硬鍵盤，也可使用此限定符。如果未提供或已禁用軟鍵盤，則只有在配備硬鍵盤的情況下才可使用此限定符。
• keyshidden：設(shè)備具有可用的硬鍵盤，但其處于隱藏狀態(tài)，且設(shè)備未啟用軟鍵盤。
• keyssoft：設(shè)備已啟用軟鍵盤（無論是否可見）。

如果您提供了 keysexposed 資源，但未提供 keyssoft 資源，則無論鍵盤是否可見，只要系統(tǒng)已啟用軟鍵盤，其便會使用 keysexposed 資源。

如果用戶打開硬鍵盤，此配置可能會在應(yīng)用生命周期中發(fā)生變化。如需了解這會在運行時期間給應(yīng)用帶來哪些影響，請參閱處理運行時變更。

另請參閱配置字段 hardKeyboardHidden 和 keyboardHidden，二者分別指示硬鍵盤的可見性和任一鍵盤（包括軟鍵盤）的可見性。

• nokeys：設(shè)備沒有用于文本輸入的硬按鍵。
• qwerty：設(shè)備擁有標準硬鍵盤（無論是否對用戶可見）。
• 12key：設(shè)備擁有 12 鍵硬鍵盤（無論是否對用戶可見）。

另請參閱 keyboard 配置字段，該字段指示可用的主要文本輸入法。

• navexposed：導航鍵可供用戶使用。
• navhidden：導航鍵不可用（例如，在密封蓋子后面）。

如果用戶顯示導航鍵，此配置可能會在應(yīng)用生命周期中發(fā)生變化。如需了解這會在運行時期間給應(yīng)用帶來哪些影響，請參閱處理運行時變更。

另請參閱 navigationHidden 配置字段，該字段指示導航鍵是否處于隱藏狀態(tài)。

• nonav：除了使用觸摸屏以外，設(shè)備沒有其他導航設(shè)施。
• dpad：設(shè)備具有用于導航的方向鍵。
• trackball：設(shè)備具有用于導航的軌跡球。
• wheel：設(shè)備具有用于導航的方向盤（不常見）。

另請參閱 navigation 配置字段，該字段指示可用的導航方法類型。

設(shè)備支持的 API 級別。例如，v1 對應(yīng) API 級別 1（裝有 Android 1.0 或更高版本系統(tǒng)的設(shè)備），v4 對應(yīng) API 級別 4（裝有 Android 1.6 或更高版本系統(tǒng)的設(shè)備）。如需了解有關(guān)這些值的詳細信息，請參閱 Android API 級別文檔。