• 2025/5/1
• 3分

【Kotlin/Android】Edge-to-Edgeを有効/無効にする方法！

＼ アプリをリリースしました ／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

環境

• Android Studio：Meerkat
• Kotlin：2.0.21
• AGP：8.9.2
• Gradle：8.11.1
• Mac M1：Sequoia 15.4

Edge-to-Edgeとは？

「Edge-to-Edge」とはアプリのUIがステータスバーやナビゲーションバーなどのシステムバーの背後まで広がるレイアウトデザインのことを指します。Android15からは「Edge-to-Edge」がデフォルトで有効になるようになっているので注意が必要です。

公式リファレンス：Android15 エッジ ツー エッジの適用

Edge-to-Edgeを無効にする

Edge-to-Edgeでのレイアウトが意図せず、無効にしたい場合はstyleにandroid:windowOptOutEdgeToEdgeEnforcement属性を付与しtrueを指定すればEdge-to-Edgeを無効にすることができます。Android15からはデフォルトでONになっているので無効にしたい場合は明示的にこれを指定する必要があります。

<resources xmlns:tools="http://schemas.android.com/tools">
    <style name="Base.Theme.XXXXXXXX" parent="Theme.Material3.DayNight.NoActionBar">
        <!-- Edge-to-Edgeを無効にする -- >
        <item name="android:windowOptOutEdgeToEdgeEnforcement" tools:targetApi="35">true</item>
    </style>
</resources>

公式リファレンス：windowOptOutEdgeToEdgeEnforcement

Android 16(API36)以上では使えない

一時的にEdge-to-Edgeを無効化できるandroid:windowOptOutEdgeToEdgeEnforcement属性はターゲットがAndroid 16(API36)の場合は属性自体が非推奨で無効になるため注意してください。修正期間としてAndroid15の間だけ無効にできるようにしてくれているだけのようです。

公式リファレンス：エッジ ツー エッジのオプトアウトの廃止

Android14(API34)以下でEdge-to-Edgeを有効にする

公式リファレンス：Display content edge-to-edge in views

Android14(API34)以下でEdge-to-Edgeを有効にしたい場合はenableEdgeToEdgeメソッドを呼び出せばOKです。

override fun onCreate(savedInstanceState: Bundle?) {
  enableEdgeToEdge()
  super.onCreate(savedInstanceState)
  ...
}

まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。

ご覧いただきありがとうございました。