Google Play 会利用应用清单中声明的 元素，从不符合应用硬件和软件功能要求的设备上过滤该应用。

通过指定应用所要求的功能，您可以让 Google Play 仅向设备符合应用功能要求的用户（而非所有用户）提供您的应用。

如需了解有关 Google Play 如何根据功能进行过滤的重要信息，请阅读 Google Play 和根据功能进行过滤部分。

声明应用使用的一项硬件或软件功能。

声明的用途是向任何外部实体表明应用所依赖的硬件和软件功能集。借助该元素提供的 required 属性，您可以指定应用是否需要声明的功能并且没有该功能便无法正常工作，或者使用该功能只是一种优先选择，没有它仍然可以正常工作。

由于功能支持可能因 Android 设备而异，因此 元素发挥的重要作用是，能够让应用描述其使用的随设备而变化的功能。

应用所声明的可用功能集对应 Android PackageManager 提供的功能常量集。本文中的功能参考资料部分已列出这些功能常量。

您必须在单独的 元素中指定每个功能，因此如果您的应用需要多个功能，则需声明多个 元素。例如，要求设备同时具有蓝牙和相机功能的应用需声明以下两个元素：

一般来说，务必要为应用需要的所有功能声明 元素。

声明的 元素仅供参考，这意味着在安装应用前，Android 系统本身不会检查设备是否提供相应的功能支持。

不过，其他服务（如 Google Play）和应用可能会在处理您的应用或与其交互的过程中检查它的 声明。因此，声明您的应用使用的所有功能非常重要。

对于某些功能，您可能可以通过特定属性来定义功能的版本，例如所使用的 Open GL 版本（使用 glEsVersion 声明）。设备具有或不具有的其他功能（如相机）均使用 name 属性进行声明。

尽管只有运行 API 级别 4 或更高版本系统的设备才能激活 元素，但请为所有应用加入这些元素（即使 minSdkVersion 为 3 或更低）。运行较低版本平台的设备会忽略该元素。

注意：声明功能时，切记您还必须视情况请求权限。例如，您需要请求 CAMERA 权限，才能让您的应用访问 Camera API。请求权限可允许应用访问相应的硬件和软件。声明应用使用的功能有助于确保设备兼容性。

android:required 的默认值为 "true"。

应用应在其清单中至多指定一个 android:glEsVersion 属性。如果指定多个该属性，则系统会使用数值最高的 android:glEsVersion，并忽略任何其他值。

如果应用不指定 android:glEsVersion 属性，则系统假定应用只需要 OpenGL ES 1.0，即所有 Android 设备都支持的版本。

应用可以假定：如果平台支持给定的 OpenGL ES 版本，则其同样支持所有数值更低的 OpenGL ES 版本。因此，对于同时需要 OpenGL ES 1.0 和 OpenGL ES 2.0 的应用，应指定其需要 OpenGL ES 2.0。

如果应用能够使用任一种 OpenGL ES 版本，则只应指定其所需数值最低的 OpenGL ES 版本。它可以在运行时检查是否有更高版本的 OpenGL ES 可用。

如需了解有关如何使用 OpenGL ES（包括如何在运行时检查支持的 OpenGL ES 版本）的详细信息，请参阅 OpenGL ES API 指南。

Google Play 会过滤用户可见的应用，以便用户只能看到和下载与其设备兼容的应用。它过滤应用的方法之一是按功能兼容性进行过滤。

为确定应用与给定用户设备的功能兼容性，Google Play 会比较以下两个方面的功能：

为了准确比较功能，Android 软件包管理器会提供共享的功能常量集，应用和设备均可使用该集来声明功能要求和支持。本文的功能参考资料部分以及 PackageManager 的类文档中已列出这些可用的功能常量。

当用户启动 Google Play 时，应用会通过调用 getSystemAvailableFeatures()，在软件包管理器中查询设备中提供的功能列表。然后，在为用户建立会话时，Google 商店应用会将功能列表向上传递给 Google Play。

每次向 Google Play 管理中心上传应用时，Google Play 都会扫描应用的清单文件。它会寻找 元素并在某些情况下结合其他元素（例如 和 元素）对其进行评估。在建立应用所需的功能集之后，它会在内部将该列表存储为与应用 APK 和应用版本关联的元数据。

当用户使用 Google Play 应用搜索或浏览应用时，该服务会将各应用所需功能与用户设备上提供的功能进行比较。如果设备提供应用所需的全部功能，Google Play 便会向用户显示该应用，并视情况下载它。

如果设备不支持任何所需功能，则 Google Play 会过滤该应用，令其对用户不可见，也无法供用户下载。

由于您在 元素中声明的功能会直接影响 Google Play 对过滤您应用的方式，因此您必须了解 Google Play 如何评估应用的清单以及如何建立所需功能集。以下几节做出了更详细的介绍。

明确声明的功能是指您的应用在 元素中声明的功能。如果您编译的应用面向 API 级别 5 或更高版本，功能声明可包含 android:required=["true" | "false"] 属性。

您可通过此属性指定应用是必须使用该功能，否则无法正常工作（设置为 "true" 时）；还是在该功能可用时使用它，但设计为在没有该功能的情况下也能正常工作（设置为 "false" 时）。

Google Play 按以下方式处理明确声明的功能：

一般而言，如果您的应用设计为在 Android 1.6 及更低版本上运行，则 API 中不提供 android:required 属性，Google Play 会假定所有 声明均为所需功能。

注意：通过明确声明某个功能并加入 android:required="false" 属性，您可以在 Google Play 上有效停用所有针对指定功能的过滤。

隐含功能是指应用正常工作所需，但未在清单文件的 元素中进行声明的功能。严格地讲，最好让每个应用都务必声明其使用或需要的所有功能，对于未声明应用使用的某项功能的情况，可视为错误。

不过，作为向用户和开发者提供的一种保障措施，Google Play 会寻找每个应用中的隐含功能并为这些功能设置过滤条件，就像其为明确声明功能所做的那样。

应用可能需要某个功能，但由于一些原因而不声明它，例如以下原因：

为将这些情况考虑在内，Google Play 会尝试检查清单文件中声明的其他元素（具体而言，即 元素），从而发现应用的隐含功能要求。

如果应用请求硬件相关权限，Google Play 会假定该应用使用基础硬件功能，因此即使没有相应的 声明，也会需要这些功能。对于此类权限，Google Play 会向其为应用存储的元数据中添加这些基础的硬件功能，并为这类功能设置过滤。

例如，如果应用请求 CAMERA 权限，则 Google Play 会假定该应用需要使用后置（面向外的）摄像头，即使该应用没有针对 android.hardware.camera 声明 元素。因此，Google Play 会过滤掉没有后置摄像头的设备。

如果您不想让 Google Play 根据特定隐含功能进行过滤，请在 元素中显式声明该功能并加入 android:required="false" 属性。例如，如需停用 CAMERA 权限隐含的过滤，请声明以下功能：

注意：您在 元素中请求的权限可能会直接影响 Google Play 对您应用的过滤方式。隐含功能要求的权限部分列出了隐含功能要求并因此触发过滤的全部权限。

在确定针对蓝牙的过滤时，Google Play 应用的规则与上例所述的规则略有差异。

如果某个应用在 元素中声明蓝牙权限，但未在 元素中明确声明蓝牙功能，Google Play 会根据 元素中指定的内容，检查作为应用设计运行目标的 Android 平台版本。

如下表所示，只有当应用声明其最低或目标平台为 Android 2.0（API 级别 5）或更高版本时，Google Play 才会启用针对蓝牙功能的过滤。但请注意，当应用在 元素中明确声明蓝牙功能时，Google Play 会应用正常的过滤规则。

表 1. Google Play 如何为已请求蓝牙权限却未在 元素中声明蓝牙功能的应用确定蓝牙功能要求。

以下示例根据 Google Play 对蓝牙功能的处理方式说明不同的过滤效果。

您可以使用 Android SDK 中包含的 aapt 工具确定 Google Play 如何根据应用声明的功能和权限对其进行过滤。如需执行该操作，请使用 dump badging 命令运行 aapt。这会使 aapt 解析应用的清单，并应用与 Google Play 所用相同的规则，从而确定应用需要的功能。

如要使用该工具，请按以下步骤操作：

注意：您必须使用为最新可用 Build-Tools 组件提供的 aapt 版本。如果您没有最新的 Build-Tools 组件，请使用 Android SDK 管理器下载该组件。

以下是针对上文第二个蓝牙示例的命令输出示例：

下文提供有关硬件功能、软件功能以及隐含具体功能要求的权限集的参考信息。

此部分介绍最新平台版本所支持的硬件功能。如要指出您的应用使用或需要某项硬件功能，请在 android:name 属性中声明以 "android.hardware" 开头的相应值。每次声明硬件功能时，请使用单独的 元素。

注意：为了避免 Google Play 对您的应用进行不必要的过滤，请向您的应用即使不具备也可正常运行的任何相机功能添加 android:required="false"。否则，Google Play 会假定该功能是必备功能，并阻止不支持该功能的设备获取您的应用。

某些相机功能在部分大屏幕设备上不受支持。Chromebook 通常不具备后置（面向外的）摄像头、自动对焦功能或闪光灯。但是，Chromebook 配有前置（面向用户的）摄像头，并且通常会连接到外接摄像头。

如需提供基本的相机支持并使您的应用可供尽可能多的设备使用，请在应用清单中添加以下相机功能设置：

调整功能设置以支持应用的用例。但是，为了使您的应用可供尽可能多的设备使用，应始终添加 required 属性，以明确指定某项功能是否是必备功能。

应用使用设备的其中一个摄像头或为设备连接的外接摄像头。如果您的应用不要求摄像头必须是后置（朝向外面）摄像头或前置（朝向用户）摄像头，请使用此功能来代替 android.hardware.camera 或 android.hardware.camera.front。

CAMERA 权限意味着您的应用也使用 android.hardware.camera。除非使用 android:required="false" 声明 android.hardware.camera，否则后置摄像头就是一项必备功能。

应用使用设备的后置（朝向外面）摄像头。

注意：像 Chromebook 这样只有前置（朝向用户）摄像头的设备不支持此功能。如果您的应用可以使用任何摄像头（无论其朝向哪个方向），请使用 android.hardware.camera.any。

注意：CAMERA 权限意味着后置摄像头是一项必备功能。为了帮助在应用清单包含 CAMERA 权限时在 Google Play 上正确进行过滤，请明确指定您的应用使用 camera 功能，并指明此功能是否属于必备功能，例如：

应用使用设备的前置（朝向用户）摄像头。

CAMERA 权限意味着您的应用也使用 android.hardware.camera。除非使用 android:required="false" 声明 android.hardware.camera，否则后置摄像头就是一项必备功能。

注意：如果您的应用使用 android.hardware.camera.front，但未使用 android.required="false" 明确声明 android.hardware.camera，Google Play 就会将没有后置摄像头的设备（例如 Chromebook）过滤掉。如果您的应用支持只有前置摄像头的设备，请使用 android.required="false" 声明 android.hardware.camera 以防止不必要的过滤。

应用与用户为设备连接的外接摄像头进行通信。此功能无法保证外接摄像头可供您的应用使用。

CAMERA 权限意味着您的应用也使用 android.hardware.camera。除非使用 android:required="false" 声明 android.hardware.camera，否则后置摄像头就是一项必备功能。

应用使用设备相机支持的自动对焦功能。

注意：CAMERA 权限意味着自动对焦是一项必备功能。当您的应用清单包含 CAMERA 权限时，为了确保在 Google Play 上进行正确的过滤，请明确指定您的应用使用自动对焦功能，并指明此功能是否属于必备功能，例如： 。

应用使用设备相机支持的闪光灯功能。

应用使用设备相机支持的 MANUAL_POST_PROCESSING 功能。

您的应用可通过该功能替换相机的自动白平衡功能。使用 android.colorCorrection.transform、android.colorCorrection.gains 以及 TRANSFORM_MATRIX 的 android.colorCorrection.mode。

应用使用设备相机支持的 MANUAL_SENSOR 功能。

此功能隐含对自动曝光锁定 (android.control.aeLock) 的支持，从而让摄像头的曝光时间和灵敏度一直固定在特定值。

应用使用设备相机支持的 RAW 功能。

此功能暗示设备可以保存 DNG（原始）文件。设备的摄像头会提供应用直接处理这些原始图像所需的 DNG 相关元数据。

将应用设计为在车辆内的一组屏幕上显示其界面。 用户通过硬按钮、轻触、旋转控制器以及类鼠标界面与应用进行交互。车辆的屏幕通常出现在车辆的中控台或仪表板中。这些屏幕的尺寸和分辨率通常有限。

注意 ：由于用户是在驾车时使用此类应用界面，因此应用必须尽量不要让驾驶员分心。

（已废弃；请改用 android.software.leanback。）

将应用设计为在电视上显示其界面。此功能将“电视”定义为一种典型的起居室电视体验：应用在大屏幕上显示、用户坐在远处，主流输入形式是类似方向键的设备，而不是鼠标、指示器或触摸设备。

应用使用通过设备的全球定位系统 (GPS) 接收器获得的精确位置坐标。

通过使用此功能，应用暗示其还会使用 android.hardware.location 功能（除非使用属性 android:required="false" 声明此父功能）。

应用使用通过设备所支持的基于网络的地理定位系统获得的粗略位置坐标。

通过使用此功能，应用暗示其还会使用 android.hardware.location 功能（除非使用属性 android:required="false" 声明此父功能）。

应用使用托管在设备上的 NFC 卡模拟。

应用要求设备使用纵向或横向方向。 如果您的应用同时支持这两种屏幕方向，则无需声明任一功能。

例如，如果您的应用要求纵向方向，则应声明以下功能，使得只有支持纵向方向（始终或由用户选择）的设备才能运行您的应用：

默认情况下假定两种屏幕方向均非必须使用的方向，这样您的应用就可以安装在支持一种或同时支持两种方向的设备上。不过，如果应用的任一 Activity 利用 android:screenOrientation 属性请求在特定屏幕方向下运行，则此声明意味着您的应用需要该屏幕方向。

例如，如果您使用 "landscape"、"reverseLandscape" 或 "sensorLandscape" 声明 android:screenOrientation，则您的应用只能安装在支持横向方向的设备上。

最佳实践是，使用 元素声明对该屏幕方向的要求。如果您使用 android:screenOrientation 为 activity 声明某个方向，但实际并无此要求，则可通过使用 元素并加入 android:required="false" 来声明该方向，进而停用这一要求。

为实现向后兼容性，任何运行 Android 3.1（API 级别 12）或更低版本的设备均支持横向和纵向方向。

应用使用码分多址接入 (CDMA) 无线电话系统。

通过使用此功能，应用暗示其还会使用 android.hardware.telephony 功能（除非使用 android:required="false" 声明此父功能）。

应用使用全球移动通讯系统 (GSM) 无线电话系统。

通过使用此功能，应用暗示其还会使用 android.hardware.telephony 功能（除非使用 android:required="false" 声明此父功能）。

应用使用基本的轻触交互事件，例如点按和拖动。

当声明为必需时，此功能表示只有当设备提供模拟触摸屏（“模拟触摸”）或实际具有触摸屏时，应用才能与之兼容。

如果设备带有模拟触摸界面，则其会为用户提供模拟部分触摸屏功能的用户输入系统。例如，鼠标或遥控器可以驱动屏幕上的光标。

如果您的应用需要基本的点击式交互，并且在只使用方向键控制器的情况下无法正常工作，请声明此功能。由于这是最低水平的触摸交互，因此您还可在提供更复杂触摸界面的设备上使用声明该功能的应用。

默认情况下，应用需要使用 android.hardware.faketouch 功能。如果您想将自己的应用限制为仅供拥有触摸屏的设备使用，则必须按如下方式明确声明要求提供触摸屏：

如下例所示，所有未明确要求 android.hardware.touchscreen 的应用也可在支持 android.hardware.faketouch 的设备上运行。

应用在模拟触摸界面上区分两根或更多“手指”的触摸轨迹。这是 android.hardware.faketouch 功能的一个超集。当声明为必需时，此功能表示只有当设备模拟区分两根或更多手指的触摸轨迹，或实际具有触摸屏时，应用才能与之兼容。

不同于 android.hardware.touchscreen.multitouch.distinct 所定义的区分式多点触摸，通过模拟触摸界面支持区分式多点触摸的输入设备并不支持所有双指手势，因为输入会转换成屏幕上的光标移动。换言之，在此类设备上，单指手势移动光标，双指划动触发单指触摸事件，而其他双指手势则触发相应的双指触摸事件。

如果设备提供双指触摸触控板进行光标移动，则其可支持此功能。

应用在模拟触摸界面上区分五根或更多“手指”的触摸轨迹。这是 android.hardware.faketouch 功能的一个超集。当声明为必需时，此功能表示只有当设备模拟区分五根或更多手指的触摸轨迹，或实际具有触摸屏时，应用才能与之兼容。

不同于 android.hardware.touchscreen.multitouch.jazzhand 所定义的区分式多点触摸，通过模拟触摸界面支持五指式多点触摸的输入设备并不支持所有五指手势，因为输入会转换成屏幕上的光标移动。换言之，在此类设备上，单指手势移动光标，多指划动手势触发单指触摸事件，而其他多指手势则触发相应的多指触摸事件。

如果设备提供五指触摸触控板进行光标移动，则其可支持此功能。

应用利用设备的触摸屏功能来实现比基本触摸事件交互性更强的手势，例如滑屏。这是 android.hardware.faketouch 功能的一个超集。

默认情况下，所有应用都需要该功能，因此不适用于只提供“模拟触摸”界面的设备。您可以结合使用 android.hardware.touchscreen 和 android:required="false" 来明确声明触摸屏不是必需的，让您的应用可用于提供模拟触摸界面的设备，甚至是只提供方向键控制器的设备。如果您的应用使用（但并不需要）真触摸屏界面，请添加此声明。所有未明确要求 android.hardware.touchscreen 的应用也可在支持 android.hardware.faketouch 的设备上运行。

如果您的应用确实需要触摸界面（例如，执行快速滑动之类的更高级触摸手势），则您无需声明任何触摸界面功能，因为它们默认为必需功能。不过，最好还是明确声明应用使用的所有功能。

如果您需要进行更复杂的触摸交互（例如多指手势），请声明您的应用使用高级触摸屏功能。

应用使用设备基本的两点式多点触摸功能（例如实现双指张合手势），但不需要独立追踪触摸轨迹。这是 android.hardware.touchscreen 功能的一个超集。

通过使用此功能，应用暗示其还会使用 android.hardware.touchscreen 功能（除非使用 android:required="false" 声明此父功能）。

应用使用设备的高级多点触摸功能，从而独立追踪两点或更多点的轨迹。该功能是 android.hardware.touchscreen.multitouch 功能的一个超集。

通过使用此功能，应用暗示其还会使用 android.hardware.touchscreen.multitouch 功能（除非使用 android:required="false" 声明此父功能）。

应用使用设备的高级多点触摸功能，从而独立追踪五点或更多点的轨迹。该功能是 android.hardware.touchscreen.multitouch 功能的一个超集。

通过使用此功能，应用暗示其还会使用 android.hardware.touchscreen.multitouch 功能（除非使用 android:required="false" 声明此父功能）。

此部分介绍最新平台版本所支持的软件功能。如要指出您的应用使用或需要某项软件功能，请在 android:name 属性中声明相应的值（以 "android.software" 开头）。每次声明软件功能时，请使用单独的 元素。

应用使用基于 SIP 的互联网语音协议 (VoIP) 服务。通过使用 VoIP，应用可以支持实时互联网电话操作，例如双向视频会议。

通过使用此功能，应用暗示其还会使用 android.software.sip 功能（除非使用 android:required="false" 声明此父功能）。

相应 API 发布后，应用可使用一些硬件和软件功能常量。因此，某些应用在能够利用 系统声明需要某个 API 之前，可能就已经使用了该 API。

为防止无意间提供这些应用，Google Play 会假定特定硬件相关权限规定，默认情况下需要底层硬件功能。例如，使用蓝牙的应用必须在 元素中请求 BLUETOOTH 权限。

对于旧版应用，Google Play 假定权限声明意味着，应用需要底层 android.hardware.bluetooth 功能，并根据该功能设置过滤条件。表 2 所列权限隐含的功能要求等同于 元素中声明的功能。

声明（包括任何声明的 android:required 属性）优先级始终高于表 2 中权限所隐含的功能。对于上述任一权限，您均可通过在 元素中明确声明相应功能（将 required 属性设置为 false），从而停用根据隐含功能进行过滤。

例如，如需停用根据 CAMERA 权限进行过滤，请将以下 声明添加到清单文件中：

注意：如果应用以 Android 5.0（API 级别 21）或更高版本为目标平台，并使用 ACCESS_COARSE_LOCATION 或 ACCESS_FINE_LOCATION 权限接收来自网络或 GPS 的位置信息更新，您还必须分别明确声明应用使用 android.hardware.location.network 或 android.hardware.location.gps 硬件功能。

表 2. 隐含设备硬件用途的设备权限。

如需了解详情，请参阅针对蓝牙功能的特殊处理。

android.hardware.location

android.hardware.location.network （仅适用于目标 API 级别 20 或更低版本。）

android.hardware.location

android.hardware.location.gps （仅适用于目标 API 级别 20 或更低版本。）