<uses-permission>

注意：在某些情况下，您通过 <uses-permission> 请求的权限会影响 Google Play 如何筛选您的应用程序。如果您请求与硬件相关的权限（例如 CAMERA），Google Play 会假定您的应用程序需要底层硬件功能，并从不提供该功能的设备中筛选该应用程序。

要控制筛选，请始终在 <uses-feature> 元素中显式声明硬件功能，而不是依赖 Google Play 在 <uses-permission> 元素中“发现”这些要求。然后，如果您想禁用特定功能的筛选，可以在 <uses-feature> 声明中添加 android:required="false" 属性。

有关暗示硬件功能的权限列表，请参阅 <uses-feature> 元素的文档。

语法

<uses-permission android:name="string"
        android:maxSdkVersion="integer" />

包含在

<manifest>

描述

指定应用正常运行时用户必须授予的系统权限。用户在应用安装时（在运行 Android 5.1 及更低版本的设备上）或应用运行时（在运行 Android 6.0 及更高版本的设备上）授予权限。

有关权限的更多信息，请参阅应用清单概述中的权限部分以及 Android 上的权限指南。基本平台定义的权限列表位于 android.Manifest.permission。

属性

android:name

权限的名称。它可以是使用 <permission> 元素由应用程序定义的权限、由另一个应用程序定义的权限或标准系统权限之一，例如 "android.permission.CAMERA" 或 "android.permission.READ_CONTACTS"。如这些示例所示，权限名称通常包含包名称作为前缀。

android:maxSdkVersion

授予应用此权限的最高 API 级别。如果应用所需的权限从特定 API 级别开始不再需要，则设置此属性很有用。

例如，从 Android 4.4（API 级别 19）开始，您的应用不再需要请求 WRITE_EXTERNAL_STORAGE 权限才能将其自身应用专用目录写入外部存储，这些目录由 getExternalFilesDir() 提供。

但是，对于 API 级别 18 及以下，需要此权限。因此，您可以使用如下声明来声明此权限仅在 API 级别 18 及以下版本中需要

<uses-permission
     android:name="android.permission.WRITE_EXTERNAL_STORAGE"
     android:maxSdkVersion="18" />

这样，从 API 级别 19 开始，系统将不再授予您的应用 WRITE_EXTERNAL_STORAGE 权限。

在 API 级别 19 中添加。

引入于

API 级别 1

另请参阅