Android 版本适配：9

blacklist(黑名单)：无论 targetSdkVersion 为多少，只要应用运行在 Android 9.0 平台上，访问此名单中的接口都会受限

3.2 如何测试应用是否使用非 SDK 接口

可以通过以下方式进行测试（详情请至[官方文档](()）：

使用 Android 9.0 或更高版本的设备调试应用
使用 StrictMode API 进行测试
使用 veridex 工具对应用进行扫描

建议使用第三种方式，该工具的扫描结果会列出应用对于三个限制名单中的接口的调用细节。

4. 前台服务权限

在 Android 9.0 中，应用在使用前台服务之前必须先申请 FOREGROUND_SERVICE 权限，否则就会抛出 SecurityException 异常。

此外，由于 FOREGROUND_SERVICE 权限只是普通权限，因此开发者只需在 AndroidManifest.xml 中注册此权限即可，系统会自动对此权限进行授权：

5. 强制执行 FLAG_ACTIVITY_NEW_TASK 要求

在 Android 7.0（API 级别 24）之前，若开发者需要通过非 Activity context 启动 Activity，就必须设置 Intent 标志 FLAG_ACTIVITY_NEW_TASK，否则会启动失败并抛出以下异常

android.util.AndroidRuntimeException: Calling startActivity() from outside of an Activity context requires the FLAG_ACTIVITY_NEW_TASK flag. Is this really what you want?

但这个要求在更新 Android 7.0 以后由于系统问题被临时取消了，开发者即使不设置标志也可以正常启动 Activity。而在 Android 9.0 中官方修复了这个问题，这个要求重新开始强制执行，因此开发者在适配 Android 9.0 时需要注意这个问题。

6. 不允许共享 WebView 数据目录

Android 9.0 中为了改善应用稳定性和数据完整性，应用无法再让多个进程共用同一 WebView 数据目录。此类数据 《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》无偿开源徽信搜索公众号【编程进阶路】 目录一般存储 Cookie、HTTP 缓存以及其他与网络浏览有关的持久性和临时性存储。

如果开发者需要在多进程中使用 WebView，则必须先调用 WebView.setDataDirectorySuffix() 方法为每个进程设置用于存储 WebView 数据的目录。若多进程 WebView 之间需要共享数据，开发者需自己通过 IPC 的方式实现。

此外，若开发者只想在一个进程中使用 WebView，并且希望严格执行这个规则，可以通过在其他进程中调用 WebView.disableWebView() 方法，这样其他进程创建 WebView 实例就会抛出异常。

7. 其他 API 方面的修改

7.1 Region.Op 相关

Android 9.0 中如果在使用绘图裁剪功能时设置了除 Region.Op.INTERSECT 或 Region.Op.DIFFERENCE 以外的类型，就会抛出以下异常：

java.lang.IllegalArgumentException: Invalid Region.Op - only INTERSECT and DIFFERENCE are allowed

具体原因是官方废弃了那几个具有 Region.Op 参数的裁剪方法，如 clipRect(@NonNull RectF rect, @NonNull Region.Op op) ：

/**

Modify the current clip with the specified rectangle.
@param rect The rect to intersect with the current clip
@param op How the clip is modified
@return true if the resulting clip is non-empty
@deprecated Region.Op values other than {@link Region.Op#INTERSECT} and
{@link Region.Op#DIFFERENCE} have the ability to expand the clip. The canvas clipping APIs
are intended to only expand the clip as a result of a restore operation. This enables a view
parent to clip a canvas to clearly define the maximal drawing area of its children. The
recommended alternative calls are {@link #clipRect(RectF)} and {@link #clipOutRect(RectF)};
As of API Level API level {@value Build.VERSION_CODES#P} only {@link Region.Op#INTERSECT} and
{@link Region.Op#DIFFERENCE} are valid Region.Op parameters.
*/
@Deprecated
public boolean clipRect(@NonNull RectF rect, @NonNull Region.Op op) {
checkValidClipOp(op);
return nClipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom,
op.nativeInt);
}

private static void checkValidClipOp(@NonNull Region.Op op) {
if (sCompatiblityVersion >= Build.VERSION_CODES.P
&& op != Region.Op.INTERSECT && op != Region.Op.DIFFERENCE) {
throw new IllegalArgumentException(
“Invalid Region.Op - only INTERSECT and DIFFERENCE are allowed”);
}
}
对于这个问题，可以通过以下方法进行适配：
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
canvas.clipPath(path);
} else {
canvas.clipPath(path, Region.Op.XOR);// REPLACE、UNION 等类型
}

7.2 Build.SERIAL 被弃用