• 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

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)
  ...
}

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

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