每个应用项目都必须在项目源代码集的根目录下有一个 AndroidManifest.xml 文件，且文件名精确无误。清单文件会向 Android 构建工具、Android 操作系统和 Google Play 描述有关应用的基本信息。

清单文件必须声明以下内容（还有许多其他内容）：

如果您使用 Android Studio 构建应用，系统会为您创建清单文件，并且会在您构建应用时添加大部分基本清单元素，尤其是在使用代码模板时。

下面几部分介绍如何在清单文件中反映应用的一些最重要的特性。

对于您在应用中创建的每个应用组件，可在清单文件中声明一个相应的 XML 元素：

如果您将上述任一组件加入子类而未在清单文件中声明该组件，则系统无法启动该组件。

使用完整的软件包标识指定带有 name 属性的子类的名称。例如，按如下方式声明 Activity 子类：

不过，如果 name 值中的第一个字符是一个句点，则来自模块级 build.gradle 文件的 namespace 属性的应用的命名空间会作为该名称的前缀。例如，如果命名空间为 "com.example.myapp"，则以下 activity 名称将解析为 com.example.myapp.MainActivity：

如需详细了解如何设置软件包名称或命名空间，请参阅设置命名空间。

如果您的某些应用组件位于子软件包中（如在 com.example.myapp.purchases 中），则 name 值必须添加缺少的子软件包名称（如 ".purchases.PayActivity"）或使用完全限定的软件包名称。

应用 activity、服务和广播接收器由 intent 激活。intent 是由 Intent 对象定义的消息，它描述了要执行的操作，包括作为操作对象的数据、应执行操作的组件类别，以及其他说明。

当应用向系统发出某个 intent 时，系统会根据每个应用的清单文件中的 intent 过滤器声明来查找可以处理该 intent 的应用组件。系统会启动符合条件的组件的实例，并将 Intent 对象传递给该组件。如果多个应用可以处理相应的 intent，则用户可以选择要使用哪个应用。

一个应用组件可以具有任意多个 intent 过滤器（使用 元素定义），每个 intent 过滤器描述该组件的不同功能。

如需了解详情，请参阅 intent 和 intent 过滤器文档。

许多清单元素具有 icon 和 label 属性，分别用于向用户显示相应应用组件的一个小图标和一个文本标签。

在每种情况下，在父元素中设置的图标和标签都会成为所有子元素的默认 icon 和 label 值。例如，在 元素中设置的图标和标签是应用的每个组件（如所有 activity）的默认图标和标签。

每当某个组件以实现 intent 的一个选项的形式呈现，系统就会向用户显示在该组件的 中设置的图标和标签。默认情况下，此图标从针对父组件（ 或 元素）声明的图标继承而来。

但如果某个 intent 过滤器提供了独一无二的操作，而您希望在选择器对话框中更好地予以指示，那么您可能想要针对该 intent 过滤器更改图标。如需了解详情，请参阅允许其他应用启动您的 activity。

Android 应用必须请求权限才能访问敏感的用户数据（如联系人和短信）或某些系统功能（如相机和互联网接入）。每种权限都由唯一的标签进行标识。例如，需要发送短信的应用必须在清单中添加以下代码行：

从 Android 6.0（API 级别 23）开始，用户可以在运行时批准或拒绝某些应用权限。但是，无论应用支持哪个 Android 版本，您都必须在清单中使用 元素声明所有权限请求。如果向应用授予了相应的权限，应用便可以使用受保护的功能。否则，应用在尝试使用这些功能时会失败。

您的应用也可以利用权限来保护它自己的组件。它可以使用由 Android 定义的任何权限（如 android.Manifest.permission 中所列），也可以使用在其他应用中声明的权限。此外，您的应用也可以定义它自己的权限。新权限使用 元素进行声明。

如需了解详情，请参阅 Android 中的权限。

在清单文件中，您还可以声明应用需要哪些类型的硬件或软件功能，进而声明应用与哪些类型的设备兼容。Google Play 商店不允许应用安装在不提供应用所需的功能或系统版本的设备上。

有几个清单标记用于定义应用与哪些设备兼容。以下是一些最常见的清单标记。

元素可让您声明应用所需的硬件和软件功能。例如，如果应用在不带罗盘传感器的设备上无法获得基本功能，则您可以使用以下清单标记将罗盘传感器声明为必需功能：

注意：如果您希望让应用可以在 Chromebook 上使用，则需考虑一些重要的硬件和软件功能限制。如需了解详情，请参阅 Chromebook 的应用清单兼容性。

每个后续的平台版本通常会添加之前版本中不可用的新 API。为了指明与应用兼容的最低版本，清单必须包含 标记及其 minSdkVersion 属性。

但请注意， 元素中的属性会被替换为 build.gradle 文件中的相应属性。因此，如果您使用的是 Android Studio，则在此处指定 minSdkVersion 和 targetSdkVersion 值：

如需详细了解 build.gradle 文件，请参阅如何配置 build。

如需详细了解如何声明应用对不同设备的支持，请参阅设备兼容性概览。

本部分介绍了通常适用于清单文件中的所有元素和属性的约定和规则。

所有值均通过属性进行设置，而不是通过元素内的字符数据设置。

同一级别的元素通常不分先后顺序。例如，、 和 元素可按任意顺序放置。此规则主要有两种例外情况：

除了 根元素的某些属性之外，所有属性名称都以 android: 前缀开头，例如 android:alwaysRetainTaskState。由于该前缀是通用的，因此在按名称引用属性时，文档中通常会将其省略。

资源表示为值，格式如下：

"@[package:]type/name"

如果资源由您的应用提供（包括资源由库依赖项提供的情况，因为库资源会合并到您的资源中），则您可以省略 package 名称。当您想要使用来自 Android 框架的资源时，唯一一个其他有效的软件包名称是 android。

type 是资源的类型，如 string 或 drawable；name 是标识特定资源的名称。示例如下：

如需详细了解如何为项目添加资源，请参阅应用资源概览。

如需应用在主题背景中定义的值，第一个字符必须是 ?，而不是 @：

"?[package:]type/name"

下表提供了 AndroidManifest.xml 文件中所有有效元素的参考文档的链接。

下面的 XML 是一个简单的 AndroidManifest.xml 示例，它为应用声明了两个 activity。