安卓Q | 黑名单接口暴增10倍，非SDK接口管控适配指南

作者: 技术爱好 | 来源:发表于2019-04-26 11:41 被阅读3次

安卓Q | 黑名单接口暴增10倍，非SDK接口管控适配指南
Android Q适配(非SDK接口管控)
Android非SDK接口检测工具--veridex在windo
非 SDK 接口常见问题 | Android 开发者 FAQ V
Android 9 pie更新内容
设计模式-适配器模式
sdk测试
Unity启动时获取了android_id等设备信息
史上最严管控，Android P非SDK接口管控特性解读及适配
安网3（SAFE）项目进展(第12期)

image

从Android P开始，谷歌开始对非 SDK 接口使用进行限制，该变更被称为Android史上最严管控之一。在Android Q中，谷歌继续加强了对非SDK接口的使用限制，黑名单接口数量大幅增长，部分非SDK接口被删除，将导致大面积应用无法正常使用的问题，需要开发者重点关注并进行适配。

变更介绍

1、非SDK接口定义

SDK接口：

谷歌官方网站能查到的接口都是SDK接口，查询链接：

https://developer.android.com/reference/packages

非SDK接口：

除了谷歌开放的SDK接口之外的其他JAVA接口都是非SDK接口。

2、滥用非SDK接口的危害

非SDK接口在Android不同版本间存在很大的差异，使用非SDK接口容易带来兼容性问题。

3、非SDK接口管控名单说明

1、名单类型说明

名单类型

影响

greylist

targetSDK>=P时，警告

greylist-max-o

targetSDK<P时，警告；>=P时，不允许调用

greylist-max-p

targetSDK<Q时，警告；>=Q时，不允许调用

blacklist

所有三方应用不允许调用

2、名单查看

开发者可以使用预编译版本的veridex工具来查看非sdk接口名单。veridex 工具链接：

https://android.googlesource.com/platform/prebuilts/runtime/+/refs/heads/master/appcompat/

该工具目录下面的hiddenapi-flags.csv文件就是所有的SDK和非SDK接口名单及其对应的接口类型，开发者可以下载查看。

3、名单变化

•Android P 中109810个接口被加入了Android Q 接口黑名单；

•Android P 中10642个接口（非SDK+SDK）在Android Q中被删除。

image

*注：以上数据基于Android Q Beta 1统计。

变更影响

1、影响范围

所有非系统应用都可能会受到影响，从名单变化来看，黑名单接口大大增加，Q版本有很多非SDK接口被删除，都会导致应用出现兼容性问题，影响很大，需要所有应用排查和整改。

在Android Q beta被删除的非SDK接口中，部分接口依然存在应用调用，导致了明显的兼容性问题。目前已经测试发现，很多应用由于调用Landroid/view/DisplayListCanvas;->callDrawGLFunction2(J)V接口出现了crash 问题，开发者应重点关注。其余调用较多的接口名单如下：

Landroid/app/INotificationManager;->enqueueToast(Ljava/lang/String;Landroid/app/ITransientNotification;I)V
Landroid/graphics/drawable/StateListDrawable;->getStateDrawableIndex([I)I
Landroid/hardware/fingerprint/Fingerprint;->getFingerId()I
Landroid/media/MediaFile;->isWMAEnabled()Z
Landroid/media/MediaFile;->isWMVEnabled()Z
Landroid/media/MediaFile;->sMimeTypeMap:Ljava/util/HashMap;
Landroid/media/ThumbnailUtils$SizedThumbnailBitmap;-><init>(Landroid/media/ThumbnailUtils$1;)V
Landroid/os/ServiceManager;->sCache:Ljava/util/HashMap;
Landroid/telephony/SignalStrength;->mCdmaDbm:I
Landroid/telephony/SignalStrength;->mCdmaEcio:I
Landroid/telephony/SignalStrength;->mEvdoDbm:I
Landroid/telephony/SignalStrength;->mEvdoEcio:I
Landroid/telephony/SignalStrength;->mEvdoSnr:I
Landroid/telephony/SignalStrength;->mGsmBitErrorRate:I
Landroid/telephony/SignalStrength;->mGsmSignalStrength:I
Landroid/view/DisplayListCanvas;->callDrawGLFunction2(J)V
Landroid/view/DisplayListCanvas;->drawGLFunctor2(JLjava/lang/Runnable;)V
Landroid/view/DisplayListCanvas;->drawRenderNode(Landroid/view/RenderNode;)V
Landroid/view/RenderNode;->create(Ljava/lang/String;Landroid/view/View;)Landroid/view/RenderNode;
Landroid/view/RenderNode;->discardDisplayList()V
Landroid/view/RenderNode;->end(Landroid/view/DisplayListCanvas;)V
Landroid/view/RenderNode;->isValid()Z
Landroid/view/RenderNode;->output()V
Landroid/view/RenderNode;->setClipToBounds(Z)Z
Landroid/view/RenderNode;->setLeftTopRightBottom(IIII)Z
Landroid/webkit/TokenBindingService$TokenBindingKey;-><init>()V
Landroid/widget/TextView;->onProvideStructure(Landroid/view/ViewStructure;)V
Lcom/android/internal/location/ILocationProvider;->sendExtraCommand(Ljava/lang/String;Landroid/os/Bundle;)Z
Lcom/android/internal/telephony/CallManager;->getAllPhones()Ljava/util/List;
Lcom/android/internal/telephony/CommandsInterface$RadioState;->isOn()Z
Lcom/android/internal/telephony/CommandsInterface;->getRadioState()Lcom/android/internal/telephony/CommandsInterface$RadioState;
Lcom/android/internal/telephony/dataconnection/DcTracker;->cleanUpAllConnections(ZLjava/lang/String;)Z
Lcom/android/internal/telephony/dataconnection/DcTracker;->onDataSetupComplete(Landroid/os/AsyncResult;)V
Lcom/android/internal/telephony/ITelephony;->answerRingingCall()V
Lcom/android/internal/telephony/ITelephony;->endCall()Z
Lcom/android/internal/telephony/ITelephony;->getVoiceMessageCount()I
Lcom/android/internal/telephony/ITelephony;->silenceRinger()V
Lcom/android/internal/telephony/ITelephonyRegistry;->notifyDataConnectionFailed(Ljava/lang/String;Ljava/lang/String;)V

</pre>

2、兼容性表现

在DeveloperPreview的后续版本中，访问non-SDK接口的各种方法都会产生错误或其他不良结果，具体如下表所示：

image

适配指导

1、获取应用使用的所有非SDK接口列表

方法1：通过扫描分析动态运行日志获取

a) 关键日志

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

b）调试命令

在Android Q中，启用对非SDK接口的访问的命令已更改，开发者需要通过更改API强制策略来启用对开发设备上的非SDK接口的访问，ADB命令如下：

adb shell settings put globalhidden_api_policy 1

API强制策略中的整数值可以设置为以下三个选项：

0：禁用所有非SDK接口检测。使用此设置会禁用非SDK接口使用的所有日志消息，并阻止您使用StrictMode API测试应用程序。

1：允许访问所有非SDK接口，但打印日志消息，并显示任何非SDK接口使用情况的警告，使用此设置还允许您使用StrictMode API测试您的应用程序。

2：禁止使用属于黑名单的非SDK接口或目标API级别的受限制灰名单。

建议开发者将数值设置为1，再通过自动化或人工测试遍历应用所有功能和界面，然后通过抓取的日志分析调用的非SDK接口。

如需将API强制策略重置，可以使用以下命令进行设置：

adb shell settings deleteglobal hidden_api_policy

*以上命令不需要root设备。

方法2：通过谷歌提供的veridex静态扫描工具获取

veridex静态扫描工具下载链接：

https://android.googlesource.com/platform/prebuilts/runtime/+/refs/heads/master/appcompat/

使用说明请查看压缩包中README.txt文件，如果是linux系统，可以参考以下方法进行使用：

Linux x64

Download veridex-linux.zip,unzip the file and run with:

./appcompat.sh--dex-file=test.apk（替换成开发者自己的apk文件路径）

2、非SDK接口整改

三方应用需要重点关注max-o、max-p和黑名单的非SDK接口，需要找可替代的SDK接口进行适配。

3、无法整改的接口申请添加到浅灰名单

如果应用无法找到可替代的SDK接口整改，而且必须要使用这个非SDK接口，建议开发者直接给谷歌反馈申请新的公共API，申请链接：https://partnerissuetracker.corp.google.com/issues/new?component=328403&template=1027267

开发者需要按照下面的模板反馈信息：