一、项目介绍
1.1 背景与意义
在 Android 应用中，“分享”是最常见的跨应用交互模式之一。无论是用户将文档、图片、音频、视频还是任意类型文件，通过社交、邮件、云盘等第三方应用流转，都需要依赖系统级的 Intent 机制与内容提供者（ContentProvider）来完成无缝对接。实现“分享文件”功能，不仅能提升应用的用户体验，也能让应用更易被传播和推广。
本项目针对 Android 5.0 及以上主流版本，演示如何：
在内部存储或外部私有目录中创建并管理文件；
使用官方推荐的 FileProvider 安全地向其他应用暴露文件；
构建并发送分享 Intent，将单个或多个文件分享给任意目标应用；
处理 Android 7.0+ 的 严厉文件 URI 限制（FileUriExposedException）；
兼容 Android 10+ 的 Scoped Storage（范围存储）；
利用 ShareCompat.IntentBuilder 简化开发；
优雅地处理运行时权限和异常。
并在此基础上，提供最佳实践和扩展思路，帮助读者将“分享文件”功能集成到真实项目中。
1.2 项目目标
文件创建与管理：在应用存储空间中读写文件（文本、图片、PDF、任意二进制），并保留可分享路径。
FileProvider 配置：在 AndroidManifest.xml 与 res/xml/file_paths.xml 中注册 FileProvider，并设置可共享的目录结构。
分享 Intent 构建：基于 Intent.ACTION_SEND 与 Intent.ACTION_SEND_MULTIPLE，支持单文件及多文件分享，设置合适的 MIME 类型与 URI 权限。
运行时权限：动态申请必要的存储或媒体权限，保证在 Android 6.0+ 环境下功能正常。
兼容性处理：处理 Android 7.0 以上的 URI 暴露限制，以及 Android 10+ 的 Scoped Storage (SAF) 差异。
示例完整：集中展示所有关键文件与代码，含注释分区，便于复制使用；
扩展与优化：总结常见坑点、性能建议以及下一步可以考虑的高级功能（如云端分享、WorkManager 后台分享、Compose 版本等）。
二、相关知识讲解
2.1 Intent 分享机制概述
Android 分享机制基于 隐式 Intent，核心步骤：
构造一个包含操作类型的 Intent，如 ACTION_SEND（单文件/单数据）或 ACTION_SEND_MULTIPLE（多文件）。
调用 Intent.setType() 指定 MIME 类型，如 "text/plain"、"image/jpeg"、"*/*"。
使用 Intent.putExtra(Intent.EXTRA_STREAM, uri) 或 Intent.EXTRA_STREAM 列表，附加要分享的文件 URI。
为目标应用授予读权限，通常通过 intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION).
调用 startActivity(Intent.createChooser(intent, "分享至"))，调起系统分享面板。
2.2 FileProvider 原理
由于 Android 7.0+ 禁止通过 file:// URI 跨进程共享文件，会抛出 FileUriExposedException。推荐做法：
在 AndroidManifest.xml 中声明
在 file_paths.xml 中定义可共享的目录，比如
使用 FileProvider.getUriForFile(context, authority, file) 将 java.io.File 转为 content:// URI。
authority 通常是 "${applicationId}.fileprovider"，需与 Manifest 保持一致。
2.3 Scoped Storage 与外部存储
Android 9 及以下：外部存储（Environment.getExternalStorageDirectory()）可自由读写，但需 WRITE_EXTERNAL_STORAGE 权限；
Android 10：引入 Scoped Storage，应用沙箱化，直接访问外部公共目录受限；可通过 requestLegacyExternalStorage=true 临时兼容；
Android 11+：更严格，推荐使用 Storage Access Framework（SAF）或仅访问自己私有目录。
对于分享，只要文件在应用私有目录（getFilesDir() 或 getExternalFilesDir()）并通过 FileProvider 暴露，即可跨应用访问，无需额外存储权限。
2.4 ShareCompat.IntentBuilder 简化
AndroidX 提供 ShareCompat.IntentBuilder，简化分享流程：
ShareCompat.IntentBuilder.from(activity)
.setType(mimeType)
.setStream(uri)
.setChooserTitle("分享文件")
.startChooser();
内部自动处理读权限标记与 Intent 包装。
三、实现思路
创建演示文件
在应用启动时，向 getExternalFilesDir("shared") 或 getFilesDir() 中写入一个测试文本文件 example.txt；
配置 FileProvider
在 AndroidManifest.xml 中注册；
在 res/xml/file_paths.xml 中定义
UI 布局
在 activity_main.xml 放置两个按钮：“分享单个文件”、“分享多个文件”；另放一个 TextView 显示分享结果；
MainActivity 实现
动态申请 CAMERA 权限不需要，但需要 READ_EXTERNAL_STORAGE 或 WRITE_EXTERNAL_STORAGE 仅在 Android ≤9；
在按钮点击的回调中，调用 shareSingleFile() 与 shareMultipleFiles() 方法；
shareSingleFile()
获取 File，转为 content:// URI，通过 FileProvider.getUriForFile()；
构造 Intent.ACTION_SEND，setType()，putExtra(EXTRA_STREAM, uri)，addFlags(FLAG_GRANT_READ_URI_PERMISSION)；
调用 startActivity(Intent.createChooser(...))；
shareMultipleFiles()
构造 ArrayList
使用 ACTION_SEND_MULTIPLE，putParcelableArrayListExtra(EXTRA_STREAM, urisList)；
结果处理
分享完成后，若希望捕获返回需使用 startActivityForResult(), 但大多数第三方应用不会返回结果。
四、完整代码整合
package="com.example.fileshare"> android:maxSdkVersion="28"/> android:allowBackup="true" android:label="文件分享示例" android:theme="@style/Theme.AppCompat.Light.NoActionBar"> android:name="androidx.core.content.FileProvider" android:authorities="${applicationId}.fileprovider" android:exported="false" android:grantUriPermissions="true"> android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths"/>
name="shared" path="shared/"/> android:orientation="vertical" android:padding="24dp" android:gravity="center_horizontal" android:layout_width="match_parent" android:layout_height="match_parent"> android:id="@+id/btn_share_single" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="分享单个文件"/> android:id="@+id/btn_share_multiple" android:layout_width="match_parent" android:layout_marginTop="16dp" android:layout_height="wrap_content" android:text="分享多个文件"/> android:id="@+id/tv_status" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_marginTop="32dp" android:text="分享状态：未操作" android:textSize="16sp"/> // ==================== File: MainActivity.java ==================== package com.example.fileshare; import android.content.Intent; import android.net.Uri; import android.os.Build; import android.os.Bundle; import android.widget.*; import androidx.annotation.Nullable; import androidx.appcompat.app.AppCompatActivity; import androidx.core.content.FileProvider; import java.io.*; import java.util.ArrayList; import java.util.List; /** * MainActivity：演示 Android 文件分享功能 */ public class MainActivity extends AppCompatActivity { private Button btnShareSingle, btnShareMultiple; private TextView tvStatus; private File sharedDir; @Override protected void onCreate(@Nullable Bundle saved) { super.onCreate(saved); setContentView(R.layout.activity_main); // 1. 绑定控件 btnShareSingle = findViewById(R.id.btn_share_single); btnShareMultiple = findViewById(R.id.btn_share_multiple); tvStatus = findViewById(R.id.tv_status); // 2. 创建示例文件目录 sharedDir = new File(getExternalFilesDir("shared"), ""); if (!sharedDir.exists()) sharedDir.mkdirs(); // 3. 在目录中创建示例文件 createExampleFile("example1.txt", "这是示例文件 1 的内容。"); createExampleFile("example2.txt", "这是示例文件 2 的内容。"); createExampleFile("example3.txt", "这是示例文件 3 的内容。"); // 4. 单文件分享 btnShareSingle.setOnClickListener(v -> { File file = new File(sharedDir, "example1.txt"); if (file.exists()) shareSingleFile(file, "text/plain"); else tvStatus.setText("文件不存在: example1.txt"); }); // 5. 多文件分享 btnShareMultiple.setOnClickListener(v -> { List files.add(new File(sharedDir, "example1.txt")); files.add(new File(sharedDir, "example2.txt")); files.add(new File(sharedDir, "example3.txt")); shareMultipleFiles(files, "text/plain"); }); } /** * 创建示例文本文件 */ private void createExampleFile(String name, String content) { File out = new File(sharedDir, name); try (FileWriter fw = new FileWriter(out)) { fw.write(content); } catch (IOException e) { e.printStackTrace(); tvStatus.setText("创建文件失败：" + name); } } /** * 分享单个文件 */ private void shareSingleFile(File file, String mimeType) { Uri uri = getUriForFile(file); if (uri == null) return; Intent intent = new Intent(Intent.ACTION_SEND); intent.setType(mimeType); intent.putExtra(Intent.EXTRA_STREAM, uri); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); startActivity(Intent.createChooser(intent, "分享文件")); } /** * 分享多个文件 */ private void shareMultipleFiles(List ArrayList for (File f : files) { Uri uri = getUriForFile(f); if (uri != null) uris.add(uri); } if (uris.isEmpty()) { tvStatus.setText("无可分享文件"); return; } Intent intent = new Intent(Intent.ACTION_SEND_MULTIPLE); intent.setType(mimeType); intent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); startActivity(Intent.createChooser(intent, "分享多个文件")); } /** * 获取 content:// URI，兼容各版本 */ private Uri getUriForFile(File file) { try { // 使用 FileProvider 生成 URI String authority = getPackageName() + ".fileprovider"; return FileProvider.getUriForFile(this, authority, file); } catch (IllegalArgumentException e) { e.printStackTrace(); tvStatus.setText("无法获取 URI：" + file.getName()); return null; } } } 五、代码解读 FileProvider 配置 在 AndroidManifest.xml 中声明 file_paths.xml 定义的 示例文件创建 createExampleFile() 向私有外部存储目录写入文本文件，无需外部存储权限； 文件写在 Android/data/ 分享单个文件 Intent.ACTION_SEND：用于单文件分享； setType("text/plain")：告诉系统文件类型； EXTRA_STREAM：附件 URI； addFlags(FLAG_GRANT_READ_URI_PERMISSION)：授予目标应用临时读权限。 分享多个文件 ACTION_SEND_MULTIPLE：支持多文件； 与单文件类似，但多通过 putParcelableArrayListExtra(EXTRA_STREAM, uris) 添加多 URI； 运行时兼容性 Android 7.0+ 强制使用 content:// URI； FileProvider 内部会为每个 URI 颁发权限，目标应用在 onActivityResult 中可使用； Android 6.0+ 如操作公共外部存储需申请 读取/写入 权限，但示例仅用私有目录，无需申请。 六、项目总结与扩展 6.1 效果回顾 成功实现单个与多个文件分享，覆盖文本、图片、二进制任意文件。 采用官方推荐的 FileProvider 方案，兼容 Android 7.0+ 严格文件 URI 限制。 私有目录无需存储权限，安全可靠，并无须额外存储申请。 6.2 常见坑与注意 URI 权限失效：必须为每个 Intent 加入 FLAG_GRANT_READ_URI_PERMISSION； authority 不一致：getUriForFile() 的 authority 必需与 Manifest 中 provider 一致，否则抛异常； Scoped Storage：Android 10+ 若需访问公有目录或 SD 卡，需要改用 SAF (Intent.ACTION_OPEN_DOCUMENT / MediaStore)，FileProvider 仅限私有目录； 大文件分享：分享大文件时，不要在 UI 线程读写或复制文件； 6.3 可扩展方向 自定义 ShareCompat.IntentBuilder 使用 ShareCompat.IntentBuilder 简化 Intent 构建与权限处理； 云端分享 在分享前先上传文件到云端，生成可公开访问 URL，再通过 ACTION_SEND 分享链接； 后台定时分享 结合 WorkManager 定时生成报告并自动分享； Jetpack Compose 实现 使用 Intent 与 rememberLauncherForActivityResult 集成分享按钮； 原生 CameraX 与 MediaStore 在分享图片或视频前，先通过 CameraX 拍照/录制并保存至 MediaStore，再分享； Advanced MIME Negotiation 针对不同目标应用调整 MIME，例如分享 Office 文档（application/msword）或压缩包（application/zip）； 分享进度反馈 对于大文件或网络分享，可在 UI 中展示“准备中”、“已分享”、“失败”状态； 安全加密分享 在分享文件前使用 AES 加密，并在接收端或目标应用中解密。