AndroidManifest详解

时间 2019-11-18

原文原文链接

一，重要性AndroidManifest.xml是Android应用程序中最重要的文件之一。它是Android程序的全局配置文件，是每一个 android程序中必须的文件。它位于咱们开发的应用程序的根目录下，描述了package中的全局数据，包括package中暴露的组件（activities, services, 等等），以及他们各自的实现类，各类能被处理的数据和启动位置等重要信息。
所以，该文件提供了Android系统所须要的关于该应用程序的必要信息，即在该应用程序的任何代码运行以前系统所必须拥有的信息。一个典型的Android应用程序的结构以下图所示：

二，主要功能它指定了该应用程序的Java包：该包名做为应用程序的一个独特标识。
它描述了应用程序组件：该应用程序由哪些activity，service，broadcast receiver和content provider组成。它指定了实现每一个组件的类以及公开发布它们的能力(例如，它们能持有哪一个Intent信息)。这些声明使Android系统知道这儿有什么组件以及在什么条件下它们能够被载入。
它决定那些进程将容纳应用程序组件。
它声明了本应用程序必须拥有哪些许可，以便访问API的被保护部分，以及与其余应用程序交互。
它也声明了其余应用程序在和该应用程序交互时须要持有的许可。
它列出了Instrumentation类，能够在应用程序运行时提供简档和其余信息。这些声明仅当应用程序在开发和测试过程当中被提供；它们将在应用程序正式发布以前被移除。
它声明了该应用程序所需的Android API的最小化水平。
它列出了该应用程序必须连接的库。

三，主要结构及规则下面列表显示了manifest文件的一般的结构以及它能够含有的元素。每一个元素，连同它的全部属性，会在各个单独的文档里进行充分的描绘。

<?xml version="1.0" encoding="utf-8"?>
<manifest>  //根节点，描述了package中全部的内容
<uses-permission /> //请求你的package正常运做所需赋予的安全许可。一个manifest能包含零个或更多此元素
<permission />  //声明了安全许可来限制哪些程序能使用你的package中的组件和功能。一个manifest能包含零个或更多此元素
<permission-tree />
<permission-group />
<instrumentation />  //声明了用来测试此package或其余package指令组件的代码。一个manifest能包含零个或更多此元素
<uses-sdk />  //指定当前应用程序兼容的最低sdk版本号
<application>  //包含package中application级别组件声明的根节点。此元素也可包含 application中全局和默认的属性，如标签，icon，主题，必要的权限，等等。一个manifest能包含零个或一个此元素（不容许多余一个）
      <activity>  //用来与用户交互的主要工具。当用户打开一个应用程序的初始页面时一个activity,大部分被使用到的其余页面也由不一样的activity所实现并声明在另外的activity标记中。
         <intent-filter>  //声明了指定的一组组件支持的Intent值
            <action />
            <category />
            <data />
                  <type/>
                  <schema/>
                  <authority/>
                  <path/>
         </intent-filter>
         <meta-data />
      </activity>
      <activity-alias>
         <intent-filter> . . . </intent-filter>
         <meta-data />
      </activity-alias>
      <service>  //Service是能在后台运行任意时间的组件
         <intent-filter> . . . </intent-filter>
         <meta-data/>
      </service>
      <receiver> //IntentReceiver能使你的application得到数据的改变或者发生的操做，即便它当前不在运行
         <intent-filter> . . . </intent-filter>
         <meta-data />
      </receiver>
      <provider>  //ContentProvider是用来管理持久化数据并发布给其余应用程序使用的组件
         <grant-uri-permission />
         <meta-data />
      </provider>
      <uses-library />
      <uses-configuration />
</application>
</manifest>
下面是按照字母顺序排列的全部能够出如今manifest文件里的元素。它们是惟一合法的元素；你不能加入你本身的元素或属性。
<action>
<activity>
<activity-alias>
<application>
<category>
<data>
<grant-uri-permission>
<instrumentation>
<intent-filter>
<manifest>
<meta-data>
<permission>
<permission-group>
<permission-tree>
<provider>
<receiver>
<service>
<uses-configuration>
<uses-library>
<uses-permission>
<uses-sdk>
说明：AndroidManifest.xml文件的结构、元素，以及元素的属性，能够在Android SDK文档中查看详细说明。而在看这些众多的元素以及元素的属性前，须要先了解一下这些元素在命名、结构等方面的规则：
元素：在全部的元素中只有<manifest>和<application>是必需的，且只能出现一次。若是一个元素包含有其余子元素，必须经过子元素的属性来设置其值。处于同一层次的元素，这些元素的说明是没有顺序的。
属性：按照常理，全部的属性都是可选的，可是有些属性是必须设置的。那些真正可选的属性，即便不存在，其也有默认的数值项说明。除了根元素<manifest>的属性，全部其余元素属性的名字都是以android:前缀的；
定义类名：全部的元素名都对应其在SDK中的类名，若是你本身定义类名，必须包含类的数据包名，若是类与application处于同一数据包中，能够直接简写为“.”；
多数值项：若是某个元素有超过一个数值，这个元素必须经过重复的方式来讲明其某个属性具备多个数值项，且不能将多个数值项一次性说明在一个属性中；
资源项说明：当须要引用某个资源时，其采用以下格式：@[package :]type :name 。例如 <activity android:icon=”@drawable/icon ” . . . >
字符串值：相似于其余语言，若是字符中包含有字符“\”，则必须使用转义字符“\\”；

四，详细说明值得一提一些经常使用之处：
1，几乎全部的AndroidManifest.xml（以及许多其余Android的xml的文件）在第一个元素中包含了命名空间的声明 xmlns:android="http://schemas.android.com/apk/res/android"。这样使得Android中各种标准属性能在文件中使用，提供了大部分元素中的数据。
2，大部分manifests包含了单个<application>的元素，它定义了全部的application级别组件和属性，并能在package中使用。
3，任何被用户看做顶层应用程序，并能被程序启动器所用的package，须要包含至少一个Activity组件来支持MAIN操做和LAUNCHER种类。动做android.intent.action.MAIN指示这是应用程序的入口点。类别 android.intent.category.LAUNCHER将此Activity放在启动器窗口中。
在最外层的<manifest>中包含了包名如 package="cn.androidlover.demo" 、软件的版本号 android:versionCode="1" 以及 android:versionName="1.0"的属性，而里面一层的<application>分支中将可能包含Android程序的四种对象 Activity、Service、Content Provider以及Receiver。咱们每添加上面四个类型中的任一种新对象都须要在androidmanifest.xml文件中添加相应节点，否则运行时将会产生异常。每个activity必需要一个<activity>标记对应，不管它给外部使用或是只用于本身的package 中。若是一个activity没有对应的标记，你将不能运行它。
此文件一个重要的地方就是它所包含的intent-filters。这些filters描述了activity启动的位置和时间。每当一个 activity（或者操做系统）要执行一个操做，例如：打开网页或联系簿时，它建立出一个intent的对象。它能承载一些信息描述了你想作什么，你想处理什么数据，数据的类型，和一些其余信息。Android比较了intent对象中和每一个application所暴露的intent-filter中的信息，来找到最合适的activity来处理调用者所指定的数据和操做。关于intent的更多信息请访问Intent参考页面。
application属性介绍：
有关AndroidManifest.xml文件的application分支咱们有必要了解一些常见的属性，这里能够看到一些咱们实用的选项，好比容许调试android:debuggable、任务关系android:taskAffinity，好比咱们常见的方式建立一个新的任务实用标记 FLAG_ACTIVITY_NEW_TASK，为程序制定一个主题，可使用android:theme指向一个主题文件。平时咱们建立的程序使用一些安全敏感项，会须要请求系统许可权限，这里可使用android:permission来制定相关的许可，每一个程序的service、 activity、content provider、receiver都须要在application的节点内实现。有关完整的属性能够查看:
<application android:allowClearUserData=["true" | "false"]
         android:allowTaskReparenting=["true" | "false"]
         android:debuggable=["true" | "false"]
         android:description="string resource"
            android:enabled=["true" | "false"]
         android:hasCode=["true" | "false"]
         android:icon="drawable resource"
            android:label="string resource"
         android:manageSpaceActivity="string"
            android:name="string"
            android:permission="string"
            android:persistent=["true" | "false"]
            android:process="string"
            android:taskAffinity="string"
            android:theme="resource or theme" >
   . . .
</application>
另外：Activity的属性经常使用的可能为android:name和android:label两个，但咱们须要了解全部的属性以帮助解决复杂的问题，完整的以下:android

android:allowTaskReparenting=["true" | "false"]
android:alwaysRetainTaskState=["true" | "false"]
android:clearTaskOnLaunch=["true"" | "false"]
android:configChanges=[one or more of: "mcc" "mnc" "locale" "touchscreen" "keyboard" "keyboardHidden" "navigation" "orientation" "fontScale"]
android:enabled=["true" | "false"]
android:excludeFromRecents=["true" | "false"]
android:exported=["true" | "false"]
android:finishOnTaskLaunch=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:launchMode=["multiple" | "singleTop" | "singleTask" | "singleInstance"]
android:multiprocess=["true" | "false"]
android:name="string"
android:noHistory=["true" | "false"]
android:permission="string"
android:process="string"
android:screenOrientation=["unspecified" | "user" | "behind" | "landscape" | "portrait" | "sensor" | "nonsensor"]
android:stateNotNeeded=["true" | "false"]
android:taskAffinity="string"
android:theme="resource or theme"
android:windowSoftInputMode=[one or more of: "stateUnspecified" "stateUnchanged" "stateHidden" "stateAlwaysHidden" "stateVisible" "stateAlwaysVisible" "adjustUnspecified" "adjustResize" "adjustPan"]

从Provider节点中用到的定义，能够看到包含了权限控制、排序方式完整的以下: <provider android:authorities="list" android:enabled=["true" | "false"] android:exported=["true" | "false"] android:grantUriPermissions=["true" | "false"] android:icon="drawable resource" android:initOrder="integer" android:label="string resource" android:multiprocess=["true" | "false"] android:name="string" android:permission="string" android:process="string" android:readPermission="string" android:syncable=["true" | "false"] android:writePermission="string" > </provider> 而对于服务相关定义以下: <service android:enabled=["true" | "false"] android:exported[="true" | "false"] android:icon="drawable resource" android:label="string resource" android:name="string" android:permission="string" android:process="string" > </service> 最后是Broadcast使用的Receiver定义，通常配合和隐式处理。 <receiver android:enabled=["true" | "false"] android:exported=["true" | "false"] android:icon="drawable resource" android:label="string resource" android:name="string" android:permission="string" android:process="string" > </receiver> 总之，AndroidManifest.xml文件虽然看起来复杂，可是，只要咱们理清中里面各元素的做用，那么一切就变得简单了。