[置顶] activity配置信息详解

翻译原文地址:点击打开链接

<activity>

SYNTAX:

<activity android:allowTaskReparenting=["true" | "false"]     android:alwaysRetainTaskState=["true" | "false"]     android:clearTaskOnLaunch=["true" | "false"]     android:configChanges=["mcc", "mnc", "locale",                "touchscreen", "keyboard", "keyboardHidden",                "navigation", "screenLayout", "fontScale", "uiMode",                "orientation", "screenSize", "smallestScreenSize"]     android:enabled=["true" | "false"]     android:excludeFromRecents=["true" | "false"]     android:exported=["true" | "false"]     android:finishOnTaskLaunch=["true" | "false"]     android:hardwareAccelerated=["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:parentActivityName="string"      android:permission="string"     android:process="string"     android:screenOrientation=["unspecified" | "behind" |                  "landscape" | "portrait" |                  "reverseLandscape" | "reversePortrait" |                  "sensorLandscape" | "sensorPortrait" |                  "userLandscape" | "userPortrait" |                  "sensor" | "fullSensor" | "nosensor" |                  "user" | "fullUser" | "locked"]     android:stateNotNeeded=["true" | "false"]     android:taskAffinity="string"     android:theme="resource or theme"     android:uiOptions=["none" | "splitActionBarWhenNarrow"]     android:windowSoftInputMode=["stateUnspecified",                   "stateUnchanged", "stateHidden",                   "stateAlwaysHidden", "stateVisible",                   "stateAlwaysVisible", "adjustUnspecified",                   "adjustResize", "adjustPan"] >    . . .</activity>

CONTAINED IN:

<application>

CAN CONTAIN:

<intent-filter>
<meta-data>

描述：

声明一个Activity（Activity的子类)可以实现应用程序的可视化用户界面的一部分。所有的Activity必须以<activity>在manifest文件中的元素形式存在。任何未声明的Activity将不会被系统所识别并且永远不会被执行。

属性：

android:allowTaskReparenting

 这个属性用于设定Activity能够从启动它的任务中转移到另一个与启动它的任务有亲缘关系的任务中，转移发生在这个有亲缘关系的任务被带到前台的时候。如果设置了true，则能够转移，如果设置了false，则这个Activity必须要保留在启动它的那个任务中。  如果这个属性没有设置，那么其对应的<application>元素的allowTaskReparenting属性值就会应用到这个Activity上。它的默认值是false。  通常，当Activity被启动时，它会跟启动它的任务关联，并且它的整个生命周期都会保持在那个任务中。但是当Activity的当前任务不在显示时，可以使用这个属性来强制将Activity转移到与当前任务有亲缘关系的任务中。这种情况的典型应用是把应用程序的Activity转移到与这个应用程序相关联的主任务中。  例如，如果一个电子邮件消息中包含了一个网页的链接，点击这个链接会启动一个显示这个网页的Activity。但是，由e-mail任务部分启动的这个Activity是由浏览器应用程序定义的。如果把它放到浏览器的任务中，那么在浏览器下次启动到前台时，这个网页会被显示，并且在e-mail任务再次显示时，这个Activity有会消失。  Activity的亲缘关系是由taskAffinity属性定义的。通过读取任务的根Activity的亲缘关系来判断任务的亲缘关系。因此，通过定义，任务中的根Activity与任务有着相同的亲缘关系。因此带有singleTask或singleInstance启动模式的Activity只能是任务的根节点，Activity的任务归属受限于standard和singleTop模式。

android:alwaysRetainTaskState

     这个属性用于设置Activity所属的任务状态是否始终由系统来维护。如果设置为true，则由系统来维护状态，设置为false，那么在某些情况下，系统会允许重设任务的初始状态。默认值是false。这个属性只对任务根节点的Activity有意义，其他所有的Activity都会被忽略。

     通常，在某些情况中，当用户从主屏中重新启动一个任务时，系统会先清除任务（从堆栈中删除根节点Activity之上的所有Activity）。典型用例，如果用户在超过一段时间不去访问一个应用，例如30分钟，系统将会清理这个任务。

      但是，当这个属性被设置为true时，用户会始终返回到这个任务的最后状态，而不管中间经历了哪些操作。这样做是有好处的，例如，Web浏览器的应用就会保留很多用户不想丢失的状态，如多个被打开的标签页。

android:clearTaskOnLaunch

这个属性用于设定在从主屏中重启任务时，处理根节点的Activity以外，任务中的其他所有的Activity是否要被删除。如果设置为true，那么任务根节点的Activity之上的所有Activity都要被清除，如果设置了false，就不会被清除。默认设置时false。这个属性只对启动新任务（或根Activity）的那些Activity有意义，任务中其他所有的Activity都会被忽略。当这个属性值被设置为true，用户再次启动任务时，任务根节点的Activity就会被显示，而不管在任务的最后做了什么，也不管任务使用Back按钮，还是使用Home离开的。当这个属性被设置为false时，在某些情况中这个任务的Activity可以被清除，但不总是这样的。例如，假设某人从主屏中启动了Activity P，并且又从P中启动了Activity Q。接下来用户按下了Home按钮，然后由返回到Activity P。通常用户会看到Activity Q，因为这是在P的任务中所做的最后的事情。但是，如果P把这个属性设置为true，那么在用户按下Home按钮，任务被挂起时，Activity P之上的所有Activity（本例中是Activity Q）都会被删除。因此当用户再次返回到本任务时，用户只能看到Activity P。如果这个属性和allowTaskReparenting属性都被设置为true，那些被设置了亲缘关系的Activity会被转移到它们共享的亲缘任务中，然后把剩下的Activity都给删除。

android:configChanges

列表属性用户改变设定的activity本身。在没有设置此属性时，当配置变化发生在运行时，默认的这个activity将会被销毁或者被重新创建，但在申明了此属性时，将阻止活动再次启动。 取而代之的是，活性保持运行，其onConfigurationChanged()方法被调用。　　注意：这个属性应当避免使用，或者当做最后的手段。 请阅读Handling Runtime Changes 有关如何正确处理重新启动由于配置更改的详细信息。　　下面的所有这些配置都是可以用于这个属性的，多个值之间用’|’隔开。例如， "locale|navigation|orientation".

值	描述
“mcc“	该IMSI移动国家代码（MCC）已经改变-SIM卡已被检测并更新MCC。
“mnc“	该IMSI的移动网络代码（MNC）已经改变-SIM卡已被检测并更新MNC。
“locale“	语言环境已经改变-用户选择的文本应显示英寸新语言
“touchscreen“	触摸屏已经改变。（这不应该常发生。）
“keyboard“	键盘类型已经改变-例如，用户已经插入了外部键盘。
“keyboardHidden“	键盘辅助功能已经改变-例如，用户已经透露了硬件键盘。
“navigation“	导航型（轨迹球/DPAD）发生了变化。（这不应该常发生。）
“screenLayout“	屏幕布局已经改变-这可能是由于不同的显示被激活引起。
“fontScale“	字体缩放因子改变-用户已经选择了一个新的全局字体大小。
“uiMode“	用户界面模式已经改变-这可以当用户将设备插入一张桌子/车停靠时或夜间模式的变化引起的。见UiModeManager。在新增API级别8。
“orientation“	屏幕的方向发生了变化-用户旋转设备。注意：如果您的应用程序面向API级别13或更高（由作为申报minSdkVersion和targetSdkVersion属性），那么你也应该申报"screenSize"的配置，因为它也改变时纵向和横向之间的设备开关。
“screenSize“	当前可用的屏幕尺寸已经改变。这代表了目前可用的尺寸，相对于当前纵横比发生变化，所以，当用户在横向和纵向之间切换将发生变化。但是，如果您的应用程序面向API级别12或更低，那么你的活动总是处理此配置变化本身（一个Android3.2或更高版本的设备上运行，即使这种配置更改不会重新启动您的活动）。在加入API级别13。
“smallestScreenSize“	物理屏幕的大小发生了变化。这代表了尺寸的变化，无论取向的，因此，当实际的物理屏幕的大小发生了变化，如切换到外部显示只会改变。改变到这种配置对应于一个变化smallestWidth配置。但是，如果您的应用程序面向API级别12或更低，那么你的活动总是处理此配置变化本身（一个Android3.2或更高版本的设备上运行，即使这种配置更改不会重新启动您的活动）。在加入API级别13。
“layoutDirection“	布局方向已经改变。例如，从左边到右（LTR）更改为从右到左（RTL）。在新增API级别17。

所有这些配置更改可能会影响看到的应用程序的资源价值。因此，当onConfigurationChanged()被调用时，它通常会需要再次检索所有资源（包括视图的布局，可绘，等等）来正确处理的变化。

android:enabled

　　这个属性用于设置activity是否能被系统初始化，“true”可以，“false”不可以，默认值是“false”。　　<application>元素有它自己的enabled属性，这个属性可以用到所有的组件中的，包括所有的activity。 <application> 和<activity> 的enabled属性都必须同时是“true”时（默认他们都是“true”）系统才能够初始化activity。只要其中的一个enabled属性为false，系统将不能系统该activity。

android:excludeFromRecents

这个属性用于设置这个任务是否会罗列在最近使用的应用的列表中。当一个activity是一个任务的根activity时，这个属性将决定着这个任务是否会显示在最近使用的应用列表中。如果设置为“true”这个任务将不会显示在最近使用列表中，如果设置为“false”，则会显示。这个属性的默认值是“false”。

android:exported

这个属性用于设置activity是否能被其他应用程序中的组件启动，如果设置为true时，则表示可以，如果设置为“false”则表示不可以，此时的actvity只能被用一个应用或者相同userID的组件启动。这个属性的默认值依赖于activity是否设置了intentfilters。当没有设置任何filter时，此时的activity只能用类名来执行。这就意味着这个activity只能在一个application内部使用。所以在这种情况下，默认值为“false”。另一方面，当activity至少有一个filter时，它可以被外在的组件启动，此时的默认值是“true”。这个属性不是唯一的办法将activity暴露给其他的应用。你也可以使用permission去控制外部的实体执行activity。

关于activity的暴露问题另见：http://blog.csdn.net/ff20081528/article/details/17167803

android:finishOnTaskLaunch

这个属性用于设置当用户重新启动一个task时（重新点击桌面的应用图标），activity是否会被结束掉。如果设置为“true”，则会被结束，如果是“false”则不会。

如果这个属性和allowTaskReparenting属性同时被设置为“true”，这个属性的级别要高于其他属性。

android:hardwareAccelerated

这个属性用于设置activity能否被硬件加速渲染，“true”表示能，“false”表示不能，默认值是“false”。

从Android3.0开始，应用程序能够被OpenGL渲染加速，能够展示很多2D的画面操作。当硬件加速渲染被被设置为true时，大多数的操作在Canvas,Paint,Xfermode,ColorFilter,Shader,和Camera中都会被加速。在面板动画，面板滚动，能提高所有的响应速度，甚至在应用中没有明确的表明framework的OpenGL库。因为增加资源需要使用赢家加速，这将会使用更多的RAM。

注意，不是所有的OpenGL2D操作都会被加速，如果你需要硬件加速渲染，你先要测试你的应用，确保其没有渲染错误。

android:icon

代表activity的图标。该图标显示给用户时，该activity的需要展示在屏幕上。例如，task启动时，图标将会展示在状态栏中。该图标往往伴随着一个标签一起使用（见android:label属性）。

这个属性必须设置为一个图片的应用资源包括图片的定义。如果没有设置，该应用程序作为一个整体所指定的图标来代替（见<application>元素的icon属性）。

该activity的图标-无论是在这里设置或<application>元素-都是所有活动的意图过滤器的默认图标（见<intent-filter>元素的icon属性）。

android:label

用户可读的标签为活动。标签被显示在屏幕上时，该活动必须表示给用户。它通常伴随着活动的图标显示。

如果这个属性没有设置，用于应用程序作为一个整体的标签集代替（见<application>元素的label属性）。

该活动的标签-无论是在这里设置或<application>元素-也是所有活动的意图过滤器的默认标签（见<intent-filter>元素的label属性）。

标签应设置为一个参考的字符串资源，以便它可以被本地化一样在用户界面的其他字符串。然而，作为一种方便你开发的应用程序，同时，它也可以被设置为一个原始字符串。

android:launchMode

这个就不翻译了，感觉文档写的不是很明白，直接看一篇文章吧，说的挺明了的。

http://blog.csdn.net/ff20081528/article/details/17170165

android:multiprocess

一个activity实例是否运行于启动组件的进程中，“true”表示可以，“false”表示不可以，默认值是“false”。

通常，一个activity实例都运行于定义这个应用的进程中，所以很多的activity实例都运行在用一个进程中。然而，如果这个属性设置为“true”，这个activity实例将运行于其他的进程中，不管它在哪里被使用，都允许系统去创建实例（只要有这个权限），只是有的时候这个不是必须的。

android:name

这个属性用于描述activity的名称。Activity的名称描述有两种，一种是全路径的，例如："com.example.project.ExtracurricularActivity"。一种简写是在当前包的路劲后面加上类的名称，例如：".ExtracurricularActivity"。

android:noHistory

当用户离开这个activity时既此activity在屏幕上不可见时，当前activity是否会从activity stack中的移除，或者被结束掉。如果此属性设置为“true”则表示，会被移除并结束，如果是“false”则不会。此属性的默认值是“false”。

如果此属性设置为“true”意味着此activity不会留下历史痕迹。它不会保存在activity stack中，所以用户不会在得到该实例。此属性在API 3中被引进。

android:parentActivityName

逻辑父activity的类名。这个名字必须与<activity>元素中的android:name属性中的值相匹配。

如果设置了这个属性，当用户在actionbar中点击了Upbutton时，系统会读取这个逻辑父类，并启动它。也可以用一个TaskStackBuilder的activity的反回栈来实现这个逻辑。

支持的API级别4-16，你也能用<meta-data>元素来申明逻辑父类，这个值是"android.support.PARENT_ACTIVITY"。例如：

<activity  android:name="com.example.app.ChildActivity"  android:label="@string/title_child_activity"  android:parentActivityName="com.example.myfirstapp.MainActivity" >  <!-- Parent activity meta-data to support API level 4+ -->  <meta-data    android:name="android.support.PARENT_ACTIVITY"    android:value="com.example.app.MainActivity" /></activity>

关于跟多申明逻辑父类的方式请看ProvidingUpNavigation.

android:permission

 客户端必须去启动一个activity或者去相应一个意图的权限的名称。如果一个起动与startActivity()或者startActivityForResult()访问没有权限，这个访问将不会成功，它的intent将不会被传到到这个activity。

 如果这个属性没有设置，那么<application>元素中的权限将会被应用到这个activity当中。如果两个属性都没有设置，这个activity将不会被这个权限所保护。

 更多关于权限的信息，请看Permissions部分的介绍。另见文档，SecurityandPermissions。

android:process

Activity运行的进程的名称。通常，一个应用的所有组件都会运行于一个默认的进程当中，一般你不需要使用这个属性。但是如果需要，你可以使用这个属性来重载这个默认的进程名称，允许你在多进程中去传播你的应用组件。  如果这个进程的名称是以一个冒号开始的（‘:’）,表明这个进程是这个应用的私有进程，当这个activity需要运行时，这个进程将会被创建。如果这个进程是以一个小写字母开通，那么这个进程将是全局的进程。这个允许不同的应用间的组件共享这个进程，以减小系统开销。

 <application>元素的process属性能设置一个不同的默认进程供所有的组件使用。

android:screenOrientation

Activity在屏幕当中显示的方向。属性值可以是下表中列出的一个值：

"unspecified"	默认值，由系统来选择方向。它的使用策略，以及由于选择时特定的上下文环境，可能会因为设备的差异而不同。
"behind"	使用Activity堆栈中与该Activity之下的那个Activity的相同的方向。
"landscape"	横向显示（宽度比高度要大）
"portrait"	纵向显示（高度比宽度要大）
"reverseLandscape"	与正常的横向方向相反显示，在APILevel9中被引入。
"reversePortrait"	与正常的纵向方向相反显示，在APILevel9中被引入。
"sensorLandscape"	横向显示，但是基于设备传感器，既可以是按正常方向显示，也可以反向显示，在APILevel9中被引入。
"sensorPortrait"	纵向显示，但是基于设备传感器，既可以是按正常方向显示，也可以反向显示，在APILevel9中被引入。
"userLandscape"	横向显示，但是基于设备传感器和用户的偏好设置，既可以是按正常方向显示，也可以反向显示。如果用户已锁定基于传感器的旋转，这种行为和landscape效果一样，否则它的行为和sensorLandscape效果一样，这个属性在API级别18中添加。
"userPortrait"	纵向显示，但是基于设备传感器和用户的偏好设置，既可以是按正常方向显示，也可以反向显示。如果用户已锁定基于传感器的旋转，这种行为和portrait效果一样，否则它的行为和sensorPortrait效果一样，这个属性在API级别18中添加。
"sensor"	显示的方向是由设备的方向传感器来决定的。显示方向依赖与用户怎样持有设备；当用户旋转设备时，显示的方向会改变。但是，默认情况下，有些设备不会在所有的四个方向上都旋转，因此要允许在所有的四个方向上都能旋转，就要使用fullSensor属性值。
"fullSensor"	显示的方向（4个方向）是由设备的方向传感器来决定的，除了它允许屏幕有4个显示方向之外，其他与设置为“sensor”时情况类似，不管什么样的设备，通常都会这么做。例如，某些设备通常不使用纵向倒转或横向反转，但是使用这个设置，还是会发生这样的反转。这个值在APILevel9中引入。
"nosensor"	屏幕的显示方向不会参照物理方向传感器。传感器会被忽略，所以显示不会因用户移动设备而旋转。除了这个差别之外，系统会使用与“unspecified”设置相同的策略来旋转屏幕的方向。
"user"	使用用户当前首选的方向。
"fullUser"	如果用户已锁定基于传感器的旋转，这种行为于user效果一样，否则它的行为于fullSensor效果一样，并允许任何4个可能的屏幕方向的。增加与API级别18中。
"locked"	不论发生什么，都锁定屏幕当前的旋转方向。增加与API级别18中。

注意：在给这个属性设置的值是“landscape”或portrait的时候，要考虑硬件对Activity运行的方向要求。正因如此，这些声明的值能够被诸如GooglePlay这样的服务所过滤，以便应用程序只能适用于那些支持Activity所要求的方向的设备。例如，如果声明了“landscape”、“reverseLandscape”、或“sensorLandscape”，那么应用程序就只能适用于那些支持横向显示的设备。但是，还应该使用<uses-feature>元素来明确的声明应用程序所有的屏幕方向是纵向的还是横行的。例如：<uses-featureandroid:name=”android.hardware.screen.portrait”/>。这个设置由GooglePlay提供的纯粹的过滤行为，并且在设备仅支持某个特定的方向时，平台本身并不控制应用程序是否能够被按照。

android:stateNotNeeded

这个属性用于设置activity在被杀死和成功再次启动之前是否保存它的状态。如果设置为“true”它在重新启动后不会关联到死之前的状态，如果是“false”则会关联。默认值是“false”。

通常情况下，在一个activity临时被停止的时候，它会调用onSaveInstanceState()方法来保存这个状态。这个方法会用一个Bundle对象来存储这个状态，然后在activity被重新启动时，这个对象会被传递到onCreate()方法中。如果这个属性被设置为“true”时，在activity被停止时onSaveInstanceState()可能不会被调用，再次启动时onCreate()方法会被传递一个null值来代替bundle对象。

该属性设置为true时，当用户按了Home键，可以保证不用保存原先的状态引用，节省了空间资源，从而可以让Activity不会像默认设置那样Crash掉。

android:taskAffinity

与activity有亲和力的任务。有相同亲和力概念的activities属于同一个任务。根activity的亲和力取决于所在的这个任务的亲和力。

亲和力决定了两件事，一个是activity转移到这个任务（参考allowTaskReparenting属性），第二个是当activity以FLAG_ACTIVITY_NEW_TASK标示启动被任务容纳。（好难翻译）意思就亲和力会决定activity和task的关系，一个是通过allowTaskReparenting属性设置，一个是启动时在intent里面设置了FLAG_ACTIVITY_NEW_TASK。

默认情况下，一个application里面的所有activity都是相同的亲和力。你可以设置这个属性去讲他们分组，甚至可以在不同的应用中将他们的activity定义到同一个任务中。设置一个空的字符串，来指定activity对任何任务都没有亲和力。

如果这个属性没有设置，activity将会继承application的亲和力（参考<application>元素的taskAffinity属性）。一个application的默认亲和力的名称就是这个应用的包名，设置于<manifest>元素中。

android:theme

一个样式资源的应用去设定activity的主题。使用这个主题会自动的设置到activity的上下文中。

如果这个属性没有设置，activity会默认的继承application的主题。如果application的主题也没有设置，activity会默认使用系统的主题。

android:uiOptions

ActivityUI的扩展选项。

必须是下列值之一。

                               值       描述      
           "none"       没有多余的UI选项。这是默认的。      
           "splitActionBarWhenNarrow"       当手机处于横屏状态下时，添加bar位于屏幕的底部，来显示ActionBar的操作项目。而不是少数出现在屏幕上方操作栏中的actionbar，操作栏被分成顶部导航部分和底部的actionitems。这保证了空间的合理利用，而不仅仅是为了actionitems，同时也为在顶部导航和标题元素。菜单项不会分成两个bars，他们总是一起出现。

有关操作栏的详细信息，请参阅ActionBar开发人员指南。

此属性添加于API级别14。

android:windowSoftInputMode

活动的主窗口如何与包含屏幕上的软键盘窗口交互。这个属性的设置将会影响两件事情:

1,软键盘的状态——是否它是隐藏或显示——当活动(Activity)成为用户关注的焦点。

2,活动的主窗口调整——是否减少活动主窗口大小以便腾出空间放软键盘或是否当活动窗口的部分被软键盘覆盖时它的内容的当前焦点是可见的。

它的设置必须是下面列表中的一个值，或一个”state…”值加一个”adjust…”值的组合。在任一组设置多个值——多个”state…”values，例如＆mdash有未定义的结果。各个值之间用|分开。例如:<activityandroid:windowSoftInputMode="stateVisible|adjustResize"...>

在这设置的值(除"stateUnspecified"和"adjustUnspecified"以外)将覆盖在主题中设置的值。

Value	Description
"stateUnspecified"	软键盘的状态(是否它是隐藏或可见)没有被指定。系统将选择一个合适的状态或依赖于主题的设置。这个是为了软件盘行为默认的设置。
"stateUnchanged"	软键盘被保持无论它上次是什么状态，是否可见或隐藏，当主窗口出现在前面时。
"stateHidden"	当用户选择该Activity时，软键盘被隐藏——也就是，当用户确定导航到该Activity时，而不是返回到它由于离开另一个Activity。
"stateAlwaysHidden"	软键盘总是被隐藏的，当该Activity主窗口获取焦点时。
"stateVisible"	软键盘是可见的，当那个是正常合适的时(当用户导航到Activity主窗口时)。
"stateAlwaysVisible"	当用户选择这个Activity时，软键盘是可见的——也就是，当用户确定导航到该Activity时，而不是返回到它由于离开另一个Activity。
"adjustUnspecified"	它不被指定是否该Activity主窗口调整大小以便留出软键盘的空间，或是否窗口上的内容得到屏幕上当前的焦点是可见的。系统将自动选择这些模式中一种主要依赖于是否窗口的内容有任何布局视图能够滚动他们的内容。如果有这样的一个视图，这个窗口将调整大小，这样的假设可以使滚动窗口的内容在一个较小的区域中可见的。这个是主窗口默认的行为设置。
"adjustResize"	该Activity主窗口总是被调整屏幕的大小以便留出软键盘的空间。
"adjustPan"	该Activity主窗口并不调整屏幕的大小以便留出软键盘的空间。相反，当前窗口的内容将自动移动以便当前焦点从不被键盘覆盖和用户能总是看到输入内容的部分。这个通常是不期望比调整大小，因为用户可能关闭软键盘以便获得与被覆盖内容的交互操作。

这个属性在API级别为3中加入。

第一次翻译api，很多地方翻译的不是很通顺，有不好的地方希望读者能提出来，大家一起探讨。

转载请说明出处：http://blog.csdn.net/ff20081528/article/details/17163621