剖析"Only fullscreen opaque activities can request orientation"的本质

2023-11-11 11:37:58

Android 8.0 的方向更改谜团：只有全屏不透明活动才能请求方向

作为一名 Android 开发者，您可能已经遇到一个棘手的问题，即在 Android 8.0（API 26）及更高版本中，只有全屏且不透明的活动才能请求方向更改。这个限制给许多开发者带来了困惑和挑战，本文将深入探讨这个问题，提供解决方案并分享最佳实践。

谜团的根源

Android 8.0 引入了一个新的限制，旨在提升用户体验。此限制要求活动既是全屏的，即覆盖整个屏幕，又是完全不透明的，即背景不可见，才能请求方向更改。这种改变旨在防止应用在全屏模式下随意更改方向，从而造成界面混乱或崩溃。

受影响的活动

此限制主要影响以下类型的活动：

全屏活动： 覆盖整个屏幕的活动，例如视频播放器或游戏。
不透明活动： 背景不可见的活动，例如设置菜单或对话框。

如果您的活动同时满足这两个条件，则需要在清单文件中声明 android:resizeableActivity 属性为 `"false"，才能继续请求方向更改。

破解谜团的解决方案

解决此问题的办法有两种：

1. 将活动标记为不调整大小

在您的清单文件中，添加以下代码：

<activity
    android:name=".MainActivity"
    android:resizeableActivity="false" />

这将强制您的活动保持全屏，从而符合方向更改限制。

2. 使用沉浸模式

沉浸模式是一种全屏模式，允许活动保持透明度。要使用沉浸模式，需要在代码中调用以下方法：

View decorView = getWindow().getDecorView();
int uiOptions = View.SYSTEM_UI_FLAG_IMMERSIVE
        | View.SYSTEM_UI_FLAG_FULLSCREEN
        | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION;
decorView.setSystemUiVisibility(uiOptions);

其他注意事项

除了上述解决方案外，还需要注意以下几点：

对话框和弹出窗口： 这些元素通常是透明的，因此无法请求方向更改。需要使用全屏且不透明的活动来承载它们。
横屏固定活动： 在清单文件中声明 android:screenOrientation 为 "landscape" 的活动不受此限制的影响。
主题兼容性： 确保您的应用程序主题与沉浸模式兼容。推荐使用继承自 Theme.AppCompat.Light.NoActionBar 的主题。

结论

理解 "Only fullscreen opaque activities can request orientation" 问题的根源和解决办法对于 Android 开发者来说至关重要。通过遵循本文提供的指导，您可以轻松解决此问题，确保您的应用在 Android 8.0 及更高版本上顺畅运行。持续学习和适应 Android 不断发展的生态系统是开发者不断进步和提供出色用户体验的关键。

常见问题解答