"Only fullscreen opaque act

前言

最近在升级targetsdkversion,我负责了一部分的升级适配工作，后面会找时间对Android升级targetsdkversion的相关工作做一个比较深入的总结。但是今天我想把一个问题单独拎出来说一说。那就是网上盛传的 Android8.0
"Only fullscreen opaque activities can request orientation "问题。这个问题从被大家发现，到现在已经快一年半了，解决方案都很全，之所以叫在分析，是因为这里面还有些问题一直没有被解释清楚，昨天在做这个适配的时候也有些困扰，因此在这里做一个简短而全面的分析。

问题原由

我们先来说说这个问题的由来，最先在网上有人爆出，如果开发者把targetsdkversion调成27及以上，而且项目中的Activity主题设为透明，而又指定了activity屏幕的方向的话，在Android8.0的手机上会直接抛出RunRuntimeException异常，并且打印的错误信息里面会有这段话："Only fullscreen opaque activities can request orientation "

接着就有人指出这个是Android开发人员在开发Android8.0的时候的一次提交的代码造成的问题。点击传送门

从上述提交中，我们能够看到开发人员意在阻止非全屏的activity影响屏幕的方向。而根据代码追踪到的代码片段大概是这里：

if (ActivityInfo.isFixedOrientation(requestedOrientation) // 是否锁定了屏幕方向
    && !fullscreen // 不是全屏
    && appInfo.targetSdkVersion >= O) { // targetsdkversion版本是Android8及以上
    throw new IllegalStateException("Only fullscreen activities can request orientation");
}

而是否是全屏的判断依据是以下几个主题属性：

public static boolean isTranslucentOrFloating(TypedArray attributes) { 
    final boolean isTranslucent = attributes.getBoolean(com.android.internal.R.styleable.Window_windowIsTranslucent, false); 
    final boolean isSwipeToDismiss = !attributes.hasValue( com.android.internal.R.styleable.Window_windowIsTranslucent) 
                                     && attributes.getBoolean( com.android.internal.R.styleable.Window_windowSwipeToDismiss, false); 
    final boolean isFloating = attributes.getBoolean(com.android.internal.R.styleable.Window_windowIsFloating, false);  
    return isFloating || isTranslucent || isSwipeToDismiss;    
}

问题到这里看起来已经讲清楚了，如果我们设置了以上几个主题，并且锁定了屏幕方向，那么在Android8.0的手机上系统会直接抛出异常。

解决方案

我们说说解决方法：

• targetsdkversion降低到26及以下
• 针对项目中的activity做一次检查，避免指定透明主题的activity同时又指定了方向

基本上所有的解决方法本质上都是基于这两种思路。好了，问题解决了。基本上网上关于相关问题的讨论到这里就结束了，比如下面这几篇文章和讨论：

java.lang.IllegalStateException: Only fullscreen opaque activities can request orientation

Only fullscreen activities can request orientation？一个搞笑的坑！

Kaola Mobile Team's Blog： Android O 适配详细指南

当然，既然有了解决方案，所以一般分析到这里也是可以理解的。

未解释的问题

可是当我看到上面这些文章或问答，心里还是有一些其他的疑问没有被解答：

• 按照上面的分析，在targetsdkversion>=26的时候，在Android8.0手机上应该都有异常，但实际上targetsdkversion=26的时候是OK的，只有升级到27及以上才会崩

• Android8以后真的解决了这个问题？

关于第一个问题，我继续查看了Android8.0的源码，以及它的提交记录发现在这个提交不久之后，Android开发人员又有了新的提交，在sdk为26时，放开了限制。

image image

Allow for SDK 26 Activities to specify orientation when not fullscreen

所以当我们设置的targetsdkversion<=26的时候没有出现这个问题。只有在大于26的情况下，这个异常出现。

第二个问题，在Android8.1.0的第一个release版本中确实去掉了相关的代码，这个在Android8.1.0的release版本的提交纪录里能够看得出来 传送门

image

总结

从这个问题的产生和解决过程来看，确实可以说是Android系统开发人员的“手误”了。但是说实话我很难想象会出现这样的幺蛾子，居然直接抛出异常。难道他们不知道很多开发者都会在Activity里指定透明主题和固定方向？而且提交了这种代码之后，在Android8.0系统更新说明里居然也没有提到。唉，好吧。