Android Oreo 中如何解决 `java.lang.IllegalStateException`：请求方向指南

Android 8.0 Oreo 中请求方向的指南：解决 java.lang.IllegalStateException

导言

Android 8.0 Oreo 引入了一项安全措施，限制了非全屏不透明活动请求方向的功能。当尝试在不符合这些条件的活动中请求方向时，将抛出 java.lang.IllegalStateException: 仅全屏不透明活动可以请求方向 错误。这篇文章将深入探讨问题的原因，并提供详细的解决方案，帮助您在 Android Oreo 及更高版本中正确请求方向。

问题根源

在 Oreo 之前的版本中，可以在任何类型的活动中请求方向。然而，出于安全考虑，Oreo 引入了一项更改，只允许全屏不透明活动请求方向。这是为了防止恶意应用覆盖其他应用，并确保设备上用户的隐私和安全性。

全屏不透明活动

全屏： 活动必须完全覆盖屏幕，没有可见的工具栏或状态栏。

不透明： 活动不能具有透明背景或窗口。

解决方案

要解决此错误，您的活动必须符合以下条件：

• 全屏： 使用 @android:style/Theme.NoTitleBar.Fullscreen 主题或设置 android:windowFullscreen 属性。
• 不透明： 设置 android:windowBackground 属性为非透明颜色或图像资源。

示例：

要在 AndroidManifest.xml 文件中将活动设置为全屏不透明，请使用以下代码：

<activity
    android:name=".MainActivity"
    android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />

修改后的代码：

在解决错误后，您的代码应类似于以下内容：

// ...

@Override
protected Void doInBackground(Void... params) {
    // ...

    runOnUiThread(new Runnable() {
        @Override
        public void run() {
            // 更新 UI
        }
    });

    return null;
}

其他注意事项

• 如果您的活动已经全屏不透明，请确保在其他地方不会请求方向，例如片段。
• 对于非全屏或透明活动，您可以使用 ActivityInfo.SCREEN_ORIENTATION_BEHIND 标志来强制方向。然而，请谨慎使用，因为它可能会导致 UI 问题。

结论

通过将活动配置为全屏不透明并遵循提供的准则，您可以轻松解决 Android 8.0 Oreo 中的 java.lang.IllegalStateException: 仅全屏不透明活动可以请求方向 错误。通过理解问题的原因并实施正确的解决方案，您可以在您的 Android 应用程序中实现正确的方向请求。

常见问题解答

1. 为什么 Android Oreo 限制了请求方向的功能？

为了防止恶意应用覆盖其他应用并保护用户隐私。

2. 如何使活动全屏不透明？

可以通过在 AndroidManifest.xml 文件中设置主题或属性来实现。

3. 可以在非全屏或透明活动中请求方向吗？

可以，但必须使用 ActivityInfo.SCREEN_ORIENTATION_BEHIND 标志。

4. 如果活动已经全屏不透明，为什么还会抛出错误？

请确保在其他地方没有请求方向，例如片段。

5. 如何解决 runOnUiThread 方法在 doInBackground 方法中抛出的错误？

runOnUiThread 方法必须在 UI 线程上运行。请将其移到 doInBackground 方法的末尾。