转 Android Manifest.xml解析

转载：http://www.cnblogs.com/jocc/archive/2007/11/25/971511.html

AndroidManifest.xml是每个android程序中必须的文件。它位于application的根目录，描述了package中的全局数据，包括了package中暴露的组件（activities, services, 等等），他们各自的实现类，各种能被处理的数据和启动位置。

    此文件一个重要的地方就是它所包含的intent-filters。这些filters描述了activity启动的位置和时间。每当一个activity（或者操作系统）要执行一个操作，例如：打开网页或联系簿时，它创建出一个intent的对象。它能承载一些信息描述了你想做什么，你想处理什么数据，数据的类型，和一些其他信息。Android比较了intent对象中和每个application所暴露的intent-filter中的信息，来找到最合适的activity来处理调用者所指定的数据和操作。关于intent的更多信息请访问Intent参考页面。

    除了能声明你程序中的Activities, Content Providers, Services, 和Intent Receivers,你还能指定permissions和instrumentation（安全控制和测试）在AndroidManifest.xml文件中。请见AndroidManifest标记和属性的参考。

    这是一个简单的AndroidManifest.xml。

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

        package="com.my_domain.app.helloactivity">

       

    <application android:label="@string/app_name">

   

        <activity class=".HelloActivity">

            <intent-filter>

                <action android:value="android.intent.action.MAIN"/>

                <category android:value="android.intent.category.LAUNCHER"/>

            </intent-filter>

        </activity>

       

    </application>

   

</manifest>

值得一提一些常用之处：

•几乎所有的AndroidManifest.xml（以及许多其他Android的xml的文件）在第一个元素中包含了命名空间的声明xmlns:android="http://schemas.android.com/apk/res/android"。这样使得Android中各种标准属性能在文件中使用，提供了大部分元素中的数据。
•大部分manifests包含了单个<application>的元素，它定义了所有的application级别组件和属性，并能在package中使用。
•任何被用户看作顶层应用程序，并能被程序启动器所用的package,需要包含至少一个Activity组件来支持MAIN操作和LAUNCHER种类，如上述代码中所见。
这里是AndroidManifest.xml文件结构的一个详细的列表，描述了所有能被使用的标记。

manifest

    根节点，描述了package中所有的内容。在它之下能放置：

    uses-permission

        请求你的package正常运作所需赋予的安全许可。见Security Model来获得许可的更多的信息。一个manifest能包含零个或更多此元素。

    permission

        声明了安全许可来限制哪些程序能你package中的组件和功能。见Security Model来获得许可的更多的信息。一个manifest能包含零个或更多此元素。

    instrumentation

        声明了用来测试此package或其他package指令组件的代码。见Instrumentation来获得许可的更多的信息。一个manifest能包含零个或更多此元素。

    application

        包含package中application级别组件声明的根节点。此元素也可包含application中全局和默认的属性，如标签，icon，主题，必要的权限，等等。一个manifest能包含零个或一个此元素（不允许多余一个）。在它之下能放置零个或更多下列组件声明：

        activity

            Activity是用来与用户交互的主要工具。当用户打开一个应用程序的初始页面时一个activity,大部分被使用到的其他页面也由不同的activity所实现并声明在另外的activity标记中。

            注意：每一个activity必须要一个<activity>标记对应，无论它给外部使用或是只用于自己的package中。如果一个activity没有对应的标记，你将不能运行它。

            另外，为了支持运行时迟查找你的activity,你能包含一个或多个<intent-filter>元素来描述你activity所支持的操作：

           

            intent-filter

                声明了指定的一组组件支持的Intent值，从而形成了IntentFilter。除了能在此元素下指定不同类型的值，属性也能放在这里来描述一个操作所需的唯一的标签，icon和其它信息。

                action

                    组件支持的Intent action。

                category

                    组件支持的Intent Category.

                type

                    组件支持的Intent data MIME type.

                schema

                    组件支持的Intent data URI scheme.

                authority

                    组件支持的Intent data URI authority.

                path

                    组件支持的Intent data URI path.

        receiver

            IntentReceiver能使的application获得数据的改变或者发生的操作，即使它当前不在运行。利用activity标记，你能选择地包含一个或多个receiver所支持的<intent-filter>元素；

        service

            Service是能在后台运行任意时间的组件。利用activity标记，你能选择地包含一个或多个receiver所支持的<intent-filter>元素；

        provider

            ContentProvider是用来管理持久化数据并发布给其他应用程序使用的组件。

 

android manifest.xml中元素含义

 

android:allowTaskReparenting 是否允许activity更换从属的任务，比如从短信息任务 切换到浏览器任务。 -------------------------------------------------------------------------------------- android:alwaysRetainTaskState 是否保留状态不变， 比如切换回home, 再从新打开， activity处于最后的状态 -------------------------------------------------------------------------------------- android:clearTaskOnLanunch 比如 P 是 activity, Q 是被P 触发的 activity, 然后返回Home, 从新启动 P， 是否显示 Q -------------------------------------------------------------------------------------- android:configChanges 当配置list发生修改时， 是否调用 onConfigurationChanged() 方法 比如 "locale|navigation|orientation". -------------------------------------------------------------------------------------- android:enabled activity 是否可以被实例化, -------------------------------------------------------------------------------------- android:excludeFromRecents 是否可被显示在最近打开的activity列表里 -------------------------------------------------------------------------------------- android:exported 是否允许activity被其它程序调用 -------------------------------------------------------------------------------------- android:finishOnTaskLaunch 是否关闭已打开的activity当用户重新启动这个任务的时候 -------------------------------------------------------------------------------------- android.icon -------------------------------------------------------------------------------------- android:label -------------------------------------------------------------------------------------- android:launchMode activity启动方式， "standard" "singleTop" "singleTask" "singleInstance" 其中前两个为一组， 后两个为一组 -------------------------------------------------------------------------------------- android:multiprocess 允许多进程 -------------------------------------------------------------------------------------- android:name activity的类名， 必须指定 -------------------------------------------------------------------------------------- android:onHistory 是否需要移除这个activity当用户切换到其他屏幕时。 这个属性是 API level 3 中引入的 -------------------------------------------------------------------------------------- android:permission -------------------------------------------------------------------------------------- android:process 一个activity运行时所在的进程名，所有程序组件运行在应用程序默认的进程中，这个进程名跟应用程序的包名一致。<application>中的元素process属性能够为所有组件设定一个新的默认值。但是任何组件都可以覆盖这个默认值，允许你将你的程序放在多进程中运行。 如果这个属性被分配的名字以:开头，当这个activity运行时, 一个新的专属于这个程序的进程将会被创建。如果这个进程名以小写字母开头，这个activity将会运行在全局的进程中，被它的许可所提供。 -------------------------------------------------------------------------------------- android:screenOrientation activity显示的模式, "unspecified" 默认值 "landscape" 风景画模式，宽度比高度大一些 "portrait" 肖像模式, 高度比宽度大。 "user" 用户的设置 "behind" "sensor" "nosensor" -------------------------------------------------------------------------------------- android:stateNotNeeded 是否 activity被销毁和成功重启并不保存状态 -------------------------------------------------------------------------------------- android:taskAffinity activity的亲属关系， 默认情况同一个应用程序下的activity有相同的关系 -------------------------------------------------------------------------------------- android:theme activity的样式主题, 如果没有设置，则activity的主题样式从属于应用程序， 参见<application>元素的theme属性 -------------------------------------------------------------------------------------- android:windowSoftInputMode activity主窗口与软键盘的交互模式, 自从API level 3 被引入