做Android开发这几年,我接到过好几个类似的咨询:“从微信点开文件,为什么列表里没有我的App?”“我按照网上的教程配了intent-filter,微信里确实能弹出我的App了,但一点就闪退,错误日志是FileNotFoundException,怎么解决?”这些问题指向同一个能力:在Android平台上,让微信、QQ这类聊天软件点击文件时,能在“其他应用打开”列表里出现你的App,并且由你的App拿到这份文件的真实可读数据。
这个功能的本质是跨应用文件分享,核心链路包括Intent-filter匹配、content:// URI解析、临时读写权限处理等几个环节,并不复杂,但细节非常多。微信、QQ各自对文件URI的处理方式还不一样,企业微信又和微信不一样。如果只照着网上零散的片段代码抄,很容易在“列表出来了但文件打不开”“拿到了路径却读不到数据”这些坑里反复横跳。
这篇文章我就按自己的实际项目经验,从Android系统的匹配机制讲起,把manifest配置、Activity接收、FileProvider权限、content://地址解析这些关键步骤完整过一遍,最后把我踩过的高频坑整理成排查表。开发新手可以按步骤直接“抄作业”,有经验的朋友可以重点看看第三部分的兼容性处理和第五部分的排查思路,这些是常规文档里不会写的。
1. 先搞清楚“其他应用打开”列表是怎么来的
1.1 系统靠intent-filter做应用匹配
很多新手容易陷入一个误区:以为微信内部维护了一份“支持打开文件的App列表”,谁想进来得去微信申请。其实不是。微信点到文件后,它发出的只是一个标准的Android Intent,叫ACTION_VIEW,附带一个指向该文件的content:// Uri。到底谁能收到这个Intent,完全由Android系统根据所有App在AndroidManifest.xml里声明的intent-filter来做匹配。
你可以把intent-filter理解成一份“我能处理什么”的简历。系统会拿着微信发出来的Intent,逐个App地比对简历里的action、category、data(scheme和mimeType),全都能对上的App才会出现在弹窗列表里。所以只要你的App声明了正确的intent-filter,微信、QQ根本不用做任何配置,你的App自然就会被系统拉进“其他应用打开”的候选列表。想验证这一点也很简单:随便找一台Android手机,去系统文件管理器里点开一个PDF文件,弹出来的处理列表里也会出现你的App——因为文件管理器发出的同样是ACTION_VIEW。
1.2 微信和QQ发出的是什么Intent
微信、QQ在用户点击文件并选择“其他应用打开”时,发出的Intent大致是这样:
Intent(Intent.ACTION_VIEW).apply {
setDataAndType(uri, mimeType)
addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
}
action是ACTION_VIEW,data里装着文件Uri,type是文件的MIME类型。要注意的是,这里用的uri通常是它们自己FileProvider暴露出来的content://地址,而不是file:///storage/...这种原始路径。
还有另外一个场景:如果是长按文件选择“发送到”或“分享”,这时候发出的是ACTION_SEND,文件地址放在Intent的EXTRA_STREAM里。很多App两种都要支持,但在Android 7.0以后,ACTION_SEND拿到的也是content:// Uri,处理思路和ACTION_VIEW完全一样。下面的内容我以ACTION_VIEW为主,最后会提一句ACTION_SEND的差异,因为你一旦把intent-filter配置好,这两种入口都会找上你。
2. 清单配置:把自己暴露到打开列表
2.1 核心intent-filter写法
打开AndroidManifest.xml,在你希望接收文件的Activity节点下加一段intent-filter。最通用的写法是接收所有类型的文件:
<activity
android:name=".FileReceiveActivity"
android:exported="true"
android:launchMode="singleTask">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="content" />
<data android:scheme="file" />
<data android:mimeType="*/*" />
</intent-filter>
</activity>
逐个说下这里的关键点。
android:exported="true" :这是Android 12(API 31)之后必须显式设置的属性,因为当前Activity会被其他应用的外部Intent唤起,不设为true系统直接不让你启动。如果项目minSdkVersion在31以下,不写会报错但不崩溃;编译targetSdkVersion是31或更高时,不声明exported会直接编译失败。
launchMode="singleTask" :建议加上。如果用户正在使用你的App,然后从微信点文件唤起你的Activity,不加singleTask可能会导致栈里堆积多个Activity实例,体验很怪。加上之后系统会复用已有实例并通过onNewIntent把新Intent传进来,后面我会专门写这个回调。
BROWSABLE category:这个类别通常是为了让网页里的链接也能拉起你的App,但在文件接收场景里加上它也影响不大。有一点要注意:有些国产ROM在匹配Intent时对category比较严格,DEFAULT是必须的,BROWSABLE则可以兼容一些特殊的跳转场景。
scheme 这块,很多教程只写 content ,但少数老版本Android和部分第三方文件管理器(比如ES文件浏览器、某些ROM自带的文件App)发出来的还是 file:// 协议,所以建议content和file两个scheme都声明上。当然,真正处理数据的时候,遇到file://协议要另做兼容,这个我放到第5部分讲。
2743



被折叠的 条评论
为什么被折叠?



