Android10(Api 29)新特性适配小结

文档说明

本文档主要对影响比较大的部分进行简单总结，内容并不全面；
本文档基于谷歌AndroidQ官方文档和华为Q版本应用兼容性整改指导(华为的有点过时)；
所用测试机：Google初代Pixel，AndroidQ-beta6-190730.005
版本号对应关系

Android-Q = Android-10 = Api29

Android-P = Android-9.0 = Api28

方法一、停用过滤视图，使用旧版存储模式
方法二、将文件存储到过滤视图中，官方推荐。
方法三、使用存储访问框架（SAF），由用户指定要读写的文件。
方法四、获取用户指定的某个目录的读写权限
1. 申请目录的访问权限
2. 通过Uri读写文件

设备硬件标识符访问限制

限制应用访问不可重设的设备识别码，如 IMEI、序列号等，系统应用不受影响。

原来的做法

// 在AndroidQ上以下方法都会有问题
// 返回：866976045261713; 
TelephonyManager tm = (TelephonyManager) getSystemService(TELEPHONY_SERVICE);
tm.getDeviceId();
tm.getSubscriberId();
tm.getDeviceId(TelephonyManager.PHONE_TYPE_NONE);
//返回：66J0218B19000977; 
Build.getSerial();

在低于AndroidQ的系统上没问题
在AndroidQ及以上的系统上运行时：
- 如targetSdkVersion<Q，返回null或“unknown”；
- 如targetSdkVersion>=Q，抛异常：
  
  SecurityException: getDeviceId: The user 10196 does not meet the requirements to access device identifiers.
受影响的方法
- Build
  - getSerial()
- TelephonyManager
  - getImei()
  - getDeviceId()
  - getMeid()
  - getSimSerialNumber()
  - getSubscriberId()

替代方案

方案一：

使用AndroidId代替，缺点是应用签署密钥或用户（如系统恢复出产设置）不同返回的Id不同。与实际测试结果相符。
经实际测试：相同签名密钥的不同应用androidId相同，不同签名的应用androidId不同。恢复出产设置或升级系统没测。
```
// 返回：496836e3a48d2d9d
String androidId = Settings.System.getString(context.getContentResolver(),
        Settings.Secure.ANDROID_ID);
```

方案二：

通过硬件信息拼接，缺点是还是不能保证唯一。
经测试：似乎与方案一比更稳定，不受密钥影响，但非官方建议，没安全感。

private static String makeDeviceId(Context context) {
    String  deviceInfo = new StringBuilder()
            .append(Build.BOARD).append("#")
            .append(Build.BRAND).append("#")
            //CPU_ABI，这个值和appp使用的so库是arm64-v8a还是armeabi-v7a有关，舍弃
            //.append(Build.CPU_ABI).append("#")
            .append(Build.DEVICE).append("#")
            .append(Build.DISPLAY).append("#")
            .append(Build.HOST).append("#")
            .append(Build.ID).append("#")
            .append(Build.MANUFACTURER).append("#")
            .append(Build.MODEL).append("#")
            .append(Build.PRODUCT).append("#")
            .append(Build.TAGS).append("#")
            .append(Build.TYPE).append("#")
            .append(Build.USER).append("#")
            .toString();
    try {
    	//22a49a46-b39e-36d1-b75f-a0d0b9c72d6c
       return UUID.nameUUIDFromBytes(deviceInfo.getBytes("utf8")).toString();
    } catch (UnsupportedEncodingException e) {
        e.printStackTrace();
    }
    String androidId = Settings.System.getString(context.getContentResolver(),
                Settings.Secure.ANDROID_ID);
    return androidId;
}

禁止后台启动Activity

官方文档

情况描述

AndroidQ上，后台启动Activity会被系统忽略，不管targetSdkVersion多少；
AndroidQ上，即使应用有前台服务也不行；
AndroidQ以下版本没影响。

解决方法

发送全屏通知:

//AndroidManifest 声明新权限，不用动态申请
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT"/>

Intent intent = new Intent(this, ScopedStorageActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(this,
        REQ_CODE, intent, PendingIntent.FLAG_UPDATE_CURRENT);
Notification notification = new NotificationCompat.Builder(this, Constants.CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_launcher_foreground)
        .setContentTitle("Incoming call")
        .setContentText("(919) 555-1234")
        .setPriority(NotificationCompat.PRIORITY_HIGH)
        .setCategory(NotificationCompat.CATEGORY_ALARM)
        //设置全屏通知后，发送通知直接启动Activity
        .setFullScreenIntent(pendingIntent, true)
        .build();
NotificationManager manager = getSystemService(NotificationManager.class);
manager.notify(445456, notification);

但是：在华为mate20（Api-28）上需要到设置中打开横幅通知；原生AndroidQ（beta6）上有效。

后台应用增加定位限制

官方文档

情况描述

后台应用要获取位置信息需要动态申请权限，

<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
在AndroidQ上运行：
- targetSdkVersion<Q，没影响，申请权限时系统默认会加上后台位置权限
- targetSdkVersion>=Q，需申请；
- 应用变为后台应用90s后开始定位失败（Pixel AndroidQ-beta6）
ACCESS_BACKGROUND_LOCATION不能单独申请，需要和ACCESS_COARSE_LOCATION/ACCESS_FINE_LOCATION一起申请

解决方法

动态申请即可；

启动前台服务

<!-需要设置foregroundServiceType为“location” ->
<service 
 android:name=".permission.LocationService"
    android:foregroundServiceType="location"/>

分区存储

官方文档

情况描述

从Android10开始应用将不可直接访问外部存储（/sdcard）文件，否则抛异常。
在AndroidQ上运行：
- targetSdkVersion<Q，没影响；
- targetSdkVersion>=Q，默认启用过滤视图，应用以外的文件需要通过存储访问框架（SAF，StorageAccessFramework）读写。

解决方法

方法一、停用过滤视图，使用旧版存储模式

   <manifest ... >
     <!-- This attribute is "false" by default on apps targeting Android Q. -->
     <application android:requestLegacyExternalStorage="true" ... >
       ...
     </application>
   </manifest>

方法二、将文件存储到过滤视图中，官方推荐。

   // /Android/data/com.example.androidq/files/Documents
   File dir = context.getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS);

优点：不用申请读写权限；

缺点：随应用卸载而删除；

方法三、使用存储访问框架（SAF），由用户指定要读写的文件。

这个功能Android 4.4（API: 19）就有，官方文档在此。

方法四、获取用户指定的某个目录的读写权限

从Android5.0（Api 21）开始就有，官方文档。
步骤

1. 申请目录的访问权限

会打开系统的文件目录，由用户自己选择允许访问的目录，不用申请WRITE/READ_EXTERNAL_STORAGE权限。

Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | 
        Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);				
startActivityForResult(intent, REQ_CODE);

执行上述代码后会出现类似如下图界面，点击‘允许访问“DuoKan”’按钮，

允许了之后通过onActivityResult()的intent.getData()得到该目录的Uri，通过Uri可获取子目录和文件。这种方式的缺点是应用重装后权限失效，即使可以保存了这个Uri也没用。

Uri dirUri = intent.getData();
// 持久化；应用重装后权限失效，即使知道这个uri也没用
SPUtil.setValue(this, SP_DOC_KEY, dirUri.toString());
//重要：少这行代码手机重启后会失去权限
getContentResolver().takePersistableUriPermission(dirUri, 
        Intent.FLAG_GRANT_READ_URI_PERMISSION);

2. 通过Uri读写文件

创建文件

// 在mUri目录（‘DuoKan’目录）下创建'test.txt'文件
private void createFile() {
    DocumentFile documentFile = DocumentFile.fromTreeUri(this, mUri);
    DocumentFile file = documentFile.createFile("text/plain", "test.txt");
    if (file != null && file.exists()) {
        LogUtil.log(file.getName() + " created");
    }
}

主要用到DocumentFile类，和File类的方法类似，有isFile、isDirectory、exists、listFiles等方法

删除文件

//删除"test.txt"
private void deleteFile() {
    DocumentFile documentFile = DocumentFile.fromTreeUri(this, mUri);
    // listFiles()，列出所有的子文件和文件夹
    for (DocumentFile file : documentFile.listFiles()) {
        if (file.isFile() && "test.txt".equals(file.getName())) {
            boolean delete = file.delete();
            LogUtil.log("deleteFile: " + delete);
            break;
        }
    }
}

写入数据

private void writeFile(Uri uri) {
    try {
        ParcelFileDescriptor pfd = getContentResolver().openFileDescriptor(uri, "w");
        //这种方法会覆盖原来文件内容
        OutputStreamWriter output = 
                new OutputStreamWriter(new FileOutputStream(pfd.getFileDescriptor()));
        // 不能传uri.toString(),否则FileNotFoundException
        // OutputStreamWriter output = new OutputStreamWriter(new FileOutputStream(uri.toString(), true));
        output.write("这是一段文件写入测试\n");
        output.close();
        LogUtil.log("写入成功。");
    } catch (IOException e) {
        LogUtil.log(e);
    }
}

yingchengyou

发布了10 篇原创文章 · 获赞 18 · 访问量 3万+

私信关注