• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 an extended graphical logo for its
66         associated item. Use with the application tag (to supply a default
67         logo for all application components), or with the activity, receiver,
68         service, or instrumentation tag (to supply a specific logo for that
69         component). It may also be used with the intent-filter tag to supply
70         a logo to show to the user when an activity is being selected based
71         on a particular Intent.
72
73         <p>The given logo will be used to display to the user a graphical
74         representation of its associated component; for example as the
75         header in the Action Bar. The primary differences between an icon
76         and a logo are that logos are often wider and more detailed, and are
77         used without an accompanying text caption. This must be a reference
78         to a Drawable resource containing the image definition. -->
79    <attr name="logo" format="reference" />
80
81    <!-- Name of the activity to be launched to manage application's space on
82         device. The specified activity gets automatically launched when the
83         application's space needs to be managed and is usually invoked
84         through user actions. Applications can thus provide their own custom
85         behavior for managing space for various scenarios like out of memory
86         conditions. This is an optional attribute and
87         applications can choose not to specify a default activity to
88         manage space. -->
89    <attr name="manageSpaceActivity" format="string" />
90
91    <!-- Option to let applications specify that user data can/cannot be
92         cleared. This flag is turned on by default.
93         <em>This attribute is usable only by applications
94         included in the system image. Third-party apps cannot use it.</em> -->
95    <attr name="allowClearUserData" format="boolean" />
96
97    <!-- Option to let applications specify that user data should
98         never be encrypted if an Encrypted File System solution
99         is enabled. Specifically, this is an "opt-out" feature, meaning
100         that, by default, user data will be encrypted if the EFS feature
101         is enabled. -->
102    <attr name="neverEncrypt" format="boolean" />
103
104    <!-- Option to indicate this application is only for testing purposes.
105         For example, it may expose functionality or data outside of itself
106         that would cause a security hole, but is useful for testing.  This
107         kind of application can not be installed without the
108         INSTALL_ALLOW_TEST flag, which means only through adb install.  -->
109    <attr name="testOnly" format="boolean" />
110
111    <!-- A unique name for the given item.  This must use a Java-style naming
112         convention to ensure the name is unique, for example
113         "com.mycompany.MyName". -->
114    <attr name="name" format="string" />
115
116    <!-- Specify a permission that a client is required to have in order to
117    	 use the associated object.  If the client does not hold the named
118    	 permission, its request will fail.  See the
119         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
120         document for more information on permissions. -->
121    <attr name="permission" format="string" />
122
123    <!-- A specific {@link android.R.attr#permission} name for read-only
124         access to a {@link android.content.ContentProvider}.  See the
125         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
126         document for more information on permissions. -->
127    <attr name="readPermission" format="string" />
128
129    <!-- A specific {@link android.R.attr#permission} name for write
130         access to a {@link android.content.ContentProvider}.  See the
131         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
132         document for more information on permissions. -->
133    <attr name="writePermission" format="string" />
134
135    <!-- If true, the {@link android.content.Context#grantUriPermission
136         Context.grantUriPermission} or corresponding Intent flags can
137         be used to allow others to access specific URIs in the content
138         provider, even if they do not have an explicit read or write
139         permission.  If you are supporting this feature, you must be
140         sure to call {@link android.content.Context#revokeUriPermission
141         Context.revokeUriPermission} when URIs are deleted from your
142         provider.-->
143    <attr name="grantUriPermissions" format="boolean" />
144
145    <!-- Characterizes the potential risk implied in a permission and
146         indicates the procedure the system should follow when determining
147         whether to grant the permission to an application requesting it. {@link
148         android.Manifest.permission Standard permissions} have a predefined and
149         permanent protectionLevel. If you are creating a custom permission in an
150         application, you can define a protectionLevel attribute with one of the
151         values listed below. If no protectionLevel is defined for a custom
152         permission, the system assigns the default ("normal"). -->
153    <attr name="protectionLevel">
154        <!-- A lower-risk permission that gives an application access to isolated
155             application-level features, with minimal risk to other applications,
156             the system, or the user. The system automatically grants this type
157             of permission to a requesting application at installation, without
158             asking for the user's explicit approval (though the user always
159             has the option to review these permissions before installing). -->
160        <flag name="normal" value="0" />
161        <!-- A higher-risk permission that would give a requesting application
162             access to private user data or control over the device that can
163             negatively impact the user.  Because this type of permission
164             introduces potential risk, the system may not automatically
165             grant it to the requesting application.  For example, any dangerous
166             permissions requested by an application may be displayed to the
167             user and require confirmation before proceeding, or some other
168             approach may be taken to avoid the user automatically allowing
169             the use of such facilities.  -->
170        <flag name="dangerous" value="1" />
171        <!-- A permission that the system is to grant only if the requesting
172             application is signed with the same certificate as the application
173             that declared the permission. If the certificates match, the system
174             automatically grants the permission without notifying the user or
175             asking for the user's explicit approval. -->
176        <flag name="signature" value="2" />
177        <!-- A permission that the system is to grant only to packages in the
178             Android system image <em>or</em> that are signed with the same
179             certificates. Please avoid using this option, as the
180             signature protection level should be sufficient for most needs and
181             works regardless of exactly where applications are installed.  This
182             permission is used for certain special situations where multiple
183             vendors have applications built in to a system image which need
184             to share specific features explicitly because they are being built
185             together. -->
186        <flag name="signatureOrSystem" value="3" />
187        <!-- Additional flag from base permission type: this permission can also
188             be granted to any applications installed on the system image.
189             Please avoid using this option, as the
190             signature protection level should be sufficient for most needs and
191             works regardless of exactly where applications are installed.  This
192             permission flag is used for certain special situations where multiple
193             vendors have applications built in to a system image which need
194             to share specific features explicitly because they are being built
195             together. -->
196        <flag name="system" value="0x10" />
197        <!-- Additional flag from base permission type: this permission can also
198             (optionally) be granted to development applications. -->
199        <flag name="development" value="0x20" />
200    </attr>
201
202    <!-- Flags indicating more context for a permission group. -->
203    <attr name="permissionGroupFlags">
204        <!-- Set to indicate that this permission group contains permissions
205             protecting access to some information that is considered
206             personal to the user (such as contacts, e-mails, etc). -->
207        <flag name="personalInfo" value="0x0001" />
208    </attr>
209
210    <!-- Flags indicating more context for a permission. -->
211    <attr name="permissionFlags">
212        <!-- Set to indicate that this permission allows an operation that
213             may cost the user money.  Such permissions may be highlighted
214             when shown to the user with this additional information.  -->
215        <flag name="costsMoney" value="0x0001" />
216    </attr>
217
218    <!-- Specified the name of a group that this permission is associated
219         with.  The group must have been defined with the
220         {@link android.R.styleable#AndroidManifestPermissionGroup permission-group} tag. -->
221    <attr name="permissionGroup" format="string" />
222
223    <!-- Specify the name of a user ID that will be shared between multiple
224         packages.  By default, each package gets its own unique user-id.
225         By setting this value on two or more packages, each of these packages
226         will be given a single shared user ID, so they can for example run
227         in the same process.  Note that for them to actually get the same
228         user ID, they must also be signed with the same signature. -->
229    <attr name="sharedUserId" format="string" />
230
231    <!-- Specify a label for the shared user UID of this package.  This is
232         only used if you have also used android:sharedUserId.  This must
233         be a reference to a string resource; it can not be an explicit
234         string. -->
235    <attr name="sharedUserLabel" format="reference" />
236
237    <!-- Internal version code.  This is the number used to determine whether
238         one version is more recent than another: it has no other meaning than
239         that higher numbers are more recent.  You could use this number to
240         encode a "x.y" in the lower and upper 16 bits, make it a build
241         number, simply increase it by one each time a new version is
242         released, or define it however else you want, as long as each
243         successive version has a higher number.  This is not a version
244         number generally shown to the user, that is usually supplied
245         with {@link android.R.attr#versionName}. -->
246    <attr name="versionCode" format="integer" />
247
248    <!-- The text shown to the user to indicate the version they have.  This
249         is used for no other purpose than display to the user; the actual
250         significant version number is given by {@link android.R.attr#versionCode}. -->
251    <attr name="versionName" format="string" />
252
253    <!-- Flag to control special persistent mode of an application.  This should
254         not normally be used by applications; it requires that the system keep
255         your application running at all times. -->
256    <attr name="persistent" format="boolean" />
257
258    <!-- Flag to specify if this application needs to be present for all users. Only pre-installed
259         applications can request this feature. Default value is false. -->
260    <attr name="requiredForAllUsers" format="boolean" />
261
262    <!-- Flag indicating whether the application can be debugged, even when
263         running on a device that is running in user mode. -->
264    <attr name="debuggable" format="boolean" />
265
266    <!-- Flag indicating whether the application requests the VM to operate in
267         the safe mode.  -->
268    <attr name="vmSafeMode" format="boolean" />
269
270    <!-- <p>Flag indicating whether the application's rendering should be hardware
271         accelerated if possible. This flag is turned on by default for applications
272         that are targeting {@link android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH}
273         or later.</p>
274         <p>This flag can be set on the application and any activity declared
275         in the manifest. When enabled for the application, each activity is
276         automatically assumed to be hardware accelerated. This flag can be
277         overridden in the activity tags, either turning it off (if on for the
278         application) or on (if off for the application.)</p>
279         <p>When this flag is turned on for an activity (either directly or via
280         the application tag), every window created from the activity, including
281         the activity's own window, will be hardware accelerated, if possible.</p>
282         <p>Please refer to the documentation of
283         {@link android.view.WindowManager.LayoutParams#FLAG_HARDWARE_ACCELERATED}
284         for more information on how to control this flag programmatically.</p> -->
285    <attr name="hardwareAccelerated" format="boolean" />
286
287    <!-- Flag indicating whether the given application component is available
288         to other applications.  If false, it can only be accessed by
289         applications with its same user id (which usually means only by
290         code in its own package).  If true, it can be invoked by external
291         entities, though which ones can do so may be controlled through
292         permissions.  The default value is false for activity, receiver,
293         and service components that do not specify any intent filters; it
294         is true for activity, receiver, and service components that do
295         have intent filters (implying they expect to be invoked by others
296         who do not know their particular component name) and for all
297         content providers. -->
298    <attr name="exported" format="boolean" />
299
300    <!-- If set to true, a single instance of this component will run for
301         all users.  That instance will run as user 0, the default/primary
302         user.  When the app running is in processes for other users and interacts
303         with this component (by binding to a service for example) those processes will
304         always interact with the instance running for user 0.  Enabling
305         single user mode forces "exported" of the component to be false, to
306         help avoid introducing multi-user security bugs.  This feature is only
307         available to applications built in to the system image; you must hold the
308         permission INTERACT_ACROSS_USERS in order
309         to use this feature.  This flag can only be used with services,
310         receivers, and providers; it can not be used with activities. -->
311    <attr name="singleUser" format="boolean" />
312
313    <!-- Specify a specific process that the associated code is to run in.
314         Use with the application tag (to supply a default process for all
315         application components), or with the activity, receiver, service,
316         or provider tag (to supply a specific icon for that component).
317
318         <p>Application components are normally run in a single process that
319         is created for the entire application.  You can use this tag to modify
320         where they run.  If the process name begins with a ':' character,
321         a new process private to that application will be created when needed
322         to run that component (allowing you to spread your application across
323         multiple processes).  If the process name begins with a lower-case
324         character, the component will be run in a global process of that name,
325         provided that you have permission to do so, allowing multiple
326         applications to share one process to reduce resource usage. -->
327    <attr name="process" format="string" />
328
329    <!-- Specify a task name that activities have an "affinity" to.
330         Use with the application tag (to supply a default affinity for all
331         activities in the application), or with the activity tag (to supply
332         a specific affinity for that component).
333
334         <p>The default value for this attribute is the same as the package
335         name, indicating that all activities in the manifest should generally
336         be considered a single "application" to the user.  You can use this
337         attribute to modify that behavior: either giving them an affinity
338         for another task, if the activities are intended to be part of that
339         task from the user's perspective, or using an empty string for
340         activities that have no affinity to a task. -->
341    <attr name="taskAffinity" format="string" />
342
343    <!-- Specify that an activity can be moved out of a task it is in to
344         the task it has an affinity for when appropriate.  Use with the
345         application tag (to supply a default for all activities in the
346         application), or with an activity tag (to supply a specific
347         setting for that component).
348
349         <p>Normally when an application is started, it is associated with
350         the task of the activity that started it and stays there for its
351         entire lifetime.  You can use the allowTaskReparenting feature to force an
352         activity to be re-parented to a different task when the task it is
353         in goes to the background.  Typically this is used to cause the
354         activities of an application to move back to the main task associated
355         with that application.  The activity is re-parented to the task
356         with the same {@link android.R.attr#taskAffinity} as it has. -->
357    <attr name="allowTaskReparenting" format="boolean" />
358
359    <!-- Specify whether a component is allowed to have multiple instances
360         of itself running in different processes.  Use with the activity
361         and provider tags.
362
363         <p>Normally the system will ensure that all instances of a particular
364         component are only running in a single process.  You can use this
365         attribute to disable that behavior, allowing the system to create
366         instances wherever they are used (provided permissions allow it).
367         This is most often used with content providers, so that instances
368         of a provider can be created in each client process, allowing them
369         to be used without performing IPC.  -->
370    <attr name="multiprocess" format="boolean" />
371
372    <!-- Specify whether an activity should be finished when its task is
373         brought to the foreground by relaunching from the home screen.
374
375         <p>If both this option and {@link android.R.attr#allowTaskReparenting} are
376         specified, the finish trumps the affinity: the affinity will be
377         ignored and the activity simply finished. -->
378    <attr name="finishOnTaskLaunch" format="boolean" />
379
380    <!-- Specify whether an activity should be finished when a "close system
381         windows" request has been made.  This happens, for example, when
382         the home key is pressed, when the device is locked, when a system
383         dialog showing recent applications is displayed, etc. -->
384    <attr name="finishOnCloseSystemDialogs" format="boolean" />
385
386    <!-- Specify whether an activity's task should be cleared when it
387         is re-launched from the home screen.  As a result, every time the
388         user starts the task, they will be brought to its root activity,
389         regardless of whether they used BACK or HOME to last leave it.
390         This flag only applies to activities that
391         are used to start the root of a new task.
392
393         <p>An example of the use of this flag would be for the case where
394         a user launches activity A from home, and from there goes to
395         activity B.  They now press home, and then return to activity A.
396         Normally they would see activity B, since that is what they were
397         last doing in A's task.  However, if A has set this flag to true,
398         then upon going to the background all of the tasks on top of it (B
399         in this case) are removed, so when the user next returns to A they
400         will restart at its original activity.
401
402         <p>When this option is used in conjunction with
403         {@link android.R.attr#allowTaskReparenting}, the allowTaskReparenting trumps the
404         clear.  That is, all activities above the root activity of the
405         task will be removed: those that have an affinity will be moved
406         to the task they are associated with, otherwise they will simply
407         be dropped as described here. -->
408    <attr name="clearTaskOnLaunch" format="boolean" />
409
410    <!-- Specify whether an activity should be kept in its history stack.
411         If this attribute is set, then as soon as the user navigates away
412         from the activity it will be finished and they will no longer be
413         able to return to it. -->
414    <attr name="noHistory" format="boolean" />
415
416    <!-- Specify whether an acitivty's task state should always be maintained
417         by the system, or if it is allowed to reset the task to its initial
418         state in certain situations.
419
420         <p>Normally the system will reset a task (remove all activities from
421         the stack and reset the root activity) in certain situations when
422         the user re-selects that task from the home screen.  Typically this
423         will be done if the user hasn't visited that task for a certain
424         amount of time, such as 30 minutes.
425
426         <p>By setting this attribute, the user will always return to your
427         task in its last state, regardless of how they get there.  This is
428         useful, for example, in an application like the web browser where there
429         is a lot of state (such as multiple open tabs) that the application
430         would not like to lose. -->
431    <attr name="alwaysRetainTaskState" format="boolean" />
432
433    <!-- Indicates that an Activity does not need to have its freeze state
434         (as returned by {@link android.app.Activity#onSaveInstanceState}
435         retained in order to be restarted.  Generally you use this for activities
436         that do not store any state.  When this flag is set, if for some reason
437         the activity is killed before it has a chance to save its state,
438         then the system will not remove it from the activity stack like
439         it normally would.  Instead, the next time the user navigates to
440         it its {@link android.app.Activity#onCreate} method will be called
441         with a null icicle, just like it was starting for the first time.
442
443         <p>This is used by the Home activity to make sure it does not get
444         removed if it crashes for some reason. -->
445    <attr name="stateNotNeeded" format="boolean" />
446
447    <!-- Indicates that an Activity should be excluded from the list of
448         recently launched activities. -->
449    <attr name="excludeFromRecents" format="boolean" />
450
451    <!-- Specify that an Activity should be shown over the lock screen and,
452         in a multiuser environment, across all users' windows -->
453    <attr name="showOnLockScreen" format="boolean" />
454
455    <!-- Specify the authorities under which this content provider can be
456         found.  Multiple authorities may be supplied by separating them
457         with a semicolon.  Authority names should use a Java-style naming
458         convention (such as <code>com.google.provider.MyProvider</code>)
459         in order to avoid conflicts.  Typically this name is the same
460         as the class implementation describing the provider's data structure. -->
461    <attr name="authorities" format="string" />
462
463    <!-- Flag indicating whether this content provider would like to
464         participate in data synchronization. -->
465    <attr name="syncable" format="boolean" />
466
467    <!-- Flag declaring this activity to be 'immersive'; immersive activities
468         should not be interrupted with other activities or notifications. -->
469    <attr name="immersive" format="boolean" />
470
471    <!-- Specify the order in which content providers hosted by a process
472         are instantiated when that process is created.  Not needed unless
473         you have providers with dependencies between each other, to make
474         sure that they are created in the order needed by those dependencies.
475         The value is a simple integer, with higher numbers being
476         initialized first. -->
477    <attr name="initOrder" format="integer" />
478
479    <!-- Specify the relative importance or ability in handling a particular
480         Intent.  For receivers, this controls the order in which they are
481         executed to receive a broadcast (note that for
482         asynchronous broadcasts, this order is ignored).  For activities,
483         this provides information about how good an activity is handling an
484         Intent; when multiple activities match an intent and have different
485         priorities, only those with the higher priority value will be
486         considered a match.
487
488         <p>Only use if you really need to impose some specific
489         order in which the broadcasts are received, or want to forcibly
490         place an activity to always be preferred over others.  The value is a
491         single integer, with higher numbers considered to be better. -->
492    <attr name="priority" format="integer" />
493
494    <!-- Specify how an activity should be launched.  See the
495         <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
496         Stack</a> document for important information on how these options impact
497         the behavior of your application.
498
499         <p>If this attribute is not specified, <code>standard</code> launch
500         mode will be used.  Note that the particular launch behavior can
501         be changed in some ways at runtime through the
502         {@link android.content.Intent} flags
503         {@link android.content.Intent#FLAG_ACTIVITY_SINGLE_TOP},
504         {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}, and
505         {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}. -->
506    <attr name="launchMode">
507        <!-- The default mode, which will usually create a new instance of
508             the activity when it is started, though this behavior may change
509             with the introduction of other options such as
510             {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK
511             Intent.FLAG_ACTIVITY_NEW_TASK}. -->
512        <enum name="standard" value="0" />
513        <!-- If, when starting the activity, there is already an
514            instance of the same activity class in the foreground that is
515            interacting with the user, then
516            re-use that instance.  This existing instance will receive a call to
517            {@link android.app.Activity#onNewIntent Activity.onNewIntent()} with
518            the new Intent that is being started. -->
519        <enum name="singleTop" value="1" />
520        <!-- If, when starting the activity, there is already a task running
521            that starts with this activity, then instead of starting a new
522            instance the current task is brought to the front.  The existing
523            instance will receive a call to {@link android.app.Activity#onNewIntent
524            Activity.onNewIntent()}
525            with the new Intent that is being started, and with the
526            {@link android.content.Intent#FLAG_ACTIVITY_BROUGHT_TO_FRONT
527            Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT} flag set.  This is a superset
528            of the singleTop mode, where if there is already an instance
529            of the activity being started at the top of the stack, it will
530            receive the Intent as described there (without the
531            FLAG_ACTIVITY_BROUGHT_TO_FRONT flag set).  See the
532            <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
533            Stack</a> document for more details about tasks.-->
534        <enum name="singleTask" value="2" />
535        <!-- Only allow one instance of this activity to ever be
536            running.  This activity gets a unique task with only itself running
537            in it; if it is ever launched again with the same Intent, then that
538            task will be brought forward and its
539            {@link android.app.Activity#onNewIntent Activity.onNewIntent()}
540            method called.  If this
541            activity tries to start a new activity, that new activity will be
542            launched in a separate task.  See the
543            <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
544            Stack</a> document for more details about tasks.-->
545        <enum name="singleInstance" value="3" />
546    </attr>
547
548    <!-- Specify the orientation an activity should be run in.  If not
549         specified, it will run in the current preferred orientation
550         of the screen.
551         <p>This attribute is supported by the <a
552            href="{@docRoot}guide/topics/manifest/activity-element.html">{@code &lt;activity>}</a>
553            element. -->
554    <attr name="screenOrientation">
555        <!-- No preference specified: let the system decide the best
556             orientation.  This will either be the orientation selected
557             by the activity below, or the user's preferred orientation
558             if this activity is the bottom of a task. If the user
559             explicitly turned off sensor based orientation through settings
560             sensor based device rotation will be ignored. If not by default
561             sensor based orientation will be taken into account and the
562             orientation will changed based on how the user rotates the device.
563             Corresponds to
564             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_UNSPECIFIED}. -->
565        <enum name="unspecified" value="-1" />
566        <!-- Would like to have the screen in a landscape orientation: that
567             is, with the display wider than it is tall, ignoring sensor data.
568             Corresponds to
569             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE}. -->
570        <enum name="landscape" value="0" />
571        <!-- Would like to have the screen in a portrait orientation: that
572             is, with the display taller than it is wide, ignoring sensor data.
573             Corresponds to
574             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_PORTRAIT}. -->
575        <enum name="portrait" value="1" />
576        <!-- Use the user's current preferred orientation of the handset.
577             Corresponds to
578             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER}. -->
579        <enum name="user" value="2" />
580        <!-- Keep the screen in the same orientation as whatever is behind
581             this activity.
582             Corresponds to
583             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_BEHIND}. -->
584        <enum name="behind" value="3" />
585        <!-- Orientation is determined by a physical orientation sensor:
586             the display will rotate based on how the user moves the device.
587             Ignores user's setting to turn off sensor-based rotation.
588             Corresponds to
589             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR}. -->
590        <enum name="sensor" value="4" />
591        <!-- Always ignore orientation determined by orientation sensor:
592             the display will not rotate when the user moves the device.
593             Corresponds to
594             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_NOSENSOR}. -->
595        <enum name="nosensor" value="5" />
596        <!-- Would like to have the screen in landscape orientation, but can
597             use the sensor to change which direction the screen is facing.
598             Corresponds to
599             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_LANDSCAPE}. -->
600        <enum name="sensorLandscape" value="6" />
601        <!-- Would like to have the screen in portrait orientation, but can
602             use the sensor to change which direction the screen is facing.
603             Corresponds to
604             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_PORTRAIT}. -->
605        <enum name="sensorPortrait" value="7" />
606        <!-- Would like to have the screen in landscape orientation, turned in
607             the opposite direction from normal landscape.
608             Corresponds to
609             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_LANDSCAPE}. -->
610        <enum name="reverseLandscape" value="8" />
611        <!-- Would like to have the screen in portrait orientation, turned in
612             the opposite direction from normal portrait.
613             Corresponds to
614             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_PORTRAIT}. -->
615        <enum name="reversePortrait" value="9" />
616        <!-- Orientation is determined by a physical orientation sensor:
617             the display will rotate based on how the user moves the device.
618             This allows any of the 4 possible rotations, regardless of what
619             the device will normally do (for example some devices won't
620             normally use 180 degree rotation).
621             Corresponds to
622             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_SENSOR}. -->
623        <enum name="fullSensor" value="10" />
624        <!-- Would like to have the screen in landscape orientation, but if
625             the user has enabled sensor-based rotation then we can use the
626             sensor to change which direction the screen is facing.
627             Corresponds to
628             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_LANDSCAPE}. -->
629        <enum name="userLandscape" value="11" />
630        <!-- Would like to have the screen in portrait orientation, but if
631             the user has enabled sensor-based rotation then we can use the
632             sensor to change which direction the screen is facing.
633             Corresponds to
634             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_PORTRAIT}. -->
635        <enum name="userPortrait" value="12" />
636        <!-- Respect the user's sensor-based rotation preference, but if
637             sensor-based rotation is enabled then allow the screen to rotate
638             in all 4 possible directions regardless of what
639             the device will normally do (for example some devices won't
640             normally use 180 degree rotation).
641             Corresponds to
642             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_USER}. -->
643        <enum name="fullUser" value="13" />
644        <!-- Screen is locked to its current rotation, whatever that is.
645             Corresponds to
646             {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LOCKED}. -->
647        <enum name="locked" value="14" />
648    </attr>
649
650    <!-- Specify one or more configuration changes that the activity will
651         handle itself.  If not specified, the activity will be restarted
652         if any of these configuration changes happen in the system.  Otherwise,
653         the activity will remain running and its
654         {@link android.app.Activity#onConfigurationChanged Activity.onConfigurationChanged}
655         method called with the new configuration.
656
657         <p>Note that all of these configuration changes can impact the
658         resource values seen by the application, so you will generally need
659         to re-retrieve all resources (including view layouts, drawables, etc)
660         to correctly handle any configuration change.
661
662         <p>These values must be kept in sync with those in
663         {@link android.content.pm.ActivityInfo} and
664         include/utils/ResourceTypes.h. -->
665    <attr name="configChanges">
666        <!-- The IMSI MCC has changed, that is a SIM has been detected and
667             updated the Mobile Country Code. -->
668        <flag name="mcc" value="0x0001" />
669        <!-- The IMSI MNC has changed, that is a SIM has been detected and
670             updated the Mobile Network Code. -->
671        <flag name="mnc" value="0x0002" />
672        <!-- The locale has changed, that is the user has selected a new
673             language that text should be displayed in. -->
674        <flag name="locale" value="0x0004" />
675        <!-- The touchscreen has changed.  Should never normally happen. -->
676        <flag name="touchscreen" value="0x0008" />
677        <!-- The keyboard type has changed, for example the user has plugged
678             in an external keyboard. -->
679        <flag name="keyboard" value="0x0010" />
680        <!-- The keyboard or navigation accessibility has changed, for example
681             the user has slid the keyboard out to expose it.  Note that
682             despite its name, this applied to any accessibility: keyboard
683             or navigation. -->
684        <flag name="keyboardHidden" value="0x0020" />
685        <!-- The navigation type has changed.  Should never normally happen. -->
686        <flag name="navigation" value="0x0040" />
687        <!-- The screen orientation has changed, that is the user has
688             rotated the device. -->
689        <flag name="orientation" value="0x0080" />
690        <!-- The screen layout has changed.  This might be caused by a
691             different display being activated. -->
692        <flag name="screenLayout" value="0x0100" />
693        <!-- The global user interface mode has changed.  For example,
694             going in or out of car mode, night mode changing, etc. -->
695        <flag name="uiMode" value="0x0200" />
696        <!-- The current available screen size has changed.  If applications don't
697             target at least {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}
698             then the activity will always handle this itself (the change
699             will not result in a restart).  This represents a change in the
700             currently available size, so will change when the user switches
701             between landscape and portrait. -->
702        <flag name="screenSize" value="0x0400" />
703        <!-- The physical screen size has changed.  If applications don't
704             target at least {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}
705             then the activity will always handle this itself (the change
706             will not result in a restart).  This represents a change in size
707             regardless of orientation, so will only change when the actual
708             physical screen size has changed such as switching to an external
709             display. -->
710        <flag name="smallestScreenSize" value="0x0800" />
711        <!-- The layout direction has changed. For example going from LTR to RTL. -->
712        <flag name="layoutDirection" value="0x2000" />
713        <!-- The font scaling factor has changed, that is the user has
714             selected a new global font size. -->
715        <flag name="fontScale" value="0x40000000" />
716    </attr>
717
718    <!-- Descriptive text for the associated data. -->
719    <attr name="description" format="reference" />
720
721    <!-- The name of the application package that an Instrumentation object
722         will run against. -->
723    <attr name="targetPackage" format="string" />
724
725    <!-- Flag indicating that an Instrumentation class wants to take care
726         of starting/stopping profiling itself, rather than relying on
727         the default behavior of profiling the complete time it is running.
728         This allows it to target profiling data at a specific set of
729         operations. -->
730    <attr name="handleProfiling" format="boolean" />
731
732    <!-- Flag indicating that an Instrumentation class should be run as a
733         functional test. -->
734    <attr name="functionalTest" format="boolean" />
735
736    <!-- The touch screen type used by an application. -->
737    <attr name="reqTouchScreen">
738        <enum name="undefined" value="0" />
739        <enum name="notouch" value="1" />
740        <enum name="stylus" value="2" />
741        <enum name="finger" value="3" />
742    </attr>
743
744    <!-- The input method preferred by an application. -->
745    <attr name="reqKeyboardType">
746        <enum name="undefined" value="0" />
747        <enum name="nokeys" value="1" />
748        <enum name="qwerty" value="2" />
749        <enum name="twelvekey" value="3" />
750    </attr>
751
752    <!-- Application's requirement for a hard keyboard -->
753    <attr name="reqHardKeyboard" format="boolean" />
754
755    <!-- The navigation device preferred by an application. -->
756    <attr name="reqNavigation">
757        <enum name="undefined" value="0" />
758        <enum name="nonav" value="1" />
759        <enum name="dpad" value="2" />
760        <enum name="trackball" value="3" />
761        <enum name="wheel" value="4" />
762    </attr>
763
764    <!-- Application's requirement for five way navigation -->
765    <attr name="reqFiveWayNav" format="boolean" />
766
767    <!-- The name of the class subclassing <code>BackupAgent</code> to manage
768         backup and restore of the application's data on external storage. -->
769    <attr name="backupAgent" format="string" />
770
771    <!-- Whether to allow the application to participate in the backup
772         and restore infrastructure.  If this attribute is set to <code>false</code>,
773         no backup or restore of the application will ever be performed, even by a
774         full-system backup that would otherwise cause all application data to be saved
775         via adb.  The default value of this attribute is <code>true</code>. -->
776    <attr name="allowBackup" format="boolean" />
777
778    <!-- Whether the application in question should be terminated after its
779         settings have been restored during a full-system restore operation.
780         Single-package restore operations will never cause the application to
781         be shut down.  Full-system restore operations typically only occur once,
782         when the phone is first set up.  Third-party applications will not usually
783         need to use this attribute.
784
785         <p>The default is <code>true</code>, which means that after the application
786         has finished processing its data during a full-system restore, it will be
787         terminated. -->
788    <attr name="killAfterRestore" format="boolean" />
789
790    <!-- @deprecated This attribute is not used by the Android operating system. -->
791    <attr name="restoreNeedsApplication" format="boolean" />
792
793    <!-- Indicate that the application is prepared to attempt a restore of any
794         backed-up dataset, even if the backup is apparently from a newer version
795         of the application than is currently installed on the device.  Setting
796         this attribute to <code>true</code> will permit the Backup Manager to
797         attempt restore even when a version mismatch suggests that the data are
798         incompatible.  <em>Use with caution!</em>
799
800         <p>The default value of this attribute is <code>false</code>. -->
801    <attr name="restoreAnyVersion" format="boolean" />
802
803    <!-- The default install location defined by an application. -->
804    <attr name="installLocation">
805        <!-- Let the system decide ideal install location -->
806        <enum name="auto" value="0" />
807        <!-- Explicitly request to be installed on internal phone storage
808             only. -->
809        <enum name="internalOnly" value="1" />
810        <!-- Prefer to be installed on SD card. There is no guarantee that
811             the system will honor this request. The application might end
812             up being installed on internal storage if external media
813             is unavailable or too full. -->
814        <enum name="preferExternal" value="2" />
815    </attr>
816
817    <!-- Extra options for an activity's UI. Applies to either the {@code &lt;activity&gt;} or
818         {@code &lt;application&gt;} tag. If specified on the {@code &lt;application&gt;}
819         tag these will be considered defaults for all activities in the
820         application. -->
821    <attr name="uiOptions">
822        <!-- No extra UI options. This is the default. -->
823        <flag name="none" value="0" />
824        <!-- Split the options menu into a separate bar at the bottom of
825             the screen when severely constrained for horizontal space.
826             (e.g. portrait mode on a phone.) Instead of a small number
827             of action buttons appearing in the action bar at the top
828             of the screen, the action bar will split into the top navigation
829             section and the bottom menu section. Menu items will not be
830             split across the two bars; they will always appear together. -->
831        <flag name="splitActionBarWhenNarrow" value="1" />
832    </attr>
833
834    <!-- The name of the logical parent of the activity as it appears in the manifest. -->
835    <attr name="parentActivityName" format="string" />
836
837    <!-- The <code>manifest</code> tag is the root of an
838         <code>AndroidManifest.xml</code> file,
839         describing the contents of an Android package (.apk) file.  One
840         attribute must always be supplied: <code>package</code> gives a
841         unique name for the package, using a Java-style naming convention
842         to avoid name collisions.  For example, applications published
843         by Google could have names of the form
844         <code>com.google.app.<em>appname</em></code>
845
846         <p>Inside of the manifest tag, may appear the following tags
847         in any order: {@link #AndroidManifestPermission permission},
848         {@link #AndroidManifestPermissionGroup permission-group},
849         {@link #AndroidManifestPermissionTree permission-tree},
850         {@link #AndroidManifestUsesSdk uses-sdk},
851         {@link #AndroidManifestUsesPermission uses-permission},
852         {@link #AndroidManifestUsesConfiguration uses-configuration},
853         {@link #AndroidManifestApplication application},
854         {@link #AndroidManifestInstrumentation instrumentation},
855         {@link #AndroidManifestUsesFeature uses-feature}.  -->
856    <declare-styleable name="AndroidManifest">
857        <attr name="versionCode" />
858        <attr name="versionName" />
859        <attr name="sharedUserId" />
860        <attr name="sharedUserLabel" />
861        <attr name="installLocation" />
862    </declare-styleable>
863
864    <!-- The <code>application</code> tag describes application-level components
865         contained in the package, as well as general application
866         attributes.  Many of the attributes you can supply here (such
867         as theme, label, icon, permission, process, taskAffinity,
868         and allowTaskReparenting) serve
869         as default values for the corresponding attributes of components
870         declared inside of the application.
871
872         <p>Inside of this element you specify what the application contains,
873         using the elements {@link #AndroidManifestProvider provider},
874         {@link #AndroidManifestService service},
875         {@link #AndroidManifestReceiver receiver},
876         {@link #AndroidManifestActivity activity},
877         {@link #AndroidManifestActivityAlias activity-alias}, and
878         {@link #AndroidManifestUsesLibrary uses-library}.  The application tag
879         appears as a child of the root {@link #AndroidManifest manifest} tag. -->
880    <declare-styleable name="AndroidManifestApplication" parent="AndroidManifest">
881        <!-- An optional name of a class implementing the overall
882             {@link android.app.Application} for this package.  When the
883             process for your package is started, this class is instantiated
884             before any of the other application components.  Note that this
885             is not required, and in fact most applications will probably
886             not need it. -->
887        <attr name="name" />
888        <attr name="theme" />
889        <attr name="label" />
890        <attr name="icon" />
891        <attr name="logo" />
892        <attr name="description" />
893        <attr name="permission" />
894        <attr name="process" />
895        <attr name="taskAffinity" />
896        <attr name="allowTaskReparenting" />
897        <!-- Indicate whether this application contains code.  If set to false,
898             there is no code associated with it and thus the system will not
899             try to load its code when launching components.  The default is true
900             for normal behavior. -->
901        <attr name="hasCode" format="boolean" />
902        <attr name="persistent" />
903        <attr name="requiredForAllUsers" />
904        <!-- Specify whether the components in this application are enabled or not (that is, can be
905             instantiated by the system).
906             If "false", it overrides any component specific values (a value of "true" will not
907             override the component specific values). -->
908        <attr name="enabled" />
909        <attr name="debuggable" />
910        <attr name="vmSafeMode" />
911        <attr name="hardwareAccelerated" />
912        <!-- Name of activity to be launched for managing the application's space on the device. -->
913        <attr name="manageSpaceActivity" />
914        <attr name="allowClearUserData" />
915        <attr name="testOnly" />
916        <attr name="backupAgent" />
917        <attr name="allowBackup" />
918        <attr name="killAfterRestore" />
919        <attr name="restoreNeedsApplication" />
920        <attr name="restoreAnyVersion" />
921        <attr name="neverEncrypt" />
922        <!-- Request that your application's processes be created with
923             a large Dalvik heap.  This applies to <em>all</em> processes
924             created for the application.  It only applies to the first
925             application loaded into a process; if using a sharedUserId
926             to allow multiple applications to use a process, they all must
927             use this option consistently or will get unpredictable results. -->
928        <attr name="largeHeap" format="boolean" />
929        <!-- Declare that this application can't participate in the normal
930             state save/restore mechanism.  Since it is not able to save and
931             restore its state on demand,
932             it can not participate in the normal activity lifecycle.  It will
933             not be killed while in the background; the user must explicitly
934             quit it.  Only one such app can be running at a time; if the user
935             tries to launch a second such app, they will be prompted
936             to quit the first before doing so.  While the
937             application is running, the user will be informed of this.
938             @hide -->
939        <attr name="cantSaveState" format="boolean" />
940        <attr name="uiOptions" />
941        <!-- Declare that your application will be able to deal with RTL (right to left) layouts.
942             If set to  false (default value), your application will not care about RTL layouts. -->
943        <attr name="supportsRtl" format="boolean" />
944        <!-- Declare that this application requires access to restricted accounts of a certain
945             type. The default value is null and restricted accounts won\'t be visible to this
946             application. The type should correspond to the account authenticator type, such as
947             "com.google". -->
948        <attr name="restrictedAccountType" format="string"/>
949        <!-- Declare that this application requires an account of a certain
950             type. The default value is null and indicates that the application can work without
951             any accounts. The type should correspond to the account authenticator type, such as
952             "com.google". -->
953        <attr name="requiredAccountType" format="string"/>
954    </declare-styleable>
955
956    <!-- The <code>permission</code> tag declares a security permission that can be
957         used to control access from other packages to specific components or
958         features in your package (or other packages).  See the
959         <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
960         document for more information on permissions.
961
962         <p>This appears as a child tag of the root
963         {@link #AndroidManifest manifest} tag. -->
964    <declare-styleable name="AndroidManifestPermission" parent="AndroidManifest">
965        <!-- Required public name of the permission, which other components and
966        packages will use when referring to this permission.  This is a string using
967        Java-style scoping to ensure it is unique.  The prefix will often
968        be the same as our overall package name, for example
969        "com.mycompany.android.myapp.SomePermission". -->
970        <attr name="name" />
971        <attr name="label" />
972        <attr name="icon" />
973        <attr name="logo" />
974        <attr name="permissionGroup" />
975        <attr name="description" />
976        <attr name="protectionLevel" />
977        <attr name="permissionFlags" />
978    </declare-styleable>
979
980    <!-- The <code>permission-group</code> tag declares a logical grouping of
981         related permissions.
982
983         <p>Note that this tag does not declare a permission itself, only
984         a namespace in which further permissions can be placed.  See
985         the {@link #AndroidManifestPermission &lt;permission&gt;} tag for
986         more information.
987
988         <p>This appears as a child tag of the root
989         {@link #AndroidManifest manifest} tag. -->
990    <declare-styleable name="AndroidManifestPermissionGroup" parent="AndroidManifest">
991        <!-- Required public name of the permission group, permissions will use
992        to specify the group they are in.  This is a string using
993        Java-style scoping to ensure it is unique.  The prefix will often
994        be the same as our overall package name, for example
995        "com.mycompany.android.myapp.SomePermission". -->
996        <attr name="name" />
997        <attr name="label" />
998        <attr name="icon" />
999        <attr name="logo" />
1000        <attr name="description" />
1001        <attr name="permissionGroupFlags" />
1002        <attr name="priority" />
1003    </declare-styleable>
1004
1005    <!-- The <code>permission-tree</code> tag declares the base of a tree of
1006         permission values: it declares that this package has ownership of
1007         the given permission name, as well as all names underneath it
1008         (separated by '.').  This allows you to use the
1009         {@link android.content.pm.PackageManager#addPermission
1010         PackageManager.addPermission()} method to dynamically add new
1011         permissions under this tree.
1012
1013         <p>Note that this tag does not declare a permission itself, only
1014         a namespace in which further permissions can be placed.  See
1015         the {@link #AndroidManifestPermission &lt;permission&gt;} tag for
1016         more information.
1017
1018         <p>This appears as a child tag of the root
1019         {@link #AndroidManifest manifest} tag. -->
1020    <declare-styleable name="AndroidManifestPermissionTree" parent="AndroidManifest">
1021        <!-- Required public name of the permission tree, which is the base name
1022        of all permissions under it.  This is a string using
1023        Java-style scoping to ensure it is unique.  The prefix will often
1024        be the same as our overall package name, for example
1025        "com.mycompany.android.myapp.SomePermission".  A permission tree name
1026        must have more than two segments in its path; that is,
1027        "com.me.foo" is okay, but not "com.me" or "com". -->
1028        <attr name="name" />
1029        <attr name="label" />
1030        <attr name="icon" />
1031        <attr name="logo" />
1032    </declare-styleable>
1033
1034    <!-- The <code>uses-permission</code> tag requests a
1035         {@link #AndroidManifestPermission &lt;permission&gt;} that the containing
1036         package must be granted in order for it to operate correctly.
1037         See the <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a>
1038         document for more information on permissions.  Also available is a
1039         {@link android.Manifest.permission list of permissions} included
1040         with the base platform.
1041
1042         <p>This appears as a child tag of the root
1043         {@link #AndroidManifest manifest} tag. -->
1044    <declare-styleable name="AndroidManifestUsesPermission" parent="AndroidManifest">
1045        <!-- Required name of the permission you use, as published with the
1046        corresponding name attribute of a
1047        {@link android.R.styleable#AndroidManifestPermission &lt;permission&gt;}
1048        tag; often this is one of the {@link android.Manifest.permission standard
1049        system permissions}. -->
1050        <attr name="name" />
1051        <!-- Optional: specify the maximum version of the Android OS for which the
1052             application wishes to request the permission.  When running on a version
1053             of Android higher than the number given here, the permission will not
1054             be requested.  -->
1055        <attr name="maxSdkVersion" format="integer" />
1056        <!--  Specify whether this permission is required for the application.
1057              The default is true, meaning the application requires the
1058              permission, and it must always be granted when it is installed.
1059              If you set this to false, then in some cases the application may
1060              be installed with it being granted the permission, and it will
1061              need to request the permission later if it needs it.
1062        <attr name="required" format="boolean" />
1063        -->
1064    </declare-styleable>
1065
1066    <!-- The <code>uses-configuration</code> tag specifies
1067         a specific hardware configuration value used by the application.
1068         For example an application might specify that it requires
1069         a physical keyboard or a particular navigation method like
1070         trackball. Multiple such attribute values can be specified by the
1071         application.
1072
1073         <p>This appears as a child tag of the root
1074         {@link #AndroidManifest manifest} tag. -->
1075    <declare-styleable name="AndroidManifestUsesConfiguration" parent="AndroidManifest">
1076        <!-- The type of touch screen used by an application. -->
1077        <attr name="reqTouchScreen" />
1078        <attr name="reqKeyboardType" />
1079        <attr name="reqHardKeyboard" />
1080        <attr name="reqNavigation" />
1081        <attr name="reqFiveWayNav" />
1082    </declare-styleable>
1083
1084    <!-- The <code>uses-feature</code> tag specifies
1085         a specific feature used by the application.
1086         For example an application might specify that it requires
1087         specific version of OpenGL. Multiple such attribute
1088         values can be specified by the application.
1089
1090         <p>This appears as a child tag of the root
1091         {@link #AndroidManifest manifest} tag. -->
1092    <declare-styleable name="AndroidManifestUsesFeature" parent="AndroidManifest">
1093        <!-- The GLES driver version number needed by an application.
1094             The higher 16 bits represent the major number and the lower 16 bits
1095             represent the minor number. For example for GL 1.2 referring to
1096             0x00000102, the actual value should be set as 0x00010002. -->
1097        <attr name="glEsVersion" format="integer"/>
1098        <!--  The name of the feature that is being used. -->
1099        <attr name="name" />
1100        <!--  Specify whether this feature is required for the application.
1101              The default is true, meaning the application requires the
1102              feature, and does not want to be installed on devices that
1103              don't support it.  If you set this to false, then this will
1104              not impose a restriction on where the application can be
1105              installed. -->
1106        <attr name="required" format="boolean" />
1107    </declare-styleable>
1108
1109    <!-- The <code>uses-sdk</code> tag describes the SDK features that the
1110         containing package must be running on to operate correctly.
1111
1112         <p>This appears as a child tag of the root
1113         {@link #AndroidManifest manifest} tag. -->
1114    <declare-styleable name="AndroidManifestUsesSdk" parent="AndroidManifest">
1115        <!-- This is the minimum SDK version number that the application
1116             requires.  This number is an abstract integer, from the list
1117             in {@link android.os.Build.VERSION_CODES}  If
1118             not supplied, the application will work on any SDK.  This
1119             may also be string (such as "Donut") if the application was built
1120             against a development branch, in which case it will only work against
1121             the development builds. -->
1122        <attr name="minSdkVersion" format="integer|string" />
1123        <!-- This is the SDK version number that the application is targeting.
1124             It is able to run on older versions (down to minSdkVersion), but
1125             was explicitly tested to work with the version specified here.
1126             Specifying this version allows the platform to disable compatibility
1127             code that are not required or enable newer features that are not
1128             available to older applications.  This may also be a string
1129             (such as "Donut") if this is built against a development
1130             branch, in which case minSdkVersion is also forced to be that
1131             string. -->
1132        <attr name="targetSdkVersion" format="integer|string" />
1133        <!-- This is the maximum SDK version number that an application works
1134             on.  You can use this to ensure your application is filtered out
1135             of later versions of the platform when you know you have
1136             incompatibility with them. -->
1137        <attr name="maxSdkVersion" />
1138    </declare-styleable>
1139
1140    <!-- The <code>library</code> tag declares that this apk is providing itself
1141         as a shared library for other applications to use.  It can only be used
1142         with apks that are built in to the system image.  Other apks can link to
1143         it with the {@link #AndroidManifestUsesLibrary uses-library} tag.
1144
1145         <p>This appears as a child tag of the
1146         {@link #AndroidManifestApplication application} tag. -->
1147    <declare-styleable name="AndroidManifestLibrary" parent="AndroidManifest">
1148        <!-- Required public name of the library, which other components and
1149        packages will use when referring to this library.  This is a string using
1150        Java-style scoping to ensure it is unique.  The name should typically
1151        be the same as the apk's package name. -->
1152        <attr name="name" />
1153    </declare-styleable>
1154
1155    <!-- The <code>uses-libraries</code> specifies a shared library that this
1156         package requires to be linked against.  Specifying this flag tells the
1157         system to include this library's code in your class loader.
1158
1159         <p>This appears as a child tag of the
1160         {@link #AndroidManifestApplication application} tag. -->
1161    <declare-styleable name="AndroidManifestUsesLibrary" parent="AndroidManifestApplication">
1162        <!-- Required name of the library you use. -->
1163        <attr name="name" />
1164        <!--  Specify whether this library is required for the application.
1165              The default is true, meaning the application requires the
1166              library, and does not want to be installed on devices that
1167              don't support it.  If you set this to false, then this will
1168              allow the application to be installed even if the library
1169              doesn't exist, and you will need to check for its presence
1170              dynamically at runtime. -->
1171        <attr name="required" />
1172    </declare-styleable>
1173
1174    <!-- The <code>supports-screens</code> specifies the screen dimensions an
1175         application supports.  By default a modern application supports all
1176         screen sizes and must explicitly disable certain screen sizes here;
1177         older applications are assumed to only support the traditional normal
1178         (HVGA) screen size.  Note that screen size is a separate axis from
1179         density, and is determined as the available pixels to an application
1180         after density scaling has been applied.
1181
1182         <p>This appears as a child tag of the
1183         {@link #AndroidManifest manifest} tag. -->
1184    <declare-styleable name="AndroidManifestSupportsScreens" parent="AndroidManifest">
1185        <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2},
1186             this is the new way to specify the minimum screen size an application is
1187             compatible with.  This attribute provides the required minimum
1188             "smallest screen width" (as per the -swNNNdp resource configuration)
1189             that the application can run on.  For example, a typical phone
1190             screen is 320, a 7" tablet 600, and a 10" tablet 720.  If the
1191             smallest screen width of the device is below the value supplied here,
1192             then the application is considered incompatible with that device.
1193             If not supplied, then any old smallScreens, normalScreens, largeScreens,
1194             or xlargeScreens attributes will be used instead. -->
1195        <attr name="requiresSmallestWidthDp" format="integer" />
1196        <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2},
1197             this is the new way to specify the largest screens an application is
1198             compatible with.  This attribute provides the maximum
1199             "smallest screen width" (as per the -swNNNdp resource configuration)
1200             that the application is designed for.  If this value is smaller than
1201             the "smallest screen width" of the device it is running on, the user
1202             is offered to run it in a compatibility mode that emulates a
1203             smaller screen and zooms it to fit the screen. Currently the compatibility mode only
1204             emulates phone screens with a 320dp width, so compatibility mode is not applied if the
1205             value for compatibleWidthLimitDp is larger than 320. -->
1206        <attr name="compatibleWidthLimitDp" format="integer" />
1207        <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2},
1208             this is the new way to specify the screens an application is
1209             compatible with.  This attribute provides the maximum
1210             "smallest screen width" (as per the -swNNNdp resource configuration)
1211             that the application can work well on.  If this value is smaller than
1212             the "smallest screen width" of the device it is running on, the
1213             application will be forced in to screen compatibility mode with
1214             no way for the user to turn it off. Currently the compatibility mode only
1215             emulates phone screens with a 320dp width, so compatibility mode is not applied if the
1216             value for largestWidthLimitDp is larger than 320. -->
1217        <attr name="largestWidthLimitDp" format="integer" />
1218        <!-- Indicates whether the application supports smaller screen form-factors.
1219             A small screen is defined as one with a smaller aspect ratio than
1220             the traditional HVGA screen; that is, for a portrait screen, less
1221             tall than an HVGA screen.  In practice, this means a QVGA low
1222             density or VGA high density screen.  An application that does
1223             not support small screens <em>will not be available</em> for
1224             small screen devices, since there is little the platform can do
1225             to make such an application work on a smaller screen. -->
1226        <attr name="smallScreens" format="boolean" />
1227        <!-- Indicates whether an application supports the normal screen
1228             form-factors.  Traditionally this is an HVGA normal density
1229             screen, but WQVGA low density and WVGA high density are also
1230             considered to be normal.  This attribute is true by default,
1231             and applications currently should leave it that way. -->
1232        <attr name="normalScreens" format="boolean" />
1233        <!-- Indicates whether the application supports larger screen form-factors.
1234             A large screen is defined as a screen that is significantly larger
1235             than a normal phone screen, and thus may require some special care
1236             on the application's part to make good use of it.  An example would
1237             be a VGA <em>normal density</em> screen, though even larger screens
1238             are certainly possible.  An application that does not support
1239             large screens will be placed as a postage stamp on such a
1240             screen, so that it retains the dimensions it was originally
1241             designed for. -->
1242        <attr name="largeScreens" format="boolean" />
1243        <!-- Indicates whether the application supports extra large screen form-factors. -->
1244        <attr name="xlargeScreens" format="boolean" />
1245        <!-- Indicates whether the application can resize itself to newer
1246             screen sizes.  This is mostly used to distinguish between old
1247             applications that may not be compatible with newly introduced
1248             screen sizes and newer applications that should be; it will be
1249             set for you automatically based on whether you are targeting
1250             a newer platform that supports more screens. -->
1251        <attr name="resizeable" format="boolean" />
1252        <!-- Indicates whether the application can accommodate any screen
1253             density.  Older applications are assumed to not be able to,
1254             new ones able to.  You can explicitly supply your abilities
1255             here. -->
1256        <attr name="anyDensity" format="boolean" />
1257    </declare-styleable>
1258
1259    <!-- Private tag to declare system protected broadcast actions.
1260
1261         <p>This appears as a child tag of the root
1262         {@link #AndroidManifest manifest} tag. -->
1263    <declare-styleable name="AndroidManifestProtectedBroadcast" parent="AndroidManifest">
1264        <attr name="name" />
1265    </declare-styleable>
1266
1267    <!-- Private tag to declare the original package name that this package is
1268         based on.  Only used for packages installed in the system image.  If
1269         given, and different than the actual package name, and the given
1270         original package was previously installed on the device but the new
1271         one was not, then the data for the old one will be renamed to be
1272         for the new package.
1273
1274         <p>This appears as a child tag of the root
1275         {@link #AndroidManifest manifest} tag. -->
1276    <declare-styleable name="AndroidManifestOriginalPackage" parent="AndroidManifest">
1277        <attr name="name" />
1278    </declare-styleable>
1279
1280    <!-- The <code>provider</code> tag declares a
1281         {@link android.content.ContentProvider} class that is available
1282         as part of the package's application components, supplying structured
1283         access to data managed by the application.
1284
1285         <p>This appears as a child tag of the
1286         {@link #AndroidManifestApplication application} tag. -->
1287    <declare-styleable name="AndroidManifestProvider" parent="AndroidManifestApplication">
1288        <!-- Required name of the class implementing the provider, deriving from
1289            {@link android.content.ContentProvider}.  This is a fully
1290            qualified class name (for example, com.mycompany.myapp.MyProvider); as a
1291            short-hand if the first character of the class
1292            is a period then it is appended to your package name. -->
1293        <attr name="name" />
1294        <attr name="label" />
1295        <attr name="description" />
1296        <attr name="icon" />
1297        <attr name="logo" />
1298        <attr name="process" />
1299        <attr name="authorities" />
1300        <attr name="syncable" />
1301        <attr name="readPermission" />
1302        <attr name="writePermission" />
1303        <attr name="grantUriPermissions" />
1304        <attr name="permission" />
1305        <attr name="multiprocess" />
1306        <attr name="initOrder" />
1307        <!-- Specify whether this provider is enabled or not (that is, can be instantiated by the system).
1308             It can also be specified for an application as a whole, in which case a value of "false"
1309             will override any component specific values (a value of "true" will not override the
1310             component specific values). -->
1311        <attr name="enabled" />
1312        <attr name="exported" />
1313        <attr name="singleUser" />
1314    </declare-styleable>
1315
1316    <!-- Attributes that can be supplied in an AndroidManifest.xml
1317         <code>grant-uri-permission</code> tag, a child of the
1318         {@link #AndroidManifestProvider provider} tag, describing a specific
1319         URI path that can be granted as a permission.  This tag can be
1320         specified multiple time to supply multiple paths. -->
1321    <declare-styleable name="AndroidManifestGrantUriPermission"  parent="AndroidManifestProvider">
1322        <!-- Specify a URI path that must exactly match, as per
1323             {@link android.os.PatternMatcher} with
1324             {@link android.os.PatternMatcher#PATTERN_LITERAL}. -->
1325        <attr name="path" format="string" />
1326        <!-- Specify a URI path that must be a prefix to match, as per
1327             {@link android.os.PatternMatcher} with
1328             {@link android.os.PatternMatcher#PATTERN_PREFIX}. -->
1329        <attr name="pathPrefix" format="string" />
1330        <!-- Specify a URI path that matches a simple pattern, as per
1331             {@link android.os.PatternMatcher} with
1332             {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}.
1333             Note that because '\' is used as an escape character when
1334             reading the string from XML (before it is parsed as a pattern),
1335             you will need to double-escape: for example a literal "*" would
1336             be written as "\\*" and a literal "\" would be written as
1337             "\\\\".  This is basically the same as what you would need to
1338             write if constructing the string in Java code. -->
1339        <attr name="pathPattern" format="string" />
1340    </declare-styleable>
1341
1342    <!-- Attributes that can be supplied in an AndroidManifest.xml
1343         <code>path-permission</code> tag, a child of the
1344         {@link #AndroidManifestProvider provider} tag, describing a permission
1345         that allows access to a specific path in the provider.  This tag can be
1346         specified multiple time to supply multiple paths. -->
1347    <declare-styleable name="AndroidManifestPathPermission"  parent="AndroidManifestProvider">
1348        <attr name="path" />
1349        <attr name="pathPrefix" />
1350        <attr name="pathPattern" />
1351        <attr name="permission" />
1352        <attr name="readPermission" />
1353        <attr name="writePermission" />
1354    </declare-styleable>
1355
1356    <!-- The <code>service</code> tag declares a
1357         {@link android.app.Service} class that is available
1358         as part of the package's application components, implementing
1359         long-running background operations or a rich communication API
1360         that can be called by other packages.
1361
1362         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
1363         tags can be included inside of a service, to specify the Intents
1364         that can connect with it.  If none are specified, the service can
1365         only be accessed by direct specification of its class name.
1366         The service tag appears as a child tag of the
1367         {@link #AndroidManifestApplication application} tag. -->
1368    <declare-styleable name="AndroidManifestService" parent="AndroidManifestApplication">
1369        <!-- Required name of the class implementing the service, deriving from
1370            {@link android.app.Service}.  This is a fully
1371            qualified class name (for example, com.mycompany.myapp.MyService); as a
1372            short-hand if the first character of the class
1373            is a period then it is appended to your package name. -->
1374        <attr name="name" />
1375        <attr name="label" />
1376        <attr name="description" />
1377        <attr name="icon" />
1378        <attr name="logo" />
1379        <attr name="permission" />
1380        <attr name="process" />
1381        <!-- Specify whether the service is enabled or not (that is, can be instantiated by the system).
1382             It can also be specified for an application as a whole, in which case a value of "false"
1383             will override any component specific values (a value of "true" will not override the
1384             component specific values). -->
1385        <attr name="enabled" />
1386        <attr name="exported" />
1387        <!-- If set to true, this service with be automatically stopped
1388             when the user remove a task rooted in an activity owned by
1389             the application.  The default is false. -->
1390        <attr name="stopWithTask" format="boolean" />
1391        <!-- If set to true, this service will run under a special process
1392             that is isolated from the rest of the system.  The only communication
1393             with it is through the Service API (binding and starting). -->
1394        <attr name="isolatedProcess" format="boolean" />
1395        <attr name="singleUser" />
1396    </declare-styleable>
1397
1398    <!-- The <code>receiver</code> tag declares an
1399         {@link android.content.BroadcastReceiver} class that is available
1400         as part of the package's application components, allowing the
1401         application to receive actions or data broadcast by other
1402         applications even if it is not currently running.
1403
1404         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
1405         tags can be included inside of a receiver, to specify the Intents
1406         it will receive.  If none are specified, the receiver will only
1407         be run when an Intent is broadcast that is directed at its specific
1408         class name.  The receiver tag appears as a child tag of the
1409         {@link #AndroidManifestApplication application} tag. -->
1410    <declare-styleable name="AndroidManifestReceiver" parent="AndroidManifestApplication">
1411        <!-- Required name of the class implementing the receiver, deriving from
1412            {@link android.content.BroadcastReceiver}.  This is a fully
1413            qualified class name (for example, com.mycompany.myapp.MyReceiver); as a
1414            short-hand if the first character of the class
1415            is a period then it is appended to your package name. -->
1416        <attr name="name" />
1417        <attr name="label" />
1418        <attr name="description" />
1419        <attr name="icon" />
1420        <attr name="logo" />
1421        <attr name="permission" />
1422        <attr name="process" />
1423        <!-- Specify whether the receiver is enabled or not (that is, can be instantiated by the system).
1424             It can also be specified for an application as a whole, in which case a value of "false"
1425             will override any component specific values (a value of "true" will not override the
1426             component specific values). -->
1427        <attr name="enabled" />
1428        <attr name="exported" />
1429        <attr name="singleUser" />
1430    </declare-styleable>
1431
1432    <!-- The <code>activity</code> tag declares an
1433         {@link android.app.Activity} class that is available
1434         as part of the package's application components, implementing
1435         a part of the application's user interface.
1436
1437         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
1438         tags can be included inside of an activity, to specify the Intents
1439         that it can handle.  If none are specified, the activity can
1440         only be started through direct specification of its class name.
1441         The activity tag appears as a child tag of the
1442         {@link #AndroidManifestApplication application} tag. -->
1443    <declare-styleable name="AndroidManifestActivity" parent="AndroidManifestApplication">
1444        <!-- Required name of the class implementing the activity, deriving from
1445            {@link android.app.Activity}.  This is a fully
1446            qualified class name (for example, com.mycompany.myapp.MyActivity); as a
1447            short-hand if the first character of the class
1448            is a period then it is appended to your package name. -->
1449        <attr name="name" />
1450        <attr name="theme" />
1451        <attr name="label" />
1452        <attr name="description" />
1453        <attr name="icon" />
1454        <attr name="logo" />
1455        <attr name="launchMode" />
1456        <attr name="screenOrientation" />
1457        <attr name="configChanges" />
1458        <attr name="permission" />
1459        <attr name="multiprocess" />
1460        <attr name="process" />
1461        <attr name="taskAffinity" />
1462        <attr name="allowTaskReparenting" />
1463        <attr name="finishOnTaskLaunch" />
1464        <attr name="finishOnCloseSystemDialogs" />
1465        <attr name="clearTaskOnLaunch" />
1466        <attr name="noHistory" />
1467        <attr name="alwaysRetainTaskState" />
1468        <attr name="stateNotNeeded" />
1469        <attr name="excludeFromRecents" />
1470        <attr name="showOnLockScreen" />
1471        <!-- Specify whether the activity is enabled or not (that is, can be instantiated by the system).
1472             It can also be specified for an application as a whole, in which case a value of "false"
1473             will override any component specific values (a value of "true" will not override the
1474             component specific values). -->
1475        <attr name="enabled" />
1476        <attr name="exported" />
1477        <!-- Specify the default soft-input mode for the main window of
1478             this activity.  A value besides "unspecified" here overrides
1479             any value in the theme. -->
1480        <attr name="windowSoftInputMode" />
1481        <attr name="immersive" />
1482        <attr name="hardwareAccelerated" />
1483        <attr name="uiOptions" />
1484        <attr name="parentActivityName" />
1485        <attr name="singleUser" />
1486        <!-- @hide This broacast receiver will only receive broadcasts for the
1487             primary user.  Can only be used with receivers. -->
1488        <attr name="primaryUserOnly" format="boolean" />
1489    </declare-styleable>
1490
1491    <!-- The <code>activity-alias</code> tag declares a new
1492         name for an existing {@link #AndroidManifestActivity activity}
1493         tag.
1494
1495         <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter}
1496         tags can be included inside of an activity-alias, to specify the Intents
1497         that it can handle.  If none are specified, the activity can
1498         only be started through direct specification of its class name.
1499         The activity-alias tag appears as a child tag of the
1500         {@link #AndroidManifestApplication application} tag. -->
1501    <declare-styleable name="AndroidManifestActivityAlias" parent="AndroidManifestApplication">
1502        <!-- Required name of the class implementing the activity, deriving from
1503            {@link android.app.Activity}.  This is a fully
1504            qualified class name (for example, com.mycompany.myapp.MyActivity); as a
1505            short-hand if the first character of the class
1506            is a period then it is appended to your package name. -->
1507        <attr name="name" />
1508        <!-- The name of the activity this alias should launch.  The activity
1509             must be in the same manifest as the alias, and have been defined
1510             in that manifest before the alias here.  This must use a Java-style
1511             naming convention to ensure the name is unique, for example
1512             "com.mycompany.MyName". -->
1513        <attr name="targetActivity" format="string" />
1514        <attr name="label" />
1515        <attr name="description" />
1516        <attr name="icon" />
1517        <attr name="logo" />
1518        <attr name="permission" />
1519        <!-- Specify whether the activity-alias is enabled or not (that is, can be instantiated by the system).
1520             It can also be specified for an application as a whole, in which case a value of "false"
1521             will override any component specific values (a value of "true" will not override the
1522             component specific values). -->
1523        <attr name="enabled" />
1524        <attr name="exported" />
1525        <attr name="parentActivityName" />
1526    </declare-styleable>
1527
1528    <!-- The <code>meta-data</code> tag is used to attach additional
1529         arbitrary data to an application component.  The data can later
1530         be retrieved programmatically from the
1531         {@link android.content.pm.ComponentInfo#metaData
1532         ComponentInfo.metaData} field.  There is no meaning given to this
1533         data by the system.  You may supply the data through either the
1534         <code>value</code> or <code>resource</code> attribute; if both
1535         are given, then <code>resource</code> will be used.
1536
1537         <p>It is highly recommended that you avoid supplying related data as
1538         multiple separate meta-data entries.  Instead, if you have complex
1539         data to associate with a component, then use the <code>resource</code>
1540         attribute to assign an XML resource that the client can parse to
1541         retrieve the complete data. -->
1542    <declare-styleable name="AndroidManifestMetaData"
1543         parent="AndroidManifestApplication
1544                 AndroidManifestActivity
1545                 AndroidManifestReceiver
1546                 AndroidManifestProvider
1547                 AndroidManifestService
1548                 AndroidManifestPermission
1549                 AndroidManifestPermissionGroup
1550                 AndroidManifestInstrumentation">
1551        <attr name="name" />
1552        <!-- Concrete value to assign to this piece of named meta-data.
1553             The data can later be retrieved from the meta data Bundle
1554             through {@link android.os.Bundle#getString Bundle.getString},
1555             {@link android.os.Bundle#getInt Bundle.getInt},
1556             {@link android.os.Bundle#getBoolean Bundle.getBoolean},
1557             or {@link android.os.Bundle#getFloat Bundle.getFloat} depending
1558             on the type used here. -->
1559        <attr name="value" format="string|integer|color|float|boolean" />
1560        <!-- Resource identifier to assign to this piece of named meta-data.
1561             The resource identifier can later be retrieved from the meta data
1562             Bundle through {@link android.os.Bundle#getInt Bundle.getInt}. -->
1563        <attr name="resource" format="reference" />
1564    </declare-styleable>
1565
1566    <!-- The <code>intent-filter</code> tag is used to construct an
1567         {@link android.content.IntentFilter} object that will be used
1568         to determine which component can handle a particular
1569         {@link android.content.Intent} that has been given to the system.
1570         It can be used as a child of the
1571         {@link #AndroidManifestActivity activity},
1572         {@link #AndroidManifestReceiver receiver} and
1573         {@link #AndroidManifestService service}
1574         tags.
1575
1576         <p> Zero or more {@link #AndroidManifestAction action},
1577         {@link #AndroidManifestCategory category}, and/or
1578         {@link #AndroidManifestData data} tags should be
1579         included inside to describe the contents of the filter.
1580
1581         <p> The optional label and icon attributes here are used with
1582         an activity to supply an alternative description of that activity
1583         when it is being started through an Intent matching this filter. -->
1584    <declare-styleable name="AndroidManifestIntentFilter"
1585         parent="AndroidManifestActivity AndroidManifestReceiver AndroidManifestService">
1586        <attr name="label" />
1587        <attr name="icon" />
1588        <attr name="logo" />
1589        <attr name="priority" />
1590    </declare-styleable>
1591
1592    <!-- Attributes that can be supplied in an AndroidManifest.xml
1593         <code>action</code> tag, a child of the
1594         {@link #AndroidManifestIntentFilter intent-filter} tag.
1595         See {@link android.content.IntentFilter#addAction} for
1596         more information. -->
1597    <declare-styleable name="AndroidManifestAction" parent="AndroidManifestIntentFilter">
1598        <!-- The name of an action that is handled, using the Java-style
1599             naming convention.  For example, to support
1600             {@link android.content.Intent#ACTION_VIEW Intent.ACTION_VIEW}
1601             you would put <code>android.intent.action.VIEW</code> here.
1602             Custom actions should generally use a prefix matching the
1603             package name. -->
1604        <attr name="name" />
1605    </declare-styleable>
1606
1607    <!-- Attributes that can be supplied in an AndroidManifest.xml
1608         <code>data</code> tag, a child of the
1609         {@link #AndroidManifestIntentFilter intent-filter} tag, describing
1610         the types of data that match.  This tag can be specified multiple
1611         times to supply multiple data options, as described in the
1612         {@link android.content.IntentFilter} class.  Note that all such
1613         tags are adding options to the same IntentFilter so that, for example,
1614         <code>&lt;data android:scheme="myscheme" android:host="me.com" /&gt;</code>
1615         is equivalent to <code>&lt;data android:scheme="myscheme" /&gt;
1616         &lt;data android:host="me.com" /&gt;</code>. -->
1617    <declare-styleable name="AndroidManifestData" parent="AndroidManifestIntentFilter">
1618        <!-- Specify a MIME type that is handled, as per
1619             {@link android.content.IntentFilter#addDataType
1620             IntentFilter.addDataType()}.
1621             <p><em>Note: MIME type matching in the Android framework is
1622             case-sensitive, unlike formal RFC MIME types.  As a result,
1623             MIME types here should always use lower case letters.</em></p> -->
1624        <attr name="mimeType" format="string" />
1625        <!-- Specify a URI scheme that is handled, as per
1626             {@link android.content.IntentFilter#addDataScheme
1627             IntentFilter.addDataScheme()}.
1628             <p><em>Note: scheme matching in the Android framework is
1629             case-sensitive, unlike the formal RFC.  As a result,
1630             schemes here should always use lower case letters.</em></p> -->
1631        <attr name="scheme" format="string" />
1632        <!-- Specify a URI scheme specific part that must exactly match, as per
1633             {@link android.content.IntentFilter#addDataSchemeSpecificPart
1634             IntentFilter.addDataSchemeSpecificPart()} with
1635             {@link android.os.PatternMatcher#PATTERN_LITERAL}. -->
1636        <attr name="ssp" format="string" />
1637        <!-- Specify a URI scheme specific part that must be a prefix to match, as per
1638             {@link android.content.IntentFilter#addDataSchemeSpecificPart
1639             IntentFilter.addDataSchemeSpecificPart()} with
1640             {@link android.os.PatternMatcher#PATTERN_PREFIX}. -->
1641        <attr name="sspPrefix" format="string" />
1642        <!-- Specify a URI scheme specific part that matches a simple pattern, as per
1643             {@link android.content.IntentFilter#addDataSchemeSpecificPart
1644             IntentFilter.addDataSchemeSpecificPart()} with
1645             {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}.
1646             Note that because '\' is used as an escape character when
1647             reading the string from XML (before it is parsed as a pattern),
1648             you will need to double-escape: for example a literal "*" would
1649             be written as "\\*" and a literal "\" would be written as
1650             "\\\\".  This is basically the same as what you would need to
1651             write if constructing the string in Java code. -->
1652        <attr name="sspPattern" format="string" />
1653        <!-- Specify a URI authority host that is handled, as per
1654             {@link android.content.IntentFilter#addDataAuthority
1655             IntentFilter.addDataAuthority()}.
1656             <p><em>Note: host name matching in the Android framework is
1657             case-sensitive, unlike the formal RFC.  As a result,
1658             host names here should always use lower case letters.</em></p> -->
1659        <attr name="host" format="string" />
1660        <!-- Specify a URI authority port that is handled, as per
1661             {@link android.content.IntentFilter#addDataAuthority
1662             IntentFilter.addDataAuthority()}.  If a host is supplied
1663             but not a port, any port is matched. -->
1664        <attr name="port" format="string" />
1665        <!-- Specify a URI path that must exactly match, as per
1666             {@link android.content.IntentFilter#addDataPath
1667             IntentFilter.addDataPath()} with
1668             {@link android.os.PatternMatcher#PATTERN_LITERAL}. -->
1669        <attr name="path" />
1670        <!-- Specify a URI path that must be a prefix to match, as per
1671             {@link android.content.IntentFilter#addDataPath
1672             IntentFilter.addDataPath()} with
1673             {@link android.os.PatternMatcher#PATTERN_PREFIX}. -->
1674        <attr name="pathPrefix" />
1675        <!-- Specify a URI path that matches a simple pattern, as per
1676             {@link android.content.IntentFilter#addDataPath
1677             IntentFilter.addDataPath()} with
1678             {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}.
1679             Note that because '\' is used as an escape character when
1680             reading the string from XML (before it is parsed as a pattern),
1681             you will need to double-escape: for example a literal "*" would
1682             be written as "\\*" and a literal "\" would be written as
1683             "\\\\".  This is basically the same as what you would need to
1684             write if constructing the string in Java code. -->
1685        <attr name="pathPattern" />
1686    </declare-styleable>
1687
1688    <!-- Attributes that can be supplied in an AndroidManifest.xml
1689         <code>category</code> tag, a child of the
1690         {@link #AndroidManifestIntentFilter intent-filter} tag.
1691         See {@link android.content.IntentFilter#addCategory} for
1692         more information. -->
1693    <declare-styleable name="AndroidManifestCategory" parent="AndroidManifestIntentFilter">
1694        <!-- The name of category that is handled, using the Java-style
1695             naming convention.  For example, to support
1696             {@link android.content.Intent#CATEGORY_LAUNCHER Intent.CATEGORY_LAUNCHER}
1697             you would put <code>android.intent.category.LAUNCHER</code> here.
1698             Custom actions should generally use a prefix matching the
1699             package name. -->
1700        <attr name="name" />
1701    </declare-styleable>
1702
1703    <!-- Attributes that can be supplied in an AndroidManifest.xml
1704         <code>instrumentation</code> tag, a child of the root
1705         {@link #AndroidManifest manifest} tag. -->
1706    <declare-styleable name="AndroidManifestInstrumentation" parent="AndroidManifest">
1707        <!-- Required name of the class implementing the instrumentation, deriving from
1708            {@link android.app.Instrumentation}.  This is a fully
1709            qualified class name (for example, com.mycompany.myapp.MyActivity); as a
1710            short-hand if the first character of the class
1711            is a period then it is appended to your package name. -->
1712        <attr name="name" />
1713        <attr name="targetPackage" />
1714        <attr name="label" />
1715        <attr name="icon" />
1716        <attr name="logo" />
1717        <attr name="handleProfiling" />
1718        <attr name="functionalTest" />
1719    </declare-styleable>
1720
1721    <!-- Attributes that can be supplied in an AndroidManifest.xml
1722         <code>screen</code> tag, a child of <code>compatible-screens</code>,
1723         which is itself a child of the root
1724         {@link #AndroidManifest manifest} tag. -->
1725    <declare-styleable name="AndroidManifestCompatibleScreensScreen"
1726                       parent="AndroidManifest.AndroidManifestCompatibleScreens">
1727        <!-- Specifies a compatible screen size, as per the device
1728             configuration screen size bins. -->
1729        <attr name="screenSize">
1730            <!-- A small screen configuration, at least 240x320dp. -->
1731            <enum name="small" value="200" />
1732            <!-- A normal screen configuration, at least 320x480dp. -->
1733            <enum name="normal" value="300" />
1734            <!-- A large screen configuration, at least 400x530dp. -->
1735            <enum name="large" value="400" />
1736            <!-- An extra large screen configuration, at least 600x800dp. -->
1737            <enum name="xlarge" value="500" />
1738        </attr>
1739        <!-- Specifies a compatible screen density, as per the device
1740             configuration screen density bins. -->
1741        <attr name="screenDensity" format="integer">
1742            <!-- A low density screen, approximately 120dpi. -->
1743            <enum name="ldpi" value="120" />
1744            <!-- A medium density screen, approximately 160dpi. -->
1745            <enum name="mdpi" value="160" />
1746            <!-- A high density screen, approximately 240dpi. -->
1747            <enum name="hdpi" value="240" />
1748            <!-- An extra high density screen, approximately 320dpi. -->
1749            <enum name="xhdpi" value="320" />
1750        </attr>
1751    </declare-styleable>
1752
1753    <!-- The <code>input-type</code> tag is a child of the <code>supports-input</code> tag, which
1754         is itself a child of the root {@link #AndroidManifest manifest} tag. Each
1755         <code>input-type</code> tag specifices the name of a specific input device type. When
1756         grouped with the other elements of the parent <code>supports-input</code> tag it defines
1757         a collection of input devices, which when all used together, are considered a supported
1758         input mechanism for the application. There may be multiple <code>supports-input</code>
1759         tags defined, each containing a different combination of input device types. -->
1760    <declare-styleable name="AndroidManifestSupportsInputInputType"
1761                       parent="AndroidManifest.AndroidManifestSupportsInput">
1762        <!-- Specifices the name of the input device type -->
1763        <attr name="name" />
1764    </declare-styleable>
1765
1766    <!-- The attribute that holds a Base64-encoded public key. -->
1767    <attr name="publicKey" format="string" />
1768
1769    <!-- Attributes relating to a package verifier. -->
1770    <declare-styleable name="AndroidManifestPackageVerifier" parent="AndroidManifest">
1771        <!-- Specifies the Java-style package name that defines this
1772             package verifier. -->
1773        <attr name="name" />
1774
1775        <!-- The Base64 encoded public key of the package verifier's
1776             signature. -->
1777        <attr name="publicKey" />
1778    </declare-styleable>
1779
1780    <!-- Declaration of an {@link android.content.Intent} object in XML.  May
1781         also include zero or more {@link #IntentCategory <category> and
1782         {@link #Extra <extra>} tags. -->
1783    <declare-styleable name="Intent">
1784        <!-- The action name to assign to the Intent, as per
1785            {@link android.content.Intent#setAction Intent.setAction()}. -->
1786        <attr name="action" format="string" />
1787        <!-- The data URI to assign to the Intent, as per
1788            {@link android.content.Intent#setData Intent.setData()}.
1789            <p><em>Note: scheme and host name matching in the Android framework is
1790            case-sensitive, unlike the formal RFC.  As a result,
1791            URIs here should always be normalized to use lower case letters
1792            for these elements (as well as other proper Uri normalization).</em></p> -->
1793        <attr name="data" format="string" />
1794        <!-- The MIME type name to assign to the Intent, as per
1795            {@link android.content.Intent#setType Intent.setType()}.
1796            <p><em>Note: MIME type matching in the Android framework is
1797            case-sensitive, unlike formal RFC MIME types.  As a result,
1798            MIME types here should always use lower case letters.</em></p> -->
1799        <attr name="mimeType" />
1800        <!-- The package part of the ComponentName to assign to the Intent, as per
1801            {@link android.content.Intent#setComponent Intent.setComponent()}. -->
1802        <attr name="targetPackage" />
1803        <!-- The class part of the ComponentName to assign to the Intent, as per
1804            {@link android.content.Intent#setComponent Intent.setComponent()}. -->
1805        <attr name="targetClass" format="string" />
1806    </declare-styleable>
1807
1808    <!-- A category to add to an Intent, as per
1809            {@link android.content.Intent#addCategory Intent.addCategory()}. -->
1810    <declare-styleable name="IntentCategory" parent="Intent">
1811        <!-- Required name of the category. -->
1812        <attr name="name" />
1813    </declare-styleable>
1814
1815    <!-- An extra data value to place into a an extra/name value pair held
1816            in a Bundle, as per {@link android.os.Bundle}. -->
1817    <declare-styleable name="Extra" parent="Intent">
1818        <!-- Required name of the extra data. -->
1819        <attr name="name" />
1820        <!-- Concrete value to put for this named extra data. -->
1821        <attr name="value" />
1822    </declare-styleable>
1823
1824    <!-- Groups signing keys into a {@code KeySet} for easier reference in
1825            other APIs. However, currently no APIs use this. -->
1826    <attr name="keySet" />
1827    <declare-styleable name="PublicKey">
1828        <attr name="value" />
1829    </declare-styleable>
1830    <declare-styleable name="KeySet">
1831        <attr name="name" />
1832    </declare-styleable>
1833</resources>
1834