Android中Intent Filter关联特定文件扩展名失效问题排查

核心问题分析 #

• Android 7.0+的file scheme限制：从API 24开始，Android系统不再允许应用通过file scheme的Intent访问其他应用的文件，这类Intent Filter会被系统忽略，只声明file scheme自然无法被文件管理器唤起。
• PathPattern匹配覆盖不全：单个.*\.pdf只能匹配根目录下的PDF，嵌套目录里的文件（比如docs/test.pdf）或者文件名带多个点的（比如report.v2.pdf）都匹配不到。
• 缺少明确MIME类型：不少文件管理器优先用MIME类型匹配应用，仅写*/*可能不会被识别成支持PDF格式的应用。

修复后的Manifest代码 #

把原来的Intent Filter改成下面这样：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleInstance">

    <intent-filter
        android:label="Application"
        android:priority="1">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <!-- 适配Android 7.0+的content scheme -->
        <data android:scheme="content" />
        <!-- 保留file scheme兼容旧版本系统 -->
        <data android:scheme="file" />
        <data android:host="*" />
        <!-- 明确指定PDF对应的MIME类型 -->
        <data android:mimeType="application/pdf" />
        <!-- 覆盖多层目录和多后缀的匹配场景 -->
        <data android:pathPattern=".*\\.pdf" />
        <data android:pathPattern=".*\\..*\\.pdf" />
        <data android:pathPattern=".*\\..*\\..*\\.pdf" />
        <data android:pathPattern=".*\\..*\\..*\\..*\\.pdf" />
    </intent-filter>

    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

额外注意点 #

• 权限配置：如果需要读取文件内容，得在Manifest里加READ_EXTERNAL_STORAGE权限（Android 13及以上可以用READ_MEDIA_DOCUMENTS这类细分权限），还要记得在运行时申请权限。
• 测试提示：改完代码重新安装应用后，最好清除下文件管理器的缓存，避免旧的匹配缓存干扰测试结果。

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