application-element.jd revision 6e88c84cbe0a07cb8c7b9ea23d1434bcf2e2a457
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpage.title=<application> 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project@jd:body 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dl class="xml"> 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>syntax:</dt> 66e88c84cbe0a07cb8c7b9ea23d1434bcf2e2a457Scott Main<dd><pre class="stx"><application android:<a href="#reparent">allowTaskReparenting</a>=["true" | "false"] 74e14a829129feee14ebe453f61a124784c870610Christopher Tate android:<a href="#agent">backupAgent</a>="<i>string</i>" 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#debug">debuggable</a>=["true" | "false"] 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#desc">description</a>="<i>string resource</i>" 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#enabled">enabled</a>=["true" | "false"] 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#code">hasCode</a>=["true" | "false"] 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#icon">icon</a>="<i>drawable resource</i>" 134e14a829129feee14ebe453f61a124784c870610Christopher Tate android:<a href="#killrst">killAfterRestore</a>=["true" | "false"] 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#label">label</a>="<i>string resource</i>" 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#space">manageSpaceActivity</a>="<i>string</i>" 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#nm">name</a>="<i>string</i>" 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#prmsn">permission</a>="<i>string</i>" 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#persistent">persistent</a>=["true" | "false"] 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#proc">process</a>="<i>string</i>" 204e14a829129feee14ebe453f61a124784c870610Christopher Tate android:<a href="#restoreany">restoreAnyVersion</a>=["true" | "false"] 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#aff">taskAffinity</a>="<i>string</i>" 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project android:<a href="#theme">theme</a>="<i>resource or theme</i>" > 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project . . . 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</application></pre></dd> 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>contained in:</dt> 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>can contain:</dt> 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/activity-alias-element.html"><activity-alias></a></code> 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code> 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code> 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code> 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/uses-library-element.html"><uses-library></a></code></dd> 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>description:</dt> 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The declaration of the application. This element contains subelements 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthat declare each of the application's components and has attributes 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthat can affect all the components. Many of these attributes (such as 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code icon}, {@code label}, {@code permission}, {@code process}, 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code taskAffinity}, and {@code allowTaskReparenting}) set default values 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectfor corresponding attributes of the component elements. Others (such as 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code debuggable}, {@code enabled}, {@code description}, and 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code allowClearUserData}) set values for the application as a whole and 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcannot be overridden by the components.</dd> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>attributes</dt> 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><dl class="attr"> 504e14a829129feee14ebe453f61a124784c870610Christopher Tate 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="reparent"></a>{@code android:allowTaskReparenting}</dt> 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not activities that the application defines can move from 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe task that started them to the task they have an affinity for when that task 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectis next brought to the front — "{@code true}" if they can move, and 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project"{@code false}" if they must remain with the task where they started. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe default value is "{@code false}". 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectelement has its own 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#reparent">allowTaskReparenting</a></code> 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectattribute that can override the value set here. See that attribute for more 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinformation. 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 674e14a829129feee14ebe453f61a124784c870610Christopher Tate<dt><a name="agent"></a>{@code android:backupAgent}</dt> 684e14a829129feee14ebe453f61a124784c870610Christopher Tate<dd>The name of the class that implement's the application's backup agent, 694e14a829129feee14ebe453f61a124784c870610Christopher Tatea subclass of {@link android.app.backup.BackupAgent}. The attribute value should be 704e14a829129feee14ebe453f61a124784c870610Christopher Tatea fully qualified class name (such as, "{@code com.example.project.MyBackupAgent}"). 714e14a829129feee14ebe453f61a124784c870610Christopher TateHowever, as a shorthand, if the first character of the name is a period 724e14a829129feee14ebe453f61a124784c870610Christopher Tate(for example, "{@code .MyBackupAgent}"), it is appended to the 734e14a829129feee14ebe453f61a124784c870610Christopher Tatepackage name specified in the 744e14a829129feee14ebe453f61a124784c870610Christopher Tate<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> 754e14a829129feee14ebe453f61a124784c870610Christopher Tateelement. 764e14a829129feee14ebe453f61a124784c870610Christopher Tate 774e14a829129feee14ebe453f61a124784c870610Christopher Tate<p> 784e14a829129feee14ebe453f61a124784c870610Christopher TateThere is no default. The name must be specified. 794e14a829129feee14ebe453f61a124784c870610Christopher Tate</p></dd> 804e14a829129feee14ebe453f61a124784c870610Christopher Tate 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="debug"></a>{@code android:debuggable}</dt> 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the application can be debugged, even when running 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecton a device in user mode — "{@code true}" if it can be, and "{@code false}" 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectif not. The default value is "{@code false}".</dd> 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="desc"></a>{@code android:description}</dt> 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The 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> 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="enabled"></a>{@code android:enabled}</dt> 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the Android system can instantiate components of 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe application — "{@code true}" if it can, and "{@code false}" 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectif not. If the value is "{@code true}", each component's 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code enabled} attribute determines whether that component is enabled 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projector not. If the value is "{@code false}", it overrides the 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcomponent-specific values; all components are disabled. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe default value is "{@code true}". 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="code"></a>{@code android:hasCode}</dt> 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the application contains any code — "{@code true}" 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectif it does, and "{@code false}" if not. When the value is "{@code false}", 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe system does not try to load any application code when launching components. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe default value is "{@code true}". 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectAn application would not have any code of its own only if it's using nothing 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectbut built-in component classes, such as an activity that uses the {@link 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectandroid.app.AliasActivity} class, a rare occurrence. 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="icon"></a>{@code android:icon}</dt> 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>An icon for the application as whole, and the default icon for 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecteach of the application's components. See the individual 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code icon} attributes for 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code>, 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-alias-element.html"><activity-alias></a></code>, 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code>, 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code>, and 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code> elements. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThis attribute must be set as a reference to a drawable resource containing 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe image definition. There is no default icon. 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1274e14a829129feee14ebe453f61a124784c870610Christopher Tate<dt><a name="killrst"></a>{@code android:killAfterRestore}</dt> 1284e14a829129feee14ebe453f61a124784c870610Christopher Tate<dd>Whether the application in question should be terminated after its 1294e14a829129feee14ebe453f61a124784c870610Christopher Tatesettings have been restored during a full-system restore operation. 1304e14a829129feee14ebe453f61a124784c870610Christopher TateSingle-package restore operations will never cause the application to 1314e14a829129feee14ebe453f61a124784c870610Christopher Tatebe shut down. Full-system restore operations typically only occur once, 1324e14a829129feee14ebe453f61a124784c870610Christopher Tatewhen the phone is first set up. Third-party applications will not normally 1334e14a829129feee14ebe453f61a124784c870610Christopher Tateneed to use this attribute. 1344e14a829129feee14ebe453f61a124784c870610Christopher Tate 1354e14a829129feee14ebe453f61a124784c870610Christopher Tate<p>The default is {@code true}, which means that after the application 1364e14a829129feee14ebe453f61a124784c870610Christopher Tatehas finished processing its data during a full-system restore, it will be 1374e14a829129feee14ebe453f61a124784c870610Christopher Tateterminated. 1384e14a829129feee14ebe453f61a124784c870610Christopher Tate</p></dd> 1394e14a829129feee14ebe453f61a124784c870610Christopher Tate 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="label"></a>{@code android:label}</dt> 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>A user-readable label for the application as a whole, and a default 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectlabel for each of the application's components. See the individual 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{@code label} attributes for 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code>, 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-alias-element.html"><activity-alias></a></code>, 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code>, 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code>, and 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code> elements. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe label should be set as a reference to a string resource, so that 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectit can be localized like other strings in the user interface. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectHowever, as a convenience while you're developing the application, 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectit can also be set as a raw string. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="space"></a>{@code android:manageSpaceActivity}</dt> 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The fully qualified name of an Activity subclass that the system 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcan launch to let users manage the memory occupied by the application 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecton the device. The activity should also be declared with an 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> element. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</dd> 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="nm"></a>{@code android:name}</dt> 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The fully qualified name of an {@link android.app.Application} 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectsubclass implemented for the application. When the application process 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectis started, this class is instantiated before any of the application's 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcomponents. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe subclass is optional; most applications won't need one. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectIn the absence of a subclass, Android uses an instance of the base 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectApplication class. 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="prmsn"></a>{@code android:permission}</dt> 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The name of a permission that clients must have in order to interact 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectwith the application. This attribute is a convenient way to set a 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpermission that applies to all of the application's components. It can 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectbe overwritten by setting the {@code permission} attributes of individual 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectcomponents. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectFor more information on permissions, see the 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<a href="{@docRoot}guide/topics/manifest/manifest-intro.html#sectperm">Permissions</a> 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectsection in the introduction and another document, 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<a href="{@docRoot}guide/topics/security/security.html">Security and 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectPermissions</a>. 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="persistent"></a>{@code android:persistent}</dt> 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>Whether or not the application should remain running at all times — 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project"{@code true}" if it should, and "{@code false}" if not. The default value 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectis "{@code false}". Applications should not normally set this flag; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpersistence mode is intended only for certain system applications.</dd> 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="proc"></a>{@code android:process}</dt> 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>The name of a process where all components of the application should run. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectEach component can override this default by setting its own {@code process} 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectattribute. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectBy default, Android creates a process for an application when the first 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectof its components needs to run. All components then run in that process. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectThe name of the default process matches the package name set by the 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> element. 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p> 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p>By setting this attribute to a process name that's shared with another 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectapplication, you can arrange for components of both applications to run in 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe same process — but only if the two applications also share a 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectuser ID and be signed with the same certificate. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p> 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectIf the name assigned to this attribute begins with a colon (':'), a new 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectprocess, private to the application, is created when it's needed. 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectIf the process name begins with a lowercase character, a global process 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectof that name is created. A global process can be shared with other 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectapplications, reducing resource usage. 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2234e14a829129feee14ebe453f61a124784c870610Christopher Tate<dt><a href name="restoreany"></a>{@code android:restoreAnyVersion}</dt> 2244e14a829129feee14ebe453f61a124784c870610Christopher Tate<dd>Indicate that the application is prepared to attempt a restore of any 2254e14a829129feee14ebe453f61a124784c870610Christopher Tatebacked-up data set, even if the backup was stored by a newer version 2264e14a829129feee14ebe453f61a124784c870610Christopher Tateof the application than is currently installed on the device. Setting 2274e14a829129feee14ebe453f61a124784c870610Christopher Tatethis attribute to {@code true} will permit the Backup Manager to 2284e14a829129feee14ebe453f61a124784c870610Christopher Tateattempt restore even when a version mismatch suggests that the data are 2294e14a829129feee14ebe453f61a124784c870610Christopher Tateincompatible. <em>Use with caution!</em> 2304e14a829129feee14ebe453f61a124784c870610Christopher Tate 2314e14a829129feee14ebe453f61a124784c870610Christopher Tate<p>The default value of this attribute is {@code false}. 2324e14a829129feee14ebe453f61a124784c870610Christopher Tate</p></dd> 2334e14a829129feee14ebe453f61a124784c870610Christopher Tate 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a href name="aff"></a>{@code android:taskAffinity}</dt> 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>An affinity name that applies to all activities within the application, 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectexcept for those that set a different affinity with their own 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#aff">taskAffinity</a></code> 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectattributes. See that attribute for more information. 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<p> 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source ProjectBy default, all activities within an application share the same 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectaffinity. The name of that affinity is the same as the package name 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectset by the 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> element. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</p></dd> 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt><a name="theme"></a>{@code android:theme}</dt> 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd>A reference to a style resource defining a default theme for all 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectactivities in the application. Individual activities can override 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectthe default by setting their own <code><a href="{@docRoot}guide/topics/manifest/activity-element.html#theme">theme</a></code> 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectattributes; see that attribute for more information.</dd> 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</dl></dd> 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2559c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty<!-- ##api level indication## --> 2569c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty<dt>introduced in:</dt> 2579c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty<dd>API Level 1</dd> 2589c3209db78bf171f5055baae376f7bdfdfba4a9fDirk Dougherty 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dt>see also:</dt> 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<dd><code><a href="{@docRoot}guide/topics/manifest/activity-element.html"><activity></a></code> 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/service-element.html"><service></a></code> 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver></a></code> 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project<br/><code><a href="{@docRoot}guide/topics/manifest/provider-element.html"><provider></a></code></dd> 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project</dl> 266