1<?xml version="1.0" encoding="utf-8"?>
2<!--
3/* Copyright 2006, The Android Open Source Project
4**
5** Licensed under the Apache License, Version 2.0 (the "License");
6** you may not use this file except in compliance with the License.
7** You may obtain a copy of the License at
8**
9**     http://www.apache.org/licenses/LICENSE-2.0
10**
11** Unless required by applicable law or agreed to in writing, software
12** distributed under the License is distributed on an "AS IS" BASIS,
13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14** See the License for the specific language governing permissions and
15** limitations under the License.
16*/
17-->
18<resources>
19    <!-- **************************************************************** -->
20    <!-- These are the attributes used in AndroidManifest.xml. -->
21    <!-- **************************************************************** -->
22    <eat-comment />
23
24    <!-- The overall theme to use for an activity.  Use with either the
25         application tag (to supply a default theme for all activities) or
26         the activity tag (to supply a specific theme for that activity).
27
28         <p>This automatically sets
29         your activity's Context to use this theme, and may also be used
30         for "starting" animations prior to the activity being launched (to
31         better match what the activity actually looks like).  It is a reference
32         to a style resource defining the theme.  If not set, the default
33         system theme will be used. -->
34    <attr name="theme" format="reference" />
35
36    <!-- A user-legible name for the given item.  Use with the
37         application tag (to supply a default label for all application
38         components), or with the activity, receiver, service, or instrumentation
39         tag (to supply a specific label for that component).  It may also be
40         used with the intent-filter tag to supply a label to show to the
41         user when an activity is being selected based on a particular Intent.
42
43         <p>The given label will be used wherever the user sees information
44         about its associated component; for example, as the name of a
45         main activity that is displayed in the launcher.  You should
46         generally set this to a reference to a string resource, so that
47         it can be localized, however it is also allowed to supply a plain
48         string for quick and dirty programming. -->
49    <attr name="label" format="reference|string" />
50
51    <!-- A Drawable resource providing a graphical representation of its
52         associated item.  Use with the
53         application tag (to supply a default icon for all application
54         components), or with the activity, receiver, service, or instrumentation
55         tag (to supply a specific icon for that component).  It may also be
56         used with the intent-filter tag to supply an icon to show to the
57         user when an activity is being selected based on a particular Intent.
58
59         <p>The given icon will be used to display to the user a graphical
60         representation of its associated component; for example, as the icon
61         for main activity that is displayed in the launcher.  This must be
62         a reference to a Drawable resource containing the image definition. -->
63    <attr name="icon" format="reference" />
64
65    <!-- A Drawable resource providing a graphical representation of its
66         associated item.  Use with the
67         application tag (to supply a default round icon for all application
68         components), or with the activity, receiver, service, or instrumentation
69         tag (to supply a specific round icon for that component).  It may also be
70         used with the intent-filter tag to supply a round icon to show to the
71         user when an activity is being selected based on a particular Intent.
72
73         <p>The given round icon will be used to display to the user a graphical
74         representation of its associated component; for example, as the round icon
75         for main activity that is displayed in the launcher.  This must be
76         a reference to a Drawable resource containing the image definition. -->
77    <attr name="roundIcon" format="reference" />
78
79    <!-- A Drawable resource providing an extended graphical banner for its
80         associated item. Use with the application tag (to supply a default
81         banner for all application activities), or with the activity, tag to
82         supply a banner for a specific activity.
83
84         <p>The given banner will be used to display to the user a graphical
85         representation of an activity in the Leanback application launcher.
86         Since banners are displayed only in the Leanback launcher, they should
87         only be used with activities (and applications) that support Leanback
88         mode. These are activities that handle Intents of category
89         {@link android.content.Intent#CATEGORY_LEANBACK_LAUNCHER
90         Intent.CATEGORY_LEANBACK_LAUNCHER}.
91         <p>This must be a reference to a Drawable resource containing the image definition. -->
92    <attr name="banner" format="reference" />
93
94    <!-- A Drawable resource providing an extended graphical logo for its
95         associated item. Use with the application tag (to supply a default
96         logo for all application components), or with the activity, receiver,
97         service, or instrumentation tag (to supply a specific logo for that
98         component). It may also be used with the intent-filter tag to supply
99         a logo to show to the user when an activity is being selected based
100         on a particular Intent.
101
102         <p>The given logo will be used to display to the user a graphical
103         representation of its associated component; for example as the
104         header in the Action Bar. The primary differences between an icon
105         and a logo are that logos are often wider and more detailed, and are
106         used without an accompanying text caption. This must be a reference
107         to a Drawable resource containing the image definition. -->
108    <attr name="logo" format="reference" />
109
110    <!-- Name of the activity to be launched to manage application's space on
111         device. The specified activity gets automatically launched when the
112         application's space needs to be managed and is usually invoked
113         through user actions. Applications can thus provide their own custom
114         behavior for managing space for various scenarios like out of memory
115         conditions. This is an optional attribute and
116         applications can choose not to specify a default activity to
117         manage space. -->
118    <attr name="manageSpaceActivity" format="string" />
119
120    <!-- Option to let applications specify that user data can/cannot be
121         cleared. This flag is turned on by default.
122         <p>Starting from API level 29 this flag only controls if the user can
123         clear app data from Settings. To control clearing the data after a
124         failed restore use allowClearUserDataOnFailedRestore flag.
125         <p><em>This attribute is usable only by applications
126         included in the system image. Third-party apps cannot use it.</em> -->
127    <attr name="allowClearUserData" format="boolean" />
128
129    <!-- Option to indicate this application is only for testing purposes.
130         For example, it may expose functionality or data outside of itself
131         that would cause a security hole, but is useful for testing.  This
132         kind of application can not be installed without the
133         INSTALL_ALLOW_TEST flag, which means only through adb install.  -->
134    <attr name="testOnly" format="boolean" />
135
136    <!-- A unique name for the given item.  This must use a Java-style naming
137         convention to ensure the name is unique, for example
138         "com.mycompany.MyName". -->
139    <attr name="name" format="string" />
140
141    <!-- Specify a permission that a client is required to have in order to
142    	 use the associated object.  If the client does not hold the named
143    	 permission, its request will fail.  See the
144         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
145         document for more information on permissions. -->
146    <attr name="permission" format="string" />
147
148    <!-- A specific {@link android.R.attr#permission} name for read-only
149         access to a {@link android.content.ContentProvider}.  See the
150         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
151         document for more information on permissions. -->
152    <attr name="readPermission" format="string" />
153
154    <!-- A specific {@link android.R.attr#permission} name for write
155         access to a {@link android.content.ContentProvider}.  See the
156         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
157         document for more information on permissions. -->
158    <attr name="writePermission" format="string" />
159
160    <!-- If true, the {@link android.content.Context#grantUriPermission
161         Context.grantUriPermission} or corresponding Intent flags can
162         be used to allow others to access specific URIs in the content
163         provider, even if they do not have an explicit read or write
164         permission.  If you are supporting this feature, you must be
165         sure to call {@link android.content.Context#revokeUriPermission
166         Context.revokeUriPermission} when URIs are deleted from your
167         provider.-->
168    <attr name="grantUriPermissions" format="boolean" />
169
170    <!-- If true, the system will always create URI permission grants
171         in the cases where {@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION}
172         or {@link android.content.Intent#FLAG_GRANT_WRITE_URI_PERMISSION} would apply.
173         This is useful for a content provider that dynamically enforces permissions
174         on calls in to the provider, instead of through the manifest: the system
175         needs to know that it should always apply permission grants, even if it
176         looks like the target of the grant would already have access to the URI. -->
177    <attr name="forceUriPermissions" format="boolean" />
178
179    <!-- Characterizes the potential risk implied in a permission and
180         indicates the procedure the system should follow when determining
181         whether to grant the permission to an application requesting it. {@link
182         android.Manifest.permission Standard permissions} have a predefined and
183         permanent protectionLevel. If you are creating a custom permission in an
184         application, you can define a protectionLevel attribute with one of the
185         values listed below. If no protectionLevel is defined for a custom
186         permission, the system assigns the default ("normal").
187         <p>Each protection level consists of a base permission type and zero or
188         more flags. Use the following functions to extract those.
189         <pre>
190         int basePermissionType = permissionInfo.getProtection();
191         int permissionFlags = permissionInfo.getProtectionFlags();
192         </pre>
193         -->
194    <attr name="protectionLevel">
195        <!-- <strong>Base permission type</strong>: a lower-risk permission that gives
196             an application access to isolated application-level features, with minimal
197             risk to other applications, the system, or the user. The system
198             automatically grants this type of permission to a requesting application at
199             installation, without asking for the user's explicit approval (though the
200             user always has the option to review these permissions before installing). -->
201        <flag name="normal" value="0" />
202        <!-- <strong>Base permission type</strong>: a higher-risk permission that
203             would give a requesting application access to private user data or
204             control over the device that can negatively impact the user.  Because
205             this type of permission introduces potential risk, the system may
206             not automatically grant it to the requesting application.  For example,
207             any dangerous permissions requested by an application may be displayed
208             to the user and require confirmation before proceeding, or some other
209             approach may be taken to avoid the user automatically allowing
210             the use of such facilities.  -->
211        <flag name="dangerous" value="1" />
212        <!-- <strong>Base permission type</strong>: a permission that the system is
213             to grant only if the requesting application is signed with the same
214             certificate as the application that declared the permission. If the
215             certificates match, the system automatically grants the permission
216             without notifying the user or asking for the user's explicit approval. -->
217        <flag name="signature" value="2" />
218        <!-- Old synonym for "signature|privileged". Deprecated in API level 23.
219             Base permission type: a permission that the system is to grant only
220             to packages in the Android system image <em>or</em> that are signed
221             with the same certificates. Please avoid using this option, as the
222             signature protection level should be sufficient for most needs and
223             works regardless of exactly where applications are installed.  This
224             permission is used for certain special situations where multiple
225             vendors have applications built in to a system image which need
226             to share specific features explicitly because they are being built
227             together. -->
228        <flag name="signatureOrSystem" value="3" />
229        <!-- <strong>Base permission type</strong>: a permission that is managed internally by the
230             system and only granted according to the protection flags. -->
231        <flag name="internal" value="4" />
232        <!-- Additional flag from base permission type: this permission can also
233             be granted to any applications installed as privileged apps on the system image.
234             Please avoid using this option, as the
235             signature protection level should be sufficient for most needs and
236             works regardless of exactly where applications are installed.  This
237             permission flag is used for certain special situations where multiple
238             vendors have applications built in to a system image which need
239             to share specific features explicitly because they are being built
240             together. -->
241        <flag name="privileged" value="0x10" />
242        <!-- Old synonym for "privileged". Deprecated in API level 23. -->
243        <flag name="system" value="0x10" />
244        <!-- Additional flag from base permission type: this permission can also
245             (optionally) be granted to development applications. Although undocumented, the
246              permission state used to be shared by all users (including future users), but it is
247              managed per-user since API level 31. -->
248        <flag name="development" value="0x20" />
249        <!-- Additional flag from base permission type: this permission is closely
250             associated with an app op for controlling access. -->
251        <flag name="appop" value="0x40" />
252        <!-- Additional flag from base permission type: this permission can be automatically
253             granted to apps that target API levels below
254             {@link android.os.Build.VERSION_CODES#M} (before runtime permissions
255             were introduced). -->
256        <flag name="pre23" value="0x80" />
257        <!-- Additional flag from base permission type: this permission can be automatically
258            granted to system apps that install packages. -->
259        <flag name="installer" value="0x100" />
260        <!-- Additional flag from base permission type: this permission can be automatically
261            granted to system apps that verify packages. -->
262        <flag name="verifier" value="0x200" />
263        <!-- Additional flag from base permission type: this permission can be automatically
264            granted any application pre-installed on the system image (not just privileged
265            apps). -->
266        <flag name="preinstalled" value="0x400" />
267        <!-- Additional flag from base permission type: this permission can be automatically
268            granted to the setup wizard app -->
269        <flag name="setup" value="0x800" />
270        <!-- Additional flag from base permission type: this permission can be granted to instant
271             apps -->
272        <flag name="instant" value="0x1000" />
273        <!-- Additional flag from base permission type: this permission can only be granted to apps
274             that target runtime permissions ({@link android.os.Build.VERSION_CODES#M} and above)
275             -->
276        <flag name="runtime" value="0x2000" />
277        <!-- Additional flag from base permission type: this permission can be granted only
278             if its protection level is signature, the requesting app resides on the OEM partition,
279             and the OEM has allowlisted the app to receive this permission by the OEM.
280         -->
281        <flag name="oem" value="0x4000" />
282        <!-- Additional flag from base permission type: this permission can be granted to
283             privileged apps in vendor partition. -->
284        <flag name="vendorPrivileged" value="0x8000" />
285        <!-- Additional flag from base permission type: this permission can be automatically
286            granted to the system default text classifier -->
287        <flag name="textClassifier" value="0x10000" />
288        <!-- Additional flag from base permission type: this permission automatically
289            granted to device configurator -->
290        <flag name="configurator" value="0x80000" />
291        <!-- Additional flag from base permission type: this permission designates the app
292            that will approve the sharing of incident reports. -->
293        <flag name="incidentReportApprover" value="0x100000" />
294        <!-- Additional flag from base permission type: this permission can be automatically
295            granted to the system app predictor -->
296        <flag name="appPredictor" value="0x200000" />
297        <!-- Additional flag from base permission type: this permission can also be granted if the
298             requesting application is included in the mainline module}. -->
299        <flag name="module" value="0x400000" />
300        <!-- Additional flag from base permission type: this permission can be automatically
301            granted to the system companion device manager service -->
302        <flag name="companion" value="0x800000" />
303        <!-- Additional flag from base permission type: this permission will be granted to the
304             retail demo app, as defined by the OEM. -->
305        <flag name="retailDemo" value="0x1000000" />
306        <!-- Additional flag from base permission type: this permission will be granted to the
307             recents app. -->
308        <flag name="recents" value="0x2000000" />
309        <!-- Additional flag from base permission type: this permission is managed by role. -->
310        <flag name="role" value="0x4000000" />
311        <!-- Additional flag from base permission type: this permission can also be granted if the
312             requesting application is signed by, or has in its signing lineage, any of the
313             certificate digests declared in {@link android.R.attr#knownCerts}. -->
314        <flag name="knownSigner" value="0x8000000" />
315    </attr>
316
317    <!-- Flags indicating more context for a permission group. -->
318    <attr name="permissionGroupFlags">
319        <!-- Set to indicate that this permission group contains permissions
320             protecting access to some information that is considered
321             personal to the user (such as contacts, e-mails, etc). -->
322        <flag name="personalInfo" value="0x0001" />
323    </attr>
324
325    <!-- Flags indicating more context for a permission. -->
326    <attr name="permissionFlags">
327        <!-- Set to indicate that this permission allows an operation that
328             may cost the user money.  Such permissions may be highlighted
329             when shown to the user with this additional information.  -->
330        <flag name="costsMoney" value="0x1" />
331        <!-- Additional flag from base permission type: this permission has been
332             removed and it is no longer enforced. It shouldn't be shown in the
333             UI. Removed permissions are kept as normal permissions for backwards
334             compatibility as apps may be checking them before calling an API.
335        -->
336        <flag name="removed" value="0x2" />
337        <!-- This permission is restricted by the platform and it would be
338             grantable only to apps that meet special criteria per platform
339             policy.
340        -->
341        <flag name="hardRestricted" value="0x4" />
342        <!-- This permission is restricted by the platform and it would be
343             grantable in its full form to apps that meet special criteria
344             per platform policy. Otherwise, a weaker form of the permission
345             would be granted. The weak grant depends on the permission.
346             <p>What weak grant means is described in the documentation of
347             the permissions.
348        -->
349        <flag name="softRestricted" value="0x8" />
350        <!-- This permission is restricted immutably which means that its
351             restriction state may be specified only on the first install of
352             the app and will stay in this initial allowlist state until
353             the app is uninstalled.
354        -->
355        <flag name="immutablyRestricted" value="0x10" />
356        <!--
357             Modifier for permission restriction. This permission cannot
358             be exempted by the installer.
359        -->
360        <flag name="installerExemptIgnored" value="0x20" />
361    </attr>
362
363    <!-- Specified the name of a group that this permission is associated
364         with.  The group must have been defined with the
365         {@link android.R.styleable#AndroidManifestPermissionGroup permission-group} tag. -->
366    <attr name="permissionGroup" format="string" />
367
368    <!-- A reference to an array resource containing the signing certificate digests to be granted
369         this permission when using the {@code knownSigner} protection flag. The digest should
370         be computed over the DER encoding of the trusted certificate using the SHA-256 digest
371         algorithm.
372         <p>
373         If only a single signer is declared this can also be a string resource, or the digest
374         can be declared inline as the value for this attribute. -->
375    <attr name="knownCerts" format="reference|string" />
376
377    <!-- Specify the name of a user ID that will be shared between multiple
378         packages.  By default, each package gets its own unique user-id.
379         By setting this value on two or more packages, each of these packages
380         will be given a single shared user ID, so they can for example run
381         in the same process.  Note that for them to actually get the same
382         user ID, they must also be signed with the same signature.
383         @deprecated Shared user IDs cause non-deterministic behavior within the
384         package manager. As such, its use is strongly discouraged and may be
385         removed in a future version of Android. Instead, apps should use proper
386         communication mechanisms, such as services and content providers,
387         to facilitate interoperability between shared components. Note that
388         existing apps cannot remove this value, as migrating off a
389         shared user ID is not supported. -->
390    <attr name="sharedUserId" format="string" />
391
392    <!-- Specify a label for the shared user UID of this package.  This is
393         only used if you have also used android:sharedUserId.  This must
394         be a reference to a string resource; it can not be an explicit
395         string.
396         @deprecated There is no replacement for this attribute.
397         {@link android.R.attr#sharedUserId} has been deprecated making
398         this attribute unnecessary. -->
399    <attr name="sharedUserLabel" format="reference" />
400
401    <!-- The maximum device SDK version for which the application will remain in the user ID
402         defined in sharedUserId. Used when the application wants to migrate out of using shared
403         user ID, but has to maintain backwards compatibility with the API level specified
404         and before. -->
405    <attr name="sharedUserMaxSdkVersion" format="integer" />
406
407    <!-- Internal version code.  This is the number used to determine whether
408         one version is more recent than another: it has no other meaning than
409         that higher numbers are more recent.  You could use this number to
410         encode a "x.y" in the lower and upper 16 bits, make it a build
411         number, simply increase it by one each time a new version is
412         released, or define it however else you want, as long as each
413         successive version has a higher number.  This is not a version
414         number generally shown to the user, that is usually supplied
415         with {@link android.R.attr#versionName}.  When an app is delivered
416         as multiple split APKs, each APK must have the exact same versionCode. -->
417    <attr name="versionCode" format="integer" />
418
419    <!-- Internal major version code.  This is essentially additional high bits
420         for the base version code; it has no other meaning than
421         that higher numbers are more recent.  This is not a version
422         number generally shown to the user, that is usually supplied
423         with {@link android.R.attr#versionName}. -->
424    <attr name="versionCodeMajor" format="integer" />
425
426    <!-- Internal revision code.  This number is the number used to determine
427         whether one APK is more recent than another: it has no other meaning
428         than that higher numbers are more recent.  This value is only meaningful
429         when the two {@link android.R.attr#versionCode} values are already
430         identical.  When an app is delivered as multiple split APKs, each
431         APK may have a different revisionCode value. -->
432    <attr name="revisionCode" format="integer" />
433
434    <!-- The text shown to the user to indicate the version they have.  This
435         is used for no other purpose than display to the user; the actual
436         significant version number is given by {@link android.R.attr#versionCode}. -->
437    <attr name="versionName" format="string" />
438
439    <!-- Flag to control special persistent mode of an application.  This should
440         not normally be used by applications; it requires that the system keep
441         your application running at all times. -->
442    <attr name="persistent" format="boolean" />
443
444    <!-- If set, the "persistent" attribute will only be honored if the feature
445         specified here is present on the device. -->
446    <attr name="persistentWhenFeatureAvailable" format="string" />
447
448    <!-- Flag to specify if this application needs to be present for all users. Only pre-installed
449         applications can request this feature. Default value is false. -->
450    <attr name="requiredForAllUsers" format="boolean" />
451
452    <!-- Flag indicating whether the application can be debugged, even when
453         running on a device that is running in user mode. -->
454    <attr name="debuggable" format="boolean" />
455
456    <!-- Flag indicating whether the application requests the VM to operate in
457         the safe mode.  -->
458    <attr name="vmSafeMode" format="boolean" />
459
460    <!-- <p>Flag indicating whether the application's rendering should be hardware
461         accelerated if possible. This flag is turned on by default for applications
462         that are targeting {@link android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH}
463         or later.</p>
464         <p>This flag can be set on the application and any activity declared
465         in the manifest. When enabled for the application, each activity is
466         automatically assumed to be hardware accelerated. This flag can be
467         overridden in the activity tags, either turning it off (if on for the
468         application) or on (if off for the application.)</p>
469         <p>When this flag is turned on for an activity (either directly or via
470         the application tag), every window created from the activity, including
471         the activity's own window, will be hardware accelerated, if possible.</p>
472         <p>Please refer to the documentation of
473         {@link android.view.WindowManager.LayoutParams#FLAG_HARDWARE_ACCELERATED}
474         for more information on how to control this flag programmatically.</p> -->
475    <attr name="hardwareAccelerated" format="boolean" />
476
477    <!-- Flag indicating whether the given application component is available
478         to other applications.  If false, it can only be accessed by
479         applications with its same user id (which usually means only by
480         code in its own package).  If true, it can be invoked by external
481         entities, though which ones can do so may be controlled through
482         permissions.  The default value is false for activity, receiver,
483         and service components that do not specify any intent filters; it
484         is true for activity, receiver, and service components that do
485         have intent filters (implying they expect to be invoked by others
486         who do not know their particular component name) and for all
487         content providers. -->
488    <attr name="exported" format="boolean" />
489
490    <!-- A boolean flag used to indicate if an application is a Game or not.
491         <p>This information can be used by the system to group together
492         applications that are classified as games, and display them separately
493         from the other applications. -->
494    <attr name="isGame" format="boolean" />
495
496    <!-- If set to true, a single instance of this component will run for
497         all users.  That instance will run as user 0, the default/primary
498         user.  When the app running is in processes for other users and interacts
499         with this component (by binding to a service for example) those processes will
500         always interact with the instance running for user 0.  Enabling
501         single user mode forces "exported" of the component to be false, to
502         help avoid introducing multi-user security bugs.  This feature is only
503         available to applications built in to the system image; you must hold the
504         permission INTERACT_ACROSS_USERS in order
505         to use this feature.  This flag can only be used with services,
506         receivers, and providers; it can not be used with activities. -->
507    <attr name="singleUser" format="boolean" />
508
509    <!-- Specify a specific process that the associated code is to run in.
510         Use with the application tag (to supply a default process for all
511         application components), or with the activity, receiver, service,
512         or provider tag (to supply a specific icon for that component).
513
514         <p>Application components are normally run in a single process that
515         is created for the entire application.  You can use this tag to modify
516         where they run.  If the process name begins with a ':' character,
517         a new process private to that application will be created when needed
518         to run that component (allowing you to spread your application across
519         multiple processes).  If the process name begins with a lower-case
520         character, the component will be run in a global process of that name,
521         provided that you have permission to do so, allowing multiple
522         applications to share one process to reduce resource usage. -->
523    <attr name="process" format="string" />
524
525    <!-- Specify a task name that activities have an "affinity" to.
526         Use with the application tag (to supply a default affinity for all
527         activities in the application), or with the activity tag (to supply
528         a specific affinity for that component).
529
530         <p>The default value for this attribute is the same as the package
531         name, indicating that all activities in the manifest should generally
532         be considered a single "application" to the user.  You can use this
533         attribute to modify that behavior: either giving them an affinity
534         for another task, if the activities are intended to be part of that
535         task from the user's perspective, or using an empty string for
536         activities that have no affinity to a task. -->
537    <attr name="taskAffinity" format="string" />
538
539    <!-- Specify that an activity can be moved out of a task it is in to
540         the task it has an affinity for when appropriate.  Use with the
541         application tag (to supply a default for all activities in the
542         application), or with an activity tag (to supply a specific
543         setting for that component).
544
545         <p>Normally when an application is started, it is associated with
546         the task of the activity that started it and stays there for its
547         entire lifetime.  You can use the allowTaskReparenting feature to force an
548         activity to be re-parented to a different task when the task it is
549         in goes to the background.  Typically this is used to cause the
550         activities of an application to move back to the main task associated
551         with that application.  The activity is re-parented to the task
552         with the same {@link android.R.attr#taskAffinity} as it has. -->
553    <attr name="allowTaskReparenting" format="boolean" />
554
555    <!-- Declare that this application may use cleartext traffic, such as HTTP rather than HTTPS;
556         WebSockets rather than WebSockets Secure; XMPP, IMAP, SMTP without STARTTLS or TLS.
557         Defaults to true. If set to false {@code false}, the application declares that it does not
558         intend to use cleartext network traffic, in which case platform components (e.g. HTTP
559         stacks, {@code DownloadManager}, {@code MediaPlayer}) will refuse applications's requests
560         to use cleartext traffic. Third-party libraries are encouraged to honor this flag as well.
561         -->
562    <attr name="usesCleartextTraffic" format="boolean" />
563
564    <!-- Declare that code from this application will need to be loaded into other
565         applications' processes. On devices that support multiple instruction sets,
566         this implies the code might be loaded into a process that's using any of the devices
567         supported instruction sets.
568
569         <p> The system might treat such applications specially, for eg., by
570         extracting the application's native libraries for all supported instruction
571         sets or by compiling the application's dex code for all supported instruction
572         sets. -->
573    <attr name="multiArch" format ="boolean" />
574
575    <!-- Specify whether the 32 bit version of the ABI should be used in a
576         multiArch application. If both abioverride flag (i.e. using abi option of abd install)
577         and use32bitAbi are used, then use32bit is ignored.-->
578    <attr name="use32bitAbi" />
579
580    <!-- Specify whether a component is allowed to have multiple instances
581         of itself running in different processes.  Use with the activity
582         and provider tags.
583
584         <p>Normally the system will ensure that all instances of a particular
585         component are only running in a single process.  You can use this
586         attribute to disable that behavior, allowing the system to create
587         instances wherever they are used (provided permissions allow it).
588         This is most often used with content providers, so that instances
589         of a provider can be created in each client process, allowing them
590         to be used without performing IPC.  -->
591    <attr name="multiprocess" format="boolean" />
592
593    <!-- Specify whether an activity should be finished when its task is
594         brought to the foreground by relaunching from the home screen.
595
596         <p>If both this option and {@link android.R.attr#allowTaskReparenting} are
597         specified, the finish trumps the affinity: the affinity will be
598         ignored and the activity simply finished. -->
599    <attr name="finishOnTaskLaunch" format="boolean" />
600
601    <!-- Specify whether an activity should be finished when a "close system
602         windows" request has been made.  This happens, for example, when
603         the home key is pressed, when the device is locked, when a system
604         dialog showing recent applications is displayed, etc. -->
605    <attr name="finishOnCloseSystemDialogs" format="boolean" />
606
607    <!-- Specify whether an activity's task should be cleared when it
608         is re-launched from the home screen.  As a result, every time the
609         user starts the task, they will be brought to its root activity,
610         regardless of whether they used BACK or HOME to last leave it.
611         This flag only applies to activities that
612         are used to start the root of a new task.
613
614         <p>An example of the use of this flag would be for the case where
615         a user launches activity A from home, and from there goes to
616         activity B.  They now press home, and then return to activity A.
617         Normally they would see activity B, since that is what they were
618         last doing in A's task.  However, if A has set this flag to true,
619         then upon going to the background all of the tasks on top of it (B
620         in this case) are removed, so when the user next returns to A they
621         will restart at its original activity.
622
623         <p>When this option is used in conjunction with
624         {@link android.R.attr#allowTaskReparenting}, the allowTaskReparenting trumps the
625         clear.  That is, all activities above the root activity of the
626         task will be removed: those that have an affinity will be moved
627         to the task they are associated with, otherwise they will simply
628         be dropped as described here. -->
629    <attr name="clearTaskOnLaunch" format="boolean" />
630
631    <!-- Specify whether an activity should be kept in its history stack.
632         If this attribute is set, then as soon as the user navigates away
633         from the activity it will be finished and they will no longer be
634         able to return to it. -->
635    <attr name="noHistory" format="boolean" />
636
637    <!-- Specify whether an activity's task state should always be maintained
638         by the system, or if it is allowed to reset the task to its initial
639         state in certain situations.
640
641         <p>Normally the system will reset a task (remove all activities from
642         the stack and reset the root activity) in certain situations when
643         the user re-selects that task from the home screen.  Typically this
644         will be done if the user hasn't visited that task for a certain
645         amount of time, such as 30 minutes.
646
647         <p>By setting this attribute, the user will always return to your
648         task in its last state, regardless of how they get there.  This is
649         useful, for example, in an application like the web browser where there
650         is a lot of state (such as multiple open tabs) that the application
651         would not like to lose. -->
652    <attr name="alwaysRetainTaskState" format="boolean" />
653
654    <!-- Indicates that an Activity does not need to have its freeze state
655         (as returned by {@link android.app.Activity#onSaveInstanceState}
656         retained in order to be restarted.  Generally you use this for activities
657         that do not store any state.  When this flag is set, if for some reason
658         the activity is killed before it has a chance to save its state,
659         then the system will not remove it from the activity stack like
660         it normally would.  Instead, the next time the user navigates to
661         it its {@link android.app.Activity#onCreate} method will be called
662         with a null icicle, just like it was starting for the first time.
663
664         <p>This is used by the Home activity to make sure it does not get
665         removed if it crashes for some reason. -->
666    <attr name="stateNotNeeded" format="boolean" />
667
668    <!-- Indicates that an Activity should be excluded from the list of
669         recently launched activities. -->
670    <attr name="excludeFromRecents" format="boolean" />
671
672    <!-- Specify that an Activity should be shown over the lock screen and,
673         in a multiuser environment, across all users' windows.
674         @deprecated use {@link android.R.attr#showForAllUsers} instead. -->
675    <attr name="showOnLockScreen" format="boolean" />
676
677    <!-- Specify that an Activity should be shown even if the current/foreground user
678         is different from the user of the Activity. This will also force the
679         <code>android.view.LayoutParams.FLAG_SHOW_WHEN_LOCKED</code> flag
680         to be set for all windows of this activity -->
681    <attr name="showForAllUsers" format="boolean" />
682
683    <!-- Specifies whether an {@link android.app.Activity} should be shown on top of the lock screen
684         whenever the lockscreen is up and the activity is resumed. Normally an activity will be
685         transitioned to the stopped state if it is started while the lockscreen is up, but with
686         this flag set the activity will remain in the resumed state visible on-top of the lock
687         screen.
688
689         <p>This should be used instead of {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WHEN_LOCKED}
690         flag set for Windows. When using the Window flag during activity startup, there may not be
691         time to add it before the system stops your activity for being behind the lock-screen.
692         This leads to a double life-cycle as it is then restarted.</p> -->
693    <attr name="showWhenLocked" format="boolean" />
694
695    <!-- Specifies whether the screen should be turned on when the {@link android.app.Activity} is resumed.
696         Normally an activity will be transitioned to the stopped state if it is started while the
697         screen if off, but with this flag set the activity will cause the screen to turn on if the
698         activity will be visible and resumed due to the screen coming on. The screen will not be
699         turned on if the activity won't be visible after the screen is turned on. This flag is
700         normally used in conjunction with the {@link android.R.attr#showWhenLocked} flag to make
701         sure the activity is visible after the screen is turned on when the lockscreen is up. In
702         addition, if this flag is set and the activity calls
703         {@link android.app.KeyguardManager#requestDismissKeyguard}
704         the screen will turn on.
705
706         <p>This should be used instead of {@link android.view.WindowManager.LayoutParams#FLAG_TURN_SCREEN_ON}
707         flag set for Windows. When using the Window flag during activity startup, there may not be
708         time to add it before the system stops your activity because the screen has not yet turned
709         on. This leads to a double life-cycle as it is then restarted.</p> -->
710    <attr name="turnScreenOn" format="boolean" />
711
712    <!-- Specify the authorities under which this content provider can be
713         found.  Multiple authorities may be supplied by separating them
714         with a semicolon.  Authority names should use a Java-style naming
715         convention (such as <code>com.google.provider.MyProvider</code>)
716         in order to avoid conflicts.  Typically this name is the same
717         as the class implementation describing the provider's data structure. -->
718    <attr name="authorities" format="string" />
719
720    <!-- Flag indicating whether this content provider would like to
721         participate in data synchronization. -->
722    <attr name="syncable" format="boolean" />
723
724    <!-- Flag declaring this activity to be 'immersive'; immersive activities
725         should not be interrupted with other activities or notifications. -->
726    <attr name="immersive" format="boolean" />
727
728    <!-- Flag declaring that this activity will be run in VR mode, and specifying
729         the component of the {@link android.service.vr.VrListenerService} that should be
730         bound while this Activity is visible if it is installed and enabled on this device.
731         This is equivalent to calling {@link android.app.Activity#setVrModeEnabled} with the
732         the given component name within the Activity that this attribute is set for.
733         Declaring this will prevent the system from leaving VR mode during an Activity
734         transition from one VR activity to another. -->
735    <attr name="enableVrMode" format="string" />
736
737    <!-- Flag that specifies the activity's preferred screen rotation animation.
738         Valid values are "rotate", "crossfade", "jumpcut", and "seamless" as
739         described in
740         {@link android.view.WindowManager.LayoutParams#rotationAnimation}.
741         Specifying your rotation animation in
742         <code>WindowManager.LayoutParams</code> may be racy with app startup
743         and update transitions that occur during application startup; and so,
744         specify the animation in the manifest attribute.
745    -->
746    <attr name="rotationAnimation">
747      <flag name="rotate" value= "0" />
748      <flag name="crossfade" value = "1" />
749      <flag name="jumpcut" value = "2" />
750      <flag name="seamless" value = "3" />
751    </attr>
752
753    <!-- Specify the order in which content providers hosted by a process
754         are instantiated when that process is created.  Not needed unless
755         you have providers with dependencies between each other, to make
756         sure that they are created in the order needed by those dependencies.
757         The value is a simple integer, with higher numbers being
758         initialized first. -->
759    <attr name="initOrder" format="integer" />
760
761    <!-- Specify the relative importance or ability in handling a particular
762         Intent.  For receivers, this controls the order in which they are
763         executed to receive a broadcast (note that for
764         asynchronous broadcasts, this order is ignored).  For activities,
765         this provides information about how good an activity is handling an
766         Intent; when multiple activities match an intent and have different
767         priorities, only those with the higher priority value will be
768         considered a match.
769
770         <p>Only use if you really need to impose some specific
771         order in which the broadcasts are received, or want to forcibly
772         place an activity to always be preferred over others.  The value is a
773         single integer, with higher numbers considered to be better. -->
774    <attr name="priority" format="integer" />
775
776    <!-- Indicate if this component is aware of direct boot lifecycle, and can be
777         safely run before the user has entered their credentials (such as a lock
778         pattern or PIN). -->
779    <attr name="directBootAware" format="boolean" />
780
781    <!-- Specify how an activity should be launched.  See the
782         <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
783         Stack</a> document for important information on how these options impact
784         the behavior of your application.
785
786         <p>If this attribute is not specified, <code>standard</code> launch
787         mode will be used.  Note that the particular launch behavior can
788         be changed in some ways at runtime through the
789         {@link android.content.Intent} flags
790         {@link android.content.Intent#FLAG_ACTIVITY_SINGLE_TOP},
791         {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}, and
792         {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}. -->
793    <attr name="launchMode">
794        <!-- The default mode, which will usually create a new instance of
795             the activity when it is started, though this behavior may change
796             with the introduction of other options such as
797             {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK
798             Intent.FLAG_ACTIVITY_NEW_TASK}. -->
799        <enum name="standard" value="0" />
800        <!-- If, when starting the activity, there is already an
801            instance of the same activity class in the foreground that is
802            interacting with the user, then
803            re-use that instance.  This existing instance will receive a call to
804            {@link android.app.Activity#onNewIntent Activity.onNewIntent()} with
805            the new Intent that is being started. -->
806        <enum name="singleTop" value="1" />
807        <!-- If, when starting the activity, there is already a task running
808            that starts with this activity, then instead of starting a new
809            instance the current task is brought to the front.  The existing
810            instance will receive a call to {@link android.app.Activity#onNewIntent
811            Activity.onNewIntent()}
812            with the new Intent that is being started, and with the
813            {@link android.content.Intent#FLAG_ACTIVITY_BROUGHT_TO_FRONT
814            Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT} flag set.  This is a superset
815            of the singleTop mode, where if there is already an instance
816            of the activity being started at the top of the stack, it will
817            receive the Intent as described there (without the
818            FLAG_ACTIVITY_BROUGHT_TO_FRONT flag set).  See the
819            <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
820            Stack</a> document for more details about tasks.-->
821        <enum name="singleTask" value="2" />
822        <!-- Only allow one instance of this activity to ever be
823            running.  This activity gets a unique task with only itself running
824            in it; if it is ever launched again with the same Intent, then that
825            task will be brought forward and its
826            {@link android.app.Activity#onNewIntent Activity.onNewIntent()}
827            method called.  If this
828            activity tries to start a new activity, that new activity will be
829            launched in a separate task.  See the
830            <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
831            Stack</a> document for more details about tasks.-->
832        <enum name="singleInstance" value="3" />
833        <!-- The activity can only be running as the root activity of the task, the first activity
834            that created the task, and therefore there will only be one instance of this activity
835            in a task. In contrast to the {@code singleTask} launch mode, this activity can be
836            started in multiple instances in different tasks if the
837            {@code FLAG_ACTIVITY_MULTIPLE_TASK} or {@code FLAG_ACTIVITY_NEW_DOCUMENT} is set.-->
838        <enum name="singleInstancePerTask" value="4" />
839    </attr>
840    <!-- Specify the orientation an activity should be run in.  If not
841         specified, it will run in the current preferred orientation
842         of the screen.
843         <p>This attribute is supported by the <a
844            href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a>
845            element. -->
846    <attr name="screenOrientation">
847        <!-- No preference specified: let the system decide the best
848             orientation.  This will either be the orientation selected
849             by the activity below, or the user's preferred orientation
850             if this activity is the bottom of a task. If the user
851             explicitly turned off sensor based orientation through settings
852             sensor based device rotation will be ignored. If not by default
853             sensor based orientation will be taken into account and the
854             orientation will changed based on how the user rotates the device.
855             Corresponds to
856             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_UNSPECIFIED}. -->
857        <enum name="unspecified" value="-1" />
858        <!-- Would like to have the screen in a landscape orientation: that
859             is, with the display wider than it is tall, ignoring sensor data.
860             Corresponds to
861             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE}. -->
862        <enum name="landscape" value="0" />
863        <!-- Would like to have the screen in a portrait orientation: that
864             is, with the display taller than it is wide, ignoring sensor data.
865             Corresponds to
866             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_PORTRAIT}. -->
867        <enum name="portrait" value="1" />
868        <!-- Use the user's current preferred orientation of the handset.
869             Corresponds to
870             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER}. -->
871        <enum name="user" value="2" />
872        <!-- Keep the screen in the same orientation as whatever is behind
873             this activity.
874             Corresponds to
875             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_BEHIND}. -->
876        <enum name="behind" value="3" />
877        <!-- Orientation is determined by a physical orientation sensor:
878             the display will rotate based on how the user moves the device.
879             Ignores user's setting to turn off sensor-based rotation.
880             Corresponds to
881             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR}. -->
882        <enum name="sensor" value="4" />
883        <!-- Always ignore orientation determined by orientation sensor:
884             the display will not rotate when the user moves the device.
885             Corresponds to
886             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_NOSENSOR}. -->
887        <enum name="nosensor" value="5" />
888        <!-- Would like to have the screen in landscape orientation, but can
889             use the sensor to change which direction the screen is facing.
890             Corresponds to
891             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_LANDSCAPE}. -->
892        <enum name="sensorLandscape" value="6" />
893        <!-- Would like to have the screen in portrait orientation, but can
894             use the sensor to change which direction the screen is facing.
895             Corresponds to
896             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_PORTRAIT}. -->
897        <enum name="sensorPortrait" value="7" />
898        <!-- Would like to have the screen in landscape orientation, turned in
899             the opposite direction from normal landscape.
900             Corresponds to
901             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_LANDSCAPE}. -->
902        <enum name="reverseLandscape" value="8" />
903        <!-- Would like to have the screen in portrait orientation, turned in
904             the opposite direction from normal portrait.
905             Corresponds to
906             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_PORTRAIT}. -->
907        <enum name="reversePortrait" value="9" />
908        <!-- Orientation is determined by a physical orientation sensor:
909             the display will rotate based on how the user moves the device.
910             This allows any of the 4 possible rotations, regardless of what
911             the device will normally do (for example some devices won't
912             normally use 180 degree rotation).
913             Corresponds to
914             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_SENSOR}. -->
915        <enum name="fullSensor" value="10" />
916        <!-- Would like to have the screen in landscape orientation, but if
917             the user has enabled sensor-based rotation then we can use the
918             sensor to change which direction the screen is facing.
919             Corresponds to
920             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_LANDSCAPE}. -->
921        <enum name="userLandscape" value="11" />
922        <!-- Would like to have the screen in portrait orientation, but if
923             the user has enabled sensor-based rotation then we can use the
924             sensor to change which direction the screen is facing.
925             Corresponds to
926             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_PORTRAIT}. -->
927        <enum name="userPortrait" value="12" />
928        <!-- Respect the user's sensor-based rotation preference, but if
929             sensor-based rotation is enabled then allow the screen to rotate
930             in all 4 possible directions regardless of what
931             the device will normally do (for example some devices won't
932             normally use 180 degree rotation).
933             Corresponds to
934             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_USER}. -->
935        <enum name="fullUser" value="13" />
936        <!-- Screen is locked to its current rotation, whatever that is.
937             Corresponds to
938             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LOCKED}. -->
939        <enum name="locked" value="14" />
940    </attr>
941
942    <!-- Specify the configuration changes that trigger the system to recreate the
943         current activity if any of these configuration changes happen in the system.
944         The valid configuration changes include mcc and mnc which are the same with
945         those in configChanges. By default from Android O, we don't recreate the activity
946         even the app doesn't specify mcc or mnc in configChanges. If the app wants to
947         be recreated, specify them in recreateOnConfigChanges. -->
948    <attr name="recreateOnConfigChanges">
949        <!-- The IMSI MCC has changed, that is a SIM has been detected and
950             updated the Mobile Country Code. -->
951        <flag name="mcc" value="0x0001" />
952        <!-- The IMSI MNC has changed, that is a SIM has been detected and
953             updated the Mobile Network Code. -->
954        <flag name="mnc" value="0x0002" />
955    </attr>
956
957    <!-- Specify one or more configuration changes that the activity will
958         handle itself.  If not specified, the activity will be restarted
959         if any of these configuration changes happen in the system.  Otherwise,
960         the activity will remain running and its
961         {@link android.app.Activity#onConfigurationChanged Activity.onConfigurationChanged}
962         method called with the new configuration.
963
964         <p>Note that all of these configuration changes can impact the
965         resource values seen by the application, so you will generally need
966         to re-retrieve all resources (including view layouts, drawables, etc)
967         to correctly handle any configuration change.
968
969         <p>These values must be kept in sync with those in
970         {@link android.content.pm.ActivityInfo} and
971         include/utils/ResourceTypes.h. -->
972    <attr name="configChanges">
973        <!-- The IMSI MCC has changed, that is a SIM has been detected and
974             updated the Mobile Country Code. By default from Android O, we
975             don't recreate the activity even the app doesn't specify mcc in
976             configChanges. If the app wants to recreate the activity, specify
977             mcc in recreateOnConfigChanges. -->
978        <flag name="mcc" value="0x0001" />
979        <!-- The IMSI MNC has changed, that is a SIM has been detected and
980             updated the Mobile Network Code. By default from Android O, we
981             don't recreate the activity even the app doesn't specify mnc in
982             configChanges. If the app wants to recreate the acvitity, specify
983             mnc in recreateOnConfigChanges. -->
984        <flag name="mnc" value="0x0002" />
985        <!-- The locale has changed, that is the user has selected a new
986             language that text should be displayed in. -->
987        <flag name="locale" value="0x0004" />
988        <!-- The touchscreen has changed.  Should never normally happen. -->
989        <flag name="touchscreen" value="0x0008" />
990        <!-- The keyboard type has changed, for example the user has plugged
991             in an external keyboard. -->
992        <flag name="keyboard" value="0x0010" />
993        <!-- The keyboard or navigation accessibility has changed, for example
994             the user has slid the keyboard out to expose it.  Note that
995             despite its name, this applied to any accessibility: keyboard
996             or navigation. -->
997        <flag name="keyboardHidden" value="0x0020" />
998        <!-- The navigation type has changed.  Should never normally happen. -->
999        <flag name="navigation" value="0x0040" />
1000        <!-- The screen orientation has changed, that is the user has
1001             rotated the device. -->
1002        <flag name="orientation" value="0x0080" />
1003        <!-- The screen layout has changed.  This might be caused by a
1004             different display being activated. -->
1005        <flag name="screenLayout" value="0x0100" />
1006        <!-- The global user interface mode has changed.  For example,
1007             going in or out of car mode, night mode changing, etc. -->
1008        <flag name="uiMode" value="0x0200" />
1009        <!-- The current available screen size has changed.  If applications don't
1010             target at least {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}
1011             then the activity will always handle this itself (the change
1012             will not result in a restart).  This represents a change in the
1013             currently available size, so will change when the user switches
1014             between landscape and portrait. -->
1015        <flag name="screenSize" value="0x0400" />
1016        <!-- The physical screen size has changed.  If applications don't
1017             target at least {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}
1018             then the activity will always handle this itself (the change
1019             will not result in a restart).  This represents a change in size
1020             regardless of orientation, so will only change when the actual
1021             physical screen size has changed such as switching to an external
1022             display. -->
1023        <flag name="smallestScreenSize" value="0x0800" />
1024        <!-- The display density has changed. This might be caused by the user
1025             specifying a different display scale, or it might be caused by a
1026             different display being activated. -->
1027        <flag name="density" value="0x1000" />
1028        <!-- The layout direction has changed. For example going from LTR to RTL. -->
1029        <flag name="layoutDirection" value="0x2000" />
1030        <!-- The color mode of the screen has changed (color gamut or dynamic range). -->
1031        <flag name="colorMode" value="0x4000" />
1032        <!-- The grammatical gender has changed, for example the user set the grammatical gender
1033             from the UI. -->
1034        <flag name="grammaticalGender" value="0x8000" />
1035        <!-- The font scaling factor has changed, that is the user has
1036             selected a new global font size. -->
1037        <flag name="fontScale" value="0x40000000" />
1038        <!-- The font weight adjustment value has changed. Used to reflect the user increasing font
1039             weight. -->
1040        <flag name="fontWeightAdjustment" value="0x10000000" />
1041    </attr>
1042
1043    <!-- Indicate that the activity can be launched as the embedded child of another
1044         activity. Particularly in the case where the child lives in a container
1045         such as a Display owned by another activity.
1046
1047         <p>The default value of this attribute is <code>false</code>. -->
1048    <attr name="allowEmbedded" format="boolean" />
1049
1050    <!-- A reference to an array resource containing the signing certificate digests, one of which a
1051         client is required to be signed with in order to embed the activity. If the client is not
1052         signed with one of the certificates in the set, and the activity does not allow embedding
1053         by untrusted hosts via {@link android.R.attr#allowUntrustedActivityEmbedding} flag, the
1054         embedding request will fail.
1055         <p>The digest should be computed over the DER encoding of the trusted certificate using the
1056         SHA-256 digest algorithm.
1057         <p>If only a single signer is declared this can also be a string resource, or the digest
1058         can be declared inline as the value for this attribute.
1059         <p>If the attribute is declared both on the application and the activity level, the value
1060         on the activity level takes precedence. -->
1061    <attr name="knownActivityEmbeddingCerts" format="reference|string" />
1062
1063    <!-- Indicate that the activity can be embedded by untrusted hosts. In this case the
1064         interactions and visibility of the embedded activity may be limited.
1065         <p>The default value of this attribute is <code>false</code>. -->
1066    <attr name="allowUntrustedActivityEmbedding" format="boolean" />
1067
1068    <!-- Specifies whether this {@link android.app.Activity} should be shown on
1069         top of the lock screen whenever the lockscreen is up and this activity has another
1070         activity behind it with the {@link android.R.attr#showWhenLocked} attribute set. That
1071         is, this activity is only visible on the lock screen if there is another activity with
1072         the {@link android.R.attr#showWhenLocked} attribute visible at the same time on the
1073         lock screen. A use case for this is permission dialogs, that should only be visible on
1074         the lock screen if their requesting activity is also visible.
1075
1076         <p>The default value of this attribute is <code>false</code>. -->
1077    <attr name="inheritShowWhenLocked" format="boolean" />
1078
1079    <!-- Descriptive text for the associated data. -->
1080    <attr name="description" format="reference" />
1081
1082    <!-- The name of the application package that an Instrumentation object
1083         will run against. -->
1084    <attr name="targetPackage" format="string" />
1085
1086    <!-- The name of an application's processes that an Instrumentation object
1087         will run against.  If not specified, only runs in the main process of the targetPackage.
1088         Can either be a comma-separated list of process names or '*' for any process that
1089         launches to run targetPackage code. -->
1090    <attr name="targetProcesses" format="string" />
1091
1092    <!-- Flag indicating that an Instrumentation class wants to take care
1093         of starting/stopping profiling itself, rather than relying on
1094         the default behavior of profiling the complete time it is running.
1095         This allows it to target profiling data at a specific set of
1096         operations. -->
1097    <attr name="handleProfiling" format="boolean" />
1098
1099    <!-- Flag indicating that an Instrumentation class should be run as a
1100         functional test. -->
1101    <attr name="functionalTest" format="boolean" />
1102
1103    <!-- The touch screen type used by an application. -->
1104    <attr name="reqTouchScreen">
1105        <enum name="undefined" value="0" />
1106        <enum name="notouch" value="1" />
1107        <enum name="stylus" value="2" />
1108        <enum name="finger" value="3" />
1109    </attr>
1110
1111    <!-- The input method preferred by an application. -->
1112    <attr name="reqKeyboardType">
1113        <enum name="undefined" value="0" />
1114        <enum name="nokeys" value="1" />
1115        <enum name="qwerty" value="2" />
1116        <enum name="twelvekey" value="3" />
1117    </attr>
1118
1119    <!-- Application's requirement for a hard keyboard -->
1120    <attr name="reqHardKeyboard" format="boolean" />
1121
1122    <!-- The navigation device preferred by an application. -->
1123    <attr name="reqNavigation">
1124        <enum name="undefined" value="0" />
1125        <enum name="nonav" value="1" />
1126        <enum name="dpad" value="2" />
1127        <enum name="trackball" value="3" />
1128        <enum name="wheel" value="4" />
1129    </attr>
1130
1131    <!-- Application's requirement for five way navigation -->
1132    <attr name="reqFiveWayNav" format="boolean" />
1133
1134    <!-- The name of the class subclassing <code>BackupAgent</code> to manage
1135         backup and restore of the application's data on external storage. -->
1136    <attr name="backupAgent" format="string" />
1137
1138    <!-- Whether to allow the application to participate in the backup
1139         and restore infrastructure.  If this attribute is set to <code>false</code>,
1140         no backup or restore of the application will ever be performed, even by a
1141         full-system backup that would otherwise cause all application data to be saved
1142         via adb.  The default value of this attribute is <code>true</code>. -->
1143    <attr name="allowBackup" format="boolean" />
1144
1145    <!-- Applications will set this in their manifest to opt-in to or out of full app data back-up
1146         and restore. Alternatively they can set it to an xml resource within their app that will
1147         be parsed by the BackupAgent to selectively backup files indicated within that xml. -->
1148    <attr name="fullBackupContent" format="reference|boolean" />
1149
1150    <!-- Indicates that even though the application provides a <code>BackupAgent</code>,
1151         only full-data streaming backup operations are to be performed to save the app's
1152         data.  This lets the app rely on full-data backups while still participating in
1153         the backup and restore process via the BackupAgent's full-data backup APIs.
1154         When this attribute is <code>true</code> the app's BackupAgent overrides of
1155         the onBackup() and onRestore() callbacks can be empty stubs. -->
1156    <attr name="fullBackupOnly" format="boolean" />
1157
1158    <!-- Whether the application in question should be terminated after its
1159         settings have been restored during a full-system restore operation.
1160         Single-package restore operations will never cause the application to
1161         be shut down.  Full-system restore operations typically only occur once,
1162         when the phone is first set up.  Third-party applications will not usually
1163         need to use this attribute.
1164
1165         <p>The default is <code>true</code>, which means that after the application
1166         has finished processing its data during a full-system restore, it will be
1167         terminated. -->
1168    <attr name="killAfterRestore" format="boolean" />
1169
1170    <!-- @deprecated This attribute is not used by the Android operating system. -->
1171    <attr name="restoreNeedsApplication" format="boolean" />
1172
1173    <!-- Indicate that the application is prepared to attempt a restore of any
1174         backed-up dataset, even if the backup is apparently from a newer version
1175         of the application than is currently installed on the device.  Setting
1176         this attribute to <code>true</code> will permit the Backup Manager to
1177         attempt restore even when a version mismatch suggests that the data are
1178         incompatible.  <em>Use with caution!</em>
1179
1180         <p>The default value of this attribute is <code>false</code>. -->
1181    <attr name="restoreAnyVersion" format="boolean" />
1182
1183    <!-- Indicates that full-data backup operations for this application may
1184         be performed even if the application is in a foreground-equivalent
1185         state.  <em>Use with caution!</em>  Setting this flag to <code>true</code>
1186         can impact app behavior while the user is interacting with the device.
1187
1188         <p>If unspecified, the default value of this attribute is <code>false</code>,
1189         which means that the OS will avoid backing up the application while it is
1190         running in the foreground (such as a music app that is actively playing
1191         music via a service in the startForeground() state). -->
1192    <attr name="backupInForeground" format="boolean" />
1193
1194    <!-- The default install location defined by an application. -->
1195    <attr name="installLocation">
1196        <!-- Let the system decide ideal install location -->
1197        <enum name="auto" value="0" />
1198        <!-- Explicitly request to be installed on internal phone storage
1199             only. -->
1200        <enum name="internalOnly" value="1" />
1201        <!-- Prefer to be installed on SD card. There is no guarantee that
1202             the system will honor this request. The application might end
1203             up being installed on internal storage if external media
1204             is unavailable or too full. -->
1205        <enum name="preferExternal" value="2" />
1206    </attr>
1207
1208    <!-- If set to <code>true</code>, indicates to the platform that any split APKs
1209         installed for this application should be loaded into their own Context
1210         objects and not appear in the base application's Context.
1211
1212         <p>The default value of this attribute is <code>false</code>. -->
1213    <attr name="isolatedSplits" format="boolean" />
1214
1215    <!-- The classname of the classloader used to load the application's classes
1216         from its APK. The APK in question can either be the 'base' APK or any
1217         of the application's 'split' APKs if it's using a feature split.
1218
1219         <p>
1220         The supported values for this attribute are
1221         <code>dalvik.system.PathClassLoader</code> and
1222         <code>dalvik.system.DelegateLastClassLoader</code>. If unspecified,
1223         the default value of this attribute is <code>dalvik.system.PathClassLoader</code>.
1224
1225         If an unknown classloader is provided, a PackageManagerException with cause
1226         <code>PackageManager.INSTALL_PARSE_FAILED_MANIFEST_MALFORMED</code> will be
1227         thrown and the app will not be installed.
1228         -->
1229    <attr name="classLoader" format="string" />
1230
1231    <!-- Name of the class that gets invoked for preloading application code, when starting an
1232         {@link android.R.attr#isolatedProcess} service that has
1233         {@link android.R.attr#useAppZygote} set to <code>true</code>. This is a fully
1234         qualified class name (for example, com.mycompany.myapp.MyZygotePreload); as a
1235         short-hand if the first character of the class is a period then it is appended
1236         to your package name. The class must implement the {@link android.app.ZygotePreload}
1237         interface. -->
1238    <attr name="zygotePreloadName" format="string"/>
1239
1240    <!-- If set to <code>true</code>, indicates to the platform that this APK is
1241         a 'feature' split and that it implicitly depends on the base APK. This distinguishes
1242         this split APK from a 'configuration' split, which provides resource overrides
1243         for a particular 'feature' split. Only useful when the base APK specifies
1244         <code>android:isolatedSplits="true"</code>.
1245
1246         <p>The default value of this attribute is <code>false</code>. -->
1247    <attr name="isFeatureSplit" format="boolean" />
1248
1249    <!-- Flag to specify if this APK requires at least one split [either feature or
1250         resource] to be present in order to function. Default value is false.
1251         @deprecated Use {@link android.R.attr#requiredSplitTypes} instead. -->
1252    <attr name="isSplitRequired" format="boolean" />
1253
1254    <!-- List of split types required by this APK to be present in order to function properly,
1255         separated by commas. The platform will reject installation of an app that is missing
1256         any required split types. Each split type is a string, and is only used for matching
1257         <code>requiredSplitTypes</code> and <code>splitTypes</code>. As an example, if this
1258         APK requires localized string resources, screen density resources, and native code
1259         this value could be "language,density,abi". Default value is null to indicate no split
1260         types are required. -->
1261    <attr name="requiredSplitTypes" format="string" />
1262
1263    <!-- List of split types offered by this APK, separated by commas. Each split type is a
1264         string, and is only used for matching <code>requiredSplitTypes</code> and
1265         <code>splitTypes</code>. As an example, if this split offers localized string resources,
1266         and screen density resources the value could be "language,density". Default value is
1267         null to indicate no split types are offered. -->
1268    <attr name="splitTypes" format="string" />
1269
1270    <!-- Flag to specify if this app wants to run the dex within its APK but not extracted or
1271         locally compiled variants. This keeps the dex code protected by the APK signature. Such
1272         apps will always run in JIT mode (same when they are first installed), and the system will
1273         never generate ahead-of-time compiled code for them. Depending on the app's workload,
1274         there may be some run time performance change, noteably the cold start time. -->
1275    <attr name="useEmbeddedDex" format="boolean" />
1276
1277    <!-- Extra options for an activity's UI. Applies to either the {@code <activity>} or
1278         {@code <application>} tag. If specified on the {@code <application>}
1279         tag these will be considered defaults for all activities in the
1280         application. -->
1281    <attr name="uiOptions">
1282        <!-- No extra UI options. This is the default. -->
1283        <flag name="none" value="0" />
1284        <!-- Split the options menu into a separate bar at the bottom of
1285             the screen when severely constrained for horizontal space.
1286             (e.g. portrait mode on a phone.) Instead of a small number
1287             of action buttons appearing in the action bar at the top
1288             of the screen, the action bar will split into the top navigation
1289             section and the bottom menu section. Menu items will not be
1290             split across the two bars; they will always appear together. -->
1291        <flag name="splitActionBarWhenNarrow" value="1" />
1292    </attr>
1293
1294    <!-- The name of the logical parent of the activity as it appears in the manifest. -->
1295    <attr name="parentActivityName" format="string" />
1296
1297    <!-- Define how an activity persist across reboots. Activities defined as "never" will not
1298         be persisted. Those defined as "always" will be persisted. Those defined as "taskOnly"
1299         will persist the root activity of the task only. See below for more detail as to
1300         what gets persisted. -->
1301    <attr name="persistableMode">
1302        <!-- The default. If this activity forms the root of a task then that task will be
1303             persisted across reboots but only the launching intent will be used. If the task
1304             relinquishes its identity then the intent used is that of the topmost inherited
1305             identity. All activities above this activity in the task will not be persisted.
1306             In addition this activity will not be passed a PersistableBundle into which it
1307             could have stored its state. -->
1308        <enum name="persistRootOnly" value="0" />
1309        <!-- If this activity forms the root of a task then that task will not be persisted
1310             across reboots -->
1311        <enum name="persistNever" value="1" />
1312        <!-- If this activity forms the root of a task then the task and this activity will
1313             be persisted across reboots. If the activity above this activity is also
1314             tagged with the attribute <code>"persist"</code> then it will be persisted as well.
1315             And so on up the task stack until either an activity without the
1316             <code>persistableMode="persistAcrossReboots"</code> attribute or one that was launched
1317             with the flag Intent.FLAG_CLEAR_TASK_WHEN_RESET is encountered.
1318
1319             <p>Activities that are declared with the persistAcrossReboots attribute will be
1320             provided with a PersistableBundle in onSavedInstanceState(), These activities may
1321             use this PeristableBundle to save their state. Then, following a reboot, that
1322             PersistableBundle will be provided back to the activity in its onCreate() method. -->
1323        <enum name="persistAcrossReboots" value="2" />
1324    </attr>
1325
1326    <!-- This attribute specifies that an activity shall become the root activity of a
1327         new task each time it is launched. Using this attribute permits the user to
1328         have multiple documents from the same applications appear in the recent tasks list.
1329
1330         <p>Such a document is any kind of item for which an application may want to
1331         maintain multiple simultaneous instances. Examples might be text files, web
1332         pages, spreadsheets, or emails. Each such document will be in a separate
1333         task in the recent tasks list.
1334
1335         <p>This attribute is equivalent to adding the flag {@link
1336         android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} to every Intent used to launch
1337         the activity.
1338
1339         <p>The documentLaunchMode attribute may be assigned one of four values, "none",
1340         "intoExisting", "always" and "never", described in detail below. For values other than
1341         <code>none</code> and <code>never</code> the activity must be defined with
1342         {@link android.R.attr#launchMode} <code>standard</code>.
1343         If this attribute is not specified, <code>none</code> will be used.
1344         Note that <code>none</code> can be overridden at run time if the Intent used
1345         to launch it contains the flag {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT
1346         Intent.FLAG_ACTIVITY_NEW_DOCUMENT}.
1347         Similarly <code>intoExisting</code> will be overridden by the flag
1348         {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT
1349         Intent.FLAG_ACTIVITY_NEW_DOCUMENT} combined with
1350         {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK
1351         Intent.FLAG_ACTIVITY_MULTIPLE_TASK}. If the value of
1352         documentLaunchModes is <code>never</code> then any use of
1353         {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT
1354         Intent.FLAG_ACTIVITY_NEW_DOCUMENT} to launch this activity will be ignored. -->
1355    <attr name="documentLaunchMode">
1356        <!-- The default mode, which will create a new task only when
1357             {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK
1358             Intent.FLAG_ACTIVITY_NEW_TASK} is set. -->
1359        <enum name="none" value="0" />
1360        <!-- All tasks will be searched for one whose base Intent's ComponentName and
1361             data URI match those of the launching Intent. If such a task is found
1362             that task will be cleared and restarted with the root activity receiving a call
1363             to {@link android.app.Activity#onNewIntent Activity.onNewIntent}. If no
1364             such task is found a new task will be created.
1365             <p>This is the equivalent of launching an activity with {@link
1366             android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT Intent.FLAG_ACTIVITY_NEW_DOCUMENT}
1367             set and without {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK
1368             Intent.FLAG_ACTIVITY_MULTIPLE_TASK} set. -->
1369        <enum name="intoExisting" value="1" />
1370        <!-- A new task rooted at this activity will be created. This will happen whether or
1371             not there is an existing task whose ComponentName and data URI match
1372             that of the launcing intent This is the equivalent of launching an activity
1373             with {@link
1374             android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT Intent.FLAG_ACTIVITY_NEW_DOCUMENT}
1375             and {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK
1376             Intent.FLAG_ACTIVITY_MULTIPLE_TASK} both set. -->
1377        <enum name="always" value="2" />
1378        <!-- This activity will not be launched into a new document even if the Intent contains
1379             {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT
1380             Intent.FLAG_ACTIVITY_NEW_DOCUMENT}. This gives the activity writer ultimate
1381             control over how their activity is used. Note that applications prior to api
1382             21 will default to documentLaunchMode="none" so only activities that explicitly
1383             opt out with <code>"never"</code> may do so. -->
1384        <enum name="never" value="3" />
1385    </attr>
1386
1387    <!-- The maximum number of entries of tasks rooted at this activity in the recent task list.
1388         When this number of entries is reached the least recently used instance of this activity
1389         will be removed from recents. The value will be clamped between 1 and 100 inclusive.
1390         The default value for this if it is not specified is 15. -->
1391    <attr name="maxRecents" format="integer" />
1392
1393    <!-- Tasks launched by activities with this attribute will remain in the recent tasks
1394         list until the last activity in the task is completed.  When that happens the task
1395         will be automatically removed from the recent tasks list.  This overrides the caller's
1396         use of {@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS
1397         Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS} -->
1398    <attr name="autoRemoveFromRecents" format="boolean" />
1399
1400    <!-- Tasks whose root has this attribute set to true will replace baseIntent with that of the
1401         next activity in the task. If the next activity also has this attribute set to true then
1402         it will yield the baseIntent to any activity that it launches in the same task. This
1403         continues until an activity is encountered which has this attribute set to false. False
1404         is the default. This attribute set to true also permits activity's use of the
1405         TaskDescription to change labels, colors and icons in the recent task list.
1406
1407         <p>NOTE: Setting this flag to <code>true</code> will not change the affinity of the task,
1408         which is used for intent resolution during activity launch. The task's root activity will
1409         always define its affinity. -->
1410    <attr name="relinquishTaskIdentity" format="boolean" />
1411
1412    <!-- Indicate that it is okay for this activity be resumed while the previous
1413         activity is in the process of pausing, without waiting for the previous pause
1414         to complete.  Use this with caution: your activity can not acquire any exclusive
1415         resources (such as opening the camera or recording audio) when it launches, or it
1416         may conflict with the previous activity and fail.
1417
1418         <p>The default value of this attribute is <code>false</code>. -->
1419    <attr name="resumeWhilePausing" format="boolean" />
1420
1421    <!-- Hint to platform that the activity works well in multi-window mode. Intended for a
1422         multi-window device where there can be multiple activities of various sizes on the screen
1423         at the same time.
1424
1425         <p>The default value is <code>false</code> for applications with
1426         <code>targetSdkVersion</code> lesser than {@link android.os.Build.VERSION_CODES#N} and
1427         <code>true</code> otherwise.
1428
1429         <p>Setting this flag to <code>false</code> lets the system know that the app may not be
1430         tested or optimized for multi-window environment. The system may still put such activity in
1431         multi-window with compatibility mode applied. It also does not guarantee that there will be
1432         no other apps in multi-window visible on screen (e.g. picture-in-picture) or on other
1433         displays. Therefore, this flag cannot be used to assure an exclusive resource access.
1434
1435         <p>NOTE: A task's root activity value is applied to all additional activities launched in
1436         the task. That is if the root activity of a task is resizeable then the system will treat
1437         all other activities in the task as resizeable and will not if the root activity isn't
1438         resizeable.
1439
1440         <p>NOTE: The value of {@link android.R.attr#screenOrientation} is ignored for
1441         resizeable activities when in multi-window mode before Android 12. -->
1442    <attr name="resizeableActivity" format="boolean" />
1443
1444    <!-- Indicates that the activity specifically supports the picture-in-picture form of
1445         multi-window. If true, this activity will support entering picture-in-picture, but will
1446         only support split-screen and other forms of multi-window if
1447         {@link android.R.attr#resizeableActivity} is also set to true.
1448
1449         Note that your activity may still be resized even if this attribute is true and
1450         {@link android.R.attr#resizeableActivity} is false.
1451
1452         <p>The default value is <code>false</code>.  -->
1453    <attr name="supportsPictureInPicture" format="boolean" />
1454
1455    <!-- This value indicates the maximum aspect ratio the activity supports. If the app runs on a
1456         device with a wider aspect ratio, the system automatically letterboxes the app, leaving
1457         portions of the screen unused so the app can run at its specified maximum aspect ratio.
1458         <p>
1459         Maximum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal
1460         form. For example, if the maximum aspect ratio is 7:3, set value to 2.33.
1461         <p>
1462         Value needs to be greater or equal to 1.0, otherwise it is ignored.
1463         <p>
1464         NOTE: This attribute is ignored if the activity has
1465         {@link android.R.attr#resizeableActivity} set to true. -->
1466    <attr name="maxAspectRatio" format="float" />
1467
1468    <!-- This value indicates the minimum aspect ratio the activity supports. If the app runs on a
1469         device with a narrower aspect ratio, the system automatically letterboxes the app, leaving
1470         portions of the screen unused so the app can run at its specified minimum aspect ratio.
1471         <p>
1472         Minimum aspect ratio, expressed as (longer dimension / shorter dimension) in decimal
1473         form. For example, if the minimum aspect ratio is 4:3, set value to 1.33.
1474         <p>
1475         Value needs to be greater or equal to 1.0, otherwise it is ignored.
1476         <p>
1477         NOTE: This attribute is ignored if the activity has
1478         {@link android.R.attr#resizeableActivity} set to true. -->
1479    <attr name="minAspectRatio" format="float" />
1480
1481    <!-- This value indicates how tasks rooted at this activity will behave in lockTask mode.
1482         While in lockTask mode the system will not launch non-permitted tasks until
1483         lockTask mode is disabled.
1484         <p>While in lockTask mode with multiple permitted tasks running, each launched task is
1485         permitted to finish, transitioning to the previous locked task, until there is only one
1486         task remaining. At that point the last task running is not permitted to finish, unless it
1487         uses the value always. -->
1488    <attr name="lockTaskMode">
1489        <!-- This is the default value. Tasks will not launch into lockTask mode but can be
1490             placed there by calling {@link android.app.Activity#startLockTask}. If a task with
1491             this mode has been allowlisted using {@link
1492             android.app.admin.DevicePolicyManager#setLockTaskPackages} then calling
1493             {@link android.app.Activity#startLockTask} will enter lockTask mode immediately,
1494             otherwise the user will be presented with a dialog to approve entering pinned mode.
1495             <p>If the system is already in lockTask mode when a new task rooted at this activity
1496             is launched that task will or will not start depending on whether the package of this
1497             activity has been allowlisted.
1498             <p>Tasks rooted at this activity can only exit lockTask mode using
1499             {@link android.app.Activity#stopLockTask}. -->
1500        <enum name="normal" value="0"/>
1501        <!-- Tasks will not launch into lockTask mode and cannot be placed there using
1502             {@link android.app.Activity#startLockTask} or be pinned from the Overview screen.
1503             If the system is already in lockTask mode when a new task rooted at this activity is
1504             launched that task will not be started.
1505             <p>Note: This mode is only available to system and privileged applications.
1506             Non-privileged apps with this value will be treated as normal.
1507             -->
1508        <enum name="never" value="1"/>
1509        <!-- Tasks rooted at this activity will always launch into lockTask mode. If the system is
1510             already in lockTask mode when this task is launched then the new task will be launched
1511             on top of the current task. Tasks launched in this mode are capable of exiting
1512             lockTask mode using {@link android.app.Activity#finish()}.
1513             <p>Note: This mode is only available to system and privileged applications.
1514             Non-privileged apps with this value will be treated as normal.
1515             -->
1516        <enum name="always" value="2"/>
1517        <!-- If the DevicePolicyManager (DPM) authorizes this package ({@link
1518             android.app.admin.DevicePolicyManager#setLockTaskPackages}) then this mode is
1519             identical to always, except that the activity needs to call
1520             {@link android.app.Activity#stopLockTask} before being able to finish if it is the last
1521             locked task.
1522             If the DPM does not authorize this package then this mode is identical to normal. -->
1523        <enum name="if_whitelisted" value="3"/>
1524    </attr>
1525    <!-- When set installer will extract native libraries. If set to false
1526         libraries in the apk must be stored and page-aligned.  -->
1527    <attr name="extractNativeLibs" format="boolean"/>
1528
1529    <!-- Specify whether an activity intent filter will need to be verified thru its set
1530         of data URIs. This will only be used when the Intent's action is set to
1531         {@link android.content.Intent#ACTION_VIEW Intent.ACTION_VIEW} and the Intent's category is
1532         set to {@link android.content.Intent#CATEGORY_BROWSABLE Intent.CATEGORY_BROWSABLE} and the
1533         intern filter data scheme is set to "http" or "https". When set to true, the intent filter
1534         will need to use its data tag for getting the URIs to verify with.
1535
1536         For each URI, an HTTPS network request will be done to <code>/.well-known/statements.json</code>
1537         host to verify that the web site is okay with the app intercepting the URI.
1538         -->
1539    <attr name="autoVerify" format="boolean" />
1540
1541    <!-- Specify whether a component should be visible to instant apps.
1542         -->
1543    <attr name="visibleToInstantApps" format="boolean" />
1544
1545    <!-- An XML resource with the application's Network Security Config. -->
1546    <attr name="networkSecurityConfig" format="reference" />
1547
1548    <!-- An XML resource with the application's {@link android.app.LocaleConfig} -->
1549    <attr name="localeConfig" format="reference" />
1550
1551    <!-- When an application is partitioned into splits, this is the name of the
1552         split that contains the defined component. -->
1553    <attr name="splitName" format="string" />
1554
1555    <!-- Specifies the target sandbox this app wants to use. Higher sandbox versions
1556         will have increasing levels of security.
1557
1558         <p>The default value of this attribute is <code>1</code>.
1559         <p>
1560         @deprecated The security properties have been moved to
1561         {@link android.os.Build.VERSION Build.VERSION} 27 and 28. -->
1562    <attr name="targetSandboxVersion" format="integer" />
1563
1564    <!-- The user-visible SDK version (ex. 26) of the framework against which the application was
1565         compiled. This attribute is automatically specified by the Android build tools and should
1566         NOT be manually specified.
1567         <p>
1568         This attribute is the compile-time equivalent of
1569         {@link android.os.Build.VERSION#SDK_INT Build.VERSION.SDK_INT}. -->
1570    <attr name="compileSdkVersion" format="integer" />
1571
1572    <!-- The development codename (ex. "O") of the framework against which the application was
1573         compiled, or "REL" if the application was compiled against a release build. This attribute
1574         is automatically specified by the Android build tools and should NOT be manually
1575         specified.
1576         <p>
1577         This attribute is the compile-time equivalent of
1578         {@link android.os.Build.VERSION#CODENAME Build.VERSION.CODENAME}. -->
1579    <attr name="compileSdkVersionCodename" format="string" />
1580
1581    <!-- The (optional) fully-qualified name for a subclass of
1582         {@link android.app.AppComponentFactory} that the system uses to instantiate
1583         every other manifest defined class. Most applications
1584         don't need this attribute. If it's not specified, the system
1585         instantiates items without it.-->
1586    <attr name="appComponentFactory" format="string" />
1587
1588    <attr name="usesNonSdkApi" format="boolean" />
1589
1590    <!-- Whether attributions provided are meant to be user-visible. -->
1591    <attr name="attributionsAreUserVisible" format="boolean" />
1592
1593    <!-- Specify the type of foreground service. Multiple types can be specified by ORing the flags
1594         together. -->
1595    <attr name="foregroundServiceType">
1596        <!-- Data (photo, file, account) upload/download, backup/restore, import/export, fetch,
1597            transfer over network between device and cloud.
1598
1599            <p>For apps with <code>targetSdkVersion</code>
1600            {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, this type should NOT
1601            be used: calling
1602            {@link android.app.Service#startForeground(int, android.app.Notification, int)} with
1603            this type on devices running {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE}
1604            is still allowed, but calling it with this type on devices running future platform
1605            releases may get a {@link android.app.InvalidForegroundServiceTypeException}.
1606        -->
1607        <flag name="dataSync" value="0x01" />
1608        <!-- Music, video, news or other media play.
1609
1610            <p>For apps with <code>targetSdkVersion</code>
1611            {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, starting a foreground
1612            service with this type will require permission
1613            {@link android.Manifest.permission#FOREGROUND_SERVICE_MEDIA_PLAYBACK}.
1614        -->
1615        <flag name="mediaPlayback" value="0x02" />
1616        <!-- Ongoing operations related to phone calls, video conferencing,
1617            or similar interactive communication.
1618
1619            <p>For apps with <code>targetSdkVersion</code>
1620            {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, starting a foreground
1621            service with this type will require permission
1622            {@link android.Manifest.permission#FOREGROUND_SERVICE_PHONE_CALL} and
1623            {@link android.Manifest.permission#MANAGE_OWN_CALLS} or holding the default
1624            {@link android.app.role.RoleManager#ROLE_DIALER dialer role}.
1625        -->
1626        <flag name="phoneCall" value="0x04" />
1627        <!-- GPS, map, navigation location update.
1628
1629            <p>For apps with <code>targetSdkVersion</code>
1630            {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, starting a foreground
1631            service with this type will require permission
1632            {@link android.Manifest.permission#FOREGROUND_SERVICE_LOCATION} and one of the
1633            following permissions:
1634            {@link android.Manifest.permission#ACCESS_COARSE_LOCATION},
1635            {@link android.Manifest.permission#ACCESS_FINE_LOCATION}.
1636        -->
1637        <flag name="location" value="0x08" />
1638        <!-- Auto, bluetooth, TV or other devices connection, monitoring and interaction.
1639
1640            <p>For apps with <code>targetSdkVersion</code>
1641            {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, starting a foreground
1642            service with this type will require permission
1643            {@link android.Manifest.permission#FOREGROUND_SERVICE_CONNECTED_DEVICE} and one of the
1644            following permissions:
1645            {@link android.Manifest.permission#BLUETOOTH_CONNECT},
1646            {@link android.Manifest.permission#CHANGE_NETWORK_STATE},
1647            {@link android.Manifest.permission#CHANGE_WIFI_STATE},
1648            {@link android.Manifest.permission#CHANGE_WIFI_MULTICAST_STATE},
1649            {@link android.Manifest.permission#NFC},
1650            {@link android.Manifest.permission#TRANSMIT_IR},
1651            or has been granted the access to one of the attached USB devices/accessories.
1652        -->
1653        <flag name="connectedDevice" value="0x10" />
1654        <!-- Managing a {@link android.media.projection.MediaProjection MediaProjection} session,
1655             e.g., for screen recording or takingscreenshots.
1656
1657             <p>
1658             To capture through {@link android.media.projection.MediaProjection}, an app must start
1659             a foreground service with the type corresponding to this constant. This type should
1660             only be used for {@link android.media.projection.MediaProjection}. Capturing screen
1661             contents via
1662             {@link android.media.projection.MediaProjection#createVirtualDisplay(String, int, int,
1663             int, int, android.view.Surface, android.hardware.display.VirtualDisplay.Callback,
1664             android.os.Handler) createVirtualDisplay} conveniently allows recording, presenting
1665             screen contents into a meeting, taking screenshots, or several other scenarios.
1666             </p>
1667
1668             <p>For apps with <code>targetSdkVersion</code>
1669             {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, starting a
1670             foreground service with this type will require permission
1671             {@link android.Manifest.permission#FOREGROUND_SERVICE_MEDIA_PROJECTION}, and the user
1672             must have allowed the screen capture request from this app.
1673        -->
1674        <flag name="mediaProjection" value="0x20" />
1675        <!-- Use the camera device or record video.
1676
1677            <p>For apps with <code>targetSdkVersion</code> {@link android.os.Build.VERSION_CODES#R}
1678            and above, a foreground service will not be able to access the camera if this type is
1679            not specified in the manifest and in
1680            {@link android.app.Service#startForeground(int, android.app.Notification, int)}.
1681
1682            <p>For apps with <code>targetSdkVersion</code>
1683            {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, starting a foreground
1684            service with this type will require permission
1685            {@link android.Manifest.permission#FOREGROUND_SERVICE_CAMERA} and
1686            {@link android.Manifest.permission#CAMERA}.
1687            -->
1688        <flag name="camera" value="0x40" />
1689        <!--Use the microphone device or record audio.
1690
1691            <p>For apps with <code>targetSdkVersion</code> {@link android.os.Build.VERSION_CODES#R}
1692            and above, a foreground service will not be able to access the microphone if this type
1693            is not specified in the manifest and in
1694            {@link android.app.Service#startForeground(int, android.app.Notification, int)}.
1695
1696            <p>For apps with <code>targetSdkVersion</code>
1697            {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above, starting a foreground
1698            service with this type will require permission
1699            {@link android.Manifest.permission#FOREGROUND_SERVICE_MICROPHONE} and one of the
1700            following permissions:
1701            {@link android.Manifest.permission#CAPTURE_AUDIO_OUTPUT},
1702            {@link android.Manifest.permission#RECORD_AUDIO}.
1703            -->
1704        <flag name="microphone" value="0x80" />
1705        <!--Health, wellness and fitness.
1706            <p>Requires the app to hold the permission
1707            {@link android.Manifest.permission#FOREGROUND_SERVICE_HEALTH} and one of the following
1708            permissions
1709            {@link android.Manifest.permission#ACTIVITY_RECOGNITION},
1710            {@link android.Manifest.permission#BODY_SENSORS},
1711            {@link android.Manifest.permission#HIGH_SAMPLING_RATE_SENSORS}.
1712        -->
1713        <flag name="health" value="0x100" />
1714        <!-- Messaging use cases which host local server to relay messages across devices.
1715            <p>Requires the app to hold the permission
1716            {@link android.Manifest.permission#FOREGROUND_SERVICE_REMOTE_MESSAGING} in order to use
1717            this type.
1718        -->
1719        <flag name="remoteMessaging" value="0x200" />
1720        <!-- The system exempted foreground service use cases.
1721            <p>Requires the app to hold the permission
1722            {@link android.Manifest.permission#FOREGROUND_SERVICE_SYSTEM_EXEMPTED} in order to use
1723            this type. Apps are allowed to use this type only in the use cases listed in
1724            {@link android.content.pm.ServiceInfo#FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED}.
1725        -->
1726        <flag name="systemExempted" value="0x400" />
1727        <!-- "Short service" foreground service type. See
1728           {@link android.content.pm.ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE}.
1729           for more details.
1730        -->
1731        <flag name="shortService" value="0x800" />
1732        <!-- The file management use case which manages files/directories, often involving file I/O
1733            across the file system.
1734            <p>Requires the app to hold the permission
1735            {@link android.Manifest.permission#FOREGROUND_SERVICE_FILE_MANAGEMENT} in order to use
1736            this type.
1737
1738            TODO: b/258855262 mark this field as {@code hide} once this bug is fixed.
1739            <flag name="fileManagement" value="0x1000" />
1740        -->
1741        <!-- Use cases that can't be categorized into any other foreground service types, but also
1742            can't use @link android.app.job.JobInfo.Builder} APIs.
1743            See {@link android.content.pm.ServiceInfo#FOREGROUND_SERVICE_TYPE_SPECIAL_USE} for the
1744            best practice of the use of this type.
1745
1746            <p>Requires the app to hold the permission
1747            {@link android.Manifest.permission#FOREGROUND_SERVICE_SPECIAL_USE} in order to use
1748            this type.
1749        -->
1750        <flag name="specialUse" value="0x40000000" />
1751    </attr>
1752
1753    <!-- Enable sampled memory bug detection in this process.
1754         When enabled, a very small, random subset of native
1755         memory allocations are protected with guard pages, providing an
1756         ASan-like error report in case of a memory corruption bug.
1757
1758         GWP-ASan is a recursive acronym. It stands for “GWP-ASan Will Provide Allocation SANity”.
1759         See the <a href="http://llvm.org/docs/GwpAsan.html">LLVM documentation</a>
1760         for more information about this feature.
1761
1762         <p>This attribute can be applied to a
1763         {@link android.R.styleable#AndroidManifestProcess process} tag, or to an
1764         {@link android.R.styleable#AndroidManifestApplication application} tag (to supply
1765         a default setting for all application components). -->
1766    <attr name="gwpAsanMode">
1767        <!-- Default behavior: GwpAsan is disabled in user apps, randomly enabled in system apps. -->
1768        <enum name="default" value="-1" />
1769        <!-- Never enable GwpAsan. -->
1770        <enum name="never" value="0" />
1771        <!-- Always enable GwpAsan. -->
1772       <enum name="always" value="1" />
1773    </attr>
1774
1775    <!-- Enable hardware memory tagging (ARM MTE) in this process.
1776         When enabled, heap memory bugs like use-after-free and buffer overflow
1777         are detected and result in an immediate ("sync" mode) or delayed ("async"
1778         mode) crash instead of a silent memory corruption. Sync mode, while slower,
1779         provides enhanced bug reports including stack traces at the time of allocation
1780         and deallocation of memory, similar to AddressSanitizer.
1781
1782         See the <a href="https://community.arm.com/developer/ip-products/processors/b/processors-ip-blog/posts/enhancing-memory-safety">ARM announcement</a>
1783         for more details.
1784
1785         <p>This attribute can be applied to a
1786         {@link android.R.styleable#AndroidManifestProcess process} tag, or to an
1787         {@link android.R.styleable#AndroidManifestApplication application} tag (to supply
1788         a default setting for all application components). -->
1789    <attr name="memtagMode">
1790       <enum name="default" value="-1" />
1791       <enum name="off" value="0" />
1792       <enum name="async" value="1" />
1793       <enum name="sync" value="2" />
1794    </attr>
1795
1796    <!-- Attribution tag to be used for permission sub-attribution if a
1797      permission is checked in  {@link android.content.Context#sendBroadcast(Intent, String)}.
1798      Multiple tags can be specified separated by '|'.
1799    -->
1800    <attr name="attributionTags" format="string" />
1801
1802    <attr name="allowUpdateOwnership" format="boolean" />
1803
1804    <!-- The <code>manifest</code> tag is the root of an
1805         <code>AndroidManifest.xml</code> file,
1806         describing the contents of an Android package (.apk) file.  One
1807         attribute must always be supplied: <code>package</code> gives a
1808         unique name for the package, using a Java-style naming convention
1809         to avoid name collisions.  For example, applications published
1810         by Google could have names of the form
1811         <code>com.google.app.<em>appname</em></code>
1812
1813         <p>Inside of the manifest tag, may appear the following tags
1814         in any order: {@link #AndroidManifestAttribution attribution},
1815         {@link #AndroidManifestPermission permission},
1816         {@link #AndroidManifestPermissionGroup permission-group},
1817         {@link #AndroidManifestPermissionTree permission-tree},
1818         {@link #AndroidManifestUsesSdk uses-sdk},
1819         {@link #AndroidManifestUsesPermission uses-permission},
1820         {@link #AndroidManifestUsesConfiguration uses-configuration},
1821         {@link #AndroidManifestApplication application},
1822         {@link #AndroidManifestInstrumentation instrumentation},
1823         {@link #AndroidManifestUsesFeature uses-feature}.  -->
1824    <declare-styleable name="AndroidManifest">
1825        <attr name="versionCode" />
1826        <attr name="versionCodeMajor" />
1827        <attr name="versionName" />
1828        <attr name="revisionCode" />
1829        <attr name="sharedUserId" />
1830        <attr name="sharedUserLabel" />
1831        <attr name="sharedUserMaxSdkVersion" />
1832        <attr name="installLocation" />
1833        <attr name="isolatedSplits" />
1834        <attr name="isFeatureSplit" />
1835        <attr name="targetSandboxVersion" />
1836        <attr name="compileSdkVersion" />
1837        <attr name="compileSdkVersionCodename" />
1838        <attr name="isSplitRequired" />
1839        <attr name="requiredSplitTypes" />
1840        <attr name="splitTypes" />
1841    </declare-styleable>
1842
1843    <!-- The <code>application</code> tag describes application-level components
1844         contained in the package, as well as general application
1845         attributes.  Many of the attributes you can supply here (such
1846         as theme, label, icon, permission, process, taskAffinity,
1847         and allowTaskReparenting) serve
1848         as default values for the corresponding attributes of components
1849         declared inside of the application.
1850
1851         <p>Inside of this element you specify what the application contains,
1852         using the elements {@link #AndroidManifestProvider provider},
1853         {@link #AndroidManifestService service},
1854         {@link #AndroidManifestReceiver receiver},
1855         {@link #AndroidManifestActivity activity},
1856         {@link #AndroidManifestActivityAlias activity-alias},
1857         {@link #AndroidManifestUsesLibrary uses-library},
1858         {@link #AndroidManifestUsesStaticLibrary uses-static-library}, and
1859         {@link #AndroidManifestUsesPackage uses-package}.
1860         The application tag
1861         appears as a child of the root {@link #AndroidManifest manifest} tag in
1862         an application's manifest file. -->
1863    <declare-styleable name="AndroidManifestApplication" parent="AndroidManifest">
1864        <!-- The (optional) fully-qualified name for a subclass of
1865             {@link android.app.Application} that the system instantiates before
1866             any other class when an app's process starts. Most applications
1867             don't need this attribute. If it's not specified, the system
1868             instantiates the base Application class instead.-->
1869        <attr name="name" />
1870        <attr name="theme" />
1871        <attr name="label" />
1872        <attr name="icon" />
1873        <attr name="roundIcon" />
1874        <attr name="banner" />
1875        <attr name="logo" />
1876        <attr name="description" />
1877        <attr name="permission" />
1878        <attr name="process" />
1879        <attr name="taskAffinity" />
1880        <attr name="allowTaskReparenting" />
1881        <!-- Indicate whether this application contains code.  If set to false,
1882             there is no code associated with it and thus the system will not
1883             try to load its code when launching components.  The default is true
1884             for normal behavior. -->
1885        <attr name="hasCode" format="boolean" />
1886        <attr name="persistent" />
1887        <attr name="persistentWhenFeatureAvailable" />
1888        <attr name="requiredForAllUsers" />
1889        <!-- Specify whether the components in this application are enabled or not (that is, can be
1890             instantiated by the system).
1891             If "false", it overrides any component specific values (a value of "true" will not
1892             override the component specific values). -->
1893        <attr name="enabled" />
1894        <attr name="debuggable" />
1895        <attr name="vmSafeMode" />
1896        <attr name="hardwareAccelerated" />
1897        <!-- Name of activity to be launched for managing the application's space on the device. -->
1898        <attr name="manageSpaceActivity" />
1899        <attr name="allowClearUserData" />
1900        <attr name="testOnly" />
1901        <attr name="backupAgent" />
1902        <attr name="allowBackup" />
1903        <attr name="fullBackupOnly" />
1904        <attr name="fullBackupContent" />
1905        <attr name="killAfterRestore" />
1906        <attr name="restoreNeedsApplication" />
1907        <attr name="restoreAnyVersion" />
1908        <attr name="backupInForeground" />
1909        <!-- Request that your application's processes be created with
1910             a large Dalvik heap.  This applies to <em>all</em> processes
1911             created for the application.  It only applies to the first
1912             application loaded into a process; if using a sharedUserId
1913             to allow multiple applications to use a process, they all must
1914             use this option consistently or will get unpredictable results. -->
1915        <attr name="largeHeap" format="boolean" />
1916        <!-- Declare that this application can't participate in the normal
1917             state save/restore mechanism.  Since it is not able to save and
1918             restore its state on demand,
1919             it can not participate in the normal activity lifecycle.  It will
1920             not be killed while in the background; the user must explicitly
1921             quit it.  Only one such app can be running at a time; if the user
1922             tries to launch a second such app, they will be prompted
1923             to quit the first before doing so.  While the
1924             application is running, the user will be informed of this. -->
1925        <attr name="cantSaveState" format="boolean" />
1926        <attr name="uiOptions" />
1927        <!-- Declare that your application will be able to deal with RTL (right to left) layouts.
1928             The default value is false. -->
1929        <attr name="supportsRtl" format="boolean" />
1930        <!-- Declare that this application requires access to restricted accounts of a certain
1931             type. The default value is null and restricted accounts won\'t be visible to this
1932             application. The type should correspond to the account authenticator type, such as
1933             "com.google". -->
1934        <attr name="restrictedAccountType" format="string"/>
1935        <!-- Declare that this application requires an account of a certain
1936             type. The default value is null and indicates that the application can work without
1937             any accounts. The type should correspond to the account authenticator type, such as
1938             "com.google". -->
1939        <attr name="requiredAccountType" format="string"/>
1940        <!-- @deprecated replaced by setting appCategory attribute to "game" -->
1941        <attr name="isGame" />
1942        <!-- Declare that this application may use cleartext traffic, such as HTTP rather than
1943             HTTPS; WebSockets rather than WebSockets Secure; XMPP, IMAP, SMTP without STARTTLS or
1944             TLS). Defaults to true. If set to false {@code false}, the application declares that it
1945             does not intend to use cleartext network traffic, in which case platform components
1946             (e.g. HTTP stacks, {@code DownloadManager}, {@code MediaPlayer}) will refuse
1947             applications's requests to use cleartext traffic. Third-party libraries are encouraged
1948             to honor this flag as well. -->
1949        <attr name="usesCleartextTraffic" />
1950        <attr name="multiArch" />
1951        <attr name="useEmbeddedDex" />
1952        <attr name="extractNativeLibs" />
1953        <attr name="defaultToDeviceProtectedStorage" format="boolean" />
1954        <attr name="directBootAware" />
1955        <attr name="resizeableActivity" />
1956        <attr name="maxAspectRatio" />
1957        <attr name="minAspectRatio" />
1958        <attr name="networkSecurityConfig" />
1959        <attr name="localeConfig" />
1960        <!-- Declare the category of this app. Categories are used to cluster multiple apps
1961             together into meaningful groups, such as when summarizing battery, network, or
1962             disk usage. Apps should only define this value when they fit well into one of
1963             the specific categories. -->
1964        <attr name="appCategory">
1965            <!-- Apps which are primarily games. -->
1966            <enum name="game" value="0" />
1967            <!-- Apps which primarily work with audio or music, such as music players. -->
1968            <enum name="audio" value="1" />
1969            <!-- Apps which primarily work with video or movies, such as streaming video apps. -->
1970            <enum name="video" value="2" />
1971            <!-- Apps which primarily work with images or photos, such as camera or gallery apps. -->
1972            <enum name="image" value="3" />
1973            <!-- Apps which are primarily social apps, such as messaging, communication, email, or social network apps. -->
1974            <enum name="social" value="4" />
1975            <!-- Apps which are primarily news apps, such as newspapers, magazines, or sports apps. -->
1976            <enum name="news" value="5" />
1977            <!-- Apps which are primarily maps apps, such as navigation apps. -->
1978            <enum name="maps" value="6" />
1979            <!-- Apps which are primarily productivity apps, such as cloud storage or workplace apps. -->
1980            <enum name="productivity" value="7" />
1981            <!-- Apps which are primarily accessibility apps, such as screen-readers. -->
1982            <enum name="accessibility" value="8" />
1983        </attr>
1984
1985        <!-- Declares the kind of classloader this application's classes must be loaded with -->
1986        <attr name="classLoader" />
1987
1988        <attr name="appComponentFactory" />
1989
1990        <!-- Declares that this application should be invoked without non-SDK API enforcement -->
1991        <attr name="usesNonSdkApi" />
1992
1993        <!-- If {@code true} the user is prompted to keep the app's data on uninstall -->
1994        <attr name="hasFragileUserData" format="boolean"/>
1995
1996        <attr name="zygotePreloadName" />
1997
1998        <!-- If {@code true} the system will clear app's data if a restore operation fails.
1999             This flag is turned on by default. <em>This attribute is usable only by system apps.
2000             </em> -->
2001        <attr name="allowClearUserDataOnFailedRestore" format="boolean"/>
2002        <!-- If {@code true} the app's non sensitive audio can be captured by other apps with
2003             {@link android.media.AudioPlaybackCaptureConfiguration} and a
2004             {@link android.media.projection.MediaProjection}.
2005
2006             If {@code false} the audio played by the application will never be captured by non
2007             system apps. It is equivalent to limiting
2008             {@link android.media.AudioManager#setAllowedCapturePolicy(int)} to
2009             {@link android.media.AudioAttributes#ALLOW_CAPTURE_BY_SYSTEM}.
2010
2011             <p>
2012             Non sensitive audio is defined as audio whose {@code AttributeUsage} is
2013             {@code USAGE_UNKNOWN}), {@code USAGE_MEDIA}) or {@code USAGE_GAME}).
2014             All other usages like {@code USAGE_VOICE_COMMUNICATION} will not be captured.
2015
2016             <p>
2017             The default value is:
2018                 - {@code true} for apps with targetSdkVersion >= 29 (Q).
2019                 - {@code false} for apps with targetSdkVersion < 29.
2020
2021             <p>
2022             See {@link android.media.AudioPlaybackCaptureConfiguration} for more detail.
2023             -->
2024        <attr name="allowAudioPlaybackCapture" format="boolean" />
2025        <!-- If {@code true} this app would like to run under the legacy storage
2026             model. Note that this may not always be respected due to policy or
2027             backwards compatibility reasons.
2028
2029             <p>Apps not requesting legacy storage can continue to discover and
2030             read media belonging to other apps via {@code MediaStore}.
2031             <p>
2032             The default value is:
2033                 - {@code false} for apps with targetSdkVersion >= 29 (Q).
2034                 - {@code true} for apps with targetSdkVersion < 29.
2035             -->
2036        <attr name="requestLegacyExternalStorage" format="boolean" />
2037
2038        <!-- If {@code true} this app would like to preserve the legacy storage
2039             model from a previously installed version. Note that this may not always be
2040             respected due to policy or backwards compatibility reasons.
2041
2042             <p>This has no effect on the first install of an app on a device.
2043             For an updating app, setting this to {@code true} will preserve the legacy behaviour
2044             configured by the {@code requestLegacyExternalStorage} flag. If on an update, this
2045             flag is set to {@code false} then the legacy access is not preserved, such an app can
2046             only have legacy access with the {@code requestLegacyExternalStorage} flag.
2047             <p>
2048
2049             The default value is {@code false}.
2050             -->
2051        <attr name="preserveLegacyExternalStorage" format="boolean" />
2052
2053        <!-- If {@code true} this app would like raw external storage access.
2054
2055        <p> This flag can only be used by apps holding
2056        <ul>
2057        <li>{@link android.Manifest.permission#MANAGE_EXTERNAL_STORAGE} permission or
2058        <li>{@link android.app.role}#SYSTEM_GALLERY role.
2059        </ul>
2060        <p> When the flag is set, all file path access on external storage will bypass database
2061        operations that update MediaStore collection. Raw external storage access as a side effect
2062        can improve performance of bulk file path operations but can cause unexpected behavior in
2063        apps due to inconsistencies in MediaStore collection and lower file system.
2064        When the flag is set, app should scan the file after file path operations to ensure
2065        consistency of MediaStore collection.
2066        <p> The flag can be set to false if the app doesn't do many bulk file path operations or if
2067        app prefers the system to ensure the consistency of the MediaStore collection for file path
2068        operations without scanning the file.
2069
2070        <p> The default value is {@code true} if
2071        <ul>
2072        <li>app has {@link android.Manifest.permission#MANAGE_EXTERNAL_STORAGE} permission and
2073        targets targetSDK<=30.
2074        <li>app has {@link android.app.role}#SYSTEM_GALLERY role and targetSDK<=29
2075        </ul>
2076        {@code false} otherwise.
2077        -->
2078        <attr name="requestRawExternalStorageAccess" format="boolean" />
2079
2080        <!-- If {@code true} this app declares that it should be visible to all other apps on
2081             device, regardless of what they declare via the {@code queries} tags in their
2082             manifest.
2083
2084             The default value is {@code false}. -->
2085        <attr name="forceQueryable" format="boolean" />
2086
2087        <!-- If {@code true} indicates that this application is capable of presenting a unified
2088             interface representing multiple profiles.
2089
2090             The default value is {@code false}. -->
2091        <attr name="crossProfile" format="boolean" />
2092
2093        <!-- If {@code true} this app will receive tagged pointers to native heap allocations
2094             from functions like malloc() on compatible devices. Note that this may not always
2095             be respected due to policy or backwards compatibility reasons. See the
2096             <a href="https://source.android.com/devices/tech/debug/tagged-pointers">Tagged Pointers</a>
2097             document for more information on this feature.
2098
2099             The default value is {@code true}. -->
2100        <attr name="allowNativeHeapPointerTagging" format="boolean" />
2101
2102        <attr name="gwpAsanMode" />
2103
2104        <attr name="memtagMode" />
2105
2106        <!-- If {@code true} enables automatic zero initialization of all native heap
2107             allocations. -->
2108        <attr name="nativeHeapZeroInitialized" format="boolean" />
2109
2110        <!-- @hide no longer used, kept to preserve padding -->
2111        <attr name="allowAutoRevokePermissionsExemption" format="boolean" />
2112
2113        <!-- No longer used. Declaring this does nothing -->
2114        <attr name="autoRevokePermissions">
2115            <!-- No longer used -->
2116            <enum name="allowed" value="0" />
2117            <!-- No longer used -->
2118            <enum name="discouraged" value="1" />
2119            <!-- No longer used -->
2120            <enum name="disallowed" value="2" />
2121        </attr>
2122
2123        <!-- Declare the policy to deal with user data when rollback is committed. -->
2124        <attr name="rollbackDataPolicy">
2125            <!-- User data will be restored during rollback. -->
2126            <enum name="restore" value="0" />
2127            <!-- User data will be wiped out during rollback. -->
2128            <enum name="wipe" value="1" />
2129            <!-- User data will remain unchanged during rollback. -->
2130            <enum name="retain" value="2" />
2131        </attr>
2132
2133        <!-- Applications can set this attribute to an xml resource within their app where they
2134         specified the rules determining which files and directories can be copied from the device
2135         as part of backup or transfer operations.
2136
2137         See the <a href="{@docRoot}about/versions/12/backup-restore">Changes in backup and restore</a>
2138         document for the format of the XML file.-->
2139        <attr name="dataExtractionRules" format="reference"/>
2140
2141        <!-- @hide Request exemption from the foreground service restrictions introduced in S
2142        (https://developer.android.com/about/versions/12/foreground-services)
2143        Note the framework <b>ignores</b> this attribute at this time. Once apps target S or above,
2144        there's no way to be exempted (without using a privileged permission).
2145        -->
2146        <attr name="requestForegroundServiceExemption" format="boolean" />
2147
2148        <!-- Whether attributions provided are meant to be user-visible. -->
2149        <attr name="attributionsAreUserVisible" format="boolean" />
2150
2151        <!-- Specifies whether enabled settings of components in the application should be
2152             reset to {@link android.content.pm.PackageManager#COMPONENT_ENABLED_STATE_DEFAULT}
2153             when the application's user data is cleared. The default value is false.
2154        -->
2155        <attr name="resetEnabledSettingsOnAppDataCleared" format="boolean" />
2156        <attr name="knownActivityEmbeddingCerts" />
2157
2158        <!-- If false, {@link android.view.KeyEvent#KEYCODE_BACK KEYCODE_BACK} and
2159             {@link android.app.Activity#onBackPressed Activity.onBackPressed()}
2160             and related event will be forwarded to the Activities and View, otherwise those events
2161             will be replaced by a call to
2162             {@link android.window.OnBackInvokedCallback#onBackInvoked
2163             OnBackInvokedCallback.onBackInvoked()} on the focused window. -->
2164        <attr name="enableOnBackInvokedCallback" format="boolean"/>
2165    </declare-styleable>
2166
2167    <!-- An attribution is a logical part of an app and is identified by a tag.
2168    E.g. a photo sharing app might include a direct messaging component. To tag certain code as
2169    belonging to an attribution, use a context created via
2170    {@link android.content.Context#createAttributionContext(String)} for any interaction with the
2171    system.
2172
2173    <p>This appears as a child tag of the root {@link #AndroidManifest manifest} tag.
2174
2175    <p>In case this attribution inherits from another attribution, this tag can contain one or
2176    multiple {@link #AndroidManifestAttributionInheritFrom inherit-from} tags. -->
2177    <declare-styleable name="AndroidManifestAttribution" parent="AndroidManifest">
2178        <!-- Required identifier for a attribution. Can be passed to
2179        {@link android.content.Context#createAttributionContext} to create a context tagged with
2180        this attribution
2181        -->
2182        <attr name="tag" format="string" />
2183        <!-- Required user visible label for a attribution. -->
2184        <attr name="label" format="string" />
2185    </declare-styleable>
2186
2187    <!-- Declares previously declared attributions this attribution inherits from. -->
2188    <declare-styleable name="AndroidManifestAttributionInheritFrom"
2189                       parent="AndroidManifestAttribution">
2190        <!-- Identifier of the attribution this attribution inherits from -->
2191        <attr name="tag" format="string" />
2192    </declare-styleable>
2193
2194    <!-- The <code>permission</code> tag declares a security permission that can be
2195         used to control access from other packages to specific components or
2196         features in your package (or other packages).  See the
2197         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
2198         document for more information on permissions.
2199
2200         <p>This appears as a child tag of the root
2201         {@link #AndroidManifest manifest} tag. -->
2202    <declare-styleable name="AndroidManifestPermission" parent="AndroidManifest">
2203        <!-- Required public name of the permission, which other components and
2204        packages will use when referring to this permission.  This is a string using
2205        Java-style scoping to ensure it is unique.  The prefix will often
2206        be the same as our overall package name, for example
2207        "com.mycompany.android.myapp.SomePermission". -->
2208        <attr name="name" />
2209        <attr name="label" />
2210        <attr name="icon" />
2211        <attr name="roundIcon" />
2212        <attr name="banner" />
2213        <attr name="logo" />
2214        <attr name="permissionGroup" />
2215        <attr name="backgroundPermission" format="string"/>
2216        <attr name="description" />
2217        <attr name="request" />
2218        <attr name="protectionLevel" />
2219        <attr name="permissionFlags" />
2220        <attr name="knownCerts" />
2221        <!-- Optional: specify the maximum version of the Android OS for which the
2222             application wishes to create the permission.  When running on a version
2223             of Android higher than the number given here, the permission will not
2224             be created.  -->
2225        <attr name="maxSdkVersion" />
2226    </declare-styleable>
2227
2228    <!-- The <code>permission-group</code> tag declares a logical grouping of
2229         related permissions.
2230
2231         <p>Note that this tag does not declare a permission itself, only
2232         a namespace in which further permissions can be placed.  See
2233         the {@link #AndroidManifestPermission &lt;permission&gt;} tag for
2234         more information.
2235
2236         <p>This appears as a child tag of the root
2237         {@link #AndroidManifest manifest} tag. -->
2238    <declare-styleable name="AndroidManifestPermissionGroup" parent="AndroidManifest">
2239        <!-- Required public name of the permission group, permissions will use
2240        to specify the group they are in.  This is a string using
2241        Java-style scoping to ensure it is unique.  The prefix will often
2242        be the same as our overall package name, for example
2243        "com.mycompany.android.myapp.SomePermission". -->
2244        <attr name="name" />
2245        <attr name="label" />
2246        <attr name="icon" />
2247        <attr name="roundIcon" />
2248        <attr name="banner" />
2249        <attr name="logo" />
2250        <attr name="description" />
2251        <attr name="request" format="string"/>
2252        <attr name="requestDetail" format="string"/>
2253        <attr name="backgroundRequest" format="string"/>
2254        <attr name="backgroundRequestDetail" format="string"/>
2255        <attr name="permissionGroupFlags" />
2256        <attr name="priority" />
2257    </declare-styleable>
2258
2259    <!-- The <code>permission-tree</code> tag declares the base of a tree of
2260         permission values: it declares that this package has ownership of
2261         the given permission name, as well as all names underneath it
2262         (separated by '.').  This allows you to use the
2263         {@link android.content.pm.PackageManager#addPermission
2264         PackageManager.addPermission()} method to dynamically add new
2265         permissions under this tree.
2266
2267         <p>Note that this tag does not declare a permission itself, only
2268         a namespace in which further permissions can be placed.  See
2269         the {@link #AndroidManifestPermission &lt;permission&gt;} tag for
2270         more information.
2271
2272         <p>This appears as a child tag of the root
2273         {@link #AndroidManifest manifest} tag. -->
2274    <declare-styleable name="AndroidManifestPermissionTree" parent="AndroidManifest">
2275        <!-- Required public name of the permission tree, which is the base name
2276        of all permissions under it.  This is a string using
2277        Java-style scoping to ensure it is unique.  The prefix will often
2278        be the same as our overall package name, for example
2279        "com.mycompany.android.myapp.SomePermission".  A permission tree name
2280        must have more than two segments in its path; that is,
2281        "com.me.foo" is okay, but not "com.me" or "com". -->
2282        <attr name="name" />
2283        <attr name="label" />
2284        <attr name="icon" />
2285        <attr name="roundIcon" />
2286        <attr name="banner" />
2287        <attr name="logo" />
2288    </declare-styleable>
2289
2290    <!-- The <code>uses-permission</code> tag requests a
2291         {@link #AndroidManifestPermission &lt;permission&gt;} that the containing
2292         package must be granted in order for it to operate correctly. For runtime
2293         permissions, i.e. ones with <code>dangerous</code> protection level, on a
2294         platform that supports runtime permissions, the permission will not be
2295         granted until the app explicitly requests it at runtime and the user approves
2296         the grant. You cannot request at runtime permissions that are not declared
2297         as used in the manifest. See the
2298         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
2299         document for more information on permissions.  Also available is a
2300         {@link android.Manifest.permission list of permissions} included
2301         with the base platform.
2302
2303         <p>This appears as a child tag of the root
2304         {@link #AndroidManifest manifest} tag. -->
2305    <declare-styleable name="AndroidManifestUsesPermission" parent="AndroidManifest">
2306        <!-- Required name of the permission you use, as published with the
2307        corresponding name attribute of a
2308        {@link android.R.styleable#AndroidManifestPermission &lt;permission&gt;}
2309        tag; often this is one of the {@link android.Manifest.permission standard
2310        system permissions}. -->
2311        <attr name="name" />
2312        <!-- Optional: specify the minimum version of the Android OS for which the
2313             application wishes to request the permission.  When running on a version
2314             of Android lower than the number given here, the permission will not
2315             be requested. -->
2316        <attr name="minSdkVersion" format="integer|string" />
2317        <!-- Optional: specify the maximum version of the Android OS for which the
2318             application wishes to request the permission.  When running on a version
2319             of Android higher than the number given here, the permission will not
2320             be requested.  -->
2321        <attr name="maxSdkVersion" format="integer" />
2322        <!-- Optional: the system must support this feature for the permission to be
2323        requested.  If it doesn't support the feature, it will be as if the manifest didn't
2324        request it at all. -->
2325        <attr name="requiredFeature" format="string" />
2326        <!-- Optional: the system must NOT support this feature for the permission to be
2327        requested.  If it does support the feature, it will be as if the manifest didn't
2328        request it at all. -->
2329        <attr name="requiredNotFeature" format="string" />
2330        <!-- Optional: set of flags that should apply to this permission request. Note that
2331             these flags start at 0x4 to match PackageInfo.requestedPermissionsFlags. -->
2332        <attr name="usesPermissionFlags">
2333            <!-- Strong assertion by a developer that they will never use this
2334                 permission to derive the physical location of the device, even
2335                 when the app has been granted the ACCESS_FINE_LOCATION and/or
2336                 ACCESS_COARSE_LOCATION permissions. -->
2337            <flag name="neverForLocation" value="0x00010000" />
2338        </attr>
2339    </declare-styleable>
2340
2341    <!-- <code>required-feature</code> and <code>required-not-feature</code> elements inside
2342         <code>uses-permission<code/> can be used to request the permission based on the fact
2343         whether the system supports or does not support certain features.
2344         If multiple <code>required-feature</code> and/or <code>required-not-feature</code> elements
2345         are present, the permission will be “requested” only if the system supports all of the
2346         listed "required-features" and does not support any of the "required-not-features".
2347         -->
2348    <declare-styleable name="AndroidManifestRequiredFeature">
2349        <!-- The name of the feature. -->
2350        <attr name="name" />
2351    </declare-styleable>
2352    <declare-styleable name="AndroidManifestRequiredNotFeature">
2353        <!-- The name of the feature. -->
2354        <attr name="name" />
2355    </declare-styleable>
2356
2357    <!-- The <code>uses-configuration</code> tag specifies
2358         a specific hardware configuration value used by the application.
2359         For example an application might specify that it requires
2360         a physical keyboard or a particular navigation method like
2361         trackball. Multiple such attribute values can be specified by the
2362         application.
2363
2364         <p>This appears as a child tag of the root
2365         {@link #AndroidManifest manifest} tag.
2366
2367         @deprecated Use <code>feature-group</code> instead.-->
2368    <declare-styleable name="AndroidManifestUsesConfiguration" parent="AndroidManifest">
2369        <!-- The type of touch screen used by an application. -->
2370        <attr name="reqTouchScreen" />
2371        <attr name="reqKeyboardType" />
2372        <attr name="reqHardKeyboard" />
2373        <attr name="reqNavigation" />
2374        <attr name="reqFiveWayNav" />
2375    </declare-styleable>
2376
2377    <!-- The <code>uses-feature</code> tag specifies a specific device
2378         hardware or software feature used by the application. For
2379         example an application might specify that it requires
2380         a camera. Multiple attribute values can be specified by the
2381         application.
2382
2383         <p>This appears as a child tag of the root
2384         {@link #AndroidManifest manifest} tag. -->
2385    <declare-styleable name="AndroidManifestUsesFeature" parent="AndroidManifest">
2386        <!-- The name of the feature that is being used. -->
2387        <attr name="name" />
2388        <!-- The version of the feature that is being used. -->
2389        <attr name="version" format="integer" />
2390        <!-- The GLES driver version number needed by an application.
2391             The higher 16 bits represent the major number and the lower 16 bits
2392             represent the minor number. For example for GL 1.2 referring to
2393             0x00000102, the actual value should be set as 0x00010002. -->
2394        <attr name="glEsVersion" format="integer" />
2395        <!--  Specify whether this feature is required for the application.
2396              The default is true, meaning the application requires the
2397              feature, and does not want to be installed on devices that
2398              don't support it.  If you set this to false, then this will
2399              not impose a restriction on where the application can be
2400              installed. -->
2401        <attr name="required" format="boolean" />
2402    </declare-styleable>
2403
2404    <!-- The <code>feature-group</code> tag specifies
2405         a set of one or more <code>uses-feature</code> elements that
2406         the application can utilize. An application uses multiple
2407         <code>feature-group</code> sets to indicate that it can support
2408         different combinations of features.
2409
2410         <p>This appears as a child tag of the root
2411         {@link #AndroidManifest manifest} tag. -->
2412    <declare-styleable name="AndroidManifestFeatureGroup">
2413        <!-- The human-readable name of the feature group. -->
2414        <attr name="label" />
2415    </declare-styleable>
2416
2417    <!-- The <code>uses-sdk</code> tag describes the SDK features that the
2418         containing package must be running on to operate correctly.
2419
2420         <p>This appears as a child tag of the root
2421         {@link #AndroidManifest manifest} tag. -->
2422    <declare-styleable name="AndroidManifestUsesSdk" parent="AndroidManifest">
2423        <!-- This is the minimum SDK version number that the application
2424             requires.  This number is an abstract integer, from the list
2425             in {@link android.os.Build.VERSION_CODES}  If
2426             not supplied, the application will work on any SDK.  This
2427             may also be string (such as "Donut") if the application was built
2428             against a development branch, in which case it will only work against
2429             the development builds. -->
2430        <attr name="minSdkVersion" format="integer|string" />
2431        <!-- This is the SDK version number that the application is targeting.
2432             It is able to run on older versions (down to minSdkVersion), but
2433             was explicitly tested to work with the version specified here.
2434             Specifying this version allows the platform to disable compatibility
2435             code that are not required or enable newer features that are not
2436             available to older applications.  This may also be a string
2437             (such as "Donut") if this is built against a development
2438             branch, in which case minSdkVersion is also forced to be that
2439             string. -->
2440        <attr name="targetSdkVersion" format="integer|string" />
2441        <!-- This is the maximum SDK version number that an application works
2442             on.  You can use this to ensure your application is filtered out
2443             of later versions of the platform when you know you have
2444             incompatibility with them. -->
2445        <attr name="maxSdkVersion" />
2446    </declare-styleable>
2447
2448    <!-- The <code>extension-sdk</code> tag is a child of the <uses-sdk> tag,
2449         and specifies required extension sdk features. -->
2450    <declare-styleable name="AndroidManifestExtensionSdk">
2451        <!-- The extension SDK version that this tag refers to. -->
2452        <attr name="sdkVersion" format="integer" />
2453        <!-- The minimum version of the extension SDK this application requires.-->
2454        <attr name="minExtensionVersion" format="integer" />
2455    </declare-styleable>
2456
2457    <!-- The <code>library</code> tag declares that this apk is providing itself
2458         as a shared library for other applications to use.  It can only be used
2459         with apks that are built in to the system image.  Other apks can link to
2460         it with the {@link #AndroidManifestUsesLibrary uses-library} tag.
2461
2462         <p>This appears as a child tag of the
2463         {@link #AndroidManifestApplication application} tag. -->
2464    <declare-styleable name="AndroidManifestLibrary" parent="AndroidManifest">
2465        <!-- Required public name of the library, which other components and
2466        packages will use when referring to this library.  This is a string using
2467        Java-style scoping to ensure it is unique.  The name should typically
2468        be the same as the apk's package name. -->
2469        <attr name="name" />
2470    </declare-styleable>
2471
2472    <declare-styleable name="AndroidManifestQueries" parent="AndroidManifest" />
2473    <declare-styleable name="AndroidManifestQueriesPackage" parent="AndroidManifestQueries">
2474        <attr name="name" />
2475    </declare-styleable>
2476    <declare-styleable name="AndroidManifestQueriesIntent" parent="AndroidManifestQueries" />
2477    <declare-styleable name="AndroidManifestQueriesProvider" parent="AndroidManifestQueries" >
2478        <attr name="authorities" />
2479    </declare-styleable>
2480
2481    <!-- The <code>sdk-library</code> tag declares that this apk is providing itself
2482    as an SDK library for other applications to use. Any app can declare an SDK library and there
2483    can be only one SDK library per package. These SDK libraries are updatable, multiple major
2484    versions can be installed at the same time, and an app depends on a specific version.
2485    Other apks can link to it with the {@link #AndroidManifestUsesSdkLibrary uses-sdk-library} tag.
2486
2487    <p>This appears as a child tag of the {@link #AndroidManifestApplication application} tag. -->
2488    <declare-styleable name="AndroidManifestSdkLibrary" parent="AndroidManifestApplication">
2489        <!-- Required public name of the SDK library, which other components and packages will use
2490        when referring to this SDK library. This is a string using Java-style scoping to ensure
2491        it is unique.
2492        Both name and version should typically form the apk's package name: name_versionMajor. -->
2493        <attr name="name" />
2494        <!-- Required major version of the SDK library. -->
2495        <attr name="versionMajor" format="integer" />
2496    </declare-styleable>
2497
2498
2499    <!-- The <code>uses-sdk-library</code> specifies a shared <strong>SDK</strong> library that this
2500    package requires to be present on the device.
2501
2502    <p>This appears as a child tag of the {@link #AndroidManifestApplication application} tag. -->
2503    <declare-styleable name="AndroidManifestUsesSdkLibrary" parent="AndroidManifestApplication">
2504        <!-- Required name of the SDK library you use. -->
2505        <attr name="name" />
2506        <!-- Specify which major version of the SDK library you use. -->
2507        <attr name="versionMajor" format="integer" />
2508        <!-- The SHA-256 digest of the SDK library signing certificate. -->
2509        <attr name="certDigest" format="string" />
2510    </declare-styleable>
2511
2512    <!-- The <code>static-library</code> tag declares that this apk is providing itself
2513       as a static shared library for other applications to use. Any app can declare such
2514       a library and there can be only one static shared library per package. These libraries
2515       are updatable, multiple versions can be installed at the same time, and an app links
2516       against a specific version simulating static linking while allowing code sharing.
2517       Other apks can link to it with the {@link #AndroidManifestUsesLibrary uses-static-library}
2518       tag.
2519
2520     <p>This appears as a child tag of the
2521     {@link #AndroidManifestApplication application} tag. -->
2522    <declare-styleable name="AndroidManifestStaticLibrary" parent="AndroidManifestApplication">
2523        <!-- Required public name of the library, which other components and
2524        packages will use when referring to this library.  This is a string using
2525        Java-style scoping to ensure it is unique.  The name should typically
2526        be the same as the apk's package name. -->
2527        <attr name="name" />
2528        <!-- Required specific library version. -->
2529        <attr name="version" />
2530        <!-- Required specific library major version code.  This matches
2531             android:versionCodeMajor of the library. -->
2532        <!-- Required specific library version. -->
2533        <attr name="versionMajor" format="integer" />
2534    </declare-styleable>
2535
2536    <!-- The <code>uses-libraries</code> specifies a shared library that this
2537         package requires to be linked against.  Specifying this flag tells the
2538         system to include this library's code in your class loader.
2539
2540         <p>This appears as a child tag of the
2541         {@link #AndroidManifestApplication application} tag. -->
2542    <declare-styleable name="AndroidManifestUsesLibrary" parent="AndroidManifestApplication">
2543        <!-- Required name of the library you use. -->
2544        <attr name="name" />
2545        <!--  Specify whether this library is required for the application.
2546              The default is true, meaning the application requires the
2547              library, and does not want to be installed on devices that
2548              don't support it.  If you set this to false, then this will
2549              allow the application to be installed even if the library
2550              doesn't exist, and you will need to check for its presence
2551              dynamically at runtime. -->
2552        <attr name="required" />
2553    </declare-styleable>
2554
2555    <!-- The <code>uses-native-library</code> specifies a native shared library that this
2556         package requires to be linked against.  Specifying this flag tells the
2557         system to make the native library to be available to your app.
2558
2559         <p>On devices running R or lower, this is ignored and the app has access to all
2560         the public native shared libraries that are exported from the platform. This is
2561         also ignored if the app is targeting R or lower.
2562
2563         <p>This appears as a child tag of the
2564         {@link #AndroidManifestApplication application} tag. -->
2565    <declare-styleable name="AndroidManifestUsesNativeLibrary" parent="AndroidManifestApplication">
2566        <!-- Required name of the library you use. -->
2567        <attr name="name" />
2568        <!--  Specify whether this native library is required for the application.
2569              The default is true, meaning the application requires the
2570              library, and does not want to be installed on devices that
2571              don't support it. If you set this to false, then this will
2572              allow the application to be installed even if the library
2573              doesn't exist, and you will need to check for its presence
2574              dynamically at runtime. -->
2575        <attr name="required" />
2576    </declare-styleable>
2577
2578    <!-- The <code>uses-static-library</code> specifies a shared <strong>static</strong>
2579         library that this package requires to be statically linked against. Specifying
2580         this tag tells the system to include this library's code in your class loader.
2581         Depending on a static shared library is equivalent to statically linking with
2582         the library at build time while it offers apps to share code defined in such
2583         libraries. Hence, static libraries are strictly required.
2584
2585         <p>On devices running O MR1 or higher, if the library is singed with multiple
2586         signing certificates you must to specify the SHA-256 hashes of the additional
2587         certificates via adding
2588         {@link #AndroidManifestAdditionalCertificate additional-certificate} tags.
2589
2590         <p>This appears as a child tag of the
2591         {@link #AndroidManifestApplication application} tag. -->
2592    <declare-styleable name="AndroidManifestUsesStaticLibrary" parent="AndroidManifestApplication">
2593        <!-- Required name of the library you use. -->
2594        <attr name="name" />
2595        <!-- Specify which version of the shared library should be statically linked. -->
2596        <attr name="version" />
2597        <!-- The SHA-256 digest of the library signing certificate. -->
2598        <attr name="certDigest" format="string" />
2599    </declare-styleable>
2600
2601    <!-- The <code>additional-certificate</code> specifies the SHA-256 digest of a static
2602         shared library's additional signing certificate. You need to use this tag if the
2603         library is singed with more than one certificate.
2604
2605         <p>This appears as a child tag of the
2606         {@link #AndroidManifestUsesStaticLibrary uses-static-library} or
2607         {@link #AndroidManifestUsesPackage uses-package} tag. -->
2608    <declare-styleable name="AndroidManifestAdditionalCertificate" parent="AndroidManifestUsesStaticLibrary">
2609        <!-- The SHA-256 digest of the library signing certificate. -->
2610        <attr name="certDigest" />
2611    </declare-styleable>
2612
2613    <!-- The <code>uses-package</code> specifies some kind of dependency on another
2614         package.  It does not have any impact on the app's execution on the device,
2615         but provides information about dependencies it has on other packages that need
2616         to  be satisfied for it to run correctly.  That is, this is primarily for
2617         installers to know what other apps need to be installed along with this one.
2618
2619         <p>This appears as a child tag of the
2620         {@link #AndroidManifestApplication application} tag. -->
2621    <declare-styleable name="AndroidManifestUsesPackage" parent="AndroidManifestApplication">
2622        <!-- Required type of association with the package, for example "android.package.ad_service"
2623             if it provides an advertising service.  This should use the standard scoped naming
2624             convention as used for other things such as package names, based on the Java naming
2625             convention. -->
2626        <attr name="packageType" format="string" />
2627        <!-- Required name of the package you use. -->
2628        <attr name="name" />
2629        <!-- Optional minimum version of the package that satisfies the dependency. -->
2630        <attr name="version" />
2631        <!-- Optional minimum major version of the package that satisfies the dependency. -->
2632        <attr name="versionMajor" format="integer" />
2633        <!-- Optional SHA-256 digest of the package signing certificate. -->
2634        <attr name="certDigest" format="string" />
2635    </declare-styleable>
2636
2637    <!-- The <code>supports-screens</code> specifies the screen dimensions an
2638         application supports.  By default a modern application supports all
2639         screen sizes and must explicitly disable certain screen sizes here;
2640         older applications are assumed to only support the traditional normal
2641         (HVGA) screen size.  Note that screen size is a separate axis from
2642         density, and is determined as the available pixels to an application
2643         after density scaling has been applied.
2644
2645         <p>This appears as a child tag of the
2646         {@link #AndroidManifest manifest} tag. -->
2647    <declare-styleable name="AndroidManifestSupportsScreens" parent="AndroidManifest">
2648        <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2},
2649             this is the new way to specify the minimum screen size an application is
2650             compatible with.  This attribute provides the required minimum
2651             "smallest screen width" (as per the -swNNNdp resource configuration)
2652             that the application can run on.  For example, a typical phone
2653             screen is 320, a 7" tablet 600, and a 10" tablet 720.  If the
2654             smallest screen width of the device is below the value supplied here,
2655             then the application is considered incompatible with that device.
2656             If not supplied, then any old smallScreens, normalScreens, largeScreens,
2657             or xlargeScreens attributes will be used instead. -->
2658        <attr name="requiresSmallestWidthDp" format="integer" />
2659        <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2},
2660             this is the new way to specify the largest screens an application is
2661             compatible with.  This attribute provides the maximum
2662             "smallest screen width" (as per the -swNNNdp resource configuration)
2663             that the application is designed for.  If this value is smaller than
2664             the "smallest screen width" of the device it is running on, the user
2665             is offered to run it in a compatibility mode that emulates a
2666             smaller screen and zooms it to fit the screen. Currently the compatibility mode only
2667             emulates phone screens with a 320dp width, so compatibility mode is not applied if the
2668             value for compatibleWidthLimitDp is larger than 320. -->
2669        <attr name="compatibleWidthLimitDp" format="integer" />
2670        <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2},
2671             this is the new way to specify the screens an application is
2672             compatible with.  This attribute provides the maximum
2673             "smallest screen width" (as per the -swNNNdp resource configuration)
2674             that the application can work well on.  If this value is smaller than
2675             the "smallest screen width" of the device it is running on, the
2676             application will be forced in to screen compatibility mode with
2677             no way for the user to turn it off. Currently the compatibility mode only
2678             emulates phone screens with a 320dp width, so compatibility mode is not applied if the
2679             value for largestWidthLimitDp is larger than 320. -->
2680        <attr name="largestWidthLimitDp" format="integer" />
2681        <!-- Indicates whether the application supports smaller screen form-factors.
2682             A small screen is defined as one with a smaller aspect ratio than
2683             the traditional HVGA screen; that is, for a portrait screen, less
2684             tall than an HVGA screen.  In practice, this means a QVGA low
2685             density or VGA high density screen.  An application that does
2686             not support small screens <em>will not be available</em> for
2687             small screen devices, since there is little the platform can do
2688             to make such an application work on a smaller screen. -->
2689        <attr name="smallScreens" format="boolean" />
2690        <!-- Indicates whether an application supports the normal screen
2691             form-factors.  Traditionally this is an HVGA normal density
2692             screen, but WQVGA low density and WVGA high density are also
2693             considered to be normal.  This attribute is true by default,
2694             and applications currently should leave it that way. -->
2695        <attr name="normalScreens" format="boolean" />
2696        <!-- Indicates whether the application supports larger screen form-factors.
2697             A large screen is defined as a screen that is significantly larger
2698             than a normal phone screen, and thus may require some special care
2699             on the application's part to make good use of it.  An example would
2700             be a VGA <em>normal density</em> screen, though even larger screens
2701             are certainly possible.  An application that does not support
2702             large screens will be placed as a postage stamp on such a
2703             screen, so that it retains the dimensions it was originally
2704             designed for. -->
2705        <attr name="largeScreens" format="boolean" />
2706        <!-- Indicates whether the application supports extra large screen form-factors. -->
2707        <attr name="xlargeScreens" format="boolean" />
2708        <!-- Indicates whether the application can resize itself to newer
2709             screen sizes.  This is mostly used to distinguish between old
2710             applications that may not be compatible with newly introduced
2711             screen sizes and newer applications that should be; it will be
2712             set for you automatically based on whether you are targeting
2713             a newer platform that supports more screens. -->
2714        <attr name="resizeable" format="boolean" />
2715        <!-- Indicates whether the application can accommodate any screen
2716             density. This is assumed true if targetSdkVersion is 4 or higher.
2717             @deprecated Should always be true by default and not overridden.
2718              -->
2719        <attr name="anyDensity" format="boolean" />
2720    </declare-styleable>
2721
2722    <!-- Private tag to declare system protected broadcast actions.
2723
2724         <p>This appears as a child tag of the root
2725         {@link #AndroidManifest manifest} tag. -->
2726    <declare-styleable name="AndroidManifestProtectedBroadcast" parent="AndroidManifest">
2727        <attr name="name" />
2728    </declare-styleable>
2729
2730    <!-- Private tag to declare the original package name that this package is
2731         based on.  Only used for packages installed in the system image.  If
2732         given, and different than the actual package name, and the given
2733         original package was previously installed on the device but the new
2734         one was not, then the data for the old one will be renamed to be
2735         for the new package.
2736
2737         <p>This appears as a child tag of the root
2738         {@link #AndroidManifest manifest} tag. -->
2739    <declare-styleable name="AndroidManifestOriginalPackage" parent="AndroidManifest">
2740        <attr name="name" />
2741    </declare-styleable>
2742
2743    <!-- The <code>processes</code> tag specifies the processes the application will run code in
2744         and optionally characteristics of those processes.  This tag is optional; if not
2745         specified, components will simply run in the processes they specify.  If supplied,
2746         they can only specify processes that are enumerated here, and if they don't this
2747         will be treated as a corrupt apk and result in an install failure.
2748
2749         <p>This appears as a child tag of the
2750         {@link #AndroidManifestApplication application} tag. -->
2751    <declare-styleable name="AndroidManifestProcesses" parent="AndroidManifestApplication">
2752    </declare-styleable>
2753
2754    <!-- The <code>process</code> tag enumerates one of the available processes under its
2755         containing <code>processes</code> tag.
2756
2757         <p>This appears as a child tag of the
2758         {@link #AndroidManifestProcesses processes} tag. -->
2759    <declare-styleable name="AndroidManifestProcess" parent="AndroidManifestProcesses">
2760        <!-- Required name of the process that is allowed -->
2761        <attr name="process" />
2762        <!-- custom Application class name. We use call it "name", not "className", to be
2763             consistent with the Application tag. -->
2764        <attr name="name" />
2765        <attr name="gwpAsanMode" />
2766        <attr name="memtagMode" />
2767        <attr name="nativeHeapZeroInitialized" />
2768    </declare-styleable>
2769
2770    <!-- The <code>deny-permission</code> tag specifies that a permission is to be denied
2771         for a particular process (if specified under the
2772         {@link #AndroidManifestProcess process} tag) or by default for all
2773         processes {if specified under the
2774         @link #AndroidManifestProcesses processes} tag).
2775
2776         <p>This appears as a child tag of the
2777         {@link #AndroidManifestProcesses processes} and
2778         {@link #AndroidManifestProcess process} tags. -->
2779    <declare-styleable name="AndroidManifestDenyPermission"
2780            parent="AndroidManifestProcesses">
2781        <!-- Required name of the permission that is to be denied -->
2782        <attr name="name" />
2783    </declare-styleable>
2784
2785    <!-- The <code>allow-permission</code> tag specifies that a permission is to be allowed
2786         for a particular process, when it was previously denied for all processes through
2787         {@link #AndroidManifestDenyPermission deny-permission}
2788
2789         <p>This appears as a child tag of the
2790         {@link #AndroidManifestProcesses processes} and
2791         {@link #AndroidManifestProcess process} tags. -->
2792    <declare-styleable name="AndroidManifestAllowPermission"
2793            parent="AndroidManifestProcesses">
2794        <!-- Required name of the permission that is to be allowed. -->
2795        <attr name="name" />
2796    </declare-styleable>
2797
2798    <!-- The <code>provider</code> tag declares a
2799         {@link android.content.ContentProvider} class that is available
2800         as part of the package's application components, supplying structured
2801         access to data managed by the application.
2802
2803         <p>This appears as a child tag of the
2804         {@link #AndroidManifestApplication application} tag. -->
2805    <declare-styleable name="AndroidManifestProvider" parent="AndroidManifestApplication">
2806        <!-- Required name of the class implementing the provider, deriving from
2807            {@link android.content.ContentProvider}.  This is a fully
2808            qualified class name (for example, com.mycompany.myapp.MyProvider); as a
2809            short-hand if the first character of the class
2810            is a period then it is appended to your package name. -->
2811        <attr name="name" />
2812        <attr name="label" />
2813        <attr name="description" />
2814        <attr name="icon" />
2815        <attr name="roundIcon" />
2816        <attr name="banner" />
2817        <attr name="logo" />
2818        <attr name="process" />
2819        <attr name="authorities" />
2820        <attr name="syncable" />
2821        <attr name="readPermission" />
2822        <attr name="writePermission" />
2823        <attr name="grantUriPermissions" />
2824        <attr name="forceUriPermissions" />
2825        <attr name="permission" />
2826        <attr name="multiprocess" />
2827        <attr name="initOrder" />
2828        <!-- Specify whether this provider is enabled or not (that is, can be instantiated by the system).
2829             It can also be specified for an application as a whole, in which case a value of "false"
2830             will override any component specific values (a value of "true" will not override the
2831             component specific values). -->
2832        <attr name="enabled" />
2833        <attr name="exported" />
2834        <attr name="singleUser" />
2835        <attr name="directBootAware" />
2836        <attr name="visibleToInstantApps" />
2837        <!-- The code for this component is located in the given split.
2838             <p>NOTE: This is only applicable to instant app. -->
2839        <attr name="splitName" />
2840        <!-- Set of attribution tags that should be automatically applied to this component.
2841             <p>
2842             Each instance of this ContentProvider will be automatically configured with
2843             Context.createAttributionContext() using the first attribution tag
2844             contained here. -->
2845        <attr name="attributionTags" />
2846    </declare-styleable>
2847
2848    <!-- Attributes that can be supplied in an AndroidManifest.xml
2849         <code>grant-uri-permission</code> tag, a child of the
2850         {@link #AndroidManifestProvider provider} tag, describing a specific
2851         URI path that can be granted as a permission.  This tag can be
2852         specified multiple time to supply multiple paths. If multiple
2853         path matching attributes are supplied, they will be evaluated in the
2854         following order with the first attribute being the only one honored:
2855          <code>pathAdvancedPattern</code>, <code>pathPattern</code>,
2856          <code>pathPrefix</code>, <code>pathSuffix</code>, <code>path</code>. -->
2857    <declare-styleable name="AndroidManifestGrantUriPermission"  parent="AndroidManifestProvider">
2858        <!-- Specify a URI path that must exactly match, as per
2859             {@link android.os.PatternMatcher} with
2860             {@link android.os.PatternMatcher#PATTERN_LITERAL}. -->
2861        <attr name="path" format="string" />
2862        <!-- Specify a URI path that must be a prefix to match, as per
2863             {@link android.os.PatternMatcher} with
2864             {@link android.os.PatternMatcher#PATTERN_PREFIX}. -->
2865        <attr name="pathPrefix" format="string" />
2866        <!-- Specify a URI path that matches a simple pattern, as per
2867             {@link android.os.PatternMatcher} with
2868             {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}.
2869             Note that because '\' is used as an escape character when
2870             reading the string from XML (before it is parsed as a pattern),
2871             you will need to double-escape: for example a literal "*" would
2872             be written as "\\*" and a literal "\" would be written as
2873             "\\\\".  This is basically the same as what you would need to
2874             write if constructing the string in Java code. -->
2875        <attr name="pathPattern" format="string" />
2876        <!-- Specify a URI path that matches an advanced pattern, as per
2877             {@link android.os.PatternMatcher} with
2878             {@link android.os.PatternMatcher#PATTERN_ADVANCED_GLOB}.
2879             Note that because '\' is used as an escape character when
2880             reading the string from XML (before it is parsed as a pattern),
2881             you will need to double-escape: for example a literal "*" would
2882             be written as "\\*" and a literal "\" would be written as
2883             "\\\\".  This is basically the same as what you would need to
2884             write if constructing the string in Java code. -->
2885        <attr name="pathAdvancedPattern" format="string"/>
2886        <!-- Specify a URI path that must be a suffix to match, as per
2887             {@link android.os.PatternMatcher} with
2888             {@link android.os.PatternMatcher#PATTERN_SUFFIX}. -->
2889        <attr name="pathSuffix" format="string" />
2890    </declare-styleable>
2891
2892    <!-- Attributes that can be supplied in an AndroidManifest.xml
2893         <code>path-permission</code> tag, a child of the
2894         {@link #AndroidManifestProvider provider} tag, describing a permission
2895         that allows access to a specific path in the provider.  This tag can be
2896         specified multiple time to supply multiple paths. If multiple
2897         path matching attributes are supplied, they will be evaluated in the
2898         following order with the first attribute being the only one honored:
2899          <code>pathAdvancedPattern</code>, <code>pathPattern</code>,
2900          <code>pathPrefix</code>, <code>pathSuffix</code>, <code>path</code>.-->
2901    <declare-styleable name="AndroidManifestPathPermission"  parent="AndroidManifestProvider">
2902        <attr name="path" />
2903        <attr name="pathPrefix" />
2904        <attr name="pathPattern" />
2905        <attr name="pathAdvancedPattern" format="string"/>
2906        <attr name="pathSuffix" />
2907        <attr name="permission" />
2908        <attr name="readPermission" />
2909        <attr name="writePermission" />
2910    </declare-styleable>
2911
2912    <!-- The <code>service</code> tag declares a
2913         {@link android.app.Service} class that is available
2914         as part of the package's application components, implementing
2915         long-running background operations or a rich communication API
2916         that can be called by other packages.
2917
2918         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
2919         tags can be included inside of a service, to specify the Intents
2920         that can connect with it.  If none are specified, the service can
2921         only be accessed by direct specification of its class name.
2922         The service tag appears as a child tag of the
2923         {@link #AndroidManifestApplication application} tag. -->
2924    <declare-styleable name="AndroidManifestService" parent="AndroidManifestApplication">
2925        <!-- Required name of the class implementing the service, deriving from
2926            {@link android.app.Service}.  This is a fully
2927            qualified class name (for example, com.mycompany.myapp.MyService); as a
2928            short-hand if the first character of the class
2929            is a period then it is appended to your package name. -->
2930        <attr name="name" />
2931        <attr name="label" />
2932        <attr name="description" />
2933        <attr name="icon" />
2934        <attr name="roundIcon" />
2935        <attr name="banner" />
2936        <attr name="logo" />
2937        <attr name="permission" />
2938        <attr name="process" />
2939        <!-- Specify whether the service is enabled or not (that is, can be instantiated by the system).
2940             It can also be specified for an application as a whole, in which case a value of "false"
2941             will override any component specific values (a value of "true" will not override the
2942             component specific values). -->
2943        <attr name="enabled" />
2944        <attr name="exported" />
2945        <!-- If set to true, this service with be automatically stopped
2946             when the user remove a task rooted in an activity owned by
2947             the application.  The default is false. -->
2948        <attr name="stopWithTask" format="boolean" />
2949        <!-- If set to true, this service will run under a special process
2950             that is isolated from the rest of the system.  The only communication
2951             with it is through the Service API (binding and starting). -->
2952        <attr name="isolatedProcess" format="boolean" />
2953        <attr name="singleUser" />
2954        <attr name="directBootAware" />
2955        <!-- If the service is an {@link android.R.attr#isolatedProcess} service, this permits a
2956             client to bind to the service as if it were running it its own package.  The service
2957             must also be {@link android.R.attr#exported} if this flag is set. -->
2958        <attr name="externalService" format="boolean" />
2959        <attr name="visibleToInstantApps" />
2960        <!-- The code for this component is located in the given split.
2961             <p>NOTE: This is only applicable to instant app. -->
2962        <attr name="splitName" />
2963        <!-- If true, and this is an {@link android.R.attr#isolatedProcess} service, the service
2964             will be spawned from an Application Zygote, instead of the regular Zygote.
2965             <p>
2966             The Application Zygote will first pre-initialize the application's class loader. Then,
2967             if the application has defined the {@link android.R.attr#zygotePreloadName} attribute,
2968             the Application Zygote will call into that class to allow it to perform
2969             application-specific preloads (such as loading a shared library). Therefore,
2970             spawning from the Application Zygote will typically reduce the service
2971             launch time and reduce its memory usage. The downside of using this flag
2972             is that you will have an additional process (the app zygote itself) that
2973             is taking up memory. Whether actual memory usage is improved therefore strongly
2974             depends on the number of isolated services that an application starts,
2975             and how much memory those services save by preloading and sharing memory with
2976             the app zygote. Therefore, it is recommended to measure memory usage under
2977             typical workloads to determine whether it makes sense to use this flag. -->
2978        <attr name="useAppZygote" format="boolean" />
2979        <!-- If this is a foreground service, specify its category. -->
2980        <attr name="foregroundServiceType" />
2981        <!-- Set of attribution tags that should be automatically applied to this component.
2982             <p>
2983             Each instance of this Service will be automatically configured with
2984             Context.createAttributionContext() using the first attribution tag
2985             contained here. -->
2986        <attr name="attributionTags" />
2987        <!-- If true, and this is an {@link android.R.attr#isolatedProcess} service, the service
2988             is allowed to be bound in a shared isolated process with other isolated services.
2989             Note that these other isolated services can also belong to other apps from different
2990             vendors.
2991             <p>
2992             Shared isolated processes are created when using the
2993             {@link android.content.Context#BIND_SHARED_ISOLATED_PROCESS) during service binding.
2994             <p>
2995             Note that when this flag is used, the {@link android.R.attr#process} attribute is
2996             ignored when the process is bound into a shared isolated process by a client.
2997        -->
2998        <attr name="allowSharedIsolatedProcess" format="boolean" />
2999    </declare-styleable>
3000
3001    <!-- @hide The <code>apex-system-service</code> tag declares an apex system service
3002         that is contained within an application.
3003
3004         The apex system service tag appears as a child tag of the
3005         {@link #AndroidManifestApplication application} tag. -->
3006    <declare-styleable name="AndroidManifestApexSystemService"
3007                       parent="AndroidManifestApplication">
3008        <!-- The fully qualified class name of the system service. -->
3009        <attr name="name" />
3010        <!-- The filepath to the .jar that contains the system service. If this is not provided, it
3011             is assumed that the system service exists in SYSTEMSERVERCLASSPATH. -->
3012        <attr name="path" />
3013        <attr name="minSdkVersion" />
3014        <attr name="maxSdkVersion" />
3015        <!-- The order in which the apex system services are initiated. When there are dependencies
3016        among apex system services, setting this attribute for each of them ensures that they are
3017        created in the order required by those dependencies. The apex-system-services that are
3018        started manually within SystemServer ignore the initOrder and are not considered for
3019        automatic starting of the other services.
3020        The value is a simple integer, with higher number being initialized first. If not specified,
3021        the default order is 0. -->
3022        <attr name="initOrder" format="integer" />
3023    </declare-styleable>
3024
3025    <!-- The <code>receiver</code> tag declares an
3026         {@link android.content.BroadcastReceiver} class that is available
3027         as part of the package's application components, allowing the
3028         application to receive actions or data broadcast by other
3029         applications even if it is not currently running.
3030
3031         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
3032         tags can be included inside of a receiver, to specify the Intents
3033         it will receive.  If none are specified, the receiver will only
3034         be run when an Intent is broadcast that is directed at its specific
3035         class name.  The receiver tag appears as a child tag of the
3036         {@link #AndroidManifestApplication application} tag. -->
3037    <declare-styleable name="AndroidManifestReceiver" parent="AndroidManifestApplication">
3038        <!-- Required name of the class implementing the receiver, deriving from
3039            {@link android.content.BroadcastReceiver}.  This is a fully
3040            qualified class name (for example, com.mycompany.myapp.MyReceiver); as a
3041            short-hand if the first character of the class
3042            is a period then it is appended to your package name. -->
3043        <attr name="name" />
3044        <attr name="label" />
3045        <attr name="description" />
3046        <attr name="icon" />
3047        <attr name="roundIcon" />
3048        <attr name="banner" />
3049        <attr name="logo" />
3050        <attr name="permission" />
3051        <attr name="process" />
3052        <!-- Specify whether the receiver is enabled or not (that is, can be instantiated by the system).
3053             It can also be specified for an application as a whole, in which case a value of "false"
3054             will override any component specific values (a value of "true" will not override the
3055             component specific values). -->
3056        <attr name="enabled" />
3057        <attr name="exported" />
3058        <attr name="singleUser" />
3059        <attr name="directBootAware" />
3060        <!-- Set of attribution tags that should be automatically applied to this component.
3061             <p>
3062             Each instance of this BroadcastReceiver will be automatically configured with
3063             Context.createAttributionContext() using the first attribution tag
3064             contained here. -->
3065        <attr name="attributionTags" />
3066    </declare-styleable>
3067
3068    <!-- The <code>activity</code> tag declares an
3069         {@link android.app.Activity} class that is available
3070         as part of the package's application components, implementing
3071         a part of the application's user interface.
3072
3073         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
3074         tags can be included inside of an activity, to specify the Intents
3075         that it can handle.  If none are specified, the activity can
3076         only be started through direct specification of its class name.
3077         The activity tag appears as a child tag of the
3078         {@link #AndroidManifestApplication application} tag. -->
3079    <declare-styleable name="AndroidManifestActivity" parent="AndroidManifestApplication">
3080        <!-- Required name of the class implementing the activity, deriving from
3081            {@link android.app.Activity}.  This is a fully
3082            qualified class name (for example, com.mycompany.myapp.MyActivity); as a
3083            short-hand if the first character of the class
3084            is a period then it is appended to your package name. -->
3085        <attr name="name" />
3086        <attr name="theme" />
3087        <attr name="label" />
3088        <attr name="description" />
3089        <attr name="icon" />
3090        <attr name="roundIcon" />
3091        <attr name="banner" />
3092        <attr name="logo" />
3093        <attr name="launchMode" />
3094        <attr name="screenOrientation" />
3095        <attr name="configChanges" />
3096        <attr name="recreateOnConfigChanges" />
3097        <attr name="permission" />
3098        <attr name="multiprocess" />
3099        <attr name="process" />
3100        <attr name="taskAffinity" />
3101        <attr name="allowTaskReparenting" />
3102        <attr name="finishOnTaskLaunch" />
3103        <attr name="finishOnCloseSystemDialogs" />
3104        <attr name="clearTaskOnLaunch" />
3105        <attr name="noHistory" />
3106        <attr name="alwaysRetainTaskState" />
3107        <attr name="stateNotNeeded" />
3108        <attr name="excludeFromRecents" />
3109        <!-- @deprecated use {@link android.R.attr#showForAllUsers} instead. -->
3110        <attr name="showOnLockScreen" />
3111        <!-- Specify whether the activity is enabled or not (that is, can be instantiated by the system).
3112             It can also be specified for an application as a whole, in which case a value of "false"
3113             will override any component specific values (a value of "true" will not override the
3114             component specific values). -->
3115        <attr name="enabled" />
3116        <attr name="exported" />
3117        <!-- Specify the default soft-input mode for the main window of
3118             this activity.  A value besides "unspecified" here overrides
3119             any value in the theme. -->
3120        <attr name="windowSoftInputMode" />
3121        <attr name="immersive" />
3122        <attr name="hardwareAccelerated" />
3123        <attr name="uiOptions" />
3124        <attr name="parentActivityName" />
3125        <attr name="singleUser" />
3126        <!-- @hide This broadcast receiver or activity will only receive broadcasts for the
3127             system user-->
3128        <attr name="systemUserOnly" format="boolean" />
3129        <attr name="persistableMode" />
3130        <attr name="allowEmbedded" />
3131        <attr name="documentLaunchMode" />
3132        <attr name="maxRecents" />
3133        <attr name="autoRemoveFromRecents" />
3134        <attr name="relinquishTaskIdentity" />
3135        <attr name="resumeWhilePausing" />
3136        <attr name="resizeableActivity" />
3137        <attr name="supportsPictureInPicture" />
3138        <attr name="maxAspectRatio" />
3139        <attr name="minAspectRatio" />
3140        <attr name="lockTaskMode" />
3141        <attr name="showForAllUsers" />
3142
3143        <attr name="showWhenLocked" />
3144        <attr name="inheritShowWhenLocked" />
3145        <attr name="turnScreenOn" />
3146
3147        <attr name="directBootAware" />
3148        <!-- @hide This activity is always focusable regardless of if it is in a task/stack whose
3149             activities are normally not focusable.
3150             For example, {@link android.R.attr#supportsPictureInPicture} activities are placed
3151             in a task/stack that isn't focusable. This flag allows them to be focusable.-->
3152        <attr name="alwaysFocusable" format="boolean" />
3153        <attr name="enableVrMode" />
3154        <attr name="rotationAnimation" />
3155        <attr name="visibleToInstantApps" />
3156        <!-- The code for this component is located in the given split. -->
3157        <attr name="splitName" />
3158        <!-- Specify the color mode the activity desires. The requested color mode may be ignored
3159             depending on the capabilities of the display the activity is displayed on. -->
3160        <attr name="colorMode">
3161            <!-- The default color mode (typically sRGB, low-dynamic range). -->
3162            <enum name="default" value="0" />
3163            <!-- Wide color gamut color mode. -->
3164            <enum name="wideColorGamut" value="1" />
3165            <!-- High dynamic range color mode. -->
3166            <enum name="hdr" value="2" />
3167        </attr>
3168        <attr name="forceQueryable" format="boolean" />
3169        <!-- Indicates whether the activity wants the connected display to do minimal
3170             post processing on the produced image or video frames. This will only be
3171             requested if this activity's main window is visible on the screen.
3172
3173             <p> This setting should be used when low latency has a higher priority than
3174             image enhancement processing (e.g. for games or video conferencing).
3175
3176             <p> If the Display sink is connected via HDMI, the device will begin to
3177             send infoframes with Auto Low Latency Mode enabled and Game Content Type.
3178             This will switch the connected display to a minimal image processing  mode
3179             (if available), which reduces latency, improving the user experience for
3180             gaming or video conferencing applications. For more information,
3181             see HDMI 2.1 specification.
3182
3183             <p> If the Display sink has an internal connection or uses some other
3184             protocol than HDMI, effects may be similar but implementation-defined.
3185
3186             <p> The ability to switch to a mode with minimal post proessing may be
3187             disabled by a user setting in the system settings menu. In that case,
3188             this field is ignored and the display will remain in its current
3189             mode.
3190
3191             <p> See {@link android.content.pm.ActivityInfo#FLAG_PREFER_MINIMAL_POST_PROCESSING} -->
3192        <attr name="preferMinimalPostProcessing" format="boolean"/>
3193        <!-- Set of attribution tags that should be automatically applied to this component.
3194             <p>
3195             Each instance of this Activity will be automatically configured with
3196             Context.createAttributionContext() using the first attribution tag
3197             contained here. -->
3198        <attr name="attributionTags" />
3199        <!-- Specifies whether a home sound effect should be played if the home app moves to
3200             front after an activity with this flag set to <code>true</code>.
3201             <p>The default value of this attribute is <code>true</code>.
3202             <p>Also note that home sounds are only played if the device supports home sounds,
3203             usually TVs.
3204             <p>Requires permission {@code android.permission.DISABLE_SYSTEM_SOUND_EFFECTS}. -->
3205        <attr name="playHomeTransitionSound" format="boolean"/>
3206        <!-- Indicates whether the activity can be displayed on a remote device which may or
3207             may not be running Android. -->
3208        <attr name="canDisplayOnRemoteDevices" format="boolean"/>
3209        <attr name="allowUntrustedActivityEmbedding" />
3210        <attr name="knownActivityEmbeddingCerts" />
3211        <!-- Specifies the required display category of the activity. Upon creation, a display can
3212             specify which display categories it supports and one of the categories must be present
3213             in the {@code <activity>} element to allow this activity to run. The default value is
3214             {@code null}, which indicates the activity does not have a required display category
3215             and thus can only run on a display that didn't specify any display categories. Each
3216             activity can only specify one required category but a display can accommodate multiple
3217             display categories.
3218
3219             <p> This field should be formatted as a Java-language-style free form string(for
3220             example, com.google.automotive_entertainment), which may contain uppercase or lowercase
3221             letters ('A' through 'Z'), numbers, and underscores ('_') but may only start with
3222             letters.
3223         -->
3224        <attr name="requiredDisplayCategory" format="string"/>
3225        <!-- If false, {@link android.view.KeyEvent#KEYCODE_BACK KEYCODE_BACK} and
3226             {@link android.app.Activity#onBackPressed Activity.onBackPressed()}
3227             and related event will be forwarded to the Activity and its views.
3228
3229             <p> If true, those events will be replaced by a call to
3230             {@link android.window.OnBackInvokedCallback#onBackInvoked} on the focused window.
3231
3232             <p> By default, the behavior is configured by the same attribute in application.
3233        -->
3234        <attr name="enableOnBackInvokedCallback" format="boolean"/>
3235    </declare-styleable>
3236
3237    <!-- The <code>activity-alias</code> tag declares a new
3238         name for an existing {@link #AndroidManifestActivity activity}
3239         tag.
3240
3241         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
3242         tags can be included inside of an activity-alias, to specify the Intents
3243         that it can handle.  If none are specified, the activity can
3244         only be started through direct specification of its class name.
3245         The activity-alias tag appears as a child tag of the
3246         {@link #AndroidManifestApplication application} tag. -->
3247    <declare-styleable name="AndroidManifestActivityAlias" parent="AndroidManifestApplication">
3248        <!-- Required name of the class implementing the activity, deriving from
3249            {@link android.app.Activity}.  This is a fully
3250            qualified class name (for example, com.mycompany.myapp.MyActivity); as a
3251            short-hand if the first character of the class
3252            is a period then it is appended to your package name. -->
3253        <attr name="name" />
3254        <!-- The name of the activity this alias should launch.  The activity
3255             must be in the same manifest as the alias, and have been defined
3256             in that manifest before the alias here.  This must use a Java-style
3257             naming convention to ensure the name is unique, for example
3258             "com.mycompany.MyName". -->
3259        <attr name="targetActivity" format="string" />
3260        <attr name="label" />
3261        <attr name="description" />
3262        <attr name="icon" />
3263        <attr name="roundIcon" />
3264        <attr name="banner" />
3265        <attr name="logo" />
3266        <attr name="permission" />
3267        <!-- Specify whether the activity-alias is enabled or not (that is, can be instantiated by the system).
3268             It can also be specified for an application as a whole, in which case a value of "false"
3269             will override any component specific values (a value of "true" will not override the
3270             component specific values). -->
3271        <attr name="enabled" />
3272        <attr name="exported" />
3273        <attr name="parentActivityName" />
3274        <attr name="attributionTags" />
3275        <attr name="allowUntrustedActivityEmbedding" />
3276        <attr name="knownActivityEmbeddingCerts" />
3277    </declare-styleable>
3278
3279    <!-- The <code>meta-data</code> tag is used to attach additional
3280         arbitrary data to an application component.  The data can later
3281         be retrieved programmatically from the
3282         {@link android.content.pm.ComponentInfo#metaData
3283         ComponentInfo.metaData} field.  There is no meaning given to this
3284         data by the system.  You may supply the data through either the
3285         <code>value</code> or <code>resource</code> attribute; if both
3286         are given, then <code>resource</code> will be used.
3287
3288         <p>It is highly recommended that you avoid supplying related data as
3289         multiple separate meta-data entries.  Instead, if you have complex
3290         data to associate with a component, then use the <code>resource</code>
3291         attribute to assign an XML resource that the client can parse to
3292         retrieve the complete data. -->
3293    <declare-styleable name="AndroidManifestMetaData"
3294         parent="AndroidManifestApplication
3295                 AndroidManifestActivity
3296                 AndroidManifestReceiver
3297                 AndroidManifestProvider
3298                 AndroidManifestService
3299                 AndroidManifestPermission
3300                 AndroidManifestPermissionGroup
3301                 AndroidManifestInstrumentation">
3302        <attr name="name" />
3303        <!-- Concrete value to assign to this piece of named meta-data.
3304             The data can later be retrieved from the meta data Bundle
3305             through {@link android.os.Bundle#getString Bundle.getString},
3306             {@link android.os.Bundle#getInt Bundle.getInt},
3307             {@link android.os.Bundle#getBoolean Bundle.getBoolean},
3308             or {@link android.os.Bundle#getFloat Bundle.getFloat} depending
3309             on the type used here. -->
3310        <attr name="value" format="string|integer|color|float|boolean" />
3311        <!-- Resource identifier to assign to this piece of named meta-data.
3312             The resource identifier can later be retrieved from the meta data
3313             Bundle through {@link android.os.Bundle#getInt Bundle.getInt}. -->
3314        <attr name="resource" format="reference" />
3315    </declare-styleable>
3316
3317    <!-- The <code>property</code> tag is used to attach additional data that can
3318         be supplied to the parent component. A component element can contain any
3319         number of <code>property</code> subelements. Valid names are any of the
3320         <code>PROPERTY_</code> constants defined in the
3321         {@link android.content.pm.PackageManager PackageManager} class. Values
3322         are obtained using the appropriate method on the
3323         {@link android.content.pm.PackageManager.Property PackageManager.Property} class.
3324         <p>Ordinary values are specified through the value attribute. Resource IDs are
3325         specified through the resource attribute.
3326         <p>It is invalid to specify both a value and resource attributes. -->
3327    <declare-styleable name="AndroidManifestProperty"
3328         parent="AndroidManifestApplication
3329                 AndroidManifestActivity
3330                 AndroidManifestReceiver
3331                 AndroidManifestProvider
3332                 AndroidManifestService">
3333        <attr name="name" />
3334        <!-- Concrete value to assign to this property.
3335             The data can later be retrieved from the property object
3336             through
3337             {@link android.content.pm.PackageManager.Property#getString Property.getString},
3338             {@link android.content.pm.PackageManager.Property#getInteger Property.getInteger},
3339             {@link android.content.pm.PackageManager.Property#getBoolean Property.getBoolean},
3340             or {@link android.content.pm.PackageManager.Property#getFloat Property.getFloat}
3341             depending on the type used here. -->
3342        <attr name="value" />
3343        <!-- The resource identifier to assign to this property.
3344             The resource identifier can later be retrieved from the property object through
3345             {@link android.content.pm.PackageManager.Property#getResourceId Property.getResourceId}. -->
3346        <attr name="resource" />
3347    </declare-styleable>
3348
3349    <!-- The <code>intent-filter</code> tag is used to construct an
3350         {@link android.content.IntentFilter} object that will be used
3351         to determine which component can handle a particular
3352         {@link android.content.Intent} that has been given to the system.
3353         It can be used as a child of the
3354         {@link #AndroidManifestActivity activity},
3355         {@link #AndroidManifestReceiver receiver} and
3356         {@link #AndroidManifestService service}
3357         tags.
3358
3359         <p> Zero or more {@link #AndroidManifestAction action},
3360         {@link #AndroidManifestCategory category}, and/or
3361         {@link #AndroidManifestData data} tags should be
3362         included inside to describe the contents of the filter.
3363
3364         <p> The optional label and icon attributes here are used with
3365         an activity to supply an alternative description of that activity
3366         when it is being started through an Intent matching this filter. -->
3367    <declare-styleable name="AndroidManifestIntentFilter"
3368         parent="AndroidManifestActivity AndroidManifestReceiver AndroidManifestService">
3369        <attr name="label" />
3370        <attr name="icon" />
3371        <attr name="roundIcon" />
3372        <attr name="banner" />
3373        <attr name="logo" />
3374        <attr name="priority" />
3375        <attr name="autoVerify" />
3376        <!-- Within an application, multiple intent filters may match a particular
3377             intent. This allows the app author to specify the order filters should
3378             be considered. We don't want to use priority because that is global
3379             across applications.
3380             <p>Only use if you really need to forcibly set the order in which
3381             filters are evaluated. It is preferred to target an activity with a
3382             directed intent instead.
3383             <p>The value is a single integer, with higher numbers considered to
3384             be better. If not specified, the default order is 0. -->
3385        <attr name="order" />
3386    </declare-styleable>
3387
3388    <!-- Attributes that can be supplied in an AndroidManifest.xml
3389         <code>action</code> tag, a child of the
3390         {@link #AndroidManifestIntentFilter intent-filter} tag.
3391         See {@link android.content.IntentFilter#addAction} for
3392         more information. -->
3393    <declare-styleable name="AndroidManifestAction" parent="AndroidManifestIntentFilter">
3394        <!-- The name of an action that is handled, using the Java-style
3395             naming convention.  For example, to support
3396             {@link android.content.Intent#ACTION_VIEW Intent.ACTION_VIEW}
3397             you would put <code>android.intent.action.VIEW</code> here.
3398             Custom actions should generally use a prefix matching the
3399             package name. -->
3400        <attr name="name" />
3401    </declare-styleable>
3402
3403    <!-- Attributes that can be supplied in an AndroidManifest.xml
3404         <code>data</code> tag, a child of the
3405         {@link #AndroidManifestIntentFilter intent-filter} tag, describing
3406         the types of data that match.  This tag can be specified multiple
3407         times to supply multiple data options, as described in the
3408         {@link android.content.IntentFilter} class.  Note that all such
3409         tags are adding options to the same IntentFilter so that, for example,
3410         <code>&lt;data android:scheme="myscheme" android:host="me.com" /&gt;</code>
3411         is equivalent to <code>&lt;data android:scheme="myscheme" /&gt;
3412         &lt;data android:host="me.com" /&gt;</code>. -->
3413    <declare-styleable name="AndroidManifestData" parent="AndroidManifestIntentFilter">
3414        <!-- Specify a MIME type that is handled, as per
3415             {@link android.content.IntentFilter#addDataType
3416             IntentFilter.addDataType()}.
3417             <p><em>Note: MIME type matching in the Android framework is
3418             case-sensitive, unlike formal RFC MIME types.  As a result,
3419             MIME types here should always use lower case letters.</em></p> -->
3420        <attr name="mimeType" format="string" />
3421        <!-- Specify a group of MIME types that are handled. MIME types can be added and
3422             removed to a package's MIME group via the PackageManager. -->
3423        <attr name="mimeGroup" format="string" />
3424        <!-- Specify a URI scheme that is handled, as per
3425             {@link android.content.IntentFilter#addDataScheme
3426             IntentFilter.addDataScheme()}.
3427             <p><em>Note: scheme matching in the Android framework is
3428             case-sensitive, unlike the formal RFC.  As a result,
3429             schemes here should always use lower case letters.</em></p> -->
3430        <attr name="scheme" format="string" />
3431        <!-- Specify a URI scheme specific part that must exactly match, as per
3432             {@link android.content.IntentFilter#addDataSchemeSpecificPart
3433             IntentFilter.addDataSchemeSpecificPart()} with
3434             {@link android.os.PatternMatcher#PATTERN_LITERAL}. -->
3435        <attr name="ssp" format="string" />
3436        <!-- Specify a URI scheme specific part that must be a prefix to match, as per
3437             {@link android.content.IntentFilter#addDataSchemeSpecificPart
3438             IntentFilter.addDataSchemeSpecificPart()} with
3439             {@link android.os.PatternMatcher#PATTERN_PREFIX}. -->
3440        <attr name="sspPrefix" format="string" />
3441        <!-- Specify a URI scheme specific part that matches a simple pattern, as per
3442             {@link android.content.IntentFilter#addDataSchemeSpecificPart
3443             IntentFilter.addDataSchemeSpecificPart()} with
3444             {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}.
3445             Note that because '\' is used as an escape character when
3446             reading the string from XML (before it is parsed as a pattern),
3447             you will need to double-escape: for example a literal "*" would
3448             be written as "\\*" and a literal "\" would be written as
3449             "\\\\".  This is basically the same as what you would need to
3450             write if constructing the string in Java code. -->
3451        <attr name="sspPattern" format="string" />
3452        <!-- Specify a URI scheme specific part that matches an advanced pattern, as per
3453             {@link android.content.IntentFilter#addDataSchemeSpecificPart
3454             IntentFilter.addDataSchemeSpecificPart()} with
3455             {@link android.os.PatternMatcher#PATTERN_ADVANCED_GLOB}.
3456             Note that because '\' is used as an escape character when
3457             reading the string from XML (before it is parsed as a pattern),
3458             you will need to double-escape: for example a literal "*" would
3459             be written as "\\*" and a literal "\" would be written as
3460             "\\\\".  This is basically the same as what you would need to
3461             write if constructing the string in Java code. -->
3462        <attr name="sspAdvancedPattern" format="string" />
3463        <!-- Specify a URI scheme specific part that must be a suffix to match, as per
3464             {@link android.content.IntentFilter#addDataSchemeSpecificPart
3465             IntentFilter.addDataSchemeSpecificPart()} with
3466             {@link android.os.PatternMatcher#PATTERN_SUFFIX}. -->
3467        <attr name="sspSuffix" format="string" />
3468        <!-- Specify a URI authority host that is handled, as per
3469             {@link android.content.IntentFilter#addDataAuthority
3470             IntentFilter.addDataAuthority()}.
3471             <p><em>Note: host name matching in the Android framework is
3472             case-sensitive, unlike the formal RFC.  As a result,
3473             host names here should always use lower case letters.</em></p> -->
3474        <attr name="host" format="string" />
3475        <!-- Specify a URI authority port that is handled, as per
3476             {@link android.content.IntentFilter#addDataAuthority
3477             IntentFilter.addDataAuthority()}.  If a host is supplied
3478             but not a port, any port is matched. -->
3479        <attr name="port" format="string" />
3480        <!-- Specify a URI path that must exactly match, as per
3481             {@link android.content.IntentFilter#addDataPath
3482             IntentFilter.addDataPath()} with
3483             {@link android.os.PatternMatcher#PATTERN_LITERAL}. -->
3484        <attr name="path" />
3485        <!-- Specify a URI path that must be a prefix to match, as per
3486             {@link android.content.IntentFilter#addDataPath
3487             IntentFilter.addDataPath()} with
3488             {@link android.os.PatternMatcher#PATTERN_PREFIX}. -->
3489        <attr name="pathPrefix" />
3490        <!-- Specify a URI path that matches a simple pattern, as per
3491             {@link android.content.IntentFilter#addDataPath
3492             IntentFilter.addDataPath()} with
3493             {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}.
3494             Note that because '\' is used as an escape character when
3495             reading the string from XML (before it is parsed as a pattern),
3496             you will need to double-escape: for example a literal "*" would
3497             be written as "\\*" and a literal "\" would be written as
3498             "\\\\".  This is basically the same as what you would need to
3499             write if constructing the string in Java code. -->
3500        <attr name="pathPattern" />
3501        <!-- Specify a URI path that matches an advanced pattern, as per
3502             {@link android.content.IntentFilter#addDataPath
3503             IntentFilter.addDataPath()} with
3504             {@link android.os.PatternMatcher#PATTERN_ADVANCED_GLOB}.
3505             Note that because '\' is used as an escape character when
3506             reading the string from XML (before it is parsed as a pattern),
3507             you will need to double-escape: for example a literal "*" would
3508             be written as "\\*" and a literal "\" would be written as
3509             "\\\\".  This is basically the same as what you would need to
3510             write if constructing the string in Java code. -->
3511        <attr name="pathAdvancedPattern" />
3512        <!-- Specify a URI path that must be a suffix to match, as per
3513             {@link android.content.IntentFilter#addDataPath
3514             IntentFilter.addDataPath()} with
3515             {@link android.os.PatternMatcher#PATTERN_SUFFIX}. -->
3516        <attr name="pathSuffix" />
3517    </declare-styleable>
3518
3519    <!-- Attributes that can be supplied in an AndroidManifest.xml
3520         <code>category</code> tag, a child of the
3521         {@link #AndroidManifestIntentFilter intent-filter} tag.
3522         See {@link android.content.IntentFilter#addCategory} for
3523         more information. -->
3524    <declare-styleable name="AndroidManifestCategory" parent="AndroidManifestIntentFilter">
3525        <!-- The name of category that is handled, using the Java-style
3526             naming convention.  For example, to support
3527             {@link android.content.Intent#CATEGORY_LAUNCHER Intent.CATEGORY_LAUNCHER}
3528             you would put <code>android.intent.category.LAUNCHER</code> here.
3529             Custom actions should generally use a prefix matching the
3530             package name. -->
3531        <attr name="name" />
3532    </declare-styleable>
3533
3534    <!-- Attributes that can be supplied in an AndroidManifest.xml
3535         <code>instrumentation</code> tag, a child of the root
3536         {@link #AndroidManifest manifest} tag. -->
3537    <declare-styleable name="AndroidManifestInstrumentation" parent="AndroidManifest">
3538        <!-- Required name of the class implementing the instrumentation, deriving from
3539            {@link android.app.Instrumentation}.  This is a fully
3540            qualified class name (for example, com.mycompany.myapp.MyActivity); as a
3541            short-hand if the first character of the class
3542            is a period then it is appended to your package name. -->
3543        <attr name="name" />
3544        <attr name="targetPackage" />
3545        <attr name="targetProcesses" />
3546        <attr name="label" />
3547        <attr name="icon" />
3548        <attr name="roundIcon" />
3549        <attr name="banner" />
3550        <attr name="logo" />
3551        <attr name="handleProfiling" />
3552        <attr name="functionalTest" />
3553    </declare-styleable>
3554
3555    <!-- Attributes that can be supplied in an AndroidManifest.xml
3556         <code>screen</code> tag, a child of <code>compatible-screens</code>,
3557         which is itself a child of the root
3558         {@link #AndroidManifest manifest} tag. -->
3559    <declare-styleable name="AndroidManifestCompatibleScreensScreen"
3560                       parent="AndroidManifest.AndroidManifestCompatibleScreens">
3561        <!-- Specifies a compatible screen size, as per the device
3562             configuration screen size bins. -->
3563        <attr name="screenSize">
3564            <!-- A small screen configuration, at least 240x320dp. -->
3565            <enum name="small" value="200" />
3566            <!-- A normal screen configuration, at least 320x480dp. -->
3567            <enum name="normal" value="300" />
3568            <!-- A large screen configuration, at least 400x530dp. -->
3569            <enum name="large" value="400" />
3570            <!-- An extra large screen configuration, at least 600x800dp. -->
3571            <enum name="xlarge" value="500" />
3572        </attr>
3573        <!-- Specifies a compatible screen density, as per the device
3574             configuration screen density bins. -->
3575        <attr name="screenDensity" format="integer">
3576            <!-- A low density screen, approximately 120dpi. -->
3577            <enum name="ldpi" value="120" />
3578            <!-- A medium density screen, approximately 160dpi. -->
3579            <enum name="mdpi" value="160" />
3580            <!-- A high density screen, approximately 240dpi. -->
3581            <enum name="hdpi" value="240" />
3582            <!-- An extra high density screen, approximately 320dpi. -->
3583            <enum name="xhdpi" value="320" />
3584            <!-- An extra extra high density screen, approximately 480dpi. -->
3585            <enum name="xxhdpi" value="480" />
3586            <!-- An extra extra extra high density screen, approximately 640dpi. -->
3587            <enum name="xxxhdpi" value="640" />
3588        </attr>
3589    </declare-styleable>
3590
3591    <!-- The <code>input-type</code> tag is a child of the <code>supports-input</code> tag, which
3592         is itself a child of the root {@link #AndroidManifest manifest} tag. Each
3593         <code>input-type</code> tag specifices the name of a specific input device type. When
3594         grouped with the other elements of the parent <code>supports-input</code> tag it defines
3595         a collection of input devices, which when all used together, are considered a supported
3596         input mechanism for the application. There may be multiple <code>supports-input</code>
3597         tags defined, each containing a different combination of input device types. -->
3598    <declare-styleable name="AndroidManifestSupportsInputInputType"
3599                       parent="AndroidManifest.AndroidManifestSupportsInput">
3600        <!-- Specifices the name of the input device type -->
3601        <attr name="name" />
3602    </declare-styleable>
3603
3604    <!-- The attribute that holds a Base64-encoded public key. -->
3605    <attr name="publicKey" format="string" />
3606
3607    <!-- Attributes relating to a package verifier. -->
3608    <declare-styleable name="AndroidManifestPackageVerifier" parent="AndroidManifest">
3609        <!-- Specifies the Java-style package name that defines this
3610             package verifier. -->
3611        <attr name="name" />
3612
3613        <!-- The Base64 encoded public key of the package verifier's
3614             signature. -->
3615        <attr name="publicKey" />
3616    </declare-styleable>
3617
3618    <!-- Attributes relating to resource overlay packages. -->
3619    <declare-styleable name="AndroidManifestResourceOverlay" parent="AndroidManifest">
3620        <!-- Package name of base package whose resources will be overlaid. -->
3621        <attr name="targetPackage" />
3622
3623        <!-- Category of the resource overlay. -->
3624        <attr name="category" format="string"/>
3625
3626        <!-- Load order of overlay package. -->
3627        <attr name="priority" />
3628
3629        <!-- Whether the given RRO is static or not. -->
3630        <attr name="isStatic" format="boolean" />
3631
3632        <!-- Required property name/value pair used to enable this overlay.
3633             e.g. name=ro.oem.sku value=MKT210.
3634             Overlay will be ignored unless system property exists and is
3635             set to specified value -->
3636        <!-- @hide This shouldn't be public. -->
3637        <attr name="requiredSystemPropertyName" format="string" />
3638        <!-- @hide This shouldn't be public. -->
3639        <attr name="requiredSystemPropertyValue" format="string" />
3640
3641        <!-- The name of the overlayable whose resources will be overlaid. -->
3642        <attr name="targetName" />
3643
3644        <!-- The xml file that defines the target id to overlay value mappings. -->
3645        <attr name="resourcesMap" format="reference" />
3646    </declare-styleable>
3647
3648    <!-- Declaration of an {@link android.content.Intent} object in XML.  May
3649         also include zero or more {@link #IntentCategory <category>} and
3650         {@link #Extra <extra>} tags. -->
3651    <declare-styleable name="Intent">
3652        <!-- The action name to assign to the Intent, as per
3653            {@link android.content.Intent#setAction Intent.setAction()}. -->
3654        <attr name="action" format="string" />
3655        <!-- The data URI to assign to the Intent, as per
3656            {@link android.content.Intent#setData Intent.setData()}.
3657            <p><em>Note: scheme and host name matching in the Android framework is
3658            case-sensitive, unlike the formal RFC.  As a result,
3659            URIs here should always be normalized to use lower case letters
3660            for these elements (as well as other proper Uri normalization).</em></p> -->
3661        <attr name="data" format="string" />
3662        <!-- The MIME type name to assign to the Intent, as per
3663            {@link android.content.Intent#setType Intent.setType()}.
3664            <p><em>Note: MIME type matching in the Android framework is
3665            case-sensitive, unlike formal RFC MIME types.  As a result,
3666            MIME types here should always use lower case letters.</em></p> -->
3667        <attr name="mimeType" />
3668        <!-- The identifier to assign to the intent, as per
3669            {@link android.content.Intent#setIdentifier Intent.setIdentifier()}. -->
3670        <attr name="identifier" format="string" />
3671        <!-- The package part of the ComponentName to assign to the Intent, as per
3672            {@link android.content.Intent#setComponent Intent.setComponent()}. -->
3673        <attr name="targetPackage" />
3674        <!-- The class part of the ComponentName to assign to the Intent, as per
3675            {@link android.content.Intent#setComponent Intent.setComponent()}. -->
3676        <attr name="targetClass" format="string" />
3677    </declare-styleable>
3678
3679    <!-- A category to add to an Intent, as per
3680            {@link android.content.Intent#addCategory Intent.addCategory()}. -->
3681    <declare-styleable name="IntentCategory" parent="Intent">
3682        <!-- Required name of the category. -->
3683        <attr name="name" />
3684    </declare-styleable>
3685
3686    <!-- An extra data value to place into a an extra/name value pair held
3687            in a Bundle, as per {@link android.os.Bundle}. -->
3688    <declare-styleable name="Extra" parent="Intent">
3689        <!-- Required name of the extra data. -->
3690        <attr name="name" />
3691        <!-- Concrete value to put for this named extra data. -->
3692        <attr name="value" />
3693    </declare-styleable>
3694
3695    <!-- Groups signing keys into a {@code KeySet} for easier reference in
3696            other APIs. However, currently no APIs use this. -->
3697    <attr name="keySet" />
3698    <declare-styleable name="AndroidManifestPublicKey">
3699        <attr name="name" />
3700        <attr name="value" />
3701    </declare-styleable>
3702    <declare-styleable name="AndroidManifestKeySet">
3703        <attr name="name" />
3704    </declare-styleable>
3705
3706    <!-- Associate declared KeySets with upgrading capability. -->
3707    <declare-styleable name="AndroidManifestUpgradeKeySet" parent="AndroidManifest">
3708      <attr name="name" />
3709    </declare-styleable>
3710
3711    <!-- <code>layout</code> tag allows configuring the layout for the activity within multi-window
3712         environment. -->
3713    <declare-styleable name="AndroidManifestLayout" parent="AndroidManifestActivity">
3714        <!-- Default width of the activity. Can be either a fixed value or fraction, in which case
3715             the width will be constructed as a fraction of the total available width. -->
3716        <attr name="defaultWidth" format="dimension|fraction" />
3717        <!-- Default height of the activity. Can be either a fixed value or fraction, in which case
3718             the height will be constructed as a fraction of the total available height. -->
3719        <attr name="defaultHeight" format="dimension|fraction" />
3720        <!-- Where to initially position the activity inside the available space. Uses constants
3721             defined in {@link android.view.Gravity}. -->
3722        <attr name="gravity" />
3723        <!-- Minimal width of the activity.
3724
3725         <p><strong>NOTE:</strong> A task's root activity value is applied to all additional
3726         activities launched in the task. That is if the root activity of a task set minimal width,
3727         then the system will set the same minimal width on all other activities in the task. It
3728         will also ignore any other minimal width attributes of non-root activities. -->
3729        <attr name="minWidth" />
3730        <!-- Minimal height of the activity.
3731
3732         <p><strong>NOTE:</strong> A task's root activity value is applied to all additional
3733         activities launched in the task. That is if the root activity of a task set minimal height,
3734         then the system will set the same minimal height on all other activities in the task. It
3735         will also ignore any other minimal height attributes of non-root activities. -->
3736        <attr name="minHeight" />
3737
3738        <!-- Window layout affinity of this activity. Activities with the same window layout
3739          affinity will share the same layout record. That is, if a user is opening an activity in
3740          a new task on a display that can host freeform windows, and the user had opened a task
3741          before and that task had a root activity who had the same window layout affinity, the
3742          new task's window will be created in the same window mode and around the location which
3743          the previously opened task was in.
3744
3745          <p>For example, if a user maximizes a task with root activity A and opens another
3746          activity B that has the same window layout affinity as activity A has, activity B will
3747          be created in fullscreen window mode. Similarly, if they move/resize a task with root
3748          activity C and open another activity D that has the same window layout affinity as
3749          activity C has, activity D will be in freeform window mode and as close to the position
3750          of activity C as conditions permit. It doesn't require the user to keep the task with
3751          activity A or activity C open. It won't, however, put any task into split-screen or PIP
3752          window mode on launch.
3753
3754          <p>If the user is opening an activity with its window layout affinity for the first time,
3755          the window mode and position is OEM defined.
3756
3757          <p>By default activity doesn't share any affinity with other activities. -->
3758        <attr name="windowLayoutAffinity" format="string" />
3759    </declare-styleable>
3760
3761    <!-- <code>restrict-update</code> tag restricts system apps from being updated unless the
3762        SHA-512 hash equals the specified value.
3763        @hide -->
3764    <declare-styleable name="AndroidManifestRestrictUpdate" parent="AndroidManifest">
3765        <!-- The SHA-512 hash of the only APK that can be used to update a package.
3766             <p>NOTE: This is only applicable to system packages.
3767             @hide -->
3768        <attr name="hash" format="string" />
3769    </declare-styleable>
3770
3771    <declare-styleable name="AndroidManifestUsesSplit" parent="AndroidManifest">
3772        <attr name="name" format="string" />
3773    </declare-styleable>
3774
3775
3776    <declare-styleable name="AndroidManifestProfileable" parent="AndroidManifestApplication">
3777        <!-- Flag indicating whether the application can be profiled by the shell user,
3778             even when running on a device that is running in user mode. -->
3779        <attr name="shell" format="boolean" />
3780        <!-- Flag indicating whether the application can be profiled by system services, but not
3781             necessarily via shell tools (for which also android:shell="true" must be set). If
3782             false, the application cannot be profiled at all. Defaults to true. -->
3783        <attr name="enabled" format="boolean" />
3784    </declare-styleable>
3785
3786    <!-- <code>install-constraints</code> tag rejects installs unless one the constraints defined by
3787         its child elements is true.
3788         It is possible to have multiple <code>install-constraints</code> tags in a single manifest,
3789         where each tag is evaluated independently.
3790         @hide -->
3791    <declare-styleable name="AndroidManifestInstallConstraints" parent="AndroidManifest" />
3792
3793    <!-- A constraint for <code>install-constraints</code>. Checks that the device fingerprint
3794         starts with the given prefix.
3795         @hide -->
3796    <declare-styleable name="AndroidManifestInstallConstraintsFingerprintPrefix"
3797                       parent="AndroidManifestInstallConstraints">
3798        <attr name="value" />
3799    </declare-styleable>
3800</resources>
3801