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

文档说明

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

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

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

  4. 版本号对应关系

    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();
  1. 在低于AndroidQ的系统上没问题

  2. 在AndroidQ及以上的系统上运行时:

    • targetSdkVersion,返回null或“unknown”;

    • targetSdkVersion>=Q,抛异常:

      SecurityException: getDeviceId: The user 10196 does not meet the requirements to access device identifiers.

  3. 受影响的方法

    • Build
      • getSerial()
    • TelephonyManager
      • getImei()
      • getDeviceId()
      • getMeid()
      • getSimSerialNumber()
      • getSubscriberId()

替代方案

  1. 方案一:

    使用AndroidId代替,缺点是应用签署密钥或用户(如系统恢复出产设置)不同返回的Id不同。与实际测试结果相符。
    经实际测试:相同签名密钥的不同应用androidId相同,不同签名的应用androidId不同。恢复出产设置或升级系统没测。

    // 返回:496836e3a48d2d9d
    String androidId = Settings.System.getString(context.getContentResolver(),
            Settings.Secure.ANDROID_ID);
    
  2. 方案二:

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

    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

官方文档

情况描述

  1. AndroidQ上,后台启动Activity会被系统忽略,不管targetSdkVersion多少;
  2. AndroidQ上,即使应用有前台服务也不行;
  3. 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)上有效。

后台应用增加定位限制

官方文档

情况描述

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

  2. 在AndroidQ上运行:

    • targetSdkVersion,没影响,申请权限时系统默认会加上后台位置权限
    • targetSdkVersion>=Q,需申请;
    • 应用变为后台应用90s后开始定位失败(Pixel AndroidQ-beta6)
  3. ACCESS_BACKGROUND_LOCATION不能单独申请,需要和ACCESS_COARSE_LOCATION/ACCESS_FINE_LOCATION一起申请

解决方法

  1. 动态申请即可;

  2. 启动前台服务

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

分区存储

官方文档

情况描述

  1. 从Android10开始应用将不可直接访问外部存储(/sdcard)文件,否则抛异常。
  2. 在AndroidQ上运行:
    • targetSdkVersion,没影响;
    • targetSdkVersion>=Q,默认启用过滤视图,应用以外的文件需要通过存储访问框架(SAF,StorageAccessFramework)读写。

解决方法

方法一、停用过滤视图,使用旧版存储模式
   <manifest ... >
     
     <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)新特性适配小结_第1张图片
允许了之后通过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);
        }
    }
    

你可能感兴趣的:(Android10(Api 29)新特性适配小结)