如何解决在 Android 应用中读取 ／sdcard／download 文件时的权限问题

在 Android 开发中，常常会遇到读取设备存储（如 /sdcard/download 目录）时的权限问题。尤其是在 Android 6.0 及以上版本，由于引入了运行时权限机制，开发者需要显式请求权限才能访问某些存储路径。本文将指导您如何解决在 Android 应用中读取 /sdcard/download 中文件没有权限的问题。

操作前的准备

在进行操作之前，请确保：

• 您正在使用 Android Studio 进行应用开发。
• 您的目标设备运行的是 Android 6.0（API 23）或更高版本。
• 您已创建一个简单的 Android 应用项目。

获取存储权限的详细操作步骤

步骤 1：在 AndroidManifest.xml 中添加权限

在您的 Android 应用的 AndroidManifest.xml 文件中，添加以下权限声明：

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

步骤 2：编写请求权限的代码

在您的活动或片段中，使用以下代码请求权限。在 Android 6.0 及以上版本，您需要在运行时请求权限：

private static final int REQUEST_CODE_STORAGE_PERMISSION = 100;

private void requestStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, 
            Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, 
                new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 
                REQUEST_CODE_STORAGE_PERMISSION);
    } else {
        readFilesFromDownload(); // 权限已获取，可以读取文件
    }
}

@Override
public void onRequestPermissionsResult(int requestCode, 
        @NonNull String[] permissions, 
        @NonNull int[] grantResults) {
    if (requestCode == REQUEST_CODE_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            readFilesFromDownload(); // 用户允许了权限
        } else {
            // 权限被拒绝，提示用户
            Toast.makeText(this, "权限被拒绝，无法读取文件", Toast.LENGTH_SHORT).show();
        }
    }
}

步骤 3：实现读取下载目录文件的逻辑

一旦获取到权限，您可以通过以下代码实现读取 /sdcard/download 目录中的文件：

private void readFilesFromDownload() {
    File downloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
    File[] files = downloadDir.listFiles();

    if (files != null) {
        for (File file : files) {
            Log.d("File Name", file.getName()); // 打印文件名
        }
    } else {
        Log.d("Error", "不能读取文件，可能目录为空或出现其他问题");
    }
}

操作过程中可能遇到的问题与注意事项

• 模拟器与真实设备：模拟器可能不会完全模拟存储操作，因此在真实设备上测试是必要的。
• 权限管理：确保在设备的应用设置中允许了相应的权限，某些用户可能会手动禁用应用的存储权限。
• 兼容性考虑：在 Android 10 及以上版本，您可能需要处理 Scoped Storage 相关的变化。对于这些版本，考虑使用 Storage Access Framework。

通过上述步骤，您应能够成功获取并读取 /sdcard/download 目录中的文件。如果遇到其他问题，建议查阅相关 API 文档或寻求社区的支持。