mPaaS 适配 targetSdkVersion 28

背景

mPaaS 标准基线对 targetSdkVersion 最高仅支持到 26。如果您的应用需要将 targetSdkVersion 升级到 28，请使用定制基线 10.1.68a，并按照下文更新 SDK 和添加配置，并回归相关功能。

更新 SDK

参考 mPaaS 支持多 CPU 架构 更新 SDK 及相关配置。

适配 targetSdkVersion 28

修改 targetSdkVersion

Inside/AAR

在工程主 module 下的 build.gradle 文件中修改属性 targetSdkVersion 28。

Portal&Bundle

• 在 Portal 工程主 module 下的 build.gradle 文件中修改属性 targetSdkVersion 28。
• 在 Bundle 工程中的 targetSdkVersion 可不修改，但不得高于 Portal 工程。

通用配置

Inside/AAR

修改工程 AndroidManifest.xml，在 application 节点下添加如下代码：

<uses-library android:name="org.apache.http.legacy" android:required="false"/>

Portal&Bundle

修改 Portal 工程 AndroidManifest.xml：

• 在 application 节点下添加如下代码：

  <uses-library android:name="org.apache.http.legacy" android:required="false"/>

• 从 LauncherActivity 删除以下属性（SDK 已改为通过代码设置）：

  android:screenOrientation="portrait"

其他配置

允许 HTTP 请求

Android 9.0 的网络配置默认禁止了 HTTP 请求，只允许 HTTPS 请求，设置 targetSdkVersion 28 将在 9.0+ 设备上启用 9.0 的网络配置。如果您仍然需要发送 HTTP 请求（包括小程序中），可通过配置 networkSecurityConfig 开启。

• 在工程（Portal&Bundle 为 Portal 工程）的res/xml 目录下创建 network_security_config.xml 文件，内容如下：

  <?xml version="1.0" encoding="utf-8"?>
  <network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
  </network-security-config>

• 在工程（Portal&Bundle 为 Portal 工程）的 AndroidManifest.xml 中的 application 节点添加属性：

  android:networkSecurityConfig="@xml/network_security_config"

更多配置可参考 谷歌官方文档 。

透明背景 Activity 设置屏幕方向 crash

该适配点为 Android 8.0 系统 bug。在 8.0 设备上，当应用 targetSdkVersion > 26 时，透明背景的 Activity 如果设置了屏幕方向，打开该 Activity 就会触发 crash。触发具体条件为：

• Activity 使用的 theme 中 windowIsTranslucent 或 windowIsFloating 属性为 true。
• 在 AndroidManifest.xml 中设置了 screenOrientation 属性，或调用了 setRequestedOrientation 方法。

您需要检查所有 Activity 是否满足触发条件，同时除了您自定义的 style 外，请注意部分常用的系统 theme 也满足条件，例如：

@android:style/Theme.Translucent.NoTitleBar
@android:style/Theme.Dialog

推荐适配方式：

1. 对于 theme 满足条件的 Activity，删除 AndroidManifest.xml 中的 screenOrientation 属性，改为调用 setRequestedOrientation 方法。

2. 在对应 Activity 或父类中重写 setRequestedOrientation 方法，try catch super.setRequestedOrientation() 兜底：

    @Override
    public void setRequestedOrientation(int requestedOrientation) {
        try {
            super.setRequestedOrientation(requestedOrientation);
        } catch (Exception ignore) {
        }
    }

3. mPaaS 提供的 BaseActivity、BaseFragmentActivity、BaseAppCompatActivtiy 均已重写 setRequestedOrientation 方法兜底。
4. 完成上述适配后，虽可避免 crash，但仍可能出现在8.0设备上锁定方向失效的情况，请确保您的 Activity 不会因旋转屏幕发生异常（例如重走生命周期导致某些成员变量为空）。

Android 8.0 系统相关源码：

回归测试

全量回归测试的设备中必须包含 Android 9.0+设备，同时对于透明背景 Activity 设置屏幕方向 crash问题，请在 Android 8.0 机型上专项测试。

回归测试中您需要重点关注以下组件功能（如果使用）：