声明包可见性需求

在创建应用时，务必考虑设备上其他需要与您的应用交互的应用。如果您的应用面向 Android 11（API 级别 30）或更高版本，则系统会 自动使某些应用对您的应用可见，但默认情况下会过滤掉其他应用。本指南介绍如何使这些其他应用对您的应用可见。

如果您的应用面向 Android 11 或更高版本，并且需要与自动可见的应用以外的其他应用交互，请在应用的清单文件中添加 <queries> 元素。在 <queries> 元素中，指定其他应用 按包名、按意图签名 或 按提供程序权限，如下节所述。

特定包名

如果您知道要查询或与之交互的特定应用，例如与您的应用集成的应用或您使用的服务的应用，请将其包名包含在一组 <package> 元素中，这些元素位于 <queries> 元素内

<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()。使用您的库的调用应用 自动变得可见 到主机应用，这是这种交互的结果。

与意图过滤器签名匹配的包

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

以下代码示例显示了一个 <intent> 元素，该元素将允许应用查看支持 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*。

使用特定权限的包

如果您需要查询 内容提供程序 但不知道特定的包名，则可以在 <provider> 元素中声明提供程序权限，如下面的代码片段所示

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

您可以在单个 <queries> 元素中声明提供程序权限。在 <queries> 元素内，您可以声明一个或多个 <provider> 元素。一个 <provider> 元素可以包含单个提供程序权限或以分号分隔的提供程序权限列表。

所有应用（不推荐）

在极少数情况下，您的应用可能需要查询或与设备上安装的所有应用进行交互，而与它们包含的组件无关。为了允许您的应用查看所有其他已安装的应用，系统提供了 QUERY_ALL_PACKAGES 权限。

以下是一些包含 QUERY_ALL_PACKAGES 权限的用例示例

  • 辅助功能应用
  • 浏览器
  • 设备管理应用
  • 安全应用
  • 防病毒应用

但是，通常可以通过与自动可见的应用集进行交互，并在清单文件中声明您的应用需要访问的其他应用来满足您的应用的用例。为了尊重用户隐私，您的应用应请求最少的包可见性，以确保您的应用能够正常工作。

此来自 Google Play 的策略更新提供了需要 QUERY_ALL_PACKAGES 权限的应用的指南。

上一页
了解哪些包是自动可见的
下一页
满足常见用例