Android 10 更新内容与适配

灰太狼 2022-12-10 10:14 397阅读 0赞

**Android 10** **更新内容与适配**

功能更新与API

1.  手机温度监控
2.  webview渲染程序检测
3.  设置面板
4.  快捷方式改进
5.  深色主题

6. [其他拓展功能与API][API]

跟随系统版本的变更内容

1.  非SDK接口调用限制
2.  手势导航
3.  WLAN直连广播不生效
4.  旧版 Android 系统为目标平台的应用的警告

Target 29 变更内容

1.  全屏 Intent 的权限变更:USE\_FULL\_SCREEN\_INTENT
2.  后台位置权限
3.  后台启动 Activity 的限制
4.  /proc/net 文件系统的访问权限限制
5.  不可重置的设备标识符实施了限制
6.  剪贴板数据的访问权限
7.  启用和停用 WLAN 实施了限制
8.  直接访问已配置的 WLAN 网络实施了限制
9.  一些电话 API、蓝牙 API 和 WLAN API 需要精确位置权限
10. 外部存储访问权限限制与适配

功能更新与API

1．手机温度监控（目前只在Pixel设备受支持）

在 Android 10 中，应用可以使用 Thermal API 监控设备变化情况，并在设备过热时采取措施维持低电耗状态，使设备恢复到正常温度。

PowerManager manager = (PowerManager) getSystemService(Context.POWER_SERVICE);
    
    //监听手机热值状态
    
    manager.addThermalStatusListener(new PowerManager.OnThermalStatusChangedListener() {
    
        @Override
    
        public void onThermalStatusChanged(int status) {
    
            //温度改变时调用 常量 0-6 数值越大，温度越高

}})；

2.webview渲染程序检测

Android 10 引入了 WebViewRenderProcessClient 抽象类，应用可以使用该抽象类检测 WebView 是否无响应。

//WebView 渲染程序检测
    
            WebView view;
    
            view.setWebViewRenderProcessClient(new WebViewRenderProcessClient() {
    
                @Override
    
                public void onRenderProcessUnresponsive(@NonNull WebView view,

@Nullable WebViewRenderProcess renderer) {
    
                        //无响应时触发，webview是单进程时，renderer 为null
    
                }
    
                @Override
    
                public void onRenderProcessResponsive(@NonNull WebView view,

@Nullable WebViewRenderProcess renderer) {
    
             //如果 WebView 仍然无响应，则系统会定期调用 onRenderProcessUnresponsive()

（频率不高于每 5 秒一次），
    
              / 但不会执行其他任何操作。如果 WebView 再次无响应，

系统只调用 onRenderProcessResponsive() 一次
    
                } });

功能更新与API

3.设置面板

Android 10 引入了“设置面板”，让应用能够在自身环境中向用户显示设置。这样一来，用户无需通过转到**设置**来更改 **NFC** 或**移动数据**等设置，而能继续留在原来的应用中。  
使用方式：

//ACTION_INTERNET_CONNECTIVITY //网络链接设置

//ACTION_NFC NFC 设置界面

//ACTION_WIFI Wi-Fi设置界面

//ACTION_VOLUME 音量设置界面

Intent panelIntent = new Intent(Settings.Panel.ACTION_INTERNET_CONNECTIVITY);
    
    startActivityForResult(panelIntent, 0);

4.快捷方式改进

[ShortcutManagerCompat][] 是一个新版 AndroidX API，它可以向后兼容旧版 DirectShare API。

使用isRequestPinShortcutSupported 判断是否可以添加快捷方式，并使用requestPinShortcut请求添加到桌面

5.深色主题

Android 10 (API 级别 29) 及更高版本中提供深色主题背景。

适配方案( Force Dark)：  
其主题背景中设置 android:forceDarkAllowed="true"

6.[其他拓展功能与API][API]

捕获播放的音频

共享音频输入

对点对点连接

跟随系统版本的变更内容

1.非SDK接口调用限制

在调用针对Android 9/10 的限制API，或者黑名单API时，会出现超出预期行为（抛出异常或返回NULL），直接影响后续操作与业务逻辑。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTEyMDA2MDQ_size_16_color_FFFFFF_t_70][]

排查方法： 使用veridex工具命令：appcompat.sh --dex-file=\*\*.apk --imprecise >> \*\*.txt 导出结果数据到文件，结果如下：

\#295: Reflection blacklist Landroid/bluetooth/BluetoothAdapter;->mContext potential use(s):  
       Lcom/hook/ViewInvocationHandler;->invoke(Ljava/lang/Object;Ljava/lang/reflect/Method;\[Ljava/lang/Object;)Ljava/lang/Object;  
       Lorg/hulk/mediation/pangolin/adapter/PangolinInterstitialAd$PangolinStaticInterstitialAd;->hookDialog(Lcom/bytedance/sdk/openadsdk/TTInteractionAd;Landroid/app/Activity;)V  
       Lorg/hulk/ssplib/SspInterstitialAdLoader;→(Landroid/content/Context;Ljava/lang/String;Ljava/lang/String;)V

526 in greylist //灰名单，即当前版本仍能使用的非SDK接口，但在下一版本中可能变成被限制的非SDK接口 ，不用关注  
      239 in blacklist //黑名单，使用了就会报错。项目中必须解决的非SDK接口  
      1216 in greylist-max-o 在targetSDK<=O中能使用，但是在targetSDK>O中被限制的非SDK接口  
      81 in greylist-max-p 在targetSDK<=P中能使用，但是在targetSDK>P中被限制的非SDK接口  
       从结果来看，扫描结果较多，但结果中重复且包含源码，三方SDK，Lint 库中黑名单API调用信息，所以只关注自己应用包名下的信息即可。

解决思路：

更改限制API的调用， 如果一定使用限制API使用，做try catch 处理，并做调用失败的业务逻辑处理

跟随系统版本的变更内容

2.手势导航

从 Android 10 开始，用户可以在设备中启用手势导航。用户启用后，手势导航会影响设备上的所有应用。例如，如果用户从屏幕边缘向内滑动，系统会将该手势解读为“返回”导航

3.WLAN直连广播不生效

WIFI\_P2P\_CONNECTION\_CHANGED\_ACTION

WIFI\_P2P\_THIS\_DEVICE\_CHANGED\_ACTION

4.旧版 Android 系统为目标平台的应用的警告  
              在搭载 Android 10 或更高版本的设备上，如果用户首次运行以 Android 5.1（API 级别 22）或更低版本为目标平台的应用，则会看到警告。如果此应用要求用户授予权限，则系统会先向用户提供调整应用权限的机会，然后才会允许此应用首次运行。

Target 29 变更内容

1.全屏 Intent 发送通知的权限变更:USE\_FULL\_SCREEN\_INTENT

权限需清单文件注册，系统自动授权，调用全屏通知会有以下两种场景：

1.如果用户设备被锁定，会显示全屏 Activity，覆盖锁屏。

2.如果用户设备处于解锁状态，通知以展开形式显示，其中包含用于处理或关闭通知的选项。

2.后台位置权限：[ACCESS\_BACKGROUND\_LOCATION][ACCESS_BACKGROUND_LOCATION]

\*危险权限

Android 10 中增加后台定位权限，如果没有此权限，则该应用只能在前台或者前台服务（类型为location）时，才能获取到位置信息。

对应关系：

![20200925152359470.png][]

3.后台启动 Activity 的限制

从 Android 10 开始，系统会增加针对从后台启动 Activity 的限制,但下情景除外：

应用具有可见窗口，例如前台 Activity

应用的某个 Activity 刚在不久前启动

....

4./proc/net 文件系统的访问权限限制

Android 10 或更高版本的设备上，应用无法访问 /proc/net，其中包含与设备的网络状态相关的信息。

解决方案：  
    官方推荐使用NetworkStatsManager 或 ConnectivityManager 类。

5.不可重置的设备标识符实施了限制

从 Android 10 开始，应用必须具有 READ\_PRIVILEGED\_PHONE\_STATE 特许权限才能访问设备的不可重置标识符（包含 IMEI 和序列号）。  
\*该权限为特许权限，google play 无法声明

影响接口：

Build

getSerial()

TelephonyManager

getImei()

getDeviceId()

getMeid()

getSimSerialNumber()

getSubscriberId()

强行调用影响：

A.如果应用以 Android 10 或更高版本为目标平台，则会发生 SecurityException。

B.如果应用以 Android 9（API 级别 28）或更低版本为目标平台，则相应方法会返回 null 或占位符数据（具有 READ\_PHONE\_STATE 权限）。否则，会发生 SecurityException。  
6.剪贴板数据的访问权限

除非是输入法应用或者应用在前台，否则无法访问剪切板数据

7.启用和停用 WLAN 实施了限制

以 Android 10 或更高版本为目标平台的应用无法启用或停用 WLAN。WifiManager.setWifiEnabled() 方法始终返回 false。  
解决方案：

跳转到设置页面，用户主动操作。

8.直接访问已配置的 WLAN 网络实施了限制

[getConfiguredNetworks()][getConfiguredNetworks] //返回空列表  
[addNetwork()][addNetwork] 和 [updateNetwork()][updateNetwork]始终返回 -1

（[removeNetwork()][removeNetwork]、[reassociate()][reassociate]、[enableNetwork()][enableNetwork]、[disableNetwork()][disableNetwork]、[reconnect()][reconnect] 和 [disconnect()][disconnect]）始终返回 `false`。

使用 WifiNetworkSuggestion 对象。可以分别通过调用 addNetworkSuggestions() 和 removeNetworkSuggestions()

9.一些电话 API、蓝牙 API 和 WLAN API 需要精确位置权限

Android 10 或更高版本为目标平台，则它必须具有 ACCESS\_FINE\_LOCATION 权限才能使用 WLAN、WLAN 感知或蓝牙 API 中的一些方法

![20200925152419880.png][]                         ![20200925152431388.png][]

10.外部存储访问权限限制与适配

对于以 Android 10 及更高版本为目标平台的应用，其访问权限限定为应用私有目录。共有目录不再具有访问权限，并更改了一些其他细节限制：图片文件中地理位置信息默认不提供，查询MediaProvider 获得的DATA字段不再可靠，文件增加Pending 状态等。

解决方法：

**A.****兼容模式：**

在清单文件application 中添加requestLegacyExternalStorage = true

该属性标记应用继续延续Android10以前的存储模式，对外部存储文件等依然有访问权限，但大概率在接下来的大版本中会废弃此方案。

**B.****适配方式（推荐）：**

1.文件读取

使用 MediaStore 接口访问公共目录中的多媒体文件，或使用SAF框架（System Access Framework）访问公共目录所有文件

a.使用SAF框架调用系统文件选择器进行文件获取，在应用onActivityResult中获取到文件URI,间接拿到文件的IO流或DocumentFile对象进行操作。

b.使用SAF向用户申请文件或者目录的读写权限（后面介绍）

2.文件创建

a.使用SAF框架在任意目录创建文件（用户手动选择目录），在activityResult返回中获取文件Uri,以来文件uri进行文件IO写入操作。

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
    
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    
    // 文件类型
    
    intent.setType("text/plain");
    
    // 文件名称
    
    intent.putExtra(Intent.EXTRA_TITLE, filename);
    
    startActivityForResult(intent, WRITE_REQUEST_CODE);

b.使用SAF向用户申请目录读写权限（后面介绍）

3.文件写入  
    同（文件创建）  
4.文件删除

a.有SD读写权限，明确知道文件路径，使用File.delete 依然可以使用  
    b. 如果文件是媒体文件（且是应用自身创建的文件），MediaStore 获取文件Uri,可以删除。

c.使用SAF框架向用户申请目录的读写权限（后面介绍）

共有目录的操作权限申请与适配

Android 并不是完全限制用户读取外部访问，而是给用户了选择行，由用户来判断是否需要向应用授权共有目录读写。

a. 权限的申请

使用SAF框架进行文件或者文件夹的授权，代码如下

Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    
    startActivityForResult(intent, REQUEST_CODE_FOR_DIR);

在activityResult

final int takeFlags = data.getFlags()
    
            & (Intent.FLAG_GRANT_READ_URI_PERMISSION
    
            | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

getContentResolver().takePersistableUriPermission(data.getData(), takeFlags);
    
    // 保存获取的目录权限
    
    SharedPref.setString(this, "uriTree", data.getData().toString());
    
    DocumentFile file = DocumentFile.fromTreeUri(this, data.getData());

B.权限的生命周期

在手机重启后，应用就丢失了该目录的操作权限，所以要保存目录uri到本地文件。

C.权限的判断

//获取所有授权文件列表

getContentResolver().getPersistedUriPermissions();

//判断授权列表中是否包含本地存储uri，是否有读写权限

if(item.equals("本地存储uri")&&

item.isReadPermission()&&item.isWritePermission())

DocumentFile操作：

SAF授权用户文件权限后，依赖Uri进行文件权限的操作：

DocumentFile file = DocumentFile.fromTreeUri(this, data.getData());
    
    DocumentFile file = DocumentFile.fromTreeUri(this, data.getData());
    
    file.listFiles();//获取子文件/文件夹
    
    file.getName();//获取文件/文件夹名称
    
    file.delete();//删除文件
    
    file.createFile()//创建文件；

[API]: https://developer.android.com/about/versions/10/features#thermal
[ShortcutManagerCompat]: https://developer.android.com/reference/androidx/core/content/pm/ShortcutManagerCompat
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTEyMDA2MDQ_size_16_color_FFFFFF_t_70]: /images/20221123/ff4294b3619b4effb3b6a13f7dc1565b.png
[ACCESS_BACKGROUND_LOCATION]: https://developer.android.google.cn/about/versions/10/privacy/changes#app-access-device-location
[20200925152359470.png]: /images/20221123/4f77b61c86504f23871fa0931e07b9dd.png
[getConfiguredNetworks]: https://developer.android.com/reference/android/net/wifi/WifiManager#getConfiguredNetworks%28%29
[addNetwork]: https://developer.android.com/reference/android/net/wifi/WifiManager#addNetwork%28android.net.wifi.WifiConfiguration%29
[updateNetwork]: https://developer.android.com/reference/android/net/wifi/WifiManager#updateNetwork%28android.net.wifi.WifiConfiguration%29
[removeNetwork]: https://developer.android.com/reference/android/net/wifi/WifiManager#removeNetwork%28int%29
[reassociate]: https://developer.android.com/reference/android/net/wifi/WifiManager#reassociate%28%29
[enableNetwork]: https://developer.android.com/reference/android/net/wifi/WifiManager#enableNetwork%28int,%20boolean%29
[disableNetwork]: https://developer.android.com/reference/android/net/wifi/WifiManager#disableNetwork%28int%29
[reconnect]: https://developer.android.com/reference/android/net/wifi/WifiManager#reconnect%28%29
[disconnect]: https://developer.android.com/reference/android/net/wifi/WifiManager#disconnect%28%29
[20200925152419880.png]: https://img-blog.csdnimg.cn/20200925152419880.png
[20200925152431388.png]: /images/20221123/2e28ecda51654edbb077e44cecd821e5.png