Android 开发：轻松读写用户文件

Android

2022-11-15 01:10:01

Android 10及以上版本：通过临时授权读写用户文件

前言

在Android 10及以上版本中，谷歌为保护用户隐私对文件读写权限进行了严格的控制。应用程序必须在操作用户文件之前，向用户请求必要的权限。然而，用户可能拒绝授权，导致应用程序无法正常运行。

本文将深入探讨如何通过临时授权在Android 10及以上版本中读写用户文件。它将涵盖以下主题：

使用存储访问框架（SAF）
请求读取/写入权限
代码示例

使用存储访问框架 (SAF)

存储访问框架 (SAF) 是一种Android API，允许应用程序在用户授予临时授权后访问用户文件。它通过Intent提供了一个标准化的方式，让应用程序可以请求特定文件的访问权限。

请求读取/写入权限

要通过SAF请求读取或写入权限，请执行以下步骤：

使用 createDocumentFile 或 openDocumentTree 意图创建一个 DocumentFile 对象。
调用 requestPermissions 方法，传递要请求的权限和请求代码。
在 onRequestPermissionsResult 回调方法中，检查权限是否被授予。

代码示例

以下代码示例演示了如何通过SAF请求读取用户文件的权限：

import android.Manifest;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Build;
import android.os.Bundle;
import android.provider.DocumentsContract;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

public class MainActivity extends AppCompatActivity {

    private static final int REQUEST_READ_EXTERNAL_STORAGE_PERMISSION = 1;

    private TextView tvFileContent;
    private Button btnReadFile;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        tvFileContent = findViewById(R.id.tvFileContent);
        btnReadFile = findViewById(R.id.btnReadFile);

        btnReadFile.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 检查是否具有读取外部存储的权限
                if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {
                    // 如果已经具有权限，则直接读取文件
                    readFile();
                } else {
                    // 如果没有权限，则请求权限
                    ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, REQUEST_READ_EXTERNAL_STORAGE_PERMISSION);
                }
            }
        });
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

        switch (requestCode) {
            case REQUEST_READ_EXTERNAL_STORAGE_PERMISSION:
                if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    // 用户授权了读取外部存储的权限
                    readFile();
                } else {
                    // 用户拒绝了读取外部存储的权限
                    Log.e("MainActivity", "用户拒绝了读取外部存储的权限");
                }
                break;
        }
    }

    private void readFile() {
        // 创建 SAF Intent
        Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        intent.setType("*/*");

        // 启动 SAF
        startActivityForResult(intent, REQUEST_READ_EXTERNAL_STORAGE_PERMISSION);
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);

        if (requestCode == REQUEST_READ_EXTERNAL_STORAGE_PERMISSION && resultCode == RESULT_OK) {
            // 获取文件内容
            Uri uri = data.getData();
            try {
                String fileContent = readTextFromUri(uri);
                tvFileContent.setText(fileContent);
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }

    private String readTextFromUri(Uri uri) throws IOException {
        try (InputStream inputStream = getContentResolver().openInputStream(uri)) {
            BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
            StringBuilder builder = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                builder.append(line).append("\n");
            }
            return builder.toString();
        }
    }
}