AndroidQ沙盒机制之分区存储适配

为了让用户更好地控制自己的文件，Android Q更改了应用访问设备外部存储空间中文件的方式。Android Q用更精细的媒体特定权限来替换READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限，并且无需特定权限，应用即可访问自己在外部存储设备的文件。

1、针对应用私有文件的隔离存储沙盒

对于每个应用，Android Q 都会创建一个“隔离存储沙盒”，以限制其他应用访问本应用在外部存储设备的文件。常见的外部存储设备是/sdcard。此定义具有两个优点：

①、需要的权限更少。 应用沙盒中的文件是您应用的私有文件。因此，您不再需要任何权限即可在外部存储设备中访问和保存自己的文件；

②、相对于设备上的其他应用，隐私性更强。 任何其他应用都无法直接访问您应用的隔离存储沙盒中的文件。借助此访问权限限制，您的应用可以更轻松地维护沙盒文件的隐私性；

在外部存储设备存储文件的最佳位置是Context.getExternalFilesDir()返回文件所在的位置，因此此位置的行为方式在所有Android版本中都保持一致。使用此方法时，需要在媒体环境中传递我们要创建或打开的文件类型对应的文件。例如，要保存或访问应用私有图片，请调用Context.getExternalFilesDir(Environment.DIRECTORY_PICTURES)。

2、媒体文件的共享集合

如果我们的应用创建了属于相应用户的文件，并希望卸载该应用时保留此用户，则将这些文件保存在某个通用媒体集合(共享集合)中。共享集合包括：照片、音频、视频和下载内容。

3、查看其它应用的文件所需权限

我们的应用无需请求任何权限，即可在这些共享集合中创建和修改自己的文件。但是，我们的应用要创建或修改其他应用已创建的文件，则必须先请求相应权限：

①、访问照片和视频共享集合中其他应用的文件时，需要 READ_MEDIA_IMAGES 或 READ_MEDIA_VIDEO 权限（具体取决于您的应用需要访问的文件类型）；

②、访问音乐共享集合中其他应用的文件时，需要 READ_MEDIA_AUDIO 权限；

4、访问共享集合

在请求必要的权限后，我们的应用可以使用MediaStore API访问这些集合：

①、对于照片和视频共享集合，请使用 MediaStore.Images 或 MediaStore.Video；

②、对于音乐共享集合，请使用 MediaStore.Audio；

③、对于下载内容共享集合，请使用 MediaStore.Downloads；

要在原生代码中访问媒体文件，请使用基于Java或kotlin代码的MediaStore来检索相应文件，然后对相应文件描述符传递到原生代码。详情请参考从原生代码访问媒体文件部分。

5、保留应用在共享集合的文件

默认情况下，在用户卸载应用时，Android Q会清理保存在沙盒的文件。要在卸载应用时保留这些文件，请使用存储访问框架存储访问框架，或将文件保存在共享集合中。要保留共享集合的文件，请在相关的MediaStore集合中新插一行，并使用以下方法：

①、至少应为 DISPLAY_NAME 和 MIME_TYPE 列提供值；

②、（可选）您可以使用 PRIMARY_DIRECTORY 和 SECONDARY_DIRECTORY 列来影响文件在磁盘上的存储位置；

③、保留 DATA 列不定义。这样一来，平台便可以灵活地将文件保留在沙盒之外；

插入此行后，我们可以使用ContentResolver.openFileDescriptor() 这个API向文件读取或写入数据。

6、访问照片的位置信息

一些照片在Exif元数据中包含位置信息，以便用户查看照片的拍摄地点。由于此位置信息非常敏感，因此默认情况下，Android Q会对此位置信息进行隐藏。如果我们的应用需要访问照片的位置信息，需要调用以下方法：

①、将新的 ACCESS_MEDIA_LOCATION 权限添加到您应用的清单中；

②、在 MediaStore 对象中，调用 setRequireOriginal() 并传入照片的 URI；

Java示例代码如下：

Uri photoUri = Uri.withAppendedPath(
      MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
      cursor.getString(idColumnIndex));
 
  final double[] latLong;
  if (BuildCompat.isAtLeastQ()) {
    // When running Android Q, get location data from `ExifInterface`.
    photoUri = MediaStore.setRequireOriginal(photoUri);
    InputStream stream = getContentResolver().openInputStream(photoUri);
    if (stream != null) {
      ExifInterface exifInterface = new ExifInterface(stream);
      double[] returnedLatLong = exifInterface.getLatLong();
 
      // If lat/long is null, fall back to the coordinates (0, 0).
      latLong = returnedLatLong != null ? returnedLatLong : new double[2];
 
      // Don't reuse the stream associated with {@code ExifInterface}.
      stream.close();
    } else {
      // Failed to load the stream, so return the coordinates (0, 0).
      latLong = new double[2];
    }
  } else {
    // On devices running Android 9 (API level 28) and lower, use the
    // media store columns.
    latLong = new double[]{
        cursor.getFloat(latitudeColumnIndex),
        cursor.getFloat(longitudeColumnIndex)
    };
  }

kotlin示例代码如下：

val latLong = if (BuildCompat.isAtLeastQ()) {
    // When running Android Q, get location data from `ExifInterface`.
    photoUri = MediaStore.setRequireOriginal(photoUri)
    contentResolver.openInputStream(photoUri).use { stream ->
      ExifInterface(stream).run {
        // If lat/long is null, fall back to the coordinates (0, 0).
        latLong ?: doubleArrayOf(0.0, 0.0)
      }
    }
  } else {
    // On devices running Android 9 (API level 28) and lower, use the
    // media store columns.
    doubleArrayOf(
      cursor.getFloat(latitudeColumnIndex).toDouble(),
      cursor.getFloat(longitudeColumnIndex).toDouble()
    )
  }

7、访问其他应用创建的文件

要访问其他应用已保存在外部存储设备的媒体文件，需要以下步骤：

①、根据包含您要访问的文件的共享集合请求必要的权限；

②、使用 ContentResolver 对象查找并打开该文件；

8、向其他应用创建的文件写入数据

通过将文件保存在共享集合，我们的应用成为该文件的所有者。通常情况下，只有是共享集合的某个文件所有者时，我们的应用才可以向文件写入数据。不过，如果我们的应用是用户默认的应用，我们可以向其他应用的文件写入数据：

①、如果您的应用是用户的默认照片管理器应用，则可以修改其他应用保存到照片和视频共享集合中的图片文件；

②、如果您的应用是用户的默认音乐应用，则可以修改其他应用保存到音乐共享集合中的音频文件；

要修改其他应用保存在存储设备的媒体文件，需要使用ContentResolver找到相应文件来修改。

9、标识特定的外部存储设备

在Android 9及以下版本，所有存储设备上的所有文件都会显示单个"external"卷名称。而Android Q为每个外部存储设备提供唯一的卷名称。此命名系统可以帮助我们高效整理内容并且加入索引，还可以控制存储内容的位置。要唯一标识外部存储设备的特定文件，我们需要使用卷名称和ID。例如，主存储设备的文件是content://media/external/images/media/12，而命名为FA23-3E92辅助存储设备对应文件是content://media/FA23-3E92/images/media/12。

10、获取外部存储列表

要获取所有当前可用卷的名称列表，请调用 MediaStore.getAllVolumeNames()，如以下代码段所示：

Set<String> volumeNames = MediaStore.getAllVolumeNames(context);