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 <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 <activity>} or 818 {@code <application>} tag. If specified on the {@code <application>} 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 <permission>} 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 <permission>} 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 <permission>} 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 <permission>} 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><data android:scheme="myscheme" android:host="me.com" /></code> 1615 is equivalent to <code><data android:scheme="myscheme" /> 1616 <data android:host="me.com" /></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