AndroidManifest.xml配置文件选项详解

AndroidManifest.xml下的一些属性定义和用法：

----------------------------------------------------------------------------------------------------------------------------------

android:allowTaskReparenting        

 

         用法<application android:allowTaskReparenting="true/false"></application>

是否容许activity更换从属的任务，好比从短信息任务 切换到浏览器任务。

用来标记Activity可否从启动的Task移动到有着affinity的Task（当这个Task进入到前台时）——“true”，表示能移动，“false”，表示它必须呆在启动时呆在的那个Task里。

        若是这个特性没有被设定，设定到<application>元素上的allowTaskReparenting特性的值会应用到Activity上。默认值为“false”。

       通常来讲，当Activity启动后，它就与启动它的Task关联，而且在那里耗尽它的整个生命周期。当当前的Task再也不显示时，你可使用这个特性来强制Activity移动到有着affinity的Task中。典型用法是：把一个应用程序的Activity移到另外一个应用程序的主Task中。

       例如，若是e－mail中包含一个web页的连接，点击它就会启动一个Activity来显示这个页面。这个Activity是由Browser应用程序定义的，可是，如今它做为e－mail Task的一部分。若是它从新宿主到Browser Task里，当Browser下一次进入到前台时，它就能被看见，而且，当e－mail Task再次进入前台时，就看不到它了。

       Actvity的affinity是由taskAffinity特性定义的。Task的affinity是经过读取根Activity的affinity 决定。所以，根据定义，根Activity老是位于相同affinity的Task里。因为启动模式为“singleTask”和 “singleInstance”的Activity只能位于Task的底部，所以，从新宿主只能限于“standard”和“singleTop”模式。

----------------------------------------------------------------------------------------------------------------------------------

android:alwaysRetainTaskState

 

       用法<activity android:alwaysRetainTaskState="true/false"></activity>

        用来标记Activity所在的Task的状态是否老是由系统来保持——“true”，表示老是；“false”，表示在某种情形下容许系统恢复Task 到它的初始化状态。默认值是“false”。这个特性只针对Task的根Activity有意义；对其它Activity来讲，忽略之。

        通常来讲，特定的情形如当用户从主画面从新选择这个Task时，系统会对这个Task进行清理（从stack中删除位于根Activity之上的全部Activivity）。典型的状况，当用户有一段时间没有访问这个Task时也会这么作，例如30分钟。

       然而，当这个特性设为“true”时，用户老是能回到这个Task的最新状态，不管他们是如何启动的。这很是有用，例如，像Browser应用程序，这里有不少的状态（例如多个打开的Tab），用户不想丢失这些状态。

----------------------------------------------------------------------------------------------------------------------------------

android:clearTaskOnLanunch

 

         用法<activity android:clearTaskOnLanunch=”true/false”></activity>

         用来标记是否从Task中清除全部的Activity，除了根Activity外（每当从主画面从新启动时）——“true”，表示老是清除至它的根 Activity，“false”表示不。默认值是“false”。这个特性只对启动一个新的Task的Activity（根Activity）有意义； 对Task中其它的Activity忽略。

         当这个值为“true”，每次用户从新启动这个Task时，都会进入到它的根Activity中，无论这个Task最后在作些什么，也无论用户是使用 BACK仍是HOME离开的。当这个值为“false”时，可能会在一些情形下（参考alwaysRetainTaskState特性）清除Task的 Activity，但不老是。

         假设，某人从主画面启动了Activity P，并从那里迁移至Activity Q。接下来用户按下HOME，而后返回Activity P。通常，用户可能见到的是Activity Q，由于它是P的Task中最后工做的内容。然而，若是P设定这个特性为“true”，当用户按下HOME并使这个Task再次进入前台时，其上的全部的 Activity(在这里是Q)都将被清除。所以，当返回到这个Task时，用户只能看到P。

         若是这个特性和allowTaskReparenting都设定为“true”，那些能从新宿主的Activity会移动到共享affinity的Task中；剩下的Activity都将被抛弃，如上所述。

-----------------------------------------------------------------------------------------------------------------------------------

android:configChanges

 

         当配置list发生修改时， 是否调用 onConfigurationChanged() 方法 好比 "locale|navigation|orientation".

         举例：在按下power键时，直接在应用程序里onPause处理就好。当app是竖屏时，这样处理没问题。可是当app是横屏时，按下power键，app会强制回到竖屏，而且会从新调用activity的onCreate。不少时候这不是预期结果，因此就会用到android:configChanges。

         在配置文件里设置android:configChanges＝”keyboardHidden|orientation”，这样在屏幕方向改变的时候就不会从新调用activity的onCreate()方法，而是调用onConfigurationChanged(),而后在activity里面重在下。

@Override

public void onConfigurationChanged(Configuration newConfig){

         super.onConfigurationChanged(newConfig);

         if(newConfig.orientation==Configuration.ORIENTATION_LANDSCAPE){

                   //横向

         }else{

                   //竖向

         }

}

-----------------------------------------------------------------------------------------------------------------------------------

android:enabled

 

         activity 是否能够被实例化

         用法：<activity android:enabled="true"></activity>

-----------------------------------------------------------------------------------------------------------------------------------

android:excludeFromRecents

 

         是否可被显示在最近打开的activity列表里

         用法：<activity android:excludeFromRecents="true"></activity>

----------------------------------------------------------------------------------------------------------------------------------

android:exported

 

         是否容许activity被其它程序调用

----------------------------------------------------------------------------------------------------------------------------------

android:finishOnTaskLaunch

 

         用来标记当用户再次启动它的Task（在主画面选择这个Task）时已经存在的Activity实例是否要关闭（结束）——“true”，表示应该关闭，“false”表示不关闭。默认值是“false”。

         若是这个特性和allowTaskReparenting都设定为“true”，这个特性胜出。Activity的affinity忽略。这个 Activity不会从新宿主，可是会销毁。

----------------------------------------------------------------------------------------------------------------------------------

android.icon

        

         用法：<application android:icon="@drawable/xx_icon"></application>,加在应用程序图标

----------------------------------------------------------------------------------------------------------------------------------

android:label

 

         定义了每一个title栏的名称，可是优先级低于activity中的setTitle()

---------------------------------------------------------------------------------------------------------------------------------

android:launchMode

 

         用于指示Activity如何启动。这里有四种模式，与Intent对象中的Activity Flags（FLAG_ACTIVITY_*变量）共同做用，来决定Activity如何启动来处理Intent。它们是：

          "standard"

          "singleTop"

          "singleTask"

          "singleInstance"

          默认模式是“standard”。

         “standard”和“singleTop”为第一组，“singleTask”和“singleInstance”为第二组。

         第一组能够被实例化不少次。这些实例能够属于任何task而且能够位于activity stack的任何位置。典型的状况是，它们会进入调用startActivity()的Task（除非Intent对象包含 FLAG_ACTIVITY_NEW_TASK标志，在这种状况下会选择一个不一样的Task——参考taskAffinity特性）。

--------------------------------------------------------------------------------------------------------------------------------

 

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 被引入

 

原文地址：http://www.cnblogs.com/tt_mc/archive/2010/10/27/1862915.html