タイトル: リソース (Android アプリケーション)
SEOタイトル: Android のリソース (res/) 完全ガイド — layout/values/drawable/mipmap 解説
| この記事の要点 |
|
リソースとは
Android のリソースとは、コードと分離して管理されるUI のための静的データのことです。文字列・色・画像・寸法・レイアウト XML などを res/ ディレクトリにまとめ、コードからは R クラス経由で参照します。
こうすることで多言語対応、画面密度対応、ダークモード、横画面/縦画面の出し分けがコード本体を触らずに済みます。
標準ディレクトリ構成
app/src/main/res/
├── layout/ # 画面レイアウト XML
│ ├── activity_main.xml
│ └── item_user.xml
├── values/ # 文字列・色・寸法など
│ ├── strings.xml
│ ├── colors.xml
│ ├── dimens.xml
│ ├── styles.xml
│ └── themes.xml
├── values-ja/ # 日本語用
│ └── strings.xml
├── values-night/ # ダークモード
│ └── colors.xml
├── drawable/ # ベクター / シェイプ / 画像
│ ├── ic_home.xml
│ └── bg_button.xml
├── drawable-xxhdpi/ # 高解像度 PNG
│ └── photo.png
├── mipmap-anydpi-v26/ # アイコン (Adaptive Icon)
│ └── ic_launcher.xml
├── mipmap-mdpi 〜 xxxhdpi/ # 旧式アイコン
├── raw/ # 音声・動画・JSON など
│ └── beep.mp3
├── xml/ # 任意 XML（widget設定など）
│ └── preferences.xml
├── menu/ # メニュー XML
│ └── main_menu.xml
└── font/ # カスタムフォント
└── roboto.ttfR クラスからの参照
// 文字列
val title: String = getString(R.string.app_name)
// 色
val color: Int = ContextCompat.getColor(this, R.color.primary)
// 画像
val icon: Drawable? = ContextCompat.getDrawable(this, R.drawable.ic_home)
// 寸法
val padding: Float = resources.getDimension(R.dimen.padding_default)
// レイアウト
setContentView(R.layout.activity_main)
// 文字列フォーマット (placeholder 入り)
val msg = getString(R.string.welcome_message, userName, age)
// strings.xml: こんにちは %1$s さん (%2$d 歳) 画面密度別のリソース (drawable)
| 名前 | 密度 | 倍率 | 典型機種 |
|---|---|---|---|
| mdpi (基準) | ~160 dpi | 1x | 旧式 (絶滅) |
| hdpi | ~240 dpi | 1.5x | 2010年代初期 |
| xhdpi | ~320 dpi | 2x | iPhone 4 相当 / 廉価 Android |
| xxhdpi | ~480 dpi | 3x | Pixel 6/7/8 等 |
| xxxhdpi | ~640 dpi | 4x | Samsung Galaxy S 系最上位 |
たとえばアイコンを 24dp で表示する場合、各密度フォルダに 24/36/48/72/96 px の PNG を配置すると Android が自動選択します。現代では Vector Drawable (XML) で密度非依存にするのが推奨です。
言語・地域別のリソース
| フォルダ | 意味 |
|---|---|
values/ | デフォルト（通常英語） |
values-ja/ | 日本語 |
values-en-rUS/ | 英語 (米国) |
values-zh-rCN/ | 中国語簡体 |
values-night/ | ダークモード |
values-w600dp/ | 横幅 600dp 以上（タブレット） |
values-land/ | 横画面 |
Vector Drawable
SVG ライクな XML で密度非依存のアイコンを作れます。Android Studio の Asset Studio → Vector Asset で Material Icons / SVG を取り込めます。
テーマとスタイル
Configuration Changes（画面回転・言語切替）対策
画面回転や言語変更が起きると Android はActivity を作り直します。リソース XML の文言・色・レイアウトが自動で適切なものに切り替わりますが、コードで持っているデータは失われます。
- ViewModel に状態を持たせる — Configuration Change 越境
- onSaveInstanceState で Bundle にプリミティブ値保存
- 独自対策で
android:configChanges="orientation|screenSize"を Manifest に書くと自前で onConfigurationChanged を実装する必要
FAQ
Q: 画像はすべて drawable-xxhdpi に置けばいい？
A: 拡大表示でぼやけることがあります。Vector Drawable に変換、または mdpi/hdpi/xhdpi/xxhdpi の段階で持つのが安全。
Q: 多言語対応で抜けがあるとどうなる？
A: 該当ロケールに該当する strings.xml 内にキーが無い場合、デフォルト（values/strings.xml）にフォールバック。
Q: ColorRes と Color int の違いは？
A: R.color.primary はリソース ID（整数）。Color.RED や getColor() はARGB int。getColor は API 23+ で Context 必須に変更されたので、ContextCompat.getColor 推奨。