Android Intent过滤器详解与深度链接实践

Android Intent过滤器详解与深度链接实践

发布时间：2026/9/12 11:24:46
Android Intent过滤器详解与深度链接实践 1. Intent过滤器基础概念解析在Android开发中Intent过滤器Intent Filter是组件与系统之间的通信协议它定义了组件能够响应哪些类型的隐式Intent。每个过滤器都包含三个核心要素action、data和category它们共同构成了组件的能力声明书。1.1 过滤器的工作原理当应用组件Activity、Service或BroadcastReceiver在AndroidManifest.xml中声明 时相当于向系统注册了它的技能清单。例如一个图片编辑Activity可能会声明它能处理查看和编辑图片的Intent。系统维护着一个所有已安装应用的过滤器数据库。当隐式Intent出现时系统会进行如下匹配流程收集所有声明了匹配action的组件筛选出data类型MIME/URI匹配的组件确保Intent中包含过滤器声明的所有category如果多个组件匹配成功则显示选择器对话框让用户选择关键提示Android 12要求必须为使用 的组件显式设置android:exported属性否则应用将无法安装。这是重要的安全改进。1.2 过滤器的典型应用场景深度链接通过特定URL直接打开应用内特定页面intent-filter data android:schemehttps android:hostexample.com android:pathPrefix/product/ action android:nameandroid.intent.action.VIEW/ category android:nameandroid.intent.category.DEFAULT/ category android:nameandroid.intent.category.BROWSABLE/ /intent-filter分享功能让应用出现在系统分享菜单中intent-filter action android:nameandroid.intent.action.SEND/ category android:nameandroid.intent.category.DEFAULT/ data android:mimeTypeimage/*/ /intent-filter应用入口定义应用启动图标对应的主Activityintent-filter action android:nameandroid.intent.action.MAIN/ category android:nameandroid.intent.category.LAUNCHER/ /intent-filter2. 过滤器匹配规则深度剖析2.1 Action匹配机制Action代表Intent要执行的操作如VIEW、SEND等。匹配规则要点Intent必须指定action不能为null过滤器可以声明多个actionOR关系Intent的action必须与过滤器声明的某个action完全匹配特殊action如ACTION_MAIN通常不携带数据常见系统action示例Intent.ACTION_VIEW // 查看内容 Intent.ACTION_SEND // 发送/分享内容 Intent.ACTION_DIAL // 拨打电话 Intent.ACTION_WEB_SEARCH // 网页搜索2.2 Data匹配详解Data匹配是过滤器最复杂的部分涉及URI结构和MIME类型URI结构分解scheme://host:port/path例如content://com.example.provider/images/123匹配规则矩阵Intent携带数据过滤器声明匹配结果只有URI只有MIME不匹配只有MIME只有URI不匹配URIMIME只有MIME需MIME匹配URI(content:)只有MIME自动匹配通配符使用技巧!-- 匹配所有图片类型 -- data android:mimeTypeimage/*/ !-- 匹配任意子路径 -- data android:pathPattern.*\\.jpg/2.3 Category匹配要点Intent可以没有category但如果有则必须全部匹配隐式Intent必须包含DEFAULT category特殊category的作用LAUNCHER显示在启动器中BROWSABLE允许从浏览器打开HOME作为桌面应用候选常见问题忘记声明DEFAULT category导致隐式Intent无法匹配。解决方法intent-filter ... category android:nameandroid.intent.category.DEFAULT/ /intent-filter3. 高级匹配策略与优化3.1 多过滤器配置技巧单个组件可以声明多个 每个过滤器独立匹配。典型应用场景同时处理单张和多张图片分享intent-filter action android:nameandroid.intent.action.SEND/ data android:mimeTypeimage/*/ /intent-filter intent-filter action android:nameandroid.intent.action.SEND_MULTIPLE/ data android:mimeTypeimage/*/ /intent-filter支持多种文件类型intent-filter action android:nameandroid.intent.action.VIEW/ data android:mimeTypeapplication/pdf/ data android:mimeTypeapplication/msword/ /intent-filter3.2 匹配优先级控制当多个组件匹配同一Intent时系统按以下顺序确定优先级优先选择声明了更具体data的组件选择filter数量更少的组件更专注按安装顺序排列后安装的优先开发者可以通过priority属性影响排序intent-filter android:priority100 ... /intent-filter注意priority只对广播接收器有效Activity和Service中会被忽略。3.3 Android 12匹配强化从Android 12开始系统加强了Intent过滤的安全性必须显式声明android:exported嵌套Intent需要特别处理见下文包可见性限制更严格适配建议// 检查Intent是否能被处理 fun isIntentResolvable(intent: Intent): Boolean { return intent.resolveActivity(packageManager) ! null } // 安全的Intent启动方式 val safeIntent Intent().apply { setPackage(com.example.targetapp) action com.example.action.CUSTOM } startActivity(safeIntent)4. 常见问题排查指南4.1 匹配失败典型场景问题现象Intent无法启动目标Activity检查清单文件是否正确定义了确认Intent构造时设置了正确的action、data和category使用adb命令测试adb shell am start -a android.intent.action.VIEW -d https://example.com问题现象分享菜单中不显示应用确认至少声明了DEFAULT category检查MIME类型是否与分享内容匹配验证组件exported属性设置正确4.2 安全异常处理案例1Android 12上Service启动失败// 错误方式 - 隐式Intent启动Service Intent serviceIntent new Intent(com.example.CUSTOM_ACTION); startService(serviceIntent); // 触发SecurityException // 正确方式 - 显式Intent Intent serviceIntent new Intent(this, MyService.class); startService(serviceIntent);案例2嵌套Intent安全处理// 不安全的方式 val nestedIntent intent.getParcelableExtraIntent(extra_intent) nestedIntent?.let { startActivity(it) } // 可能被利用 // 安全替代方案 val pendingIntent PendingIntent.getActivity( this, REQUEST_CODE, Intent(this, SafeActivity::class.java), PendingIntent.FLAG_IMMUTABLE )4.3 性能优化建议避免过度通用的过滤器声明!-- 不推荐 -- intent-filter action android:nameandroid.intent.action.VIEW/ data android:schemehttp/ data android:schemehttps/ /intent-filter !-- 推荐 -- intent-filter action android:nameandroid.intent.action.VIEW/ data android:schemehttps android:hostexample.com/ /intent-filter使用PackageManager预查询PackageManager pm getPackageManager(); ListResolveInfo activities pm.queryIntentActivities(intent, 0); if (!activities.isEmpty()) { // 安全启动 }考虑使用Deep Link Dispatch库简化处理implementation com.airbnb:deeplinkdispatch:5.4.05. 实战构建健壮的深度链接系统5.1 配置多层级深度链接场景电商应用需要处理以下链接格式商品页https://shop.com/products/{id}分类页https://shop.com/categories/{name}搜索页https://shop.com/search?q{query}实现方案activity android:name.ProductActivity android:exportedtrue intent-filter action android:nameandroid.intent.action.VIEW/ category android:nameandroid.intent.category.DEFAULT/ category android:nameandroid.intent.category.BROWSABLE/ data android:schemehttps android:hostshop.com android:pathPrefix/products// /intent-filter /activity activity android:name.CategoryActivity android:exportedtrue intent-filter action android:nameandroid.intent.action.VIEW/ category android:nameandroid.intent.category.DEFAULT/ data android:schemehttps android:hostshop.com android:pathPrefix/categories// /intent-filter /activity5.2 动态参数处理技巧在目标Activity中解析参数override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) intent.data?.let { uri - when { uri.path?.startsWith(/products/) true - { val productId uri.lastPathSegment showProductDetail(productId) } uri.path?.startsWith(/categories/) true - { val categoryName uri.lastPathSegment showCategory(categoryName) } uri.path /search - { val query uri.getQueryParameter(q) performSearch(query) } } } }5.3 验证与测试方案Android App Links验证adb shell pm verify-app-links --package com.example.app手动测试深度链接adb shell am start -W -a android.intent.action.VIEW -d https://shop.com/products/123 com.example.app自动化测试示例Test public void testProductDeepLink() { Intent intent new Intent(Intent.ACTION_VIEW) .setData(Uri.parse(https://shop.com/products/123)); ResolveInfo resolveInfo getInstrumentation() .getTargetContext() .getPackageManager() .resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY); assertNotNull(resolveInfo); assertEquals(ProductActivity, resolveInfo.activityInfo.name); }6. 特殊场景处理方案6.1 文件类型关联处理让应用成为特定文件类型的默认打开方式intent-filter android:labelstring/pdf_viewer action android:nameandroid.intent.action.VIEW/ category android:nameandroid.intent.category.DEFAULT/ data android:mimeTypeapplication/pdf/ data android:schemefile/ data android:schemecontent/ data android:host*/ data android:pathPattern.*\\.pdf/ /intent-filter处理接收到的文件val uri intent.data when { uri?.scheme content - { contentResolver.openInputStream(uri)?.use { stream - // 处理文件流 } } uri?.scheme file - { File(uri.path).inputStream().use { stream - // 处理文件 } } }6.2 自定义协议处理注册自定义schemeintent-filter action android:nameandroid.intent.action.VIEW/ category android:nameandroid.intent.category.DEFAULT/ data android:schememyapp android:hostfeature/ /intent-filter解析自定义URL参数// myapp://feature/param1/value1/param2/value2 val pathSegments intent.data?.pathSegments ?: emptyList() val params pathSegments.chunked(2).associate { it[0] to it[1] }6.3 多应用协作场景使用Intent传递复杂数据// 发送方 val intent Intent(Intent.ACTION_SEND).apply { type text/plain putExtra(Intent.EXTRA_TEXT, 分享内容) putExtra(custom_data, ParcelableObject()) flags Intent.FLAG_GRANT_READ_URI_PERMISSION setPackage(com.target.app) // 指定目标包名 } startActivity(intent) // 接收方 val text intent.getStringExtra(Intent.EXTRA_TEXT) val customData intent.getParcelableExtraParcelableObject(custom_data)重要安全提示跨应用传递数据时对于文件URI应该使用FileProvider并添加FLAG_GRANT_READ_URI_PERMISSION权限标志。