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

深渊向深渊呼唤

文档说明

    本文档主要对影响比较大的部分进行简单总结,内容并不全面;

    本文档基于谷歌AndroidQ官方文档和华为Q版本应用兼容性整改指导(华为的有点过时);

    所用测试机:Google初代Pixel,AndroidQ-beta6-190730.005

    版本号对应关系

    Android-Q = Android-10 = Api29

    Android-P = Android-9.0 = Api28

目录

文档说明 设备硬件标识符访问限制 原来的做法 替代方案 禁止后台启动Activity 情况描述 解决方法 后台应用增加定位限制 情况描述 解决方法 分区存储 情况描述 解决方法 方法一、停用过滤视图,使用旧版存储模式 方法二、将文件存储到过滤视图中,官方推荐。 方法三、使用存储访问框架(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”’按钮,
Android10(Api 29)新特性适配小结
允许了之后通过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);
    }
}
栏目