文章目录安卓应用开发中 Android 11 软件包可见性问题详解一、问题现象二、产生原因2.1 软件包可见性策略2.2 受影响的 API2.3 为什么引入此限制三、解决方案3.1 使用 queries 声明需要访问的应用3.1.1 按包名声明3.1.2 按 Intent 过滤器声明3.1.3 混合使用3.2 使用显式 Intent 启动或绑定服务3.3 获取通用的 Intent 处理应用3.4 临时处理请求 QUERY_ALL_PACKAGES 权限不推荐3.5 适配旧版本和未来的兼容性3.6 测试验证四、常见业务场景的适配示例4.1 分享功能Share Intent4.2 检测微信、支付宝是否安装用于支付4.3 打开第三方地图高德、百度4.4 自定义 Scheme 调起第三方 App4.5 获取已安装浏览器列表五、检测与调试5.1 日志分析5.2 测试工具5.3 使用 getInstalledPackages 调试六、最佳实践七、总结安卓应用开发中 Android 11 软件包可见性问题详解从 Android 11API 30开始系统对应用的软件包可见性Package Visibility施加了严格限制。以往应用可以通过PackageManager.getInstalledPackages()或queryIntentActivities()等方法轻松获取设备上安装的所有应用列表。但在 Android 11 上默认情况下应用只能看到自身以及一些基础系统组件无法随意查询其他应用。这是为了保护用户隐私防止应用滥用包信息进行追踪或分析。如果开发者的应用需要与其他应用交互如分享、跳转、检测应用是否安装就必须在AndroidManifest.xml中显式声明queries元素否则相关 API 返回的结果将为空或受限。本文将深入分析软件包可见性限制的成因并提供完整的适配方案和最佳实践。一、问题现象调用PackageManager.getInstalledApplications(0)或getInstalledPackages(0)返回的列表只包含自身应用和少数系统应用。queryIntentActivities()无法找到可处理特定 Intent 的其他应用例如分享、打开文件。resolveActivity()返回null即使设备上存在能处理该 Intent 的应用。getPackageInfo(packageName, 0)对于非系统、非自身应用抛出NameNotFoundException。在使用第三方 SDK如分享 SDK、支付 SDK时无法正常检测目标应用是否安装。在 Android 10 及以下设备上正常的功能在 Android 11 上失效。二、产生原因2.1 软件包可见性策略Android 11 引入了PackageManager的新行为默认情况下应用只能“看见”与自身交互密切相关的包发起查询的应用自身。系统核心组件如系统设置、启动器、系统输入法等。与应用具有相同签名的其他应用。已经与应用发生过交互的应用例如被应用通过显式 Intent 启动、或已经请求过权限。对于其他未指定的应用PackageManager会过滤掉它们导致查询结果不完整。2.2 受影响的 APIgetInstalledPackages()getInstalledApplications()getPackageInfo()queryIntentActivities()queryIntentServices()queryBroadcastReceivers()resolveActivity()resolveService()2.3 为什么引入此限制许多应用在后台收集已安装软件包列表用于推送个性化广告、竞争分析或指纹追踪。这严重侵犯用户隐私。因此Google 强制要求应用声明需要交互的包名或 Intent 过滤器才能访问相关信息。三、解决方案3.1 使用queries声明需要访问的应用通过在AndroidManifest.xml中添加queries元素可以指定应用想要查询哪些包或基于 Intent 规则匹配的应用。3.1.1 按包名声明如果知道需要访问的具体应用包名如微信、支付宝可以直接列出。manifestpackagecom.example.appqueriespackageandroid:namecom.tencent.mm/!-- 微信 --packageandroid:namecom.eg.android.AlipayGphone/!-- 支付宝 --/queries/manifest3.1.2 按 Intent 过滤器声明如果不知道具体包名但知道期望的 Intent action 和 category可以声明 Intent 签名系统会匹配所有能处理该 Intent 的应用。queriesintentactionandroid:nameandroid.intent.action.VIEW/dataandroid:schemehttps//intentintentactionandroid:nameandroid.intent.action.SEND/dataandroid:mimeTypeimage/*//intent/queries3.1.3 混合使用可以同时使用package和intent。3.2 使用显式 Intent 启动或绑定服务如果你只是要启动另一个应用或获取其组件信息可以使用显式 Intent此时不需要额外的queries声明。例如IntentintentnewIntent();intent.setComponent(newComponentName(com.example.target,com.example.target.MainActivity));if(intent.resolveActivity(getPackageManager())!null){startActivity(intent);}但resolveActivity仍需要可见性支持。如果目标包未在queries中声明resolveActivity可能返回null。因此建议仍然添加queries。3.3 获取通用的 Intent 处理应用如果你只需要知道是否有应用能处理某个 Intent例如打开 HTTP 链接无需知道具体包名可以使用PackageManager.queryIntentActivities但设置MATCH_ALL标志实际上没有这样做。更好的做法是直接使用Intent.createChooser系统会弹出选择器无需预先查询列表。3.4 临时处理请求QUERY_ALL_PACKAGES权限不推荐从 Android 11 起Google 引入了QUERY_ALL_PACKAGES权限允许应用查询所有已安装的软件包。但这属于正常权限normal需要声明即可获得但 Google Play 对使用该权限的应用有严格审核除非应用核心功能确实需要全包可见如杀毒软件、文件管理器。滥用会导致下架。uses-permissionandroid:nameandroid.permission.QUERY_ALL_PACKAGES/警告此权限非常敏感不建议普通应用添加。务必确保符合 Google Play 政策。3.5 适配旧版本和未来的兼容性对于targetSdkVersion 30的应用在 Android 11 设备上仍会应用新的可见性规则这是系统行为与 targetSdk 无关。因此即使你的应用尚未升级 targetSdkVersion也必须适配queries。为了兼容 Android 10 及以下可以在代码中判断版本但queries元素在低版本上会被忽略所以直接添加即可。3.6 测试验证在适配后使用以下代码验证可见性PackageManagerpmgetPackageManager();try{PackageInfoinfopm.getPackageInfo(com.tencent.mm,0);Log.d(Test,WeChat installed: info.versionName);}catch(PackageManager.NameNotFoundExceptione){Log.d(Test,WeChat not visible);}如果没有在queries中声明微信上述代码会抛出NameNotFoundException。四、常见业务场景的适配示例4.1 分享功能Share Intent需要知道哪些应用可以接收文本/图片分享。声明 Intent 过滤器queriesintentactionandroid:nameandroid.intent.action.SEND/dataandroid:mimeTypetext/plain//intentintentactionandroid:nameandroid.intent.action.SEND/dataandroid:mimeTypeimage/*//intent/queries4.2 检测微信、支付宝是否安装用于支付直接添加包名queriespackageandroid:namecom.tencent.mm/packageandroid:namecom.eg.android.AlipayGphone//queries4.3 打开第三方地图高德、百度如果需要通过 Intent 调起地图并导航声明 Intent 模式queriesintentactionandroid:nameandroid.intent.action.VIEW/dataandroid:schemegeo//intentintentactionandroid:nameandroid.intent.action.VIEW/dataandroid:schemebaidumap//intent/queries4.4 自定义 Scheme 调起第三方 App如果希望调起特定的第三方 App例如myapp://同样需要声明 Intentqueriesintentactionandroid:nameandroid.intent.action.VIEW/dataandroid:schememyapp//intent/queries4.5 获取已安装浏览器列表声明能处理 HTTP/HTTPS 的 Intentqueriesintentactionandroid:nameandroid.intent.action.VIEW/dataandroid:schemehttp//intentintentactionandroid:nameandroid.intent.action.VIEW/dataandroid:schemehttps//intent/queries五、检测与调试5.1 日志分析如果resolveActivity返回null但实际存在应用检查 logcat 是否输出类似Permission Denial: queryIntentActivities from ... requires android.permission.QUERY_ALL_PACKAGES。使用adb shell dumpsys package可以查看应用的实际可见性配置。5.2 测试工具Android Studio 的App Inspection中的Package Visibility工具需 Android Studio 4.2可以模拟不同可见性配置。使用PackageManager的isPackageQueryEnabled方法API 30可以检查是否可查询某包。5.3 使用getInstalledPackages调试临时在开发版本中添加QUERY_ALL_PACKAGES权限观察应用需要访问哪些包然后再迁移到queries列表。六、最佳实践不要使用QUERY_ALL_PACKAGES除非你的核心功能确实需要例如应用市场、防火墙。否则会被 Google Play 拒绝。明确声明所需包名或 Intent只申请最小集合。使用 Intent 方式优于包名如果你的应用只需要打开某个类型的内容如 HTTPS 链接声明intent比列举所有可能支持的包更灵活。兼容旧版本在代码中使用try-catch处理NameNotFoundException并准备降级逻辑。动态适配如果目标包不满足可见性可引导用户主动打开一次例如通过显式 Intent 启动之后系统会将其加入可见列表。测试多版本在 Android 10API 29和 Android 11API 30上分别验证。第三方 SDK 适配如果你使用第三方 SDK如分享、支付检查它们是否已提供适配文档可能需要你在主项目中添加相应的queries。七、总结Android 11 的软件包可见性限制是隐私保护的重要措施。开发者必须放弃以往随意获取所有已安装应用列表的做法转而通过queries显式声明需要交互的包或 Intent。这一改变对于大多数应用来说并不复杂只需在AndroidManifest.xml中添加少量配置。遵循“最小必要”原则只声明真正需要的包或 Intent既能满足功能又能顺利通过 Google Play 审核。如果你的应用确实需要全包可见性请认真评估并准备充分的理由否则不建议申请QUERY_ALL_PACKAGES权限。适配后你的应用将更符合用户隐私安全期望也更健壮。