Android 13下Outlook无法分享自定义JSON配置文件问题求助

问题概述 #

使用Android Studio开发的应用生成JSON配置文件，保存到Documents目录子文件夹后，在Android 13中通过Outlook分享时提示“无法添加附件”，但Teams可正常分享。最初使用Uri.fromFile()实现分享，后配置了FileProvider但问题依旧。

核心问题排查与修复 #

1. FileProvider Authorities不一致 #

代码中调用FileProvider.getUriForFile()时使用的authorities是com.test.example.fileProvider，但AndroidManifest.xml中配置的是com.test.project.fileProvider，两者不匹配会导致FileProvider无法生成有效Uri，这是Outlook无法读取文件的关键原因之一。

修正方法：保持两处authorities统一，示例：

Uri path = FileProvider.getUriForFile(this,"com.test.project.fileProvider", file);

2. 未显式授予文件读取权限 #

部分应用（如Outlook）需要显式获取Uri的读取权限，即使FileProvider配置了grantUriPermissions="true"，也需在Intent中添加权限标记：

emailIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

3. MIME类型错误 #

原代码使用的vnd.android.cursor.dir/email是联系人选择类型，不适合分享JSON文件。需改为JSON对应的MIME类型或通用类型：

emailIntent.setType("application/json");
// 或通用类型：emailIntent.setType("*/*");

4. FileProvider路径配置不匹配 #

文件保存在Documents目录子文件夹，但file_provider_path.xml中配置的是cache-path（对应应用缓存目录），导致FileProvider无法映射目标文件。需根据文件存储位置修改配置：

• 若文件在应用外部Documents目录，使用external-files-path：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-files-path
        name="app_documents"
        path="Documents/你的子文件夹名"/>
</paths>

• 若文件在系统公共Documents目录，使用documents-path：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <documents-path
        name="public_documents"
        path="你的子文件夹名"/>
</paths>

完整可运行分享代码示例 #

1. AndroidManifest.xml中的FileProvider配置 #

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="com.test.project.fileProvider"
    android:grantUriPermissions="true"
    android:exported="false">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_provider_path"/>
</provider>

2. res/xml/file_provider_path.xml（公共Documents目录示例） #

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <documents-path
        name="public_documents"
        path="ConfigFiles"/> <!-- 替换为你的Documents子文件夹名 -->
</paths>

3. 分享逻辑代码 #

// 目标文件：公共Documents目录下的ConfigFiles子文件夹内的testfile.json
File file = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS), "ConfigFiles/testfile.json");

Uri fileUri = FileProvider.getUriForFile(this, "com.test.project.fileProvider", file);

Intent shareIntent = new Intent(Intent.ACTION_SEND);
shareIntent.setType("application/json");
shareIntent.putExtra(Intent.EXTRA_STREAM, fileUri);
shareIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

startActivity(Intent.createChooser(shareIntent, "分享配置文件"));

额外注意事项 #

• Android 13及以上，访问公共Documents目录下的非媒体文件（如JSON），需申请MANAGE_EXTERNAL_STORAGE权限，或使用存储访问框架（SAF）让用户选择保存位置，避免权限限制。
• 测试前确认文件已正确生成且内容完整，排除文件损坏导致的分享失败。

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