声明软件包可见性需求

在创建应用时，请务必考虑您的应用打算访问的已在设备上安装的一组其他应用。如果您的应用以 Android 11（API 级别 30）或更高版本为目标平台，在默认情况下，系统会自动让部分应用对您的应用可见，但会过滤掉其他应用。本指南将介绍如何让上述其他应用对您的应用可见。

如果您的应用以 Android 11 或更高版本为目标平台，并且需要与应用（自动可见的应用除外）交互，请在您应用的清单文件中添加 <queries> 元素。在 <queries> 元素中，按软件包名称、按 intent 签名或按 Provider 授权指定其他应用，如以下部分所述。

特定软件包名称

如果您知道要查询或与之交互的一组特定应用（例如，与您的应用集成的应用或您使用其服务的应用），请将其软件包名称添加到 <queries> 元素内的一组 <package> 元素中：

<manifest package="com.example.game">
    <queries>
        <package android:name="com.example.store" />
        <package android:name="com.example.services" />
    </queries>
    ...
</manifest>

在库中与托管应用通信

如果您要开发 Android 库，您可以通过在 AAR 清单文件中添加 <queries> 元素来声明软件包可见性需求。此 <queries> 元素与应用可在自己的清单中声明的元素功能相同。

如果您的库涉及与“托管”应用通信（例如使用绑定服务），请添加用于指定托管应用的软件包名称的 <package> 元素：

<!-- Place inside the <queries> element. -->
<package android:name=PACKAGE_NAME />

通过添加此声明，您可以检查是否已安装托管应用并与之交互，例如通过调用 bindService() 来完成。此交互的结果是，使用您的库的调用方应用会自动对托管应用可见。

与 intent 过滤器签名匹配的软件包

您的应用可能需要查询一组具有特定用途的应用或与之交互，但您可能不知道要添加的具体软件包名称。在这种情况下，您可以在 <queries> 元素中列出 intent 过滤器签名。然后，您的应用就可以发现具有匹配的 <intent-filter> 元素的应用。

以下示例允许您的应用看到支持 JPEG 图片共享功能的已安装应用：

<manifest package="com.example.game">
    <queries>
        <intent>
            <action android:name="android.intent.action.SEND" />
            <data android:mimeType="image/jpeg" />
        </intent>
    </queries>
    ...
</manifest>

<intent> 元素有一些限制：

您必须只添加一个 <action> 元素。
您不能在 <data> 元素中使用 path、pathPrefix、pathPattern 或 port 属性。系统的行为就像您将每个属性的值都设为通用通配符 (*) 一样。
您不能使用 <data> 元素的 mimeGroup 属性。
在单个 <intent> 元素的 <data> 元素中，您可以使用以下每个属性最多一次：
- mimeType
- scheme
- host
您可以在多个 <data> 元素之间分配这些属性，也可以在单个 <data> 元素中使用这些属性。

<intent> 元素支持通用通配符 (*) 作为一些属性的值：

<action> 元素的 name 属性。
<data> 元素的 mimeType 属性的子类型 (image/*)。
<data> 元素的 mimeType 属性的类型和子类型 (*/*)。
<data> 元素的 scheme 属性。
<data> 元素的 host 属性。

除非前面列表中另有说明，否则系统不支持混合使用文本和通配符，如 prefix*。

使用特定授权的软件包

如果您需要查询 Content Provider 但不知道具体的软件包名称，您可以在 <provider> 元素中声明该提供程序授权，如以下代码段所示：

<manifest package="com.example.suite.enterprise">
    <queries>
        <provider android:authorities="com.example.settings.files" />
    </queries>
    ...
</manifest>

您可以在单个 <queries> 元素中声明所有提供程序授权。此格式取决于您声明提供程序授权的数量：

单个 <provider> 元素: 在元素中，声明以英文分号分隔的授权列表。
多个 <provider> 元素: 在每个元素中，声明单项授权或以英文分号分隔的授权列表。

所有应用（不推荐）

在极少数情况下，您的应用可能需要查询设备上的所有已安装应用或与之交互，不管这些应用包含哪些组件。为了允许您的应用看到其他所有已安装应用，系统会提供 QUERY_ALL_PACKAGES 权限。

下面列出了适合添加 QUERY_ALL_PACKAGES 权限的用例的一些示例：

无障碍应用
浏览器
设备管理应用
安全应用
防病毒应用

不过，在绝大多数情况下，可以通过以下方式实现您应用的用例：与一组自动可见的应用交互，并在您的清单文件中声明您的应用需要访问的其他应用。为了尊重用户隐私，您的应用应请求应用正常工作所需的最小软件包可见性。

这项来自 Google Play 的政策更新为需要 QUERY_ALL_PACKAGES 权限的应用提供了相关准则。

了解自动可见的软件包

实现常见用例