被EdgeToEdge适配折磨疯了，谁懂！

被EdgeToEdge适配折磨疯了，谁懂！

一、开头引入

家人们，谁懂啊！最近我在做应用开发的时候，被 EdgeToEdge 适配折磨得死去活来😭。就因为这个适配问题，我加了好几个大夜班，头发都掉了一大把。本以为开发已经够难了，没想到这个 EdgeToEdge 适配更是让人崩溃，今天必须来跟大家吐槽吐槽，顺便也给正在被它困扰的小伙伴们一些经验和建议。

二、EdgeToEdge 是什么

（一）定义解释

EdgeToEdge 适配，简单来说，就是让应用的界面能够延伸到手机屏幕的边缘，充分利用整个屏幕空间，打破传统应用被状态栏和导航栏限制显示区域的局面，给用户带来更具沉浸感的体验。就好比以前我们看电影，屏幕上下总有两条黑边，而现在通过 EdgeToEdge 适配，电影画面能铺满整个屏幕，视觉体验直接拉满🎬。在 Android 系统中，它主要表现为将状态栏和导航栏变成透明，让应用内容可以覆盖到这些区域。

（二）发展历程

EdgeToEdge 这个概念其实早就出现了，只是一开始并没有得到广泛应用 。随着全面屏手机越来越普及，为了充分发挥大屏的优势，Google 开始大力推广 EdgeToEdge 适配。从最初在部分系统版本中支持，到后来在 Android 15 中，只要 App 的 targetSdkVersion 指定到 35 或更高，就会强制启用 edge-to-edge 功能 ，这一步步推动着开发者们不得不去面对和解决这个适配问题。

三、为什么觉得恶心

（一）大量界面修改

一旦进行 EdgeToEdge 适配 ，就像是推倒了多米诺骨牌，应用中原有的布局受到极大影响。很多界面元素都需要重新调整位置和大小。比如，之前在普通布局下，顶部的标题栏距离状态栏有固定的间距，适配后，由于状态栏透明，标题栏就可能直接顶到了屏幕最上方，变得很突兀。再比如底部的导航栏区域，原来一些按钮在这个区域上方正常显示，现在导航栏透明了，按钮就可能被覆盖住一部分 ，完全无法点击操作。

而且不同页面的布局还各不相同，像列表页面、详情页面、设置页面等等，每个页面都要根据 EdgeToEdge 的要求去单独调整，工作量巨大。一个拥有十几个页面的应用，光是调整这些界面布局，就得花费好几天时间，真的让人崩溃😫。

（二）兼容性噩梦

不同版本的 Android 系统在 EdgeToEdge 适配方面存在着各种各样的兼容性问题。在低版本系统上，可能根本就不支持某些 EdgeToEdge 的特性，而在高版本系统上，又可能因为系统的一些默认设置，导致适配效果不理想。比如，在 Android 13 上适配好的应用，到了 Android 15 上，导航栏的透明效果就可能出现异常，颜色显示不正确，或者透明度不一致。

不同厂商的设备也让开发者头疼不已。华为、小米、OPPO、vivo 等各大厂商，他们的设备在屏幕尺寸、比例、系统定制化方面都有很大差异。有些厂商可能对系统栏进行了特殊处理，导致 EdgeToEdge 适配时出现各种奇怪的问题。比如，在某些华为手机上，状态栏和导航栏的高度与标准值不同，适配时就需要单独进行处理；而在小米手机上，可能存在一些特殊的手势操作，与 EdgeToEdge 适配后的界面元素产生冲突，导致用户操作体验很差 。

（三）废弃 API 带来的困扰

随着 EdgeToEdge 适配的推行，一些与状态栏、导航栏相关的 API 被废弃了 。像 Window#setStatusBarColor、Window#setStatusBarContrastEnforced、Window#setNavigationBarColor、Window#setNavigationBarContrastEnforced 这些曾经常用的 API，现在要么不能用，要么不再推荐使用 。这就意味着开发者们之前写的很多关于状态栏和导航栏设置的代码都要重新修改。

原本通过简单调用这些 API 就能实现状态栏颜色的改变、导航栏的隐藏或显示等功能，现在不得不去学习和使用新的方法。比如，要实现状态栏颜色的设置，现在可能需要通过 WindowInsetsControllerCompat 来进行复杂的操作，不仅要考虑不同版本的兼容性，还要处理各种异常情况，真的是难上加难😭。

四、常见恶心案例展示

（一）输入框被遮挡

在进行 EdgeToEdge 适配时，输入框被状态栏遮挡的情况屡见不鲜。就拿我最近开发的一个聊天应用来说，当适配 EdgeToEdge 后，在消息输入框界面，原本位于屏幕底部的输入框，在软键盘弹出时，会被状态栏往下挤压，导致输入框的一部分被状态栏覆盖住 。用户根本无法完整地看到输入框中的内容，也不能正常输入文字，严重影响了用户的聊天体验😡。

究其原因，主要是在适配过程中，没有正确处理好软键盘弹出时的布局变化 。通常情况下，在普通布局下，系统会自动调整界面布局，让输入框避开软键盘。但 EdgeToEdge 适配后，状态栏透明，整个布局的计算方式发生了变化，如果没有重新设置相关的布局参数，就很容易出现这种输入框被遮挡的问题。比如，没有设置合适的 windowSoftInputMode 属性，或者在布局文件中没有正确使用 fitsSystemWindows 属性 ，都会导致布局出现异常。

（二）按钮点击区域异常

底部按钮被导航栏覆盖导致点击区域不准确也是 EdgeToEdge 适配中常见的恶心问题。在一个电商应用的购物车页面，底部有 "结算" 和 "删除商品" 等按钮。适配 EdgeToEdge 后，当用户使用三键导航模式时，导航栏会覆盖住部分按钮，使得按钮的实际可点击区域变小。用户在点击 "结算" 按钮时，可能需要多次点击才能成功触发操作，甚至有时候明明点击了按钮，却没有任何反应，这让用户感到非常困惑和恼火😤。

这主要是因为在适配时，没有考虑到导航栏透明后对底部按钮布局的影响 。没有给按钮留出足够的安全区域，导致按钮与导航栏重叠。在计算按钮的点击区域时，也没有将导航栏的高度计算在内，从而出现点击区域不准确的情况。而且不同设备的导航栏高度不一致，这就要求开发者在适配时，要动态获取导航栏的高度，并根据这个高度来调整按钮的布局和点击区域 ，增加了开发的难度和工作量。

五、如何应对这些恶心情况

（一）官方解决方案介绍

面对 EdgeToEdge 适配带来的种种恶心问题，官方也提供了一些解决方案 。其中，使用 WindowInsetsControllerCompat 是一个重要的方法。通过它，我们可以方便地控制状态栏和导航栏的显示与隐藏，以及处理它们与应用界面的交互 。比如，在一些全屏展示的应用中，我们可以使用 WindowInsetsControllerCompat 来隐藏状态栏和导航栏，让用户专注于应用内容。

增加视图边距也是一种常用的方法。在布局文件中，通过设置 fitsSystemWindows 属性为 true ，可以让视图自动调整边距，避免被状态栏和导航栏遮挡。这个属性就像是给视图穿上了一件 "防护衣"，让它在 EdgeToEdge 适配的环境中也能保持正常的显示和交互 。

（二）实际代码示例

下面给大家分享一些实际代码示例，帮助大家更好地理解如何利用官方方法解决布局被遮挡问题 。

首先是使用 WindowInsetsControllerCompat 隐藏状态栏和导航栏的代码：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    WindowInsetsControllerCompat windowInsetsController = WindowCompat.getInsetsController(getWindow(), getWindow().getDecorView());
    windowInsetsController.hide(WindowInsetsCompat.Type.systemBars());
}

然后是在布局文件中设置 fitsSystemWindows 属性的示例：

<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true"
    android:orientation="vertical">

    <!-- 其他布局内容 -->

</LinearLayout>

通过这些代码，我们可以有效地解决输入框被遮挡、按钮点击区域异常等问题 ，让应用在 EdgeToEdge 适配后能够正常运行 。

（三）避免手势区域冲突

为了避免手势区域冲突，我们可以在 AndroidManifest.xml 中声明相关属性 。比如，声明 android:windowOverScanPolicy="never"，这样可以防止应用内容延伸到系统手势操作区域，避免用户在进行手势操作时与应用界面元素产生冲突 。代码如下：

<application
   ...
    <activity
       ...
        <meta-data
            android:name="android.window.PROPERTY_OVERSCAN_LAYOUT_MARGINS"
            android:resource="@null" />
        <meta-data
            android:name="android:windowOverScanPolicy"
            android:value="never" />
    </activity>
</application>

通过这些设置，我们可以提高应用在 EdgeToEdge 适配后的用户操作体验，让用户能够更加流畅地使用应用 。

六、总结与吐槽结尾

EdgeToEdge 适配真的是一个让人又爱又恨的东西。它虽然能给用户带来更沉浸式的体验 ，但对于开发者来说，真的是一场噩梦。大量的界面修改、复杂的兼容性问题以及废弃 API 带来的困扰，每一个都让人头大。

真的希望 Google 在推行这些新特性的时候，能够多考虑一下开发者的感受 ，提供更加完善的文档和更简便的解决方案。也希望各大厂商能够统一设备的标准，减少兼容性问题。

不知道大家在 EdgeToEdge 适配过程中还遇到过哪些恶心的问题呢 ？欢迎在评论区留言分享，让我们一起抱团取暖，共同攻克这个难题💪！