uni-app 真机调试安卓11设备读写失败问题

在 uni-app 开发过程中，真机调试时遇到安卓11设备读写失败的问题，通常是由于安卓11（API 30）引入的存储访问权限变更（Scoped Storage）导致的。Scoped Storage 限制了应用对文件系统的直接访问，尤其是对公共存储区域的访问。

解决方案

1. 配置 AndroidManifest.xml

在 AndroidManifest.xml 文件中，添加以下权限声明：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

2. 请求存储权限

在应用启动时，动态请求存储权限：

// 在 App.vue 或 main.js 中
uni.getSystemInfo({
  success: function (res) {
    if (res.platform === 'android' && res.system.indexOf('11') !== -1) {
      uni.authorize({
        scope: 'scope.writePhotosAlbum',
        success: function () {
          console.log('授权成功');
        },
        fail: function () {
          console.log('授权失败');
        }
      });
    }
  }
});

3. 使用 MANAGE_EXTERNAL_STORAGE 权限

对于需要访问所有外部存储文件的应用，可以请求 MANAGE_EXTERNAL_STORAGE 权限：

uni.request({
  url: 'android.settings.MANAGE_ALL_FILES_ACCESS_PERMISSION',
  success: function (res) {
    console.log('请求成功');
  },
  fail: function (err) {
    console.log('请求失败', err);
  }
});

4. 使用 FileProvider

如果需要访问应用私有目录以外的文件，可以使用 FileProvider：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

在 res/xml/file_paths.xml 中定义文件路径：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="external_files" path="." />
</paths>

5. 使用 MediaStore

对于媒体文件的访问，可以使用 MediaStore API：

const uri = android.provider.MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
const cursor = uni.getContentResolver().query(uri, null, null, null, null);
if (cursor != null) {
    while (cursor.moveToNext()) {
        const displayName = cursor.getString(cursor.getColumnIndex(android.provider.MediaStore.Images.Media.DISPLAY_NAME));
        console.log(displayName);
    }
    cursor.close();
}