アプリのリソースの概要

リソースとは、コードが使用する追加のファイルと静的コンテンツであり、ビットマップ、レイアウト定義、ユーザー インターフェース文字列、アニメーション命令などがあります。

画像や文字列などのアプリリソースは必ずコードとは別にする必要があります。それにより、コードとは独立して管理できるようになります。また、代替リソースは、異なる名前を付けたリソース ディレクトリに分類してデバイス構成ごとに指定する必要があります。実行時に、Android は現在の構成に基づいて適切なリソースを使用します。たとえば、画面サイズごとに異なる UI レイアウトや言語設定ごとに異なる文字列を指定できます。

アプリリソースをコードとは別にした場合、そのリソースにアクセスするには、プロジェクトの R クラスで生成されたリソース ID を使用します。このドキュメントでは、Android プロジェクトでのリソースの分類方法と、デバイス構成ごとの代替リソースの指定方法に加え、それらのリソースにアプリコードやその他の XML ファイルからアクセスする方法について説明します。

リソースタイプの分類

リソースはタイプごとにプロジェクトの res/ ディレクトリの対応するサブディレクトリに保存する必要があります。たとえば、単純なプロジェクトのファイル階層の例を次に示します。

MyProject/
    src/
        MyActivity.java
    res/
        drawable/
            graphic.png
        layout/
            main.xml
            info.xml
        mipmap/
            icon.png
        values/
            strings.xml

この例では、res/ ディレクトリのサブディレクトリにすべてのリソース（画像リソース、2 つのレイアウト リソース、ランチャー アイコン用の mipmap/ ディレクトリ、文字列リソース ファイル）が保存されています。リソース ディレクトリ名は重要です。これについては表 1 で説明しています。

注: mipmap フォルダの使用方法については、アプリアイコンを mipmap ディレクトリに配置するをご覧ください。

表 1. プロジェクトの res/ ディレクトリ内でサポートされるリソース ディレクトリ

注意: リソース ファイルを res/ ディレクトリの中に直接保存しないでください。コンパイラ エラーが発生します。

リソースのタイプについて詳しくは、リソースタイプの説明をご覧ください。

表 1 で定義したサブディレクトリに保存するリソースは、「デフォルト」のリソースです。つまり、このリソースではアプリのデフォルトのデザインとコンテンツを定義します。しかし、Android 搭載デバイスの種類が異なれば、要求されるリソースタイプも異なる可能性があります。たとえば、デバイスの画面が通常よりも大きい場合は、画面に余分なスペースが表示されないような別のレイアウト リソースが必要になります。また、デバイスによって異なる言語設定を使用している場合は、ユーザー インターフェースのテキストを翻訳した別の文字列リソースが必要になります。さまざまなデバイス構成向けに異なるリソースを指定するには、デフォルトのリソースに加えて、代替リソースを準備する必要があります。

代替リソースの指定

通常どのアプリにもデバイスの構成ごとに代替リソースを用意する必要があります。たとえば、各種の画面密度に対応した代替のドローアブル リソースや、各種の言語に対応した代替の文字列リソースを追加します。実行時に、Android によって現在のデバイス構成が自動的に検出され、アプリに適したリソースが読み込まれます。

図 1. それぞれ異なるレイアウト リソースを使用した 2 種類のデバイス

リソースセットに対応した構成固有の代替リソースを指定するには:

1. res/ の中に、<resources_name>-<qualifier> という形式の名前で新しいディレクトリを作成します。
   • <resources_name> は、対応するデフォルトのリソースのディレクトリ名です（表 1 で定義）。
   • <qualifier> は、そのリソースが使用される個々の構成を指定する名前です（表 2 で定義）。

   <qualifier> は複数追加できます。それらはダッシュ記号でつなぎます。

   注意: 複数の修飾子を追加する場合は、それらを表 2 の記載と同じ順序で配置する必要があります。修飾子の順序が間違っている場合、そのリソースは無視されます。

2. この新しいディレクトリにそれぞれの代替リソースを保存します。リソース ファイルにはデフォルトのリソース ファイルと同じ名前を付ける必要があります。

デフォルトのリソースと代替リソースの例を次に示します。

res/
    drawable/
        icon.png
        background.png
    drawable-hdpi/
        icon.png
        background.png

hdpi 修飾子は、そのディレクトリにあるリソースが高密度画面を備えたデバイス用であることを示します。それぞれの drawable ディレクトリにある画像のサイズは画面密度ごとに調整されていますが、ファイル名は同じです。このように、icon.png や background.png の画像を参照する際に使用するリソース ID は常に同じですが、Android では、デバイス構成情報をリソース ディレクトリ名の修飾子と比較することで、現在のデバイスに最も適したバージョンのリソースをそれぞれ選択します。

注意: 代替リソースを定義する場合は、必ずデフォルト構成でもリソースを定義してください。そうしないと、デバイスで構成が変更された場合にアプリでランタイム例外が発生する可能性があります。たとえば、文字列を values-en だけに追加して values には追加しないと、ユーザーがデフォルトのシステム言語を変更したときに、アプリで Resource Not Found 例外が発生することがあります。

Android ではいくつかの構成修飾子がサポートされていて、複数の修飾子をダッシュ記号でつなぐことで 1 つのディレクトリ名に追加できます。表 2 では、有効な構成修飾子の一覧を優先度の高い順に示します。リソース ディレクトリで複数の修飾子を使用する場合は、それらを表に記載されている順序でディレクトリ名に追加する必要があります。

表 2. 構成修飾子の名前。

注: 一部の構成修飾子は Android 1.0 以降に追加されたため、Android のすべてのバージョンですべての修飾子がサポートされているわけではありません。新しい修飾子を使用すると、プラットフォーム バージョンの修飾子が暗黙的に追加され、古いバージョンのデバイスで無視できるようになっています。たとえば、利用可能な幅の修飾子は API レベル 13 で新しく導入されたため、w600dp 修飾子を使用すると v13 修飾子が自動的に含まれます。問題を避けるため、必ず、デフォルトのリソースセット（修飾子を付けないリソースのセット）を用意してください。詳しくは、リソースに関するデバイスの互換性を最適に保つをご覧ください。

修飾子の命名規則

構成修飾子の名前を使用する場合の規則は次のとおりです。

• 複数の修飾子をダッシュ記号でつないで 1 つのリソースセットとして指定できます。たとえば drawable-en-rUS-land は、言語が英語（米国）で横向きのデバイスに適用されます。
• 修飾子は表 2 に記載されている順序で指定する必要があります。次に例を示します。
  • 不適切: drawable-hdpi-port/
  • 適切: drawable-port-hdpi/
• 代替リソースのディレクトリをネストすることはできません。たとえば、res/drawable/drawable-en/ のようにすることはできません。
• 値は大文字と小文字が区別されません。大文字と小文字が区別されないファイル システムで問題が生じるのを避けるため、リソース コンパイラでは処理の前にディレクトリ名が小文字に変換されます。大文字を使用するのは単に名前を読みやすくする場合だけです。
• 修飾子の種類ごとに 1 つの値だけを指定できます。たとえば、スペインとフランスで同じドローアブル ファイルを使用する場合、drawable-es-fr/ というディレクトリは作成できません。その場合は、drawable-es/ と drawable-fr/ というように、それぞれのファイルを保存する 2 つのリソース ディレクトリが必要になります。ただし、両方の場所に同じファイルを実際に複製する必要はありません。代わりに、リソースのエイリアスを作成できます。後述のエイリアス リソースの作成をご覧ください。

この修飾子で名前を付けたディレクトリに代替リソースを保存すると、現在のデバイス構成に基づいてアプリのリソースが自動的に適用されます。リソースが必要になるたびに、必要なリソース ファイルが保存されている代替リソース ディレクトリが調べられ、最適なリソースが見つけられます（これについては後述します）。デバイス構成に一致する代替リソースがない場合は、対応するデフォルトのリソースが使用されます（デフォルトのリソースとは、特別なリソースタイプに用意された、構成修飾子が付かないリソースセットです）。

エイリアス リソースの作成

あるリソースを複数のデバイス構成で使用したいが、デフォルトのリソースにはしたくない場合、その同じリソースを複数の代替リソース ディレクトリに保存する必要はありません。代わりに、デフォルトのリソース ディレクトリに保存したリソースのエイリアスとして機能する代替リソースを作成できます（場合によります）。

注: リソースによっては、他のリソースを表すエイリアスを作成できるメカニズムがないものもあります。特に、アニメーション、メニュー、raw、xml/ ディレクトリの配下にあるその他の未指定のリソースについては、こうした機能はありません。

たとえば、icon.png というアプリアイコンがあり、ロケールごとに固有のバージョンが必要だとします。しかし、English-Canadian と French-Canadian の 2 つのロケールについては同じバージョンを使用する必要があるとします。この場合、English-Canadian 用と French-Canadian 用の両方のリソース ディレクトリに同じ画像をコピーする必要があるように思われますが、その必要はありません。代わりに、両方に使用する画像を icon_ca.png（icon.png 以外の任意の名前）として保存し、デフォルトの res/drawable/ ディレクトリに置くことができます。次に、res/drawable-en-rCA/ と res/drawable-fr-rCA/ に、<bitmap> 要素を使用して icon_ca.png リソースを参照する icon.xml ファイルを作成します。こうすることで、PNG ファイルの 1 つのバージョンと、それを参照する 2 つの小さな XML ファイルを保存するだけで済みます（XML ファイルの例については下記をご覧ください）。

ドローアブル

既存のドローアブルのエイリアスを作成するには、<drawable> 要素を使用します。次に例を示します。

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <drawable name="icon">@drawable/icon_ca</drawable>
</resources>

このファイルを（res/values-en-rCA/ などの代替リソース ディレクトリに）icon.xml として保存した場合、ファイルは R.drawable.icon として参照できるリソースにコンパイルされますが、実際には R.drawable.icon_ca リソースのエイリアスになり、res/drawable/ に保存されます。

レイアウト

既存のレイアウトのエイリアスを作成するには、<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="red">#f00</color>
    <color name="highlight">@color/red</color>
</resources>

アプリのリソースへのアクセス

アプリでリソースを指定したら、そのリソース ID を参照して適用できます。すべてのリソース ID は、aapt ツールによって自動的に生成される、プロジェクトの R クラスで定義されます。

アプリがコンパイルされると、aapt が R クラスを生成します。このクラスには、res/ ディレクトリ内のすべてのリソースのリソース ID が含まれています。リソースのタイプごとに R サブクラスがあり（たとえば、すべてのドローアブル リソースに対応する R.drawable）、そのタイプのリソースごとに静的整数があります（たとえば R.drawable.icon）。この整数は、リソースの取得に使用できるリソース ID です。

R クラスはリソース ID を指定するために使用されますが、リソース ID を検出するためにこれを確認する必要はありません。リソース ID は常に次の要素で構成されます。

• リソースタイプ: 各リソースは string、drawable、layout などの「タイプ」に分類されます。さまざまなタイプの詳細については、リソースタイプをご覧ください。
• リソース名。ファイル名（拡張子を除く）、または XML android:name 属性の値（リソースが単純な値（文字列など）の場合）。

リソースにアクセスするには、次の 2 つの方法があります。

• コードの場合: 次のように、R クラスのサブクラスの静的整数を使用します。

  R.string.hello

  string はリソースタイプ、hello はリソース名です。この形式でリソース ID を指定すると、多くの Android API がリソースにアクセスできます。コードでのリソースへのアクセスをご覧ください。

• XML の場合: R クラスで定義されたリソース ID に対応する特別な XML 構文を使用します。次に例を示します。

  @string/hello

  string はリソースタイプ、hello はリソース名です。この構文は、リソースで指定している値が予期される XML リソース内の任意の場所に使用できます。XML からのリソースへのアクセスをご覧ください。

コードでのリソースへのアクセス

コード内でリソースを使用するには、リソース ID をメソッド パラメータとして渡します。たとえば、setImageResource() で res/drawable/myimage.png リソースを使用するように ImageView を設定できます。

val imageView = findViewById(R.id.myimageview) as ImageView
imageView.setImageResource(R.drawable.myimage)

ImageView imageView = (ImageView) findViewById(R.id.myimageview);
imageView.setImageResource(R.drawable.myimage);

Resources のメソッドを使用して個々のリソースを取得することもできます。このインスタンスは getResources() メソッドで取得できます。

構文

コード内でリソースを参照する構文は次のとおりです。

[<package_name>.]R.<resource_type>.<resource_name>

• <package_name> は、リソースがあるパッケージの名前です（独自のパッケージからリソースを参照する場合は必要ありません）。
• <resource_type> はリソースタイプの R サブクラスです。
• <resource_name> は、拡張子のないリソース ファイル名または XML 要素の android:name 属性値です（単純な値の場合）。

各リソースタイプの詳細と参照方法については、リソースタイプをご覧ください。

ユースケース

リソース ID パラメータを許容するメソッドは多数あり、Resources のメソッドを使用してリソースを取得できます。Resources のインスタンスは Context.getResources() で取得できます。

コード内でリソースにアクセスする例を次に示します。

// Load a background for the current screen from a drawable resource
window.setBackgroundDrawableResource(R.drawable.my_background_image)

// Set the Activity title by getting a string from the Resources object, because
//  this method requires a CharSequence rather than a resource ID
window.setTitle(resources.getText(R.string.main_title))

// Load a custom layout for the current screen
setContentView(R.layout.main_screen)

// Set a slide in animation by getting an Animation from the Resources object
flipper.setInAnimation(AnimationUtils.loadAnimation(this,
        R.anim.hyperspace_in))

// Set the text on a TextView object using a resource ID
val msgTextView = findViewById(R.id.msg) as TextView
msgTextView.setText(R.string.hello_message)

// Load a background for the current screen from a drawable resource
getWindow().setBackgroundDrawableResource(R.drawable.my_background_image) ;

// Set the Activity title by getting a string from the Resources object, because
//  this method requires a CharSequence rather than a resource ID
getWindow().setTitle(getResources().getText(R.string.main_title));

// Load a custom layout for the current screen
setContentView(R.layout.main_screen);

// Set a slide in animation by getting an Animation from the Resources object
flipper.setInAnimation(AnimationUtils.loadAnimation(this,
        R.anim.hyperspace_in));

// Set the text on a TextView object using a resource ID
TextView msgTextView = (TextView) findViewById(R.id.msg);
msgTextView.setText(R.string.hello_message);

注意: R.java ファイルは手動で変更しないでください。このファイルは、プロジェクトのコンパイル時に aapt ツールによって生成されるものです。変更内容は、次回のコンパイル時にオーバーライドされます。

XML からのリソースへのアクセス

既存のリソースへの参照を使用して、一部の XML 属性と要素の値を定義できます。これは、レイアウト ファイルを作成して、ウィジェットに文字列や画像を指定する際によく行います。

たとえば、Button をレイアウトに追加する場合は、ボタンテキストに文字列リソースを使用します。

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/submit" />

構文

XML リソース内でリソースを参照する構文は次のとおりです。

@[<package_name>:]<resource_type>/<resource_name>

• <package_name> は、リソースがあるパッケージの名前です（同じパッケージからリソースを参照する場合は必要ありません）。
• <resource_type> はリソースタイプの R サブクラスです。
• <resource_name> は、拡張子のないリソース ファイル名または XML 要素の android:name 属性値です（単純な値の場合）。

各リソースタイプの詳細と参照方法については、リソースタイプをご覧ください。

ユースケース

場合によっては、XML の値にリソースを使用する必要があります（たとえば、ウィジェットにドローアブル画像を適用するなど）。ただし、単純な値を受け付ける場所であれば XML 内のどこにでもリソースを使用できます。たとえば、次のリソース ファイルにはカラーリソースと文字列リソースが含まれています。

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <color name="opaque_red">#f00</color>
   <string name="hello">Hello!</string>
</resources>

これらのリソースを次のレイアウト ファイルで使用して、テキストの色とテキストの文字列を設定できます。

<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:textColor="@color/opaque_red"
    android:text="@string/hello" />

この場合、リソースは自身のパッケージ内にあるため、リソースの参照でパッケージ名を指定する必要はありません。システム リソースを参照する場合は、パッケージ名を含める必要があります。次に例を示します。

<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:textColor="@android:color/secondary_text_dark"
    android:text="@string/hello" />

注: 他の言語用にアプリをローカライズできるように、常に文字列リソースを使用します。代替リソース（ローカライズされた文字列など）の作成方法については、代替リソースの指定をご覧ください。他の言語向けにアプリをローカライズする方法については、ローカライズをご覧ください。

XML でリソースを使用してエイリアスを作成することもできます。たとえば、別のドローアブル リソースのエイリアスであるドローアブル リソースを作成できます。

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/other_drawable" />

これは冗長なように見えますが、代替リソースを使用する場合には非常に役立ちます。詳しくはエイリアス リソースの作成をご覧ください。

スタイル属性の参照

スタイル属性リソースを使用すると、現在適用されているテーマの属性の値を参照できます。スタイル属性を参照すると、ハードコードされた値を指定する代わりに、現在のテーマによって得られる標準のバリエーションに合わせてスタイル設定を行い、UI 要素の外観をカスタマイズできます。スタイル属性の参照は、基本的に「現在のテーマでこの属性によって定義されているスタイルを使用する」という意味になります。

名前の構文が通常のリソース形式とほとんど同一ですが、スタイル属性を参照するには、アットマーク（@）ではなく疑問符（?）を使用します。リソースタイプの部分は省略可能です。次に例を示します。

?[<package_name>:][<resource_type>/]<resource_name>

たとえば、属性を参照し、テキストの色をシステムテーマの「セカンダリ」テキストと同じ色に設定するには、次のようにします。

<EditText id="text"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textColor="?android:textColorSecondary"
    android:text="@string/hello_world" />

ここで、android:textColor 属性は、現在のテーマに含まれるスタイル属性の名前を指定しています。Android では、このウィジェットの android:textColor の値として、android:textColorSecondary スタイル属性に適用された値が使用されるようになりました。このコンテキストでは属性リソースを指定することをシステム リソース ツールが認識しているため、型（?android:attr/textColorSecondary）を明示的に記述する必要はありません。attr 型は除外できます。

元のファイルへのアクセス

場合によっては、元のファイルとディレクトリへのアクセスが必要になることがあります。その場合、res/ からリソースを読み取るにはリソース ID を使用するしかないため、res/ にファイルを保存するのは適切ではありません。代わりに、assets/ ディレクトリにリソースを保存します。

assets/ ディレクトリに保存されているファイルにはリソース ID が割り当てられないため、R クラスや XML リソースから参照することはできません。代わりに、通常のファイル システムと同様に assets/ ディレクトリ内のファイルをクエリし、AssetManager を使用して元データを読み取ることができます。

ただし、元データ（動画や音声ファイルなど）を読み取るだけでよい場合は、res/raw/ ディレクトリにファイルを保存し、openRawResource() を使用してバイト ストリームとして読み取ります。

プラットフォーム リソースへのアクセス

Android には、スタイル、テーマ、レイアウトなど、さまざまな標準リソースが含まれています。これらのリソースにアクセスするには、リソース参照を android パッケージ名で修飾します。たとえば、Android には、ListAdapter 内のリストアイテムに使用できるレイアウト リソースが用意されています。

listAdapter = ArrayAdapter(this, android.R.layout.simple_list_item_1, myarray)

setListAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, myarray));

この例の simple_list_item_1 は、ListView 内のアイテムに対してプラットフォームが定義したレイアウト リソースです。これは、リストアイテム用に独自のレイアウトを作成する代わりに使用できます。

リソースに関するデバイスの互換性を最適に保つ

アプリで複数のデバイス構成をサポートするには、アプリが使用するリソースのタイプごとにデフォルトのリソースを準備しておくことが重要です。

たとえば、アプリで複数の言語をサポートする場合は、必ず、言語と地域の修飾子を付けない values/ ディレクトリを用意しておきます（このディレクトリに文字列を保存します）。このようにせず、言語と地域の修飾子を付けたディレクトリにすべての文字列ファイルを保存した場合、文字列が対応していない言語に設定されたデバイス上でアプリが実行されたとき、アプリはクラッシュします。しかし、デフォルトの values/ リソースを用意しておけば、アプリは適切に実行されます（ユーザーがその言語を理解しないとしても、クラッシュするよりはよいでしょう）。

同様に、画面の向きに基づいてデフォルトのレイアウト リソースを指定する場合は、どちらかの向きをデフォルトとして選択します。たとえば、横向き用の layout-land/ と縦向き用の layout-port/ にレイアウト リソースを保存するのではなく、どちらか一方にデフォルトの場所を割り当て、横向き用に layout/、縦向き用に layout-port/ のようにします。

デフォルトのリソースを準備しておくことが重要なのは、アプリが予期しない構成で実行される場合があるだけでなく、Android の新しいバージョンには、古いバージョンでサポートしていない構成修飾子が追加されることがあるためです。新しいリソース修飾子を使用し、古いバージョンの Android とのコード互換性も保つ場合、デフォルトのリソースを用意しておかないと、古いバージョンの Android でアプリが実行されたとき、アプリは新しい修飾子が名前に付いたリソースを使用できないため、クラッシュします。たとえば、minSdkVersion を 4 に設定し、夜間モード（API レベル 8 で追加された night または notnight）を使用してすべてのドローアブル リソースを修飾するとします。その場合、API レベル 4 のデバイスはドローアブル リソースにアクセスできず、クラッシュします。これに対処するには、notnight をデフォルトのリソースにして、問題の修飾子は使用せず、ドローアブル リソースを drawable/ と drawable-night/ に用意します。

このように、デバイスの互換性を適切に保つには、アプリを正しく実行するために必要なリソースについて、必ずデフォルトのリソースを用意しておきます。そのうえで、構成修飾子を使って個々のデバイス構成用に代替リソースを作成します。

このルールには 1 つだけ例外があります。アプリの minSdkVersion が 4 以上で、画面密度の修飾子を付けた代替ドローアブル リソースを用意した場合は、デフォルトのドローアブル リソースは必要ありません。デフォルトのドローアブル リソースがなくても、Android は代替の画面密度から最適な密度を見つけて、必要に応じてビットマップを拡大縮小できます。ただし、すべての種類のデバイスで最良のエクスペリエンスを提供するには、3 種類の密度のすべてについて代替のドローアブル リソースを用意してください。

Android が最適なリソースを見つける仕組み

Android では、代替リソースが提供されているリソースがシステムで必要になると、現在のデバイス構成に応じて、どの代替リソースを使用するのかが実行時に選択されます。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 のドローアブルが選択されます。

システムは次のようなロジックで、使用するリソースを決定します。

図 2. Android が最適なリソースをどのように見つけるかを示すフローチャート

1. デバイス構成と一致しないリソース ファイルが除外されます。

   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. 一覧（表 2）で、（次に）優先度の高い修飾子が選ばれます（MCC から下に向かって順に選ばれます）。
3. この修飾子が含まれているリソース ディレクトリがあるかどうかが調べられます。
   • 「ない」場合は、ステップ 2 に戻って次の修飾子が調べられます（この例では、言語修飾子に達するまで答えは「ない」です）。
   • 「ある」場合は、ステップ 4 に進みます。
4. この修飾子が含まれていないリソース ディレクトリが除外されます。この例では、言語修飾子が含まれていないディレクトリがすべて除外されます。

   drawable/
   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   drawable-port-ldpi/
   drawable-port-notouch-12key/
   

   例外: 対象の修飾子が画面のピクセル密度の場合、Android はデバイスの画面密度に最も近い設定を選択します。通常は、小さい方の元画像を拡大するよりも、大きい方の元画像を縮小する方が優先されます。複数画面のサポートをご覧ください。

5. ステップ 2 に戻り、ただ 1 つのディレクトリが残るまでステップ 2、3、4 が繰り返されます。この例では、比較の対象となる次の修飾子は画面の向きです。そのため、画面の向きが指定されていないリソースは除外されます。

   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   

   残りのディレクトリは drawable-en-port です。

上記の手順は必要なリソースごとに実行されますが、一部の処理はシステムによってさらに最適化されます。たとえば、デバイス構成が判明した時点で、まったく一致しない代替リソースが除外される場合があります。たとえば、構成の言語が英語（「en」）の場合には、英語以外に設定された言語修飾子を持つリソース ディレクトリはすべて、チェック対象のリソースプールから除外されます（ただし、言語修飾子を「持たない」リソース ディレクトリはまだ残されます）。

画面サイズの修飾子に基づいてリソースを選択する場合、最適なリソースがない場合は、現在の画面よりも小さい画面向けに設計されたリソースが使用されます（たとえば、「large」サイズの画面では、必要に応じて「normal」サイズの画面のリソースを使用します）。ただし、使用できるリソースがそのときの画面よりも大きい画面のものしかない場合（たとえば、レイアウト リソースすべてに修飾子 xlarge が付いているが、デバイスの画面サイズは「normal」である場合）、システムはその大きい画面向けのリソースを使用せず、他にデバイスの構成に一致するリソースがなければアプリはクラッシュしてしまいます。

注: デバイスと正確に一致する修飾子がいくつあるのかよりも、表 2 に示す修飾子の優先度の方が重要視されます。たとえば、上記のステップ 4 で、一覧の最後の選択肢にはデバイスと正確に一致する修飾子が 3 つ含まれていますが（向き、タッチスクリーンのタイプ、入力方法）、drawable-en には言語に一致するただ 1 つのパラメータしかありません。しかし、言語の方が他の修飾子よりも優先度が高いので、drawable-port-notouch-12key は除外されます。