19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpage.title=<application> 22a1b706ec11e53689a2f86cc8e558e74591b462aScott Mainparent.title=The AndroidManifest.xml File 32a1b706ec11e53689a2f86cc8e558e74591b462aScott Mainparent.link=manifest-intro.html 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project@jd:body 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dl class="xml"> 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>syntax:</dt> 86e88c84cbe0a07cb8c7b9ea23d1434bcf2e2a457Scott Main<dd><pre class="stx"><application android:<a href="#reparent">allowTaskReparenting</a>=["true" | "false"] 94e14a829129feee14ebe453f61a124784c870610Christopher Tate android:<a href="#agent">backupAgent</a>="<i>string</i>" 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#debug">debuggable</a>=["true" | "false"] 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#desc">description</a>="<i>string resource</i>" 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#enabled">enabled</a>=["true" | "false"] 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#code">hasCode</a>=["true" | "false"] 1436d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty android:<a href="#hwaccel">hardwareAccelerated</a>=["true" | "false"] 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#icon">icon</a>="<i>drawable resource</i>" 164e14a829129feee14ebe453f61a124784c870610Christopher Tate android:<a href="#killrst">killAfterRestore</a>=["true" | "false"] 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#label">label</a>="<i>string resource</i>" 18c18b534585741e1cc6c8328f7761c906f58c2684Scott Main android:<a href="#logo">logo</a>="<i>drawable resource</i>" 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#space">manageSpaceActivity</a>="<i>string</i>" 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#nm">name</a>="<i>string</i>" 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#prmsn">permission</a>="<i>string</i>" 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#persistent">persistent</a>=["true" | "false"] 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#proc">process</a>="<i>string</i>" 244e14a829129feee14ebe453f61a124784c870610Christopher Tate android:<a href="#restoreany">restoreAnyVersion</a>=["true" | "false"] 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#aff">taskAffinity</a>="<i>string</i>" 26084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main android:<a href="#theme">theme</a>="<i>resource or theme</i>" 27084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main android:<a href="#uioptions">uiOptions</a>=["none" | "splitActionBarWhenNarrow"] > 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project . . . 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</application></pre></dd> 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>contained in:</dt> 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>can contain:</dt> 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/activity-alias-element.html"><activity-alias></a></code> 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code> 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code> 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code> 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/uses-library-element.html"><uses-library></a></code></dd> 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>description:</dt> 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The declaration of the application. This element contains subelements 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthat declare each of the application's components and has attributes 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthat can affect all the components. Many of these attributes (such as 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code icon}, {@code label}, {@code permission}, {@code process}, 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code taskAffinity}, and {@code allowTaskReparenting}) set default values 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectfor corresponding attributes of the component elements. Others (such as 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code debuggable}, {@code enabled}, {@code description}, and 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code allowClearUserData}) set values for the application as a whole and 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcannot be overridden by the components.</dd> 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>attributes</dt> 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><dl class="attr"> 554e14a829129feee14ebe453f61a124784c870610Christopher Tate 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="reparent"></a>{@code android:allowTaskReparenting}</dt> 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not activities that the application defines can move from 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe task that started them to the task they have an affinity for when that task 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectis next brought to the front — "{@code true}" if they can move, and 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project"{@code false}" if they must remain with the task where they started. 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe default value is "{@code false}". 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectelement has its own 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#reparent">allowTaskReparenting</a></code> 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectattribute that can override the value set here. See that attribute for more 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinformation. 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 724e14a829129feee14ebe453f61a124784c870610Christopher Tate<dt><a name="agent"></a>{@code android:backupAgent}</dt> 734e14a829129feee14ebe453f61a124784c870610Christopher Tate<dd>The name of the class that implement's the application's backup agent, 744e14a829129feee14ebe453f61a124784c870610Christopher Tatea subclass of {@link android.app.backup.BackupAgent}. The attribute value should be 754e14a829129feee14ebe453f61a124784c870610Christopher Tatea fully qualified class name (such as, "{@code com.example.project.MyBackupAgent}"). 764e14a829129feee14ebe453f61a124784c870610Christopher TateHowever, as a shorthand, if the first character of the name is a period 774e14a829129feee14ebe453f61a124784c870610Christopher Tate(for example, "{@code .MyBackupAgent}"), it is appended to the 784e14a829129feee14ebe453f61a124784c870610Christopher Tatepackage name specified in the 794e14a829129feee14ebe453f61a124784c870610Christopher Tate<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> 804e14a829129feee14ebe453f61a124784c870610Christopher Tateelement. 814e14a829129feee14ebe453f61a124784c870610Christopher Tate 824e14a829129feee14ebe453f61a124784c870610Christopher Tate<p> 834e14a829129feee14ebe453f61a124784c870610Christopher TateThere is no default. The name must be specified. 844e14a829129feee14ebe453f61a124784c870610Christopher Tate</p></dd> 854e14a829129feee14ebe453f61a124784c870610Christopher Tate 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="debug"></a>{@code android:debuggable}</dt> 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the application can be debugged, even when running 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecton a device in user mode — "{@code true}" if it can be, and "{@code false}" 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectif not. The default value is "{@code false}".</dd> 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="desc"></a>{@code android:description}</dt> 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>User-readable text about the application, longer and more descriptive than the application label. The value must be set as a reference to a string resource. Unlike the label, it cannot be a raw string. There is no default value.</dd> 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="enabled"></a>{@code android:enabled}</dt> 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the Android system can instantiate components of 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe application — "{@code true}" if it can, and "{@code false}" 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectif not. If the value is "{@code true}", each component's 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code enabled} attribute determines whether that component is enabled 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projector not. If the value is "{@code false}", it overrides the 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcomponent-specific values; all components are disabled. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe default value is "{@code true}". 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="code"></a>{@code android:hasCode}</dt> 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the application contains any code — "{@code true}" 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectif it does, and "{@code false}" if not. When the value is "{@code false}", 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe system does not try to load any application code when launching components. 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe default value is "{@code true}". 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectAn application would not have any code of its own only if it's using nothing 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectbut built-in component classes, such as an activity that uses the {@link 11536d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertyandroid.app.AliasActivity} class, a rare occurrence.</p> 11636d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty</dd> 11736d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty 11836d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty<dt><a name="hwaccel"></a>{@code android:hardwareAccelerated}</dt> 11936d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty<dd>Whether or not hardware-accelerated rendering should be enabled for all 12036d2d1b4bfd34f966372631d27717574b1973761Dirk DoughertyActivities and Views in this application — "{@code true}" if it 12136d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertyshould be enabled, and "{@code false}" if not. The default value is "{@code false}". 12236d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty 12336d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty<p>Starting from Android 3.0, a hardware-accelerated OpenGL renderer is 12436d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertyavailable to applications, to improve performance for many common 2D graphics 12536d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertyoperations. When the hardware-accelerated renderer is enabled, most operations 12636d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertyin Canvas, Paint, Xfermode, ColorFilter, Shader, and Camera are accelerated. 12736d2d1b4bfd34f966372631d27717574b1973761Dirk DoughertyThis results in smoother animations, smoother scrolling, and improved 12836d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertyresponsiveness overall, even for applications that do not explicitly make use 12936d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertythe framework's OpenGL libraries. </p> 13036d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty 13136d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty<p>Note that not all of the OpenGL 2D operations are accelerated. If you enable 13236d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertythe hardware-accelerated renderer, test your application to ensure that it can 13336d2d1b4bfd34f966372631d27717574b1973761Dirk Doughertymake use of the renderer without errors.</p> 13436d2d1b4bfd34f966372631d27717574b1973761Dirk Dougherty</dd> 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="icon"></a>{@code android:icon}</dt> 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>An icon for the application as whole, and the default icon for 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecteach of the application's components. See the individual 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code icon} attributes for 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code>, 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-alias-element.html"><activity-alias></a></code>, 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code>, 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code>, and 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code> elements. 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThis attribute must be set as a reference to a drawable resource containing 148c18b534585741e1cc6c8328f7761c906f58c2684Scott Mainthe image (for example {@code "@drawable/icon"}). There is no default icon. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1514e14a829129feee14ebe453f61a124784c870610Christopher Tate<dt><a name="killrst"></a>{@code android:killAfterRestore}</dt> 1524e14a829129feee14ebe453f61a124784c870610Christopher Tate<dd>Whether the application in question should be terminated after its 1534e14a829129feee14ebe453f61a124784c870610Christopher Tatesettings have been restored during a full-system restore operation. 1544e14a829129feee14ebe453f61a124784c870610Christopher TateSingle-package restore operations will never cause the application to 1554e14a829129feee14ebe453f61a124784c870610Christopher Tatebe shut down. Full-system restore operations typically only occur once, 1564e14a829129feee14ebe453f61a124784c870610Christopher Tatewhen the phone is first set up. Third-party applications will not normally 1574e14a829129feee14ebe453f61a124784c870610Christopher Tateneed to use this attribute. 1584e14a829129feee14ebe453f61a124784c870610Christopher Tate 1594e14a829129feee14ebe453f61a124784c870610Christopher Tate<p>The default is {@code true}, which means that after the application 1604e14a829129feee14ebe453f61a124784c870610Christopher Tatehas finished processing its data during a full-system restore, it will be 1614e14a829129feee14ebe453f61a124784c870610Christopher Tateterminated. 1624e14a829129feee14ebe453f61a124784c870610Christopher Tate</p></dd> 1634e14a829129feee14ebe453f61a124784c870610Christopher Tate 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="label"></a>{@code android:label}</dt> 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>A user-readable label for the application as a whole, and a default 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectlabel for each of the application's components. See the individual 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code label} attributes for 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code>, 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-alias-element.html"><activity-alias></a></code>, 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code>, 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code>, and 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code> elements. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe label should be set as a reference to a string resource, so that 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectit can be localized like other strings in the user interface. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectHowever, as a convenience while you're developing the application, 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectit can also be set as a raw string. 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 181c18b534585741e1cc6c8328f7761c906f58c2684Scott Main<dt><a name="logo"></a>{@code android:logo}</dt> 182c18b534585741e1cc6c8328f7761c906f58c2684Scott Main<dd>A logo for the application as whole, and the default logo for activities. 183c18b534585741e1cc6c8328f7761c906f58c2684Scott Main<p>This attribute must be set as a reference to a drawable resource containing 184c18b534585741e1cc6c8328f7761c906f58c2684Scott Mainthe image (for example {@code "@drawable/logo"}). There is no default logo.</p></dd> 185c18b534585741e1cc6c8328f7761c906f58c2684Scott Main 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="space"></a>{@code android:manageSpaceActivity}</dt> 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The fully qualified name of an Activity subclass that the system 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcan launch to let users manage the memory occupied by the application 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecton the device. The activity should also be declared with an 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> element. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</dd> 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="nm"></a>{@code android:name}</dt> 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The fully qualified name of an {@link android.app.Application} 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectsubclass implemented for the application. When the application process 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectis started, this class is instantiated before any of the application's 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcomponents. 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe subclass is optional; most applications won't need one. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectIn the absence of a subclass, Android uses an instance of the base 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectApplication class. 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="prmsn"></a>{@code android:permission}</dt> 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The name of a permission that clients must have in order to interact 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectwith the application. This attribute is a convenient way to set a 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpermission that applies to all of the application's components. It can 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectbe overwritten by setting the {@code permission} attributes of individual 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcomponents. 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectFor more information on permissions, see the 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<a href="{@docRoot}guide/topics/manifest/manifest-intro.html#sectperm">Permissions</a> 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectsection in the introduction and another document, 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<a href="{@docRoot}guide/topics/security/security.html">Security and 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectPermissions</a>. 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="persistent"></a>{@code android:persistent}</dt> 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the application should remain running at all times — 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project"{@code true}" if it should, and "{@code false}" if not. The default value 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectis "{@code false}". Applications should not normally set this flag; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpersistence mode is intended only for certain system applications.</dd> 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="proc"></a>{@code android:process}</dt> 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The name of a process where all components of the application should run. 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectEach component can override this default by setting its own {@code process} 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectattribute. 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectBy default, Android creates a process for an application when the first 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectof its components needs to run. All components then run in that process. 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe name of the default process matches the package name set by the 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> element. 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p> 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p>By setting this attribute to a process name that's shared with another 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectapplication, you can arrange for components of both applications to run in 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe same process — but only if the two applications also share a 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectuser ID and be signed with the same certificate. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p> 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectIf the name assigned to this attribute begins with a colon (':'), a new 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectprocess, private to the application, is created when it's needed. 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectIf the process name begins with a lowercase character, a global process 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectof that name is created. A global process can be shared with other 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectapplications, reducing resource usage. 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 252cd1b08e1e239269f7d0d48119505313f52d3dd5aScott Main<dt><a name="restoreany"></a>{@code android:restoreAnyVersion}</dt> 2534e14a829129feee14ebe453f61a124784c870610Christopher Tate<dd>Indicate that the application is prepared to attempt a restore of any 2544e14a829129feee14ebe453f61a124784c870610Christopher Tatebacked-up data set, even if the backup was stored by a newer version 2554e14a829129feee14ebe453f61a124784c870610Christopher Tateof the application than is currently installed on the device. Setting 2564e14a829129feee14ebe453f61a124784c870610Christopher Tatethis attribute to {@code true} will permit the Backup Manager to 2574e14a829129feee14ebe453f61a124784c870610Christopher Tateattempt restore even when a version mismatch suggests that the data are 2584e14a829129feee14ebe453f61a124784c870610Christopher Tateincompatible. <em>Use with caution!</em> 2594e14a829129feee14ebe453f61a124784c870610Christopher Tate 2604e14a829129feee14ebe453f61a124784c870610Christopher Tate<p>The default value of this attribute is {@code false}. 2614e14a829129feee14ebe453f61a124784c870610Christopher Tate</p></dd> 2624e14a829129feee14ebe453f61a124784c870610Christopher Tate 263cd1b08e1e239269f7d0d48119505313f52d3dd5aScott Main<dt><a name="aff"></a>{@code android:taskAffinity}</dt> 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>An affinity name that applies to all activities within the application, 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectexcept for those that set a different affinity with their own 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#aff">taskAffinity</a></code> 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectattributes. See that attribute for more information. 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectBy default, all activities within an application share the same 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectaffinity. The name of that affinity is the same as the package name 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectset by the 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> element. 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="theme"></a>{@code android:theme}</dt> 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>A reference to a style resource defining a default theme for all 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectactivities in the application. Individual activities can override 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe default by setting their own <code><a href="{@docRoot}guide/topics/manifest/activity-element.html#theme">theme</a></code> 280084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainattributes. For more information, see the <a 281084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainhref="{@docRoot}guide/topics/ui/themes.html">Styles and Themes</a> developer guide. 282084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main</dd> 283084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main 284084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main<!-- ##api level 14## --> 285084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main<dt><a name="uioptions"></a>{@code android:uiOptions}</dt> 286084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main<dd>Extra options for an activity's UI. 287084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main <p>Must be one of the following values.</p> 288084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main 289084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main <table> 290084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main <tr><th>Value</th><th>Description</th></tr> 291084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main <tr><td>{@code "none"}</td><td>No extra UI options. This is the default.</td></tr> 292084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main <tr><td>{@code "splitActionBarWhenNarrow"}</td><td>Add a bar at 293084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainthe bottom of the screen to display action items in the {@link android.app.ActionBar}, when 294084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainconstrained for horizontal space (such as when in portrait mode on a handset). Instead of a small 295084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainnumber of action items appearing in the action bar at the top of the screen, the action bar is 296084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainsplit into the top navigation section and the bottom bar for action items. This ensures a reasonable 297084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainamount of space is made available not only for the action items, but also for navigation and title 298084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainelements at the top. Menu items are not split across the two bars; they always appear 299084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Maintogether.</td></tr> 300084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main </table> 301084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main <p>For more information about the action bar, see the <a 302084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Mainhref="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer guide.</p> 303084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main <p>This attribute was added in API level 14.</p> 304084369fb5e738e4db6ae94b4e24e777bdd9d9c2cScott Main</dd> 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</dl></dd> 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3089c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty<!-- ##api level indication## --> 3099c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty<dt>introduced in:</dt> 3109c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty<dd>API Level 1</dd> 3119c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>see also:</dt> 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code> 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code> 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code></dd> 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</dl> 319