android开发入门教程Manifestxml选项.pdf

androidManifest.xml选项

Android:allowTaskReparenting

用法<applicationandroid: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－mailTask的一部分。如果它重新宿主到BrowserTask
里，当Browser下一次进入到前台时，它就能被看见，并且，当e－mailTask再次进入前台时，就看不到它
了。

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

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

android:alwaysRetainTaskState

用法<activityandroid: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

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

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

当这个值为“true”，每次用户重新启动这个Task时，都会进入到它的根Activity中，不管这个Task最后在做
些什么，也不管用户是使用BACK还是HOME离开的。当这个值为“false”时，可能会在一些情形下（参考
alwaysRetai