刚刚有同学问我,不太了解 “非SDK接口” 是什么意思?android9.0有什么限制 ?apache的http也有限制 ?

而且现在的大部分系统都升级上来了,黑名单、灰名单和白名单 也是必须要了解一下的,这里参考Google开发者网站给大家整理一下。

首先,公共 SDK 接口是在 Android 框架软件包索引 中记录的那些接口,什么是框架软件包?

链接地址:https://developer.android.google.cn/reference/packages.html

非 SDK 接口 的处理是 API 抽象出来的实现细节,因此这些接口可能会在不另行通知的情况下随时发生更改。

黑名单

无论应用的目标 API 级别是什么,都无法使用此列表中的非 SDK 接口。如果您的应用尝试访问其中任何一个接口,系统就会抛出错误。

灰名单

从 Android 9(API 级别 28)开始,在每个 API 级别分别会限制某些非 SDK 接口。如果应用的目标 API 级别较低,您可以访问灰名单中的受限 API,但如果您的应用尝试访问在您的目标 API 级别受限的非 SDK 接口,系统就会假定此 API 已列入黑名单。说白了,就是只要在您应用的目标 API 级别不限制此列表中的非 SDK 接口,您就可以使用它们。

白名单

此列表中的接口已在 Android 框架软件包索引中正式记录,它们是受支持的接口,您可以自由使用。

有的同学听完还是比较郁闷……

那换个说法吧,比如应用在通过反射等机制与类互动时(WebView、HTTP等),android9.0之后就不应访问 SDK 中未列出的方法或字段,否则会提示报错,应用老老实实的用谷歌大佬提供的API就好了。

来看谷歌大佬的回应:


尽管您目前仍可以使用灰名单中的某些非 SDK 接口(取决于您应用的目标 API 级别),但是如果您使用任何非 SDK 方法或字段,终归存在很可能会损坏应用的风险。



如果您的应用依赖于非 SDK 接口,则应该开始计划迁移到 SDK 接口或其他替代方案。如果您无法为应用中的功能找到使用非 SDK 接口的替代方案,则应该请求新的公共 API。


尽管还是可以使用,但后果自负。

有frameworks的同学可以看这个路径,此文本包含已列入灰名单的非受限 API 的列表。

Android9.0 如何精准区分SDK接口和非 SDK接口_黑名单

如果非常想使用此接口又找不到替代方案?

如果非常想使用此接口又找不到替代方案时怎么办?可以找Google提需求,如下图。

Android9.0 如何精准区分SDK接口和非 SDK接口_非sdk接口_02

其它的说明都可以忽略,主要是确认自己的SDK接口到底是不是属于非SDK接口。

Android9.0 如何精准区分SDK接口和非 SDK接口_黑名单_03

应用调试时进行测试

先建议开启lintOptions,检测一下其他问题。

另外在搭载 Android 9(API 级别 28)或更高版本的设备或模拟器上构建和运行可调试应用来测试该应用是否使用非 SDK 接口。

在您的应用上运行测试时,如果该应用访问了某些非 SDK 接口,系统就会输出一条日志消息。

您可以检查应用的日志消息,查找以下详细信息:


  • 声明的类、名称和类型(采用 Android 运行时所使用的格式)。
  • 访问方式:链接、反射或 JNI
  • 所访问的非 SDK 接口属于哪个列表。

我们可以使用 adb logcat 来查看这些日志消息,这些消息显示在所运行应用的 PID 下,不过日志消息看起来很痛苦……

举例而言,日志中可能包含如下条目:

Accessing hidden field Landroid/os/Message;->flags:I (light greylist, JNI)

我们也可以使用 StrictMode API 进行测试的

记得在主方法里面开启 ​​StrictMode​​,用 StrictMode API 来测试应用是否使用 非 SDK 接口 ,怎么开启?打开 ​​detectNonSdkApiUsage​​​ 方法 ,然后使用 ​​penaltyListener​​ 来接收每次使用 非 SDK 接口的行为所对应的回调,并且可以在其中实现自定义处理。

回调中提供的 ​​Violation 对象派生​​自 Throwable,并且封闭式堆栈轨迹会提供相应使用行为的上下文。

当然,我们也可以使用 veridex 工具进行测试的

您还可以在 APK 上运行静态分析工具 veridexveridex 工具 会扫描 APK 的整个代码库(包括所有第三方库),并报告发现的所有使用非 SDK 接口的行为。

Android9.0 如何精准区分SDK接口和非 SDK接口_veridex_04

不过 ​​veridex​​ 工具存在以下局限性:


  • 它无法检测到通过 JNI 实现的调用。
  • 它只能检测到一部分通过反射实现的调用。
  • 它对非活动代码路径的分析仅限于 API 级别的检查。

有的人会好奇,它对原生代码中的非 NDK 接口是否有限制?Google大佬回应,Android SDK 包含 Java 接口。Android 平台从 Android 7(API 级别 26)开始就已经限制访问原生 C/C++ 代码中的非 NDK 的接口了。


Android9.0 如何精准区分SDK接口和非 SDK接口_android9_05


作者:奥特曼超人Dujinyang​​​

版权声明:本文为博主杜锦阳文章,转载请附上博文链接!