在AndroidP版本,Google对非SDK接口增加了管控。
SDK接口指的是Android官方开发文档中声明的方法,即文档地址中所能查询到的API,除了这些,其他的API都是非SDK接口
官网:针对非SDK接口的限制
非SDK接口分类
随着每个Android版本的发布,会有更多非SDK接口受到限制。
为最大程度地降低非SDK使用限制对开发工作流的影响,我们将非SDK接口分成了几个名单,这些名单界定了非SDK接口使用限制的严格程度。下表介绍了这些名单:
屏蔽名单 (blacklist ) | 无论应用的目标 API 级别是什么,您都无法使用的非 SDK 接口。 如果您的应用尝试访问其中任何一个接口,系统就会抛出错误。 |
有条件屏蔽 (greylist-max-x ) | 从 Android 9(API 级别 28)开始,当有应用以该 API 级别为目标平台时,我们会在每个 API 级别分别限制某些非 SDK 接口。这些名单会以应用无法再访问该名单中的非 SDK 接口之前可以作为目标平台的最高 API 级别 (max-target-x ) 进行标记。例如,在 Android Pie 中未被屏蔽、但现在已被 Android 10 屏蔽的非 SDK 接口会列入 max-target-p (greylist-max-p ) 名单,其中的“p”表示 Pie 或 Android 9(API 级别 28)。如果您的应用尝试访问受目标 API 级别限制的接口,系统就会将此 API 视为已列入屏蔽名单。 |
不支持 (greylist ) | 当前不受限制且您的应用可以使用的非 SDK 接口。 但请注意,这些接口不受支持,可能会在不另行通知的情况下随时发生更改。预计这些接口在未来的 Android 版本中会被有条件地屏蔽,并列在 max-target-x 名单中。 |
SDK (whitelist ) | 已在 Android 框架软件包索引中正式记录、受支持并且可以自由使用的接口。 |
greylist:不支持,可以正常使用;blacklist:无论什么版本的手机系统,使用这些api,系统将会抛出异常;greylist-max-o:受限制的灰名单,APP运行在版本<=0的系统里可以正常访问,targetSDK>0且运行在>0的手机会抛出异常;greylist-max-p:受限制的灰名单,APP运行在版本<=0的系统里可以正常访问,targetSDK>0且运行在>0的手机会抛出异常;greylist-max-q:受限制的灰名单,受限制的灰名单。APP运行在版本<=10.0的系统里可以正常访问,targetSDK>10.0且运行在>10.0的手机会抛出异常;
使用veridex工具进行测试
Google提供了一个静态检测工具veridex下载地址需科学上网
您还可以在APK上运行静态分析工具veridex。veridex工具会扫描APK的整个代码库,并报告发现的所有使用非SDK接口的行为。
veridex工具存在以下局限性:
它无法检测到通过JNI实现的调用。它只能检测到一部分通过反射实现的调用。它对非活动代码路径的分析仅限于API级别的检查。它只能在支持SSE2和POPCNT指令的机器上运行。
以上内容均来自官网的文档翻译。
实测结果:
看到输出的结果unsupported、blocked、max-target-x。是文档过期了,还是我的veridex工具版本太旧了,网上找了几个其他版本输出的都是这个结果。
继续在官网找了找其他说明,在一篇https://developer.androicom/about/versions/10/non-sdk-q文章中看到了max-target-x相关的说明。
blacklist==blocked:无论什么版本的手机系统,使用这些api,系统将会抛出异常;greylist==unsupported:不支持,但可以正常使用;greylist-max-x==max-target-x:APP运行在版本<=x的系统里可以正常访问,targetSDK>x且运行在>x的手机会抛出异常;
找max-gerget-0的case分析一下:
#37: Reflection max-target-o Landroid/content/pm/ActivityInfo;->isFixedOrientation use(s):
Lcom/xxx/xxx/xxx/j;->b(Landroid/app/Activity;)Z
#84: Reflection max-target-o Landroid/view/View;->sAcceptZeroSizeDragShadow use(s):
Lcom/xxx/xxx/xxx/a/c;->M(Landroid/widget/TextView;)V
以上两个方法或者变量可以在targetSDK<=27的时候使用,但如果升级targetSDK就会抛出异常。
最好寻找相关替代的api进行使用,否则在使用的时候进行异常捕获。
文章为作者独立观点,不代表观点