我们在进行APP开发的时候都会遇到一个文件：AndroidManifest.xml。从刚开始进行Android开发，到现在已经过去了几个月，还是对这个文件一知半解，只知道它是配置用的。但是这文件里的东西具体有什么用，该怎么用一直都没有理解。借着做项目的机会，仔细研究一下这个文件。

研究AndroidManifest.xml最好的方式自然就是对照着官方文档详细理解项目中每个字段的作用，并且做出一些修改来验证。

AndroidManifest是什么?AndroidManifest.xml是一个什么文件?

AndroidManifest官方解释是应用清单（manifest意思是货单），每个应用的根目录中都必须包含一个，并且文件名必须一模一样。这个文件中包含了APP的配置信息，系统需要根据里面的内容运行APP的代码，显示界面。

AndroidManifest.xml是每个apk(zip)文件解压后根目录下的一个文件,每个apk都必须包含一个AndroidManifest.xml文件,且名字必须与此完全一致.

AndroidManifest.xml的作用是什么？

描述app的包名：

Android设备据此区分不同的app,如果每个app是一个人的话,包名就相当于是这个人的名字(为了防止恶意软件仿冒其他app,只有新的app的包名和签名均与旧的app相同时才能升级覆盖安装成功).

描述app使用的android系统版本信息：

因为android系统在不断的升级,新的系统版本会增加新的API,但是旧的Android设备上并没有这些API,那么就会出现新版本的应用使用新的API但是在旧的系统上运行的问题(在旧的系统上调用新的API应用会崩溃),因此需要说明本应用支持的最低android系统版本是哪个,比如说将minSdkVersion设置为19就是说这个应用在API19以及以上的设备上运行没有问题.

描述app本身的版本信息，这样对于同一个app的两个版本,系统就能区分那个是新版本,哪个是旧版本.

很重要的一个作用是描述应用对外暴露的组件(或者叫接口)：

Activity，Service，Provider，BroadcastReceiver这四大组件的每一个都可以独立运行，都可以作为app启动的入口点。

AndroidManifest.xml可以告知系统点击应用图标后进入哪个Activity；可以告知系统本应用某个类(BroadcastReceiver的子类)需要监听网络变化等信息(广播)；告知系统本应用可以其他应用提供服务(ContentProvider和Service)；告知系统本应用某些类能够处理一些特定的请求(比如打开pdf扩展名的文件)；等等

其他各种需要用文本直接告知系统的：比如申请的权限,应用的主题等等。

归根结底就是Android系统的app需要通过文本方式直接告诉系统的信息太多了

一份真实的AndroidManifest.xml文件

这是Google官方示例中的teapots项目中的一个文件，我们就针对这份文件来分析字段的意义。字段的意义参考的是官方文档。

元素

首先，所有的xml都必须包含元素。这是文件的根节点。它必须要包含元素，并且指明xmlns:android和package属性。

元素中的属性

xmlns:android

这个属性定义了Android命名空间。必须设置成”http://schemas.android.com/apk/res/android”。不要手动修改。

package

这是一个完整的Java语言风格包名。包名由英文字母（大小写均可）、数字和下划线组成。每个独立的名字必须以字母开头。

构建APK的时候，构建系统使用这个属性来做两件事：

1、生成R.java类时用这个名字作为命名空间（用于访问APP的资源）

比如：package被设置成com.sample.teapot，那么生成的R类就是：com.sample.teapot.R2、用来生成在manifest文件中定义的类的完整类名。比如package被设置成com.sample.teapot，并且activity元素被声明成，完整的类名就是com.sample.teapot.MainActivity。包名也代表着唯一的application ID，用来发布应用。但是，要注意的一点是：在APK构建过程的最后一步，package名会被build.gradle文件中的applicationId属性取代。如果这两个属性值一样，那么万事大吉，如果不一样，那就要小心了。

android:versionCode

内部的版本号。用来表明哪个版本更新。这个数字不会显示给用户。显示给用户的是versionName。这个数字必须是整数。不能用16进制，也就是说不接受”0x1”这种参数

android:versionName

显示给用户看的版本号。

元素中的元素

元素

Google Play利用这个元素的值从不符合应用需要的设备上将应用过滤。

这东西的作用是将APP所依赖的硬件或者软件条件告诉别人。它说明了APP的哪些功能可以随设备的变化而变化。

使用的时候要注意，必须在单独的元素中指定每个功能，如果要多个功能，需要多个元素。比如要求设备同时具有蓝牙和相机功能：

的属性

android:name

该属性以字符串形式指定了APP要用的硬件或软件功能。

android:required

这项属性如果值为true表示需要这项功能否则应用无法工作，如果为false表示应用在必要时会使用该功能，但是如果没有此功能应用也能工作。

android:glEsVersion

指明应用需要的Opengl ES版本。高16位表示主版本号，低16位表示次版本号。例如，如果是要3.2的版本，就是0x00030002。如果定义多个glEsVersion，应用会自动启用最高的设置。

元素

此元素描述了应用的配置。这是一个必备的元素，它包含了很多子元素来描述应用的组件，它的属性影响到所有的子组件。许多属性（例如icon、label、permission、process、taskAffinity和allowTaskReparenting）都可以设置成默认值。

的属性

android:allowBackup

表示是否允许APP加入到备份还原的结构中。如果设置成false，那么应用就不会备份还原。默认值为true。

android:fullBackupContent

这个属性指向了一个xml文件，该文件中包含了在进行自动备份时的完全备份规则。这些规则定义了哪些文件需要备份。此属性是一个可选属性。默认情况下，自动备份包含了大部分app文件。

android:supportsRtl

声明你的APP是否支持RTL（Right To Left）布局。如果设置成true，并且targetSdkVersion被设置成17或更高。很多RTL API会被集火，这样你的应用就可以显示RTL布局了。如果设置成false或者targetSdkVersion被设置成16或更低。哪些RTL API就不起作用了。

该属性的默认的值是false。

android:icon

APP的图标，以及每个组件的默认图标。可以在组价中自定义图标。这个属性必须设置成一个引用，指向一个可绘制的资源，这个资源必须包含图片。系统不设置默认图标。例如mipmap/ic_launcher引用的就是下面的资源

android:label

一个用户可读的标签，以及所有组件的默认标签。子组件可以用他们的label属性定义自己的标签，如果没有定义，那么就用这个标签。

标签必须设置成一个字符串资源的引用。这样它们就能和其他东西一样被定位，比如@string/app_name。当然，为了开发方便，你也可以定义一个原始字符串。

android:theme

该属性定义了应用使用的主题的，它是一个指向style资源的引用。各个activity也可以用自己的theme属性设置自己的主题。

android:name

Application子类的全名。包括前面的路径。例如com.sample.teapot.TeapotApplication。当应用启动时，这个类的实例被第一个创建。这个属性是可选的，大多数APP都不需要这个属性。在没有这个属性的时候，Android会启动一个Application类的实例。

元素

该元素声明一个实现应用可视化界面的Activity（Activity类子类）。这是元素中必要的子元素。所有Activity都必须由清单文件中的元素表示。任何未在该处声明的Activity对系统都不可见，并且永远不会被执行。

android:name

Activity类的名称，是Activity类的子类。该属性值为完全限定类名称，例如com.sample.teapot.TeapotNativeActivity。为了方便起见，如果第一个字符是点（’.’），就需要加上元素中的包名。应用一旦发布，不应更改该名称。

没有默认值，必须指定该名称。

android:label

Activity标签，可以被用户读取。该标签会在Activity激活时显示在屏幕上。如果未设置，用中的label属性。对属性的设置要求和中一样。

android:configChanges

列出 Activity 将自行处理的配置更改消息。在运行时发生配置更改时，默认情况下会关闭 Activity 然后将其重新启动，但使用该属性声明配置将阻止 Activity 重新启动。 Activity 反而会保持运行状态，并且系统会调用其 onConfigurationChanged()方法。