[Android] Android 13 新特性及适配指南

• 细分媒体权限：
  将 READ_EXTERNAL_STORAGE 细分为IAMGES、VIDEO、AUDIO权限
  （若设置 targetSdk>=33 则此项必需适配！）
• WebView调整：
  废弃setAppCacheEnabled与setForceDark方法；
  （若设置 targetSdk>=33 则此项必需适配！）
• 静态广播注册：
  注册静态广播时，需设置对其他应用的可见性
  （若设置 targetSdk>=33 则此项必需适配！）
• 通知权限：
  新增运行时通知权限：POST_NOTIFICATIONS
  （若设置 targetSdk>=33 则此项必需适配！）
• Wi-Fi ：
  新增 NEARBY_WIFI_DEVICES 运行时权限
  （若设置 targetSdk>=33 则此项必需适配！）
• 身体传感器后台权限：
  新增 BODY_SENSORS_BACKGROUND 运行时权限
  （若设置 targetSdk>=33 则此项必需适配！）
• 剪切板内容隐藏：
  新增内容隐藏API
  （根据业务需求，选择性适配！）
• 非 SDK 接口的限制
  （若设置 targetSdk>=33 则此项必需适配！）
  

• 前台服务管理器：
  系统新增前台服务管理器
  （系统新特性无需适配！）
  

• 已授权READ_EXTERNAL_STORAGE权限的应用：系统将自动赋予对应的细化权限。
• 未授权仍请求READ_EXTERNAL_STORAGE权限：亲测系统将不会授予任何权限。
  

• 如果同时请求 READ_MEDIA_IMAGES 和 READ_MEDIA_VIDEO 权限，系统将会提示如下权限弹窗：
  
• 如果请求 READ_MEDIA_AUDIO 权限，系统将提示如下弹窗：
  
  

• WebSettings.setAppCacheEnabled() 方法废弃。
• WebSettings.setForceDark() 方法废弃。
  

• 若开发者仍需自定义Webview主题颜色，可以使用：
  WebSettings.setAlgorithmicDarkeningAllowed()或WebSettingsCompat.setAlgorithmicDarkeningAllowed()方法。
• 若开发者仍然使用WebSettings.setForceDark()系统将提示错误：
  

W/cr_WebSettings: setForceDark() is a no-op in an app with targetSdkVersion>=T

• 若对其他应用可见，广播注册时设置：Context.RECEIVER_EXPORTED
• 若仅应用内使用，广播注册时设置：Context.RECEIVER_NOT_EXPORTED
  

private void registerTestReceiver() {
  IntentFilter filter = new IntentFilter();
  filter.addAction("com.xiaxl.test.action");
  // api >= 33
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    // 跨应用间使用
    MainActivity.this.registerReceiver(mTestReceiver, filter, Context.RECEIVER_EXPORTED);
    // 应用内使用
    //MainActivity.this.registerReceiver(mTestReceiver, filter, Context.RECEIVER_EXPORTED);
  }
  // api <= 32
  else {
    MainActivity.this.registerReceiver(mTestReceiver, filter);
  }
}

• 对于以Android13（API 33+）为目标平台的应用：
  在显示Android通知栏时，一方面需要在AndroidManifest中声明 android.permission.POST_NOTIFICATION，另一方面代码中需动态申请该通知栏权限。
  

<!-- AndroidManifest权限声明 -->
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="com.xiaxl.test">

  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
</manifest>


// Java代码动态申请POST_NOTIFICATIONS权限
if (Build.VERSION.SDK_INT >= 33) {
  int checkPermission =
      ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.POST_NOTIFICATIONS);
  if (checkPermission != PackageManager.PERMISSION_GRANTED) {
    //动态申请
    ActivityCompat.requestPermissions(MainActivity.this, new String[]{
        Manifest.permission.POST_NOTIFICATIONS}, PERMISSION_REQUEST_CODE);
  } else {
    //showRecordNotification();
  }
} else {
  //showRecordNotification();
}

• 对于以Android12（API 32-）为目标平台的应用：
  对于以API 32-为目标平台的应用，运行在Android13及以上设备中时，当应用第一次显示通知时，系统会自动弹出以下提示框，要求用户动态授权。
  

private void addData2Clipboard() {
  ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
  ClipData clipData = ClipData.newPlainText("111111", "我是密码");
  ClipDescription description = clipData.getDescription();
  // 隐私内容：剪切板加密
  PersistableBundle persistableBundle = new PersistableBundle();
  if (Build.VERSION.SDK_INT >= 33) {
    persistableBundle.putBoolean(ClipDescription.EXTRA_IS_SENSITIVE, true);
  } else {
    persistableBundle.putBoolean("android.content.extra.IS_SENSITIVE", true);
  }
  description.setExtras(persistableBundle);
  // 剪切板添加加密内容
  clipboardManager.setPrimaryClip(clipData);
}

appcompat.sh --dex-file=apk.apk

• blacklist 黑名单：禁止使用的非SDK接口，运行时直接Crash（因此必须解决）
• greylist 灰名单：即当前版本仍能使用的非SDK接口，但在下一版本中可能变成被限制的非SDK接口
• greylist-max-o： 在targetSDK<=O中能使用，但是在targetSDK>=P中被禁止使用的非SDK接口
• greylist-max-p： 在targetSDK<=P中能使用，但是在targetSDK>=Q中被禁止使用的非SDK接口