Android开发新手求助：如何将PDF保存至普通可访问公共目录？

一、保存到公共下载目录的正确方式 #

从Android 10（API 29）开始，直接通过Environment.getExternalStoragePublicDirectory()写入公共存储目录会触发权限错误，需改用以下两种合规方式：

1. 用MediaStore API写入公共下载目录 #

无需申请WRITE_EXTERNAL_STORAGE权限（Android 10+），文件会直接出现在系统下载文件夹，用户可通过文件管理器轻松找到：

ContentValues values = new ContentValues();
values.put(MediaStore.Downloads.DISPLAY_NAME, "report.pdf");
values.put(MediaStore.Downloads.MIME_TYPE, "application/pdf");
values.put(MediaStore.Downloads.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS);

Uri uri = getContentResolver().insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, values);
if (uri != null) {
    try (OutputStream outputStream = getContentResolver().openOutputStream(uri)) {
        // 在此写入PDF文件字节流，例如：pdfGenerator.write(outputStream);
    } catch (IOException e) {
        e.printStackTrace();
    }
}

2. 用SAF让用户自主选择存储位置 #

调用系统文件选择器，让用户自行指定保存路径（支持公共下载目录、Documents目录等），完全符合权限规范：

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
intent.addCategory(Intent.CATEGORY_OPENABLE);
intent.setType("application/pdf");
intent.putExtra(Intent.EXTRA_TITLE, "report.pdf");
// AndroidX请用registerForActivityResult替代startActivityForResult
startActivityForResult(intent, REQUEST_CODE_SAVE_PDF);

在回调方法中获取返回的Uri，即可写入文件。

二、其他用户易访问的存储选项 #

• Documents目录：逻辑和MediaStore写入下载目录一致，仅需将RELATIVE_PATH改为Environment.DIRECTORY_DOCUMENTS，文件会出现在系统文档文件夹，同样便于用户访问。
• 不推荐使用getExternalFilesDir()：该目录属于应用私有区域，Android 11+默认文件管理器无法查看，且卸载应用时会被删除，不适合长期保存用户需要访问的报告。

三、Android 9及以下版本兼容 #

若需兼容Android 9（API 28）及更低版本，需在Manifest中声明WRITE_EXTERNAL_STORAGE权限，并在运行时动态申请权限，之后即可通过Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)写入公共下载目录。

内容的提问来源于stack exchange，提问作者Beginner