Actionbarとコンテンツの重なり (Android 15)

問題説明

Android 15 (バージョン名: Vanilla Ice Cream) において、アクションバーがアクティビティのコンテンツと重なる現象が発生します。具体的な症状は以下の通りです:

• 従来のAndroid 14以前では正常に表示されていたレイアウトが崩れる
• アクションバーがコンテンツエリアに上書き（オーバーレイ）される
• テーマでTheme.AppCompat.DayNight.DarkActionBarを継承し、XMLでToolbarを明示的に定義していない場合に発生
• 以下のテーマ設定を使用した環境で確認:

<style name="AppBaseTheme" parent="@style/Theme.AppCompat.DayNight.DarkActionBar">
    <item name="android:windowContentOverlay">@null</item>
    <!-- その他の設定 -->
</style>

この問題の根本原因は、Android 15で導入されたエッジツーエディスプレイの強制適用にあります。OSがコンテンツを画面全体に拡張しようとする結果、システムバーとアクションバーの領域が競合するため重なりが発生します。

解決策

推奨方法: エッジツーエディスプレイの強制適用を無効化

themes.xmlファイルに以下を追記することで解決します:

<!-- values/themes.xml と values-night/themes.xml の両方に追加 -->
<style name="AppBaseTheme" parent="Theme.AppCompat.DayNight.DarkActionBar">
    <!-- Android 15 (API 35) 以降でエッジツーエディスプレイ強制を無効化 -->
    <item name="android:windowOptOutEdgeToEdgeEnforcement" tools:targetApi="v">true</item>
    
    <!-- 既存の設定を維持 -->
    <item name="android:windowContentOverlay">@null</item>
</style>

重要ポイント:

• tools:targetApi="v"属性でAndroid 15 (APIレベル35) のみに適用
• 日間/夜間モードの両方のテーマファイルに追加すること
• 最もシンプルで効果的な解決策（スコア23の回答をベース）
• OSバージョンを特定せずに動作するため互換性が高い

動作原理

windowOptOutEdgeToEdgeEnforcementフラグがtrueの場合:

1. システムはアプリに自動的なエッジツーエディスプレイ適用を行わない
2. 従来のアクションバー領域の保証が維持される
3. Android 14以前と同じレイアウトシステムを継続使用可能

---

代替方法: fitsSystemWindows属性を使用

XMLレイアウトのルートビューに属性を追加:

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:fitsSystemWindows="true"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <!-- コンテンツ -->
</LinearLayout>

特徴:

• 画面のシステムバー領域を考慮してパディングを自動調整
• サポートされやすいシンプルなソリューション
• 半透明の状態バーが表示されることがある（見た目の調整が必要な場合あり）

注意点

windowContentOverlayと併用すると競合する可能性があります。テスト環境で動作を確認してください。

---

プログラム制御による高度な対応

エッジツーエディスプレイを有効化しつつ、Toolbarへのマージン調整を行う方法:

// MainActivity.kt
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    // エッジツーエディスプレイを有効化
    EdgeToEdge.enable(this)
    setContentView(R.layout.activity_main)
    
    val toolbar = findViewById<Toolbar>(R.id.toolbar)
    ViewCompat.setOnApplyWindowInsetsListener(toolbar) { v, insets ->
        val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        v.updateLayoutParams<ViewGroup.MarginLayoutParams> {
            topMargin = systemBars.top
        }
        WindowInsetsCompat.CONSUMED
    }
}

適用ケース:

• エッジツーエディスプレイ表示を積極的に活用したい場合
• カスタムToolbarを使用しているプロジェクト
• システムバーの変化に動的に対応する必要があるアプリ

Javaでの実装例

// MainActivity.java
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    EdgeToEdge.enable(this);
    setContentView(R.layout.activity_main);
    
    Toolbar toolbar = findViewById(R.id.toolbar);
    ViewCompat.setOnApplyWindowInsetsListener(toolbar, (v, windowInsets) -> {
        Insets insets = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars());
        ViewGroup.MarginLayoutParams params = (ViewGroup.MarginLayoutParams) v.getLayoutParams();
        params.topMargin = insets.top;
        v.setLayoutParams(params);
        return WindowInsetsCompat.CONSUMED;
    });
}

---

補足：ステータスバーの背景色設定

fitsSystemWindows使用時に半透明領域が見える場合の対処法:

// ステータスバー背景色を設定（onCreate内）
window.statusBarColor = ContextCompat.getColor(this, R.color.primary_dark)

colors.xml

<color name="primary_dark">#1a237e</color>

---

ベストプラクティス推奨事項

1. 基本アプローチ:

   • windowOptOutEdgeToEdgeEnforcement を採用しレイアウト互換性を保持
   • 既存のレイアウト設計を最小変更で維持可能

2. カスタムToolbar使用時のアドバイス:

   <style name="AppBaseTheme" parent="Theme.AppCompat.DayNight.NoActionBar">
       <item name="windowActionBar">false</item>
       <item name="android:windowOptOutEdgeToEdgeEnforcement" tools:targetApi="v">true</item>
   </style>

   • NoActionBarテーマでデフォルトアクションバーを無効化
   • 個別にToolbar実装することで制御性向上

3. バージョニングの重要性:

   <resources>
       <!-- values-v35/themes.xml でAndroid 15のみ別定義 -->
       <style name="AppBaseTheme" parent="AppBaseTheme.Base">
           <item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>
       </style>
   </resources>

   • APIレベル別にリソースを分離することで影響範囲を制御

4. 検証ポイント:

   • システムナビゲーションゲッター（三本線ボタン）の可視性
   • ダークモード切り替え時の描画状態
   • 画面回転時のレイアウト安定性

Android 15の新機能との整合性を取りつつ、従来のUIを維持したい場合は紹介した解決策を組み合わせて実装してください。特にテーマ設定による方法は最小の変更で最大の効果を得られるため、最初の選択肢として推奨します。