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 banner for its 66 associated item. Use with the application tag (to supply a default 67 banner for all application activities), or with the activity, tag to 68 supply a banner for a specific activity. 69 70 <p>The given banner will be used to display to the user a graphical 71 representation of an activity in the Leanback application launcher. 72 Since banners are displayed only in the Leanback launcher, they should 73 only be used with activities (and applications) that support Leanback 74 mode. These are activities that handle Intents of category 75 {@link android.content.Intent#CATEGORY_LEANBACK_LAUNCHER 76 Intent.CATEGORY_LEANBACK_LAUNCHER}. 77 <p>This must be a reference to a Drawable resource containing the image definition. --> 78 <attr name="banner" format="reference" /> 79 80 <!-- A Drawable resource providing an extended graphical logo for its 81 associated item. Use with the application tag (to supply a default 82 logo for all application components), or with the activity, receiver, 83 service, or instrumentation tag (to supply a specific logo for that 84 component). It may also be used with the intent-filter tag to supply 85 a logo to show to the user when an activity is being selected based 86 on a particular Intent. 87 88 <p>The given logo will be used to display to the user a graphical 89 representation of its associated component; for example as the 90 header in the Action Bar. The primary differences between an icon 91 and a logo are that logos are often wider and more detailed, and are 92 used without an accompanying text caption. This must be a reference 93 to a Drawable resource containing the image definition. --> 94 <attr name="logo" format="reference" /> 95 96 <!-- Name of the activity to be launched to manage application's space on 97 device. The specified activity gets automatically launched when the 98 application's space needs to be managed and is usually invoked 99 through user actions. Applications can thus provide their own custom 100 behavior for managing space for various scenarios like out of memory 101 conditions. This is an optional attribute and 102 applications can choose not to specify a default activity to 103 manage space. --> 104 <attr name="manageSpaceActivity" format="string" /> 105 106 <!-- Option to let applications specify that user data can/cannot be 107 cleared. This flag is turned on by default. 108 <em>This attribute is usable only by applications 109 included in the system image. Third-party apps cannot use it.</em> --> 110 <attr name="allowClearUserData" format="boolean" /> 111 112 <!-- Option to indicate this application is only for testing purposes. 113 For example, it may expose functionality or data outside of itself 114 that would cause a security hole, but is useful for testing. This 115 kind of application can not be installed without the 116 INSTALL_ALLOW_TEST flag, which means only through adb install. --> 117 <attr name="testOnly" format="boolean" /> 118 119 <!-- A unique name for the given item. This must use a Java-style naming 120 convention to ensure the name is unique, for example 121 "com.mycompany.MyName". --> 122 <attr name="name" format="string" /> 123 124 <!-- Specify a permission that a client is required to have in order to 125 use the associated object. If the client does not hold the named 126 permission, its request will fail. See the 127 <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a> 128 document for more information on permissions. --> 129 <attr name="permission" format="string" /> 130 131 <!-- A specific {@link android.R.attr#permission} name for read-only 132 access to a {@link android.content.ContentProvider}. See the 133 <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a> 134 document for more information on permissions. --> 135 <attr name="readPermission" format="string" /> 136 137 <!-- A specific {@link android.R.attr#permission} name for write 138 access to a {@link android.content.ContentProvider}. See the 139 <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a> 140 document for more information on permissions. --> 141 <attr name="writePermission" format="string" /> 142 143 <!-- If true, the {@link android.content.Context#grantUriPermission 144 Context.grantUriPermission} or corresponding Intent flags can 145 be used to allow others to access specific URIs in the content 146 provider, even if they do not have an explicit read or write 147 permission. If you are supporting this feature, you must be 148 sure to call {@link android.content.Context#revokeUriPermission 149 Context.revokeUriPermission} when URIs are deleted from your 150 provider.--> 151 <attr name="grantUriPermissions" format="boolean" /> 152 153 <!-- Characterizes the potential risk implied in a permission and 154 indicates the procedure the system should follow when determining 155 whether to grant the permission to an application requesting it. {@link 156 android.Manifest.permission Standard permissions} have a predefined and 157 permanent protectionLevel. If you are creating a custom permission in an 158 application, you can define a protectionLevel attribute with one of the 159 values listed below. If no protectionLevel is defined for a custom 160 permission, the system assigns the default ("normal"). --> 161 <attr name="protectionLevel"> 162 <!-- A lower-risk permission that gives an application access to isolated 163 application-level features, with minimal risk to other applications, 164 the system, or the user. The system automatically grants this type 165 of permission to a requesting application at installation, without 166 asking for the user's explicit approval (though the user always 167 has the option to review these permissions before installing). --> 168 <flag name="normal" value="0" /> 169 <!-- A higher-risk permission that would give a requesting application 170 access to private user data or control over the device that can 171 negatively impact the user. Because this type of permission 172 introduces potential risk, the system may not automatically 173 grant it to the requesting application. For example, any dangerous 174 permissions requested by an application may be displayed to the 175 user and require confirmation before proceeding, or some other 176 approach may be taken to avoid the user automatically allowing 177 the use of such facilities. --> 178 <flag name="dangerous" value="1" /> 179 <!-- A permission that the system is to grant only if the requesting 180 application is signed with the same certificate as the application 181 that declared the permission. If the certificates match, the system 182 automatically grants the permission without notifying the user or 183 asking for the user's explicit approval. --> 184 <flag name="signature" value="2" /> 185 <!-- A permission that the system is to grant only to packages in the 186 Android system image <em>or</em> that are signed with the same 187 certificates. Please avoid using this option, as the 188 signature protection level should be sufficient for most needs and 189 works regardless of exactly where applications are installed. This 190 permission is used for certain special situations where multiple 191 vendors have applications built in to a system image which need 192 to share specific features explicitly because they are being built 193 together. --> 194 <flag name="signatureOrSystem" value="3" /> 195 <!-- Additional flag from base permission type: this permission can also 196 be granted to any applications installed as privileged apps on the system image. 197 Please avoid using this option, as the 198 signature protection level should be sufficient for most needs and 199 works regardless of exactly where applications are installed. This 200 permission flag is used for certain special situations where multiple 201 vendors have applications built in to a system image which need 202 to share specific features explicitly because they are being built 203 together. --> 204 <flag name="privileged" value="0x10" /> 205 <!-- Old synonym for "privileged". --> 206 <flag name="system" value="0x10" /> 207 <!-- Additional flag from base permission type: this permission can also 208 (optionally) be granted to development applications. --> 209 <flag name="development" value="0x20" /> 210 <!-- Additional flag from base permission type: this permission is closely 211 associated with an app op for controlling access. --> 212 <flag name="appop" value="0x40" /> 213 <!-- Additional flag from base permission type: this permission can be automatically 214 granted to apps that target API levels below 215 {@link android.os.Build.VERSION_CODES#M} (before runtime permissions 216 were introduced). --> 217 <flag name="pre23" value="0x80" /> 218 <!-- Additional flag from base permission type: this permission can be automatically 219 granted to system apps that install packages. --> 220 <flag name="installer" value="0x100" /> 221 <!-- Additional flag from base permission type: this permission can be automatically 222 granted to system apps that verify packages. --> 223 <flag name="verifier" value="0x200" /> 224 <!-- Additional flag from base permission type: this permission can be automatically 225 granted any application pre-installed on the system image (not just privileged 226 apps). --> 227 <flag name="preinstalled" value="0x400" /> 228 <!-- Additional flag from base permission type: this permission can be automatically 229 granted to the setup wizard app --> 230 <flag name="setup" value="0x800" /> 231 </attr> 232 233 <!-- Flags indicating more context for a permission group. --> 234 <attr name="permissionGroupFlags"> 235 <!-- Set to indicate that this permission group contains permissions 236 protecting access to some information that is considered 237 personal to the user (such as contacts, e-mails, etc). --> 238 <flag name="personalInfo" value="0x0001" /> 239 </attr> 240 241 <!-- Flags indicating more context for a permission. --> 242 <attr name="permissionFlags"> 243 <!-- Set to indicate that this permission allows an operation that 244 may cost the user money. Such permissions may be highlighted 245 when shown to the user with this additional information. --> 246 <flag name="costsMoney" value="0x0001" /> 247 <!-- Additional flag from base permission type: this permission has been 248 removed and it is no longer enforced. It shouldn't be shown in the 249 UI. Removed permissions are kept as normal permissions for backwards 250 compatibility as apps may be checking them before calling an API. 251 --> 252 <flag name="removed" value="0x2" /> 253 </attr> 254 255 <!-- Specified the name of a group that this permission is associated 256 with. The group must have been defined with the 257 {@link android.R.styleable#AndroidManifestPermissionGroup permission-group} tag. --> 258 <attr name="permissionGroup" format="string" /> 259 260 <!-- Specify the name of a user ID that will be shared between multiple 261 packages. By default, each package gets its own unique user-id. 262 By setting this value on two or more packages, each of these packages 263 will be given a single shared user ID, so they can for example run 264 in the same process. Note that for them to actually get the same 265 user ID, they must also be signed with the same signature. --> 266 <attr name="sharedUserId" format="string" /> 267 268 <!-- Specify a label for the shared user UID of this package. This is 269 only used if you have also used android:sharedUserId. This must 270 be a reference to a string resource; it can not be an explicit 271 string. --> 272 <attr name="sharedUserLabel" format="reference" /> 273 274 <!-- Internal version code. This is the number used to determine whether 275 one version is more recent than another: it has no other meaning than 276 that higher numbers are more recent. You could use this number to 277 encode a "x.y" in the lower and upper 16 bits, make it a build 278 number, simply increase it by one each time a new version is 279 released, or define it however else you want, as long as each 280 successive version has a higher number. This is not a version 281 number generally shown to the user, that is usually supplied 282 with {@link android.R.attr#versionName}. When an app is delivered 283 as multiple split APKs, each APK must have the exact same versionCode. --> 284 <attr name="versionCode" format="integer" /> 285 286 <!-- Internal revision code. This number is the number used to determine 287 whether one APK is more recent than another: it has no other meaning 288 than that higher numbers are more recent. This value is only meaningful 289 when the two {@link android.R.attr#versionCode} values are already 290 identical. When an app is delivered as multiple split APKs, each 291 APK may have a different revisionCode value. --> 292 <attr name="revisionCode" format="integer" /> 293 294 <!-- The text shown to the user to indicate the version they have. This 295 is used for no other purpose than display to the user; the actual 296 significant version number is given by {@link android.R.attr#versionCode}. --> 297 <attr name="versionName" format="string" /> 298 299 <!-- Flag to control special persistent mode of an application. This should 300 not normally be used by applications; it requires that the system keep 301 your application running at all times. --> 302 <attr name="persistent" format="boolean" /> 303 304 <!-- Flag to specify if this application needs to be present for all users. Only pre-installed 305 applications can request this feature. Default value is false. --> 306 <attr name="requiredForAllUsers" format="boolean" /> 307 308 <!-- Flag indicating whether the application can be debugged, even when 309 running on a device that is running in user mode. --> 310 <attr name="debuggable" format="boolean" /> 311 312 <!-- Flag indicating whether the application requests the VM to operate in 313 the safe mode. --> 314 <attr name="vmSafeMode" format="boolean" /> 315 316 <!-- <p>Flag indicating whether the application's rendering should be hardware 317 accelerated if possible. This flag is turned on by default for applications 318 that are targeting {@link android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH} 319 or later.</p> 320 <p>This flag can be set on the application and any activity declared 321 in the manifest. When enabled for the application, each activity is 322 automatically assumed to be hardware accelerated. This flag can be 323 overridden in the activity tags, either turning it off (if on for the 324 application) or on (if off for the application.)</p> 325 <p>When this flag is turned on for an activity (either directly or via 326 the application tag), every window created from the activity, including 327 the activity's own window, will be hardware accelerated, if possible.</p> 328 <p>Please refer to the documentation of 329 {@link android.view.WindowManager.LayoutParams#FLAG_HARDWARE_ACCELERATED} 330 for more information on how to control this flag programmatically.</p> --> 331 <attr name="hardwareAccelerated" format="boolean" /> 332 333 <!-- Flag indicating whether the given application component is available 334 to other applications. If false, it can only be accessed by 335 applications with its same user id (which usually means only by 336 code in its own package). If true, it can be invoked by external 337 entities, though which ones can do so may be controlled through 338 permissions. The default value is false for activity, receiver, 339 and service components that do not specify any intent filters; it 340 is true for activity, receiver, and service components that do 341 have intent filters (implying they expect to be invoked by others 342 who do not know their particular component name) and for all 343 content providers. --> 344 <attr name="exported" format="boolean" /> 345 346 <!-- A boolean flag used to indicate if an application is a Game or not. 347 <p>This information can be used by the system to group together 348 applications that are classified as games, and display them separately 349 from the other applications. --> 350 <attr name="isGame" format="boolean" /> 351 352 <!-- If set to true, a single instance of this component will run for 353 all users. That instance will run as user 0, the default/primary 354 user. When the app running is in processes for other users and interacts 355 with this component (by binding to a service for example) those processes will 356 always interact with the instance running for user 0. Enabling 357 single user mode forces "exported" of the component to be false, to 358 help avoid introducing multi-user security bugs. This feature is only 359 available to applications built in to the system image; you must hold the 360 permission INTERACT_ACROSS_USERS in order 361 to use this feature. This flag can only be used with services, 362 receivers, and providers; it can not be used with activities. --> 363 <attr name="singleUser" format="boolean" /> 364 365 <!-- Specify a specific process that the associated code is to run in. 366 Use with the application tag (to supply a default process for all 367 application components), or with the activity, receiver, service, 368 or provider tag (to supply a specific icon for that component). 369 370 <p>Application components are normally run in a single process that 371 is created for the entire application. You can use this tag to modify 372 where they run. If the process name begins with a ':' character, 373 a new process private to that application will be created when needed 374 to run that component (allowing you to spread your application across 375 multiple processes). If the process name begins with a lower-case 376 character, the component will be run in a global process of that name, 377 provided that you have permission to do so, allowing multiple 378 applications to share one process to reduce resource usage. --> 379 <attr name="process" format="string" /> 380 381 <!-- Specify a task name that activities have an "affinity" to. 382 Use with the application tag (to supply a default affinity for all 383 activities in the application), or with the activity tag (to supply 384 a specific affinity for that component). 385 386 <p>The default value for this attribute is the same as the package 387 name, indicating that all activities in the manifest should generally 388 be considered a single "application" to the user. You can use this 389 attribute to modify that behavior: either giving them an affinity 390 for another task, if the activities are intended to be part of that 391 task from the user's perspective, or using an empty string for 392 activities that have no affinity to a task. --> 393 <attr name="taskAffinity" format="string" /> 394 395 <!-- Specify that an activity can be moved out of a task it is in to 396 the task it has an affinity for when appropriate. Use with the 397 application tag (to supply a default for all activities in the 398 application), or with an activity tag (to supply a specific 399 setting for that component). 400 401 <p>Normally when an application is started, it is associated with 402 the task of the activity that started it and stays there for its 403 entire lifetime. You can use the allowTaskReparenting feature to force an 404 activity to be re-parented to a different task when the task it is 405 in goes to the background. Typically this is used to cause the 406 activities of an application to move back to the main task associated 407 with that application. The activity is re-parented to the task 408 with the same {@link android.R.attr#taskAffinity} as it has. --> 409 <attr name="allowTaskReparenting" format="boolean" /> 410 411 <!-- Declare that this application may use cleartext traffic, such as HTTP rather than HTTPS; 412 WebSockets rather than WebSockets Secure; XMPP, IMAP, STMP without STARTTLS or TLS. 413 Defaults to true. If set to false {@code false}, the application declares that it does not 414 intend to use cleartext network traffic, in which case platform components (e.g. HTTP 415 stacks, {@code DownloadManager}, {@code MediaPlayer}) will refuse applications's requests 416 to use cleartext traffic. Third-party libraries are encouraged to honor this flag as well. 417 --> 418 <attr name="usesCleartextTraffic" format="boolean" /> 419 420 <!-- Declare that code from this application will need to be loaded into other 421 applications' processes. On devices that support multiple instruction sets, 422 this implies the code might be loaded into a process that's using any of the devices 423 supported instruction sets. 424 425 <p> The system might treat such applications specially, for eg., by 426 extracting the application's native libraries for all supported instruction 427 sets or by compiling the application's dex code for all supported instruction 428 sets. --> 429 <attr name="multiArch" format ="boolean" /> 430 431 <!-- Specify whether the 32 bit version of the ABI should be used in a 432 multiArch application. If both abioverride flag (i.e. using abi option of abd install) 433 and use32bitAbi are used, then use32bit is ignored.--> 434 <attr name="use32bitAbi" /> 435 436 <!-- Specify whether a component is allowed to have multiple instances 437 of itself running in different processes. Use with the activity 438 and provider tags. 439 440 <p>Normally the system will ensure that all instances of a particular 441 component are only running in a single process. You can use this 442 attribute to disable that behavior, allowing the system to create 443 instances wherever they are used (provided permissions allow it). 444 This is most often used with content providers, so that instances 445 of a provider can be created in each client process, allowing them 446 to be used without performing IPC. --> 447 <attr name="multiprocess" format="boolean" /> 448 449 <!-- Specify whether an activity should be finished when its task is 450 brought to the foreground by relaunching from the home screen. 451 452 <p>If both this option and {@link android.R.attr#allowTaskReparenting} are 453 specified, the finish trumps the affinity: the affinity will be 454 ignored and the activity simply finished. --> 455 <attr name="finishOnTaskLaunch" format="boolean" /> 456 457 <!-- Specify whether an activity should be finished when a "close system 458 windows" request has been made. This happens, for example, when 459 the home key is pressed, when the device is locked, when a system 460 dialog showing recent applications is displayed, etc. --> 461 <attr name="finishOnCloseSystemDialogs" format="boolean" /> 462 463 <!-- Specify whether an activity's task should be cleared when it 464 is re-launched from the home screen. As a result, every time the 465 user starts the task, they will be brought to its root activity, 466 regardless of whether they used BACK or HOME to last leave it. 467 This flag only applies to activities that 468 are used to start the root of a new task. 469 470 <p>An example of the use of this flag would be for the case where 471 a user launches activity A from home, and from there goes to 472 activity B. They now press home, and then return to activity A. 473 Normally they would see activity B, since that is what they were 474 last doing in A's task. However, if A has set this flag to true, 475 then upon going to the background all of the tasks on top of it (B 476 in this case) are removed, so when the user next returns to A they 477 will restart at its original activity. 478 479 <p>When this option is used in conjunction with 480 {@link android.R.attr#allowTaskReparenting}, the allowTaskReparenting trumps the 481 clear. That is, all activities above the root activity of the 482 task will be removed: those that have an affinity will be moved 483 to the task they are associated with, otherwise they will simply 484 be dropped as described here. --> 485 <attr name="clearTaskOnLaunch" format="boolean" /> 486 487 <!-- Specify whether an activity should be kept in its history stack. 488 If this attribute is set, then as soon as the user navigates away 489 from the activity it will be finished and they will no longer be 490 able to return to it. --> 491 <attr name="noHistory" format="boolean" /> 492 493 <!-- Specify whether an acitivty's task state should always be maintained 494 by the system, or if it is allowed to reset the task to its initial 495 state in certain situations. 496 497 <p>Normally the system will reset a task (remove all activities from 498 the stack and reset the root activity) in certain situations when 499 the user re-selects that task from the home screen. Typically this 500 will be done if the user hasn't visited that task for a certain 501 amount of time, such as 30 minutes. 502 503 <p>By setting this attribute, the user will always return to your 504 task in its last state, regardless of how they get there. This is 505 useful, for example, in an application like the web browser where there 506 is a lot of state (such as multiple open tabs) that the application 507 would not like to lose. --> 508 <attr name="alwaysRetainTaskState" format="boolean" /> 509 510 <!-- Indicates that an Activity does not need to have its freeze state 511 (as returned by {@link android.app.Activity#onSaveInstanceState} 512 retained in order to be restarted. Generally you use this for activities 513 that do not store any state. When this flag is set, if for some reason 514 the activity is killed before it has a chance to save its state, 515 then the system will not remove it from the activity stack like 516 it normally would. Instead, the next time the user navigates to 517 it its {@link android.app.Activity#onCreate} method will be called 518 with a null icicle, just like it was starting for the first time. 519 520 <p>This is used by the Home activity to make sure it does not get 521 removed if it crashes for some reason. --> 522 <attr name="stateNotNeeded" format="boolean" /> 523 524 <!-- Indicates that an Activity should be excluded from the list of 525 recently launched activities. --> 526 <attr name="excludeFromRecents" format="boolean" /> 527 528 <!-- Specify that an Activity should be shown over the lock screen and, 529 in a multiuser environment, across all users' windows. 530 @deprecated use {@link android.R.attr#showForAllUsers} instead. --> 531 <attr name="showOnLockScreen" format="boolean" /> 532 533 <!-- Specify that an Activity should be shown even if the current/foreground user 534 is different from the user of the Activity. This will also force the 535 <code>android.view.LayoutParams.FLAG_SHOW_WHEN_LOCKED</code> flag 536 to be set for all windows of this activity --> 537 <attr name="showForAllUsers" format="boolean" /> 538 539 <!-- Specify the authorities under which this content provider can be 540 found. Multiple authorities may be supplied by separating them 541 with a semicolon. Authority names should use a Java-style naming 542 convention (such as <code>com.google.provider.MyProvider</code>) 543 in order to avoid conflicts. Typically this name is the same 544 as the class implementation describing the provider's data structure. --> 545 <attr name="authorities" format="string" /> 546 547 <!-- Flag indicating whether this content provider would like to 548 participate in data synchronization. --> 549 <attr name="syncable" format="boolean" /> 550 551 <!-- Flag declaring this activity to be 'immersive'; immersive activities 552 should not be interrupted with other activities or notifications. --> 553 <attr name="immersive" format="boolean" /> 554 555 <!-- Flag declaring that this activity will be run in VR mode, and specifying 556 the component of the {@link android.service.vr.VrListenerService} that should be 557 bound while this Activity is visible if it is installed and enabled on this device. 558 This is equivalent to calling {@link android.app.Activity#setVrModeEnabled} with the 559 the given component name within the Activity that this attribute is set for. 560 Declaring this will prevent the system from leaving VR mode during an Activity 561 transtion from one VR activity to another. --> 562 <attr name="enableVrMode" format="string" /> 563 564 <!-- Specify the order in which content providers hosted by a process 565 are instantiated when that process is created. Not needed unless 566 you have providers with dependencies between each other, to make 567 sure that they are created in the order needed by those dependencies. 568 The value is a simple integer, with higher numbers being 569 initialized first. --> 570 <attr name="initOrder" format="integer" /> 571 572 <!-- Specify the relative importance or ability in handling a particular 573 Intent. For receivers, this controls the order in which they are 574 executed to receive a broadcast (note that for 575 asynchronous broadcasts, this order is ignored). For activities, 576 this provides information about how good an activity is handling an 577 Intent; when multiple activities match an intent and have different 578 priorities, only those with the higher priority value will be 579 considered a match. 580 581 <p>Only use if you really need to impose some specific 582 order in which the broadcasts are received, or want to forcibly 583 place an activity to always be preferred over others. The value is a 584 single integer, with higher numbers considered to be better. --> 585 <attr name="priority" format="integer" /> 586 587 <!-- Indicate if this component is aware of direct boot lifecycle, and can be 588 safely run before the user has entered their credentials (such as a lock 589 pattern or PIN). --> 590 <attr name="directBootAware" format="boolean" /> 591 592 <!-- Specify how an activity should be launched. See the 593 <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back 594 Stack</a> document for important information on how these options impact 595 the behavior of your application. 596 597 <p>If this attribute is not specified, <code>standard</code> launch 598 mode will be used. Note that the particular launch behavior can 599 be changed in some ways at runtime through the 600 {@link android.content.Intent} flags 601 {@link android.content.Intent#FLAG_ACTIVITY_SINGLE_TOP}, 602 {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}, and 603 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}. --> 604 <attr name="launchMode"> 605 <!-- The default mode, which will usually create a new instance of 606 the activity when it is started, though this behavior may change 607 with the introduction of other options such as 608 {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK 609 Intent.FLAG_ACTIVITY_NEW_TASK}. --> 610 <enum name="standard" value="0" /> 611 <!-- If, when starting the activity, there is already an 612 instance of the same activity class in the foreground that is 613 interacting with the user, then 614 re-use that instance. This existing instance will receive a call to 615 {@link android.app.Activity#onNewIntent Activity.onNewIntent()} with 616 the new Intent that is being started. --> 617 <enum name="singleTop" value="1" /> 618 <!-- If, when starting the activity, there is already a task running 619 that starts with this activity, then instead of starting a new 620 instance the current task is brought to the front. The existing 621 instance will receive a call to {@link android.app.Activity#onNewIntent 622 Activity.onNewIntent()} 623 with the new Intent that is being started, and with the 624 {@link android.content.Intent#FLAG_ACTIVITY_BROUGHT_TO_FRONT 625 Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT} flag set. This is a superset 626 of the singleTop mode, where if there is already an instance 627 of the activity being started at the top of the stack, it will 628 receive the Intent as described there (without the 629 FLAG_ACTIVITY_BROUGHT_TO_FRONT flag set). See the 630 <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back 631 Stack</a> document for more details about tasks.--> 632 <enum name="singleTask" value="2" /> 633 <!-- Only allow one instance of this activity to ever be 634 running. This activity gets a unique task with only itself running 635 in it; if it is ever launched again with the same Intent, then that 636 task will be brought forward and its 637 {@link android.app.Activity#onNewIntent Activity.onNewIntent()} 638 method called. If this 639 activity tries to start a new activity, that new activity will be 640 launched in a separate task. See the 641 <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back 642 Stack</a> document for more details about tasks.--> 643 <enum name="singleInstance" value="3" /> 644 </attr> 645 646 <!-- Specify the orientation an activity should be run in. If not 647 specified, it will run in the current preferred orientation 648 of the screen. 649 <p>This attribute is supported by the <a 650 href="{@docRoot}guide/topics/manifest/activity-element.html">{@code <activity>}</a> 651 element. --> 652 <attr name="screenOrientation"> 653 <!-- No preference specified: let the system decide the best 654 orientation. This will either be the orientation selected 655 by the activity below, or the user's preferred orientation 656 if this activity is the bottom of a task. If the user 657 explicitly turned off sensor based orientation through settings 658 sensor based device rotation will be ignored. If not by default 659 sensor based orientation will be taken into account and the 660 orientation will changed based on how the user rotates the device. 661 Corresponds to 662 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_UNSPECIFIED}. --> 663 <enum name="unspecified" value="-1" /> 664 <!-- Would like to have the screen in a landscape orientation: that 665 is, with the display wider than it is tall, ignoring sensor data. 666 Corresponds to 667 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE}. --> 668 <enum name="landscape" value="0" /> 669 <!-- Would like to have the screen in a portrait orientation: that 670 is, with the display taller than it is wide, ignoring sensor data. 671 Corresponds to 672 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_PORTRAIT}. --> 673 <enum name="portrait" value="1" /> 674 <!-- Use the user's current preferred orientation of the handset. 675 Corresponds to 676 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER}. --> 677 <enum name="user" value="2" /> 678 <!-- Keep the screen in the same orientation as whatever is behind 679 this activity. 680 Corresponds to 681 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_BEHIND}. --> 682 <enum name="behind" value="3" /> 683 <!-- Orientation is determined by a physical orientation sensor: 684 the display will rotate based on how the user moves the device. 685 Ignores user's setting to turn off sensor-based rotation. 686 Corresponds to 687 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR}. --> 688 <enum name="sensor" value="4" /> 689 <!-- Always ignore orientation determined by orientation sensor: 690 the display will not rotate when the user moves the device. 691 Corresponds to 692 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_NOSENSOR}. --> 693 <enum name="nosensor" value="5" /> 694 <!-- Would like to have the screen in landscape orientation, but can 695 use the sensor to change which direction the screen is facing. 696 Corresponds to 697 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_LANDSCAPE}. --> 698 <enum name="sensorLandscape" value="6" /> 699 <!-- Would like to have the screen in portrait orientation, but can 700 use the sensor to change which direction the screen is facing. 701 Corresponds to 702 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_SENSOR_PORTRAIT}. --> 703 <enum name="sensorPortrait" value="7" /> 704 <!-- Would like to have the screen in landscape orientation, turned in 705 the opposite direction from normal landscape. 706 Corresponds to 707 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_LANDSCAPE}. --> 708 <enum name="reverseLandscape" value="8" /> 709 <!-- Would like to have the screen in portrait orientation, turned in 710 the opposite direction from normal portrait. 711 Corresponds to 712 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_REVERSE_PORTRAIT}. --> 713 <enum name="reversePortrait" value="9" /> 714 <!-- Orientation is determined by a physical orientation sensor: 715 the display will rotate based on how the user moves the device. 716 This allows any of the 4 possible rotations, regardless of what 717 the device will normally do (for example some devices won't 718 normally use 180 degree rotation). 719 Corresponds to 720 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_SENSOR}. --> 721 <enum name="fullSensor" value="10" /> 722 <!-- Would like to have the screen in landscape orientation, but if 723 the user has enabled sensor-based rotation then we can use the 724 sensor to change which direction the screen is facing. 725 Corresponds to 726 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_LANDSCAPE}. --> 727 <enum name="userLandscape" value="11" /> 728 <!-- Would like to have the screen in portrait orientation, but if 729 the user has enabled sensor-based rotation then we can use the 730 sensor to change which direction the screen is facing. 731 Corresponds to 732 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_USER_PORTRAIT}. --> 733 <enum name="userPortrait" value="12" /> 734 <!-- Respect the user's sensor-based rotation preference, but if 735 sensor-based rotation is enabled then allow the screen to rotate 736 in all 4 possible directions regardless of what 737 the device will normally do (for example some devices won't 738 normally use 180 degree rotation). 739 Corresponds to 740 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_FULL_USER}. --> 741 <enum name="fullUser" value="13" /> 742 <!-- Screen is locked to its current rotation, whatever that is. 743 Corresponds to 744 {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LOCKED}. --> 745 <enum name="locked" value="14" /> 746 </attr> 747 748 <!-- Specify one or more configuration changes that the activity will 749 handle itself. If not specified, the activity will be restarted 750 if any of these configuration changes happen in the system. Otherwise, 751 the activity will remain running and its 752 {@link android.app.Activity#onConfigurationChanged Activity.onConfigurationChanged} 753 method called with the new configuration. 754 755 <p>Note that all of these configuration changes can impact the 756 resource values seen by the application, so you will generally need 757 to re-retrieve all resources (including view layouts, drawables, etc) 758 to correctly handle any configuration change. 759 760 <p>These values must be kept in sync with those in 761 {@link android.content.pm.ActivityInfo} and 762 include/utils/ResourceTypes.h. --> 763 <attr name="configChanges"> 764 <!-- The IMSI MCC has changed, that is a SIM has been detected and 765 updated the Mobile Country Code. --> 766 <flag name="mcc" value="0x0001" /> 767 <!-- The IMSI MNC has changed, that is a SIM has been detected and 768 updated the Mobile Network Code. --> 769 <flag name="mnc" value="0x0002" /> 770 <!-- The locale has changed, that is the user has selected a new 771 language that text should be displayed in. --> 772 <flag name="locale" value="0x0004" /> 773 <!-- The touchscreen has changed. Should never normally happen. --> 774 <flag name="touchscreen" value="0x0008" /> 775 <!-- The keyboard type has changed, for example the user has plugged 776 in an external keyboard. --> 777 <flag name="keyboard" value="0x0010" /> 778 <!-- The keyboard or navigation accessibility has changed, for example 779 the user has slid the keyboard out to expose it. Note that 780 despite its name, this applied to any accessibility: keyboard 781 or navigation. --> 782 <flag name="keyboardHidden" value="0x0020" /> 783 <!-- The navigation type has changed. Should never normally happen. --> 784 <flag name="navigation" value="0x0040" /> 785 <!-- The screen orientation has changed, that is the user has 786 rotated the device. --> 787 <flag name="orientation" value="0x0080" /> 788 <!-- The screen layout has changed. This might be caused by a 789 different display being activated. --> 790 <flag name="screenLayout" value="0x0100" /> 791 <!-- The global user interface mode has changed. For example, 792 going in or out of car mode, night mode changing, etc. --> 793 <flag name="uiMode" value="0x0200" /> 794 <!-- The current available screen size has changed. If applications don't 795 target at least {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2} 796 then the activity will always handle this itself (the change 797 will not result in a restart). This represents a change in the 798 currently available size, so will change when the user switches 799 between landscape and portrait. --> 800 <flag name="screenSize" value="0x0400" /> 801 <!-- The physical screen size has changed. If applications don't 802 target at least {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2} 803 then the activity will always handle this itself (the change 804 will not result in a restart). This represents a change in size 805 regardless of orientation, so will only change when the actual 806 physical screen size has changed such as switching to an external 807 display. --> 808 <flag name="smallestScreenSize" value="0x0800" /> 809 <!-- The display density has changed. This might be caused by the user 810 specifying a different display scale, or it might be caused by a 811 different display being activated. --> 812 <flag name="density" value="0x1000" /> 813 <!-- The layout direction has changed. For example going from LTR to RTL. --> 814 <flag name="layoutDirection" value="0x2000" /> 815 <!-- The font scaling factor has changed, that is the user has 816 selected a new global font size. --> 817 <flag name="fontScale" value="0x40000000" /> 818 </attr> 819 820 <!-- Indicate that the activity can be launched as the embedded child of another 821 activity. Particularly in the case where the child lives in a container 822 such as a Display owned by another activity. 823 824 <p>The default value of this attribute is <code>false</code>. --> 825 <attr name="allowEmbedded" format="boolean" /> 826 827 <!-- Descriptive text for the associated data. --> 828 <attr name="description" format="reference" /> 829 830 <!-- The name of the application package that an Instrumentation object 831 will run against. --> 832 <attr name="targetPackage" format="string" /> 833 834 <!-- Flag indicating that an Instrumentation class wants to take care 835 of starting/stopping profiling itself, rather than relying on 836 the default behavior of profiling the complete time it is running. 837 This allows it to target profiling data at a specific set of 838 operations. --> 839 <attr name="handleProfiling" format="boolean" /> 840 841 <!-- Flag indicating that an Instrumentation class should be run as a 842 functional test. --> 843 <attr name="functionalTest" format="boolean" /> 844 845 <!-- The touch screen type used by an application. --> 846 <attr name="reqTouchScreen"> 847 <enum name="undefined" value="0" /> 848 <enum name="notouch" value="1" /> 849 <enum name="stylus" value="2" /> 850 <enum name="finger" value="3" /> 851 </attr> 852 853 <!-- The input method preferred by an application. --> 854 <attr name="reqKeyboardType"> 855 <enum name="undefined" value="0" /> 856 <enum name="nokeys" value="1" /> 857 <enum name="qwerty" value="2" /> 858 <enum name="twelvekey" value="3" /> 859 </attr> 860 861 <!-- Application's requirement for a hard keyboard --> 862 <attr name="reqHardKeyboard" format="boolean" /> 863 864 <!-- The navigation device preferred by an application. --> 865 <attr name="reqNavigation"> 866 <enum name="undefined" value="0" /> 867 <enum name="nonav" value="1" /> 868 <enum name="dpad" value="2" /> 869 <enum name="trackball" value="3" /> 870 <enum name="wheel" value="4" /> 871 </attr> 872 873 <!-- Application's requirement for five way navigation --> 874 <attr name="reqFiveWayNav" format="boolean" /> 875 876 <!-- The name of the class subclassing <code>BackupAgent</code> to manage 877 backup and restore of the application's data on external storage. --> 878 <attr name="backupAgent" format="string" /> 879 880 <!-- Whether to allow the application to participate in the backup 881 and restore infrastructure. If this attribute is set to <code>false</code>, 882 no backup or restore of the application will ever be performed, even by a 883 full-system backup that would otherwise cause all application data to be saved 884 via adb. The default value of this attribute is <code>true</code>. --> 885 <attr name="allowBackup" format="boolean" /> 886 887 <!-- Applications will set this in their manifest to opt-in to or out of full app data back-up 888 and restore. Alternatively they can set it to an xml resource within their app that will 889 be parsed by the BackupAgent to selectively backup files indicated within that xml. --> 890 <attr name="fullBackupContent" format="reference|boolean" /> 891 892 <!-- Indicates that even though the application provides a <code>BackupAgent</code>, 893 only full-data streaming backup operations are to be performed to save the app's 894 data. This lets the app rely on full-data backups while still participating in 895 the backup and restore process via the BackupAgent's full-data backup APIs. 896 When this attribute is <code>true</code> the app's BackupAgent overrides of 897 the onBackup() and onRestore() callbacks can be empty stubs. --> 898 <attr name="fullBackupOnly" format="boolean" /> 899 900 <!-- Whether the application in question should be terminated after its 901 settings have been restored during a full-system restore operation. 902 Single-package restore operations will never cause the application to 903 be shut down. Full-system restore operations typically only occur once, 904 when the phone is first set up. Third-party applications will not usually 905 need to use this attribute. 906 907 <p>The default is <code>true</code>, which means that after the application 908 has finished processing its data during a full-system restore, it will be 909 terminated. --> 910 <attr name="killAfterRestore" format="boolean" /> 911 912 <!-- @deprecated This attribute is not used by the Android operating system. --> 913 <attr name="restoreNeedsApplication" format="boolean" /> 914 915 <!-- Indicate that the application is prepared to attempt a restore of any 916 backed-up dataset, even if the backup is apparently from a newer version 917 of the application than is currently installed on the device. Setting 918 this attribute to <code>true</code> will permit the Backup Manager to 919 attempt restore even when a version mismatch suggests that the data are 920 incompatible. <em>Use with caution!</em> 921 922 <p>The default value of this attribute is <code>false</code>. --> 923 <attr name="restoreAnyVersion" format="boolean" /> 924 925 <!-- Indicates that full-data backup operations for this application may 926 be performed even if the application is in a foreground-equivalent 927 state. <em>Use with caution!</em> Setting this flag to <code>true</code> 928 can impact app behavior while the user is interacting with the device. 929 930 <p>If unspecified, the default value of this attribute is <code>false</code>, 931 which means that the OS will avoid backing up the application while it is 932 running in the foreground (such as a music app that is actively playing 933 music via a service in the startForeground() state). --> 934 <attr name="backupInForeground" format="boolean" /> 935 936 <!-- The default install location defined by an application. --> 937 <attr name="installLocation"> 938 <!-- Let the system decide ideal install location --> 939 <enum name="auto" value="0" /> 940 <!-- Explicitly request to be installed on internal phone storage 941 only. --> 942 <enum name="internalOnly" value="1" /> 943 <!-- Prefer to be installed on SD card. There is no guarantee that 944 the system will honor this request. The application might end 945 up being installed on internal storage if external media 946 is unavailable or too full. --> 947 <enum name="preferExternal" value="2" /> 948 </attr> 949 950 <!-- Extra options for an activity's UI. Applies to either the {@code <activity>} or 951 {@code <application>} tag. If specified on the {@code <application>} 952 tag these will be considered defaults for all activities in the 953 application. --> 954 <attr name="uiOptions"> 955 <!-- No extra UI options. This is the default. --> 956 <flag name="none" value="0" /> 957 <!-- Split the options menu into a separate bar at the bottom of 958 the screen when severely constrained for horizontal space. 959 (e.g. portrait mode on a phone.) Instead of a small number 960 of action buttons appearing in the action bar at the top 961 of the screen, the action bar will split into the top navigation 962 section and the bottom menu section. Menu items will not be 963 split across the two bars; they will always appear together. --> 964 <flag name="splitActionBarWhenNarrow" value="1" /> 965 </attr> 966 967 <!-- The name of the logical parent of the activity as it appears in the manifest. --> 968 <attr name="parentActivityName" format="string" /> 969 970 <!-- Define how an activity persist across reboots. Activities defined as "never" will not 971 be persisted. Those defined as "always" will be persisted. Those defined as "taskOnly" 972 will persist the root activity of the task only. See below for more detail as to 973 what gets persisted. --> 974 <attr name="persistableMode"> 975 <!-- The default. If this activity forms the root of a task then that task will be 976 persisted across reboots but only the launching intent will be used. If the task 977 relinquishes its identity then the intent used is that of the topmost inherited 978 identity. All activities above this activity in the task will not be persisted. 979 In addition this activity will not be passed a PersistableBundle into which it 980 could have stored its state. --> 981 <enum name="persistRootOnly" value="0" /> 982 <!-- If this activity forms the root of a task then that task will not be persisted 983 across reboots --> 984 <enum name="persistNever" value="1" /> 985 <!-- If this activity forms the root of a task then the task and this activity will 986 be persisted across reboots. If the activity above this activity is also 987 tagged with the attribute <code>"persist"</code> then it will be persisted as well. 988 And so on up the task stack until either an activity without the 989 <code>persistableMode="persistAcrossReboots"</code> attribute or one that was launched 990 with the flag Intent.FLAG_CLEAR_TASK_WHEN_RESET is encountered. 991 992 <p>Activities that are declared with the persistAcrossReboots attribute will be 993 provided with a PersistableBundle in onSavedInstanceState(), These activities may 994 use this PeristableBundle to save their state. Then, following a reboot, that 995 PersistableBundle will be provided back to the activity in its onCreate() method. --> 996 <enum name="persistAcrossReboots" value="2" /> 997 </attr> 998 999 <!-- This attribute specifies that an activity shall become the root activity of a 1000 new task each time it is launched. Using this attribute permits the user to 1001 have multiple documents from the same applications appear in the recent tasks list. 1002 1003 <p>Such a document is any kind of item for which an application may want to 1004 maintain multiple simultaneous instances. Examples might be text files, web 1005 pages, spreadsheets, or emails. Each such document will be in a separate 1006 task in the recent taskss list. 1007 1008 <p>This attribute is equivalent to adding the flag {@link 1009 android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} to every Intent used to launch 1010 the activity. 1011 1012 <p>The documentLaunchMode attribute may be assigned one of four values, "none", 1013 "intoExisting", "always" and "never", described in detail below. For values other than 1014 <code>none</code> and <code>never</code> the activity must be defined with 1015 {@link android.R.attr#launchMode} <code>standard</code>. 1016 If this attribute is not specified, <code>none</code> will be used. 1017 Note that <code>none</code> can be overridden at run time if the Intent used 1018 to launch it contains the flag {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT 1019 Intent.FLAG_ACTIVITY_NEW_DOCUMENT}. 1020 Similarly <code>intoExisting</code> will be overridden by the flag 1021 {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT 1022 Intent.FLAG_ACTIVITY_NEW_DOCUMENT} combined with 1023 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK 1024 Intent.FLAG_ACTIVITY_MULTIPLE_TASK}. If the value of 1025 documentLaunchModes is <code>never</code> then any use of 1026 {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT 1027 Intent.FLAG_ACTIVITY_NEW_DOCUMENT} to launch this activity will be ignored. --> 1028 <attr name="documentLaunchMode"> 1029 <!-- The default mode, which will create a new task only when 1030 {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK 1031 Intent.FLAG_ACTIVITY_NEW_TASK} is set. --> 1032 <enum name="none" value="0" /> 1033 <!-- All tasks will be searched for one whose base Intent's ComponentName and 1034 data URI match those of the launching Intent. If such a task is found 1035 that task will be cleared and restarted with the root activity receiving a call 1036 to {@link android.app.Activity#onNewIntent Activity.onNewIntent}. If no 1037 such task is found a new task will be created. 1038 <p>This is the equivalent of launching an activity with {@link 1039 android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT Intent.FLAG_ACTIVITY_NEW_DOCUMENT} 1040 set and without {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK 1041 Intent.FLAG_ACTIVITY_MULTIPLE_TASK} set. --> 1042 <enum name="intoExisting" value="1" /> 1043 <!-- A new task rooted at this activity will be created. This will happen whether or 1044 not there is an existing task whose ComponentName and data URI match 1045 that of the launcing intent This is the equivalent of launching an activity 1046 with {@link 1047 android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT Intent.FLAG_ACTIVITY_NEW_DOCUMENT} 1048 and {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK 1049 Intent.FLAG_ACTIVITY_MULTIPLE_TASK} both set. --> 1050 <enum name="always" value="2" /> 1051 <!-- This activity will not be launched into a new document even if the Intent contains 1052 {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT 1053 Intent.FLAG_ACTIVITY_NEW_DOCUMENT}. This gives the activity writer ultimate 1054 control over how their activity is used. Note that applications prior to api 1055 21 will default to documentLaunchMode="none" so only activities that explicitly 1056 opt out with <code>"never"</code> may do so. --> 1057 <enum name="never" value="3" /> 1058 </attr> 1059 1060 <!-- The maximum number of entries of tasks rooted at this activity in the recent task list. 1061 When this number of entries is reached the least recently used instance of this activity 1062 will be removed from recents. The value will be clamped between 1 and 100 inclusive. 1063 The default value for this if it is not specified is 15. --> 1064 <attr name="maxRecents" format="integer" /> 1065 1066 <!-- Tasks launched by activities with this attribute will remain in the recent tasks 1067 list until the last activity in the task is completed. When that happens the task 1068 will be automatically removed from the recent tasks list. This overrides the caller's 1069 use of {@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS 1070 Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS} --> 1071 <attr name="autoRemoveFromRecents" format="boolean" /> 1072 1073 <!-- Tasks whose root has this attribute set to true will replace baseIntent with that of the 1074 next activity in the task. If the next activity also has this attribute set to true then 1075 it will yield the baseIntent to any activity that it launches in the same task. This 1076 continues until an activity is encountered which has this attribute set to false. False 1077 is the default. This attribute set to true also permits activity's use of the 1078 TaskDescription to change labels, colors and icons in the recent task list. --> 1079 <attr name="relinquishTaskIdentity" format="boolean" /> 1080 1081 <!-- Indicate that it is okay for this activity be resumed while the previous 1082 activity is in the process of pausing, without waiting for the previous pause 1083 to complete. Use this with caution: your activity can not acquire any exclusive 1084 resources (such as opening the camera or recording audio) when it launches, or it 1085 may conflict with the previous activity and fail. 1086 1087 <p>The default value of this attribute is <code>false</code>. --> 1088 <attr name="resumeWhilePausing" format="boolean" /> 1089 1090 <!-- Indicates that it is okay for this activity to be resized to any dimension. Intended for a 1091 multi-window device where there can be multiple activities of various sizes on the screen 1092 at the same time. 1093 1094 <p>The default value is <code>false</code> for applications with 1095 <code>targetSdkVersion</code> lesser than {@link android.os.Build.VERSION_CODES#N} and 1096 <code>true</code> otherwise. 1097 1098 <p>NOTE: A task's root activity value is applied to all additional activities launched in 1099 the task. That is if the root activity of a task is resizeable then the system will treat 1100 all other activities in the task as resizeable and will not if the root activity isn't 1101 resizeable. 1102 1103 <p>NOTE: The value of {@link android.R.attr#screenOrientation} is ignored for 1104 resizeable activities when in multi-window mode. --> 1105 <attr name="resizeableActivity" format="boolean" /> 1106 1107 <!-- Indicates that the activity supports the picture-in-picture (PiP) form of multi-window. 1108 While it makes sense to be able to resize most activities types in multi-window mode when 1109 {@link android.R.attr#resizeableActivity} is set. It only makes sense to put specific types 1110 of activities in PiP mode of multi-window. For example, activities that play video. When 1111 set the activity will be allowed to enter PiP mode when the system deems it appropriate on 1112 devices that support PiP. 1113 1114 <p>The default value is <code>false</code> for applications with 1115 <code>targetSdkVersion</code> lesser than {@link android.os.Build.VERSION_CODES#N} and 1116 <code>true</code> otherwise. 1117 1118 <p>NOTE: Attribute is only used if {@link android.R.attr#resizeableActivity} is true. --> 1119 <attr name="supportsPictureInPicture" format="boolean" /> 1120 1121 <!-- This value indicates how tasks rooted at this activity will behave in lockTask mode. 1122 While in lockTask mode the system will not launch non-permitted tasks until 1123 lockTask mode is disabled. 1124 <p>While in lockTask mode with multiple permitted tasks running, each launched task is 1125 permitted to finish, transitioning to the previous locked task, until there is only one 1126 task remaining. At that point the last task running is not permitted to finish, unless it 1127 uses the value always. --> 1128 <attr name="lockTaskMode"> 1129 <!-- This is the default value. Tasks will not launch into lockTask mode but can be 1130 placed there by calling {@link android.app.Activity#startLockTask}. If a task with 1131 this mode has been whitelisted using {@link 1132 android.app.admin.DevicePolicyManager#setLockTaskPackages} then calling 1133 {@link android.app.Activity#startLockTask} will enter lockTask mode immediately, 1134 otherwise the user will be presented with a dialog to approve entering pinned mode. 1135 <p>If the system is already in lockTask mode when a new task rooted at this activity 1136 is launched that task will or will not start depending on whether the package of this 1137 activity has been whitelisted. 1138 <p>Tasks rooted at this activity can only exit lockTask mode using 1139 {@link android.app.Activity#stopLockTask}. --> 1140 <enum name="normal" value="0"/> 1141 <!-- Tasks will not launch into lockTask mode and cannot be placed there using 1142 {@link android.app.Activity#startLockTask} or be pinned from the Overview screen. 1143 If the system is already in lockTask mode when a new task rooted at this activity is 1144 launched that task will not be started. 1145 <p>Note: This mode is only available to system and privileged applications. 1146 Non-privileged apps with this value will be treated as normal. 1147 --> 1148 <enum name="never" value="1"/> 1149 <!-- Tasks rooted at this activity will always launch into lockTask mode. If the system is 1150 already in lockTask mode when this task is launched then the new task will be launched 1151 on top of the current task. Tasks launched in this mode are capable of exiting 1152 lockTask mode using {@link android.app.Activity#finish()}. 1153 <p>Note: This mode is only available to system and privileged applications. 1154 Non-privileged apps with this value will be treated as normal. 1155 --> 1156 <enum name="always" value="2"/> 1157 <!-- If the DevicePolicyManager (DPM) authorizes this package ({@link 1158 android.app.admin.DevicePolicyManager#setLockTaskPackages}) then this mode is 1159 identical to always, except that the activity needs to call 1160 {@link android.app.Activity#stopLockTask} before being able to finish if it is the last 1161 locked task. 1162 If the DPM does not authorize this package then this mode is identical to normal. --> 1163 <enum name="if_whitelisted" value="3"/> 1164 </attr> 1165 <!-- When set installer will extract native libraries. If set to false 1166 libraries in the apk must be stored and page-aligned. --> 1167 <attr name="extractNativeLibs" format="boolean"/> 1168 1169 <!-- Specify whether an activity intent filter will need to be verified thru its set 1170 of data URIs. This will only be used when the Intent's action is set to 1171 {@link android.content.Intent#ACTION_VIEW Intent.ACTION_VIEW} and the Intent's category is 1172 set to {@link android.content.Intent#CATEGORY_BROWSABLE Intent.CATEGORY_BROWSABLE} and the 1173 intern filter data scheme is set to "http" or "https". When set to true, the intent filter 1174 will need to use its data tag for getting the URIs to verify with. 1175 1176 For each URI, an HTTPS network request will be done to <code>/.well-known/statements.json</code> 1177 host to verify that the web site is okay with the app intercepting the URI. 1178 --> 1179 <attr name="autoVerify" format="boolean" /> 1180 1181 <!-- An XML resource with the application's Network Security Config. --> 1182 <attr name="networkSecurityConfig" format="reference" /> 1183 1184 <!-- The <code>manifest</code> tag is the root of an 1185 <code>AndroidManifest.xml</code> file, 1186 describing the contents of an Android package (.apk) file. One 1187 attribute must always be supplied: <code>package</code> gives a 1188 unique name for the package, using a Java-style naming convention 1189 to avoid name collisions. For example, applications published 1190 by Google could have names of the form 1191 <code>com.google.app.<em>appname</em></code> 1192 1193 <p>Inside of the manifest tag, may appear the following tags 1194 in any order: {@link #AndroidManifestPermission permission}, 1195 {@link #AndroidManifestPermissionGroup permission-group}, 1196 {@link #AndroidManifestPermissionTree permission-tree}, 1197 {@link #AndroidManifestUsesSdk uses-sdk}, 1198 {@link #AndroidManifestUsesPermission uses-permission}, 1199 {@link #AndroidManifestUsesConfiguration uses-configuration}, 1200 {@link #AndroidManifestApplication application}, 1201 {@link #AndroidManifestInstrumentation instrumentation}, 1202 {@link #AndroidManifestUsesFeature uses-feature}. --> 1203 <declare-styleable name="AndroidManifest"> 1204 <attr name="versionCode" /> 1205 <attr name="versionName" /> 1206 <attr name="revisionCode" /> 1207 <attr name="sharedUserId" /> 1208 <attr name="sharedUserLabel" /> 1209 <attr name="installLocation" /> 1210 </declare-styleable> 1211 1212 <!-- The <code>application</code> tag describes application-level components 1213 contained in the package, as well as general application 1214 attributes. Many of the attributes you can supply here (such 1215 as theme, label, icon, permission, process, taskAffinity, 1216 and allowTaskReparenting) serve 1217 as default values for the corresponding attributes of components 1218 declared inside of the application. 1219 1220 <p>Inside of this element you specify what the application contains, 1221 using the elements {@link #AndroidManifestProvider provider}, 1222 {@link #AndroidManifestService service}, 1223 {@link #AndroidManifestReceiver receiver}, 1224 {@link #AndroidManifestActivity activity}, 1225 {@link #AndroidManifestActivityAlias activity-alias}, and 1226 {@link #AndroidManifestUsesLibrary uses-library}. The application tag 1227 appears as a child of the root {@link #AndroidManifest manifest} tag in 1228 an application's manifest file. --> 1229 <declare-styleable name="AndroidManifestApplication" parent="AndroidManifest"> 1230 <!-- The (optional) fully-qualified name for a subclass of 1231 {@link android.app.Application} that the system instantiates before 1232 any other class when an app's process starts. Most applications 1233 don't need this attribute. If it's not specified, the system 1234 instantiates the base Application class instead.--> 1235 <attr name="name" /> 1236 <attr name="theme" /> 1237 <attr name="label" /> 1238 <attr name="icon" /> 1239 <attr name="banner" /> 1240 <attr name="logo" /> 1241 <attr name="description" /> 1242 <attr name="permission" /> 1243 <attr name="process" /> 1244 <attr name="taskAffinity" /> 1245 <attr name="allowTaskReparenting" /> 1246 <!-- Indicate whether this application contains code. If set to false, 1247 there is no code associated with it and thus the system will not 1248 try to load its code when launching components. The default is true 1249 for normal behavior. --> 1250 <attr name="hasCode" format="boolean" /> 1251 <attr name="persistent" /> 1252 <attr name="requiredForAllUsers" /> 1253 <!-- Specify whether the components in this application are enabled or not (that is, can be 1254 instantiated by the system). 1255 If "false", it overrides any component specific values (a value of "true" will not 1256 override the component specific values). --> 1257 <attr name="enabled" /> 1258 <attr name="debuggable" /> 1259 <attr name="vmSafeMode" /> 1260 <attr name="hardwareAccelerated" /> 1261 <!-- Name of activity to be launched for managing the application's space on the device. --> 1262 <attr name="manageSpaceActivity" /> 1263 <attr name="allowClearUserData" /> 1264 <attr name="testOnly" /> 1265 <attr name="backupAgent" /> 1266 <attr name="allowBackup" /> 1267 <attr name="fullBackupOnly" /> 1268 <attr name="fullBackupContent" /> 1269 <attr name="killAfterRestore" /> 1270 <attr name="restoreNeedsApplication" /> 1271 <attr name="restoreAnyVersion" /> 1272 <attr name="backupInForeground" /> 1273 <!-- Request that your application's processes be created with 1274 a large Dalvik heap. This applies to <em>all</em> processes 1275 created for the application. It only applies to the first 1276 application loaded into a process; if using a sharedUserId 1277 to allow multiple applications to use a process, they all must 1278 use this option consistently or will get unpredictable results. --> 1279 <attr name="largeHeap" format="boolean" /> 1280 <!-- Declare that this application can't participate in the normal 1281 state save/restore mechanism. Since it is not able to save and 1282 restore its state on demand, 1283 it can not participate in the normal activity lifecycle. It will 1284 not be killed while in the background; the user must explicitly 1285 quit it. Only one such app can be running at a time; if the user 1286 tries to launch a second such app, they will be prompted 1287 to quit the first before doing so. While the 1288 application is running, the user will be informed of this. 1289 @hide --> 1290 <attr name="cantSaveState" format="boolean" /> 1291 <attr name="uiOptions" /> 1292 <!-- Declare that your application will be able to deal with RTL (right to left) layouts. 1293 If set to false (default value), your application will not care about RTL layouts. --> 1294 <attr name="supportsRtl" format="boolean" /> 1295 <!-- Declare that this application requires access to restricted accounts of a certain 1296 type. The default value is null and restricted accounts won\'t be visible to this 1297 application. The type should correspond to the account authenticator type, such as 1298 "com.google". --> 1299 <attr name="restrictedAccountType" format="string"/> 1300 <!-- Declare that this application requires an account of a certain 1301 type. The default value is null and indicates that the application can work without 1302 any accounts. The type should correspond to the account authenticator type, such as 1303 "com.google". --> 1304 <attr name="requiredAccountType" format="string"/> 1305 <attr name="isGame" /> 1306 <!-- Declare that this application may use cleartext traffic, such as HTTP rather than 1307 HTTPS; WebSockets rather than WebSockets Secure; XMPP, IMAP, STMP without STARTTLS or 1308 TLS). Defaults to true. If set to false {@code false}, the application declares that it 1309 does not intend to use cleartext network traffic, in which case platform components 1310 (e.g. HTTP stacks, {@code DownloadManager}, {@code MediaPlayer}) will refuse 1311 applications's requests to use cleartext traffic. Third-party libraries are encouraged 1312 to honor this flag as well. --> 1313 <attr name="usesCleartextTraffic" /> 1314 <attr name="multiArch" /> 1315 <attr name="extractNativeLibs" /> 1316 <attr name="defaultToDeviceProtectedStorage" format="boolean" /> 1317 <attr name="directBootAware" /> 1318 <attr name="resizeableActivity" /> 1319 <attr name="networkSecurityConfig" /> 1320 </declare-styleable> 1321 <!-- The <code>permission</code> tag declares a security permission that can be 1322 used to control access from other packages to specific components or 1323 features in your package (or other packages). See the 1324 <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a> 1325 document for more information on permissions. 1326 1327 <p>This appears as a child tag of the root 1328 {@link #AndroidManifest manifest} tag. --> 1329 <declare-styleable name="AndroidManifestPermission" parent="AndroidManifest"> 1330 <!-- Required public name of the permission, which other components and 1331 packages will use when referring to this permission. This is a string using 1332 Java-style scoping to ensure it is unique. The prefix will often 1333 be the same as our overall package name, for example 1334 "com.mycompany.android.myapp.SomePermission". --> 1335 <attr name="name" /> 1336 <attr name="label" /> 1337 <attr name="icon" /> 1338 <attr name="banner" /> 1339 <attr name="logo" /> 1340 <attr name="permissionGroup" /> 1341 <attr name="description" /> 1342 <attr name="protectionLevel" /> 1343 <attr name="permissionFlags" /> 1344 </declare-styleable> 1345 1346 <!-- The <code>permission-group</code> tag declares a logical grouping of 1347 related permissions. 1348 1349 <p>Note that this tag does not declare a permission itself, only 1350 a namespace in which further permissions can be placed. See 1351 the {@link #AndroidManifestPermission <permission>} tag for 1352 more information. 1353 1354 <p>This appears as a child tag of the root 1355 {@link #AndroidManifest manifest} tag. --> 1356 <declare-styleable name="AndroidManifestPermissionGroup" parent="AndroidManifest"> 1357 <!-- Required public name of the permission group, permissions will use 1358 to specify the group they are in. This is a string using 1359 Java-style scoping to ensure it is unique. The prefix will often 1360 be the same as our overall package name, for example 1361 "com.mycompany.android.myapp.SomePermission". --> 1362 <attr name="name" /> 1363 <attr name="label" /> 1364 <attr name="icon" /> 1365 <attr name="banner" /> 1366 <attr name="logo" /> 1367 <attr name="description" /> 1368 <attr name="permissionGroupFlags" /> 1369 <attr name="priority" /> 1370 </declare-styleable> 1371 1372 <!-- The <code>permission-tree</code> tag declares the base of a tree of 1373 permission values: it declares that this package has ownership of 1374 the given permission name, as well as all names underneath it 1375 (separated by '.'). This allows you to use the 1376 {@link android.content.pm.PackageManager#addPermission 1377 PackageManager.addPermission()} method to dynamically add new 1378 permissions under this tree. 1379 1380 <p>Note that this tag does not declare a permission itself, only 1381 a namespace in which further permissions can be placed. See 1382 the {@link #AndroidManifestPermission <permission>} tag for 1383 more information. 1384 1385 <p>This appears as a child tag of the root 1386 {@link #AndroidManifest manifest} tag. --> 1387 <declare-styleable name="AndroidManifestPermissionTree" parent="AndroidManifest"> 1388 <!-- Required public name of the permission tree, which is the base name 1389 of all permissions under it. This is a string using 1390 Java-style scoping to ensure it is unique. The prefix will often 1391 be the same as our overall package name, for example 1392 "com.mycompany.android.myapp.SomePermission". A permission tree name 1393 must have more than two segments in its path; that is, 1394 "com.me.foo" is okay, but not "com.me" or "com". --> 1395 <attr name="name" /> 1396 <attr name="label" /> 1397 <attr name="icon" /> 1398 <attr name="banner" /> 1399 <attr name="logo" /> 1400 </declare-styleable> 1401 1402 <!-- The <code>uses-permission</code> tag requests a 1403 {@link #AndroidManifestPermission <permission>} that the containing 1404 package must be granted in order for it to operate correctly. For runtime 1405 permissions, i.e. ones with <code>dangerous</code> protection level, on a 1406 platform that supports runtime permissions, the permission will not be 1407 granted until the app explicitly requests it at runtime and the user approves 1408 the grant. You cannot request at runtime permissions that are not declared 1409 as used in the manifest. See the 1410 <a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a> 1411 document for more information on permissions. Also available is a 1412 {@link android.Manifest.permission list of permissions} included 1413 with the base platform. 1414 1415 <p>This appears as a child tag of the root 1416 {@link #AndroidManifest manifest} tag. --> 1417 <declare-styleable name="AndroidManifestUsesPermission" parent="AndroidManifest"> 1418 <!-- Required name of the permission you use, as published with the 1419 corresponding name attribute of a 1420 {@link android.R.styleable#AndroidManifestPermission <permission>} 1421 tag; often this is one of the {@link android.Manifest.permission standard 1422 system permissions}. --> 1423 <attr name="name" /> 1424 <!-- Optional: specify the maximum version of the Android OS for which the 1425 application wishes to request the permission. When running on a version 1426 of Android higher than the number given here, the permission will not 1427 be requested. --> 1428 <attr name="maxSdkVersion" format="integer" /> 1429 </declare-styleable> 1430 1431 <!-- The <code>uses-configuration</code> tag specifies 1432 a specific hardware configuration value used by the application. 1433 For example an application might specify that it requires 1434 a physical keyboard or a particular navigation method like 1435 trackball. Multiple such attribute values can be specified by the 1436 application. 1437 1438 <p>This appears as a child tag of the root 1439 {@link #AndroidManifest manifest} tag. 1440 1441 @deprecated Use <code>feature-group</code> instead.--> 1442 <declare-styleable name="AndroidManifestUsesConfiguration" parent="AndroidManifest"> 1443 <!-- The type of touch screen used by an application. --> 1444 <attr name="reqTouchScreen" /> 1445 <attr name="reqKeyboardType" /> 1446 <attr name="reqHardKeyboard" /> 1447 <attr name="reqNavigation" /> 1448 <attr name="reqFiveWayNav" /> 1449 </declare-styleable> 1450 1451 <!-- The <code>uses-feature</code> tag specifies a specific device 1452 hardware or software feature used by the application. For 1453 example an application might specify that it requires 1454 a camera. Multiple attribute values can be specified by the 1455 application. 1456 1457 <p>This appears as a child tag of the root 1458 {@link #AndroidManifest manifest} tag. --> 1459 <declare-styleable name="AndroidManifestUsesFeature" parent="AndroidManifest"> 1460 <!-- The name of the feature that is being used. --> 1461 <attr name="name" /> 1462 <!-- The version of the feature that is being used. --> 1463 <attr name="version" format="integer" /> 1464 <!-- The GLES driver version number needed by an application. 1465 The higher 16 bits represent the major number and the lower 16 bits 1466 represent the minor number. For example for GL 1.2 referring to 1467 0x00000102, the actual value should be set as 0x00010002. --> 1468 <attr name="glEsVersion" format="integer" /> 1469 <!-- Specify whether this feature is required for the application. 1470 The default is true, meaning the application requires the 1471 feature, and does not want to be installed on devices that 1472 don't support it. If you set this to false, then this will 1473 not impose a restriction on where the application can be 1474 installed. --> 1475 <attr name="required" format="boolean" /> 1476 </declare-styleable> 1477 1478 <!-- The <code>feature-group</code> tag specifies 1479 a set of one or more <code>uses-feature</code> elements that 1480 the application can utilize. An application uses multiple 1481 <code>feature-group</code> sets to indicate that it can support 1482 different combinations of features. 1483 1484 <p>This appears as a child tag of the root 1485 {@link #AndroidManifest manifest} tag. --> 1486 <declare-styleable name="AndroidManifestFeatureGroup"> 1487 <!-- The human-readable name of the feature group. --> 1488 <attr name="label" /> 1489 </declare-styleable> 1490 1491 <!-- The <code>uses-sdk</code> tag describes the SDK features that the 1492 containing package must be running on to operate correctly. 1493 1494 <p>This appears as a child tag of the root 1495 {@link #AndroidManifest manifest} tag. --> 1496 <declare-styleable name="AndroidManifestUsesSdk" parent="AndroidManifest"> 1497 <!-- This is the minimum SDK version number that the application 1498 requires. This number is an abstract integer, from the list 1499 in {@link android.os.Build.VERSION_CODES} If 1500 not supplied, the application will work on any SDK. This 1501 may also be string (such as "Donut") if the application was built 1502 against a development branch, in which case it will only work against 1503 the development builds. --> 1504 <attr name="minSdkVersion" format="integer|string" /> 1505 <!-- This is the SDK version number that the application is targeting. 1506 It is able to run on older versions (down to minSdkVersion), but 1507 was explicitly tested to work with the version specified here. 1508 Specifying this version allows the platform to disable compatibility 1509 code that are not required or enable newer features that are not 1510 available to older applications. This may also be a string 1511 (such as "Donut") if this is built against a development 1512 branch, in which case minSdkVersion is also forced to be that 1513 string. --> 1514 <attr name="targetSdkVersion" format="integer|string" /> 1515 <!-- This is the maximum SDK version number that an application works 1516 on. You can use this to ensure your application is filtered out 1517 of later versions of the platform when you know you have 1518 incompatibility with them. --> 1519 <attr name="maxSdkVersion" /> 1520 </declare-styleable> 1521 1522 <!-- The <code>library</code> tag declares that this apk is providing itself 1523 as a shared library for other applications to use. It can only be used 1524 with apks that are built in to the system image. Other apks can link to 1525 it with the {@link #AndroidManifestUsesLibrary uses-library} tag. 1526 1527 <p>This appears as a child tag of the 1528 {@link #AndroidManifestApplication application} tag. --> 1529 <declare-styleable name="AndroidManifestLibrary" parent="AndroidManifest"> 1530 <!-- Required public name of the library, which other components and 1531 packages will use when referring to this library. This is a string using 1532 Java-style scoping to ensure it is unique. The name should typically 1533 be the same as the apk's package name. --> 1534 <attr name="name" /> 1535 </declare-styleable> 1536 1537 <!-- The <code>uses-libraries</code> specifies a shared library that this 1538 package requires to be linked against. Specifying this flag tells the 1539 system to include this library's code in your class loader. 1540 1541 <p>This appears as a child tag of the 1542 {@link #AndroidManifestApplication application} tag. --> 1543 <declare-styleable name="AndroidManifestUsesLibrary" parent="AndroidManifestApplication"> 1544 <!-- Required name of the library you use. --> 1545 <attr name="name" /> 1546 <!-- Specify whether this library is required for the application. 1547 The default is true, meaning the application requires the 1548 library, and does not want to be installed on devices that 1549 don't support it. If you set this to false, then this will 1550 allow the application to be installed even if the library 1551 doesn't exist, and you will need to check for its presence 1552 dynamically at runtime. --> 1553 <attr name="required" /> 1554 </declare-styleable> 1555 1556 <!-- The <code>supports-screens</code> specifies the screen dimensions an 1557 application supports. By default a modern application supports all 1558 screen sizes and must explicitly disable certain screen sizes here; 1559 older applications are assumed to only support the traditional normal 1560 (HVGA) screen size. Note that screen size is a separate axis from 1561 density, and is determined as the available pixels to an application 1562 after density scaling has been applied. 1563 1564 <p>This appears as a child tag of the 1565 {@link #AndroidManifest manifest} tag. --> 1566 <declare-styleable name="AndroidManifestSupportsScreens" parent="AndroidManifest"> 1567 <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}, 1568 this is the new way to specify the minimum screen size an application is 1569 compatible with. This attribute provides the required minimum 1570 "smallest screen width" (as per the -swNNNdp resource configuration) 1571 that the application can run on. For example, a typical phone 1572 screen is 320, a 7" tablet 600, and a 10" tablet 720. If the 1573 smallest screen width of the device is below the value supplied here, 1574 then the application is considered incompatible with that device. 1575 If not supplied, then any old smallScreens, normalScreens, largeScreens, 1576 or xlargeScreens attributes will be used instead. --> 1577 <attr name="requiresSmallestWidthDp" format="integer" /> 1578 <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}, 1579 this is the new way to specify the largest screens an application is 1580 compatible with. This attribute provides the maximum 1581 "smallest screen width" (as per the -swNNNdp resource configuration) 1582 that the application is designed for. If this value is smaller than 1583 the "smallest screen width" of the device it is running on, the user 1584 is offered to run it in a compatibility mode that emulates a 1585 smaller screen and zooms it to fit the screen. Currently the compatibility mode only 1586 emulates phone screens with a 320dp width, so compatibility mode is not applied if the 1587 value for compatibleWidthLimitDp is larger than 320. --> 1588 <attr name="compatibleWidthLimitDp" format="integer" /> 1589 <!-- Starting with {@link android.os.Build.VERSION_CODES#HONEYCOMB_MR2}, 1590 this is the new way to specify the screens an application is 1591 compatible with. This attribute provides the maximum 1592 "smallest screen width" (as per the -swNNNdp resource configuration) 1593 that the application can work well on. If this value is smaller than 1594 the "smallest screen width" of the device it is running on, the 1595 application will be forced in to screen compatibility mode with 1596 no way for the user to turn it off. Currently the compatibility mode only 1597 emulates phone screens with a 320dp width, so compatibility mode is not applied if the 1598 value for largestWidthLimitDp is larger than 320. --> 1599 <attr name="largestWidthLimitDp" format="integer" /> 1600 <!-- Indicates whether the application supports smaller screen form-factors. 1601 A small screen is defined as one with a smaller aspect ratio than 1602 the traditional HVGA screen; that is, for a portrait screen, less 1603 tall than an HVGA screen. In practice, this means a QVGA low 1604 density or VGA high density screen. An application that does 1605 not support small screens <em>will not be available</em> for 1606 small screen devices, since there is little the platform can do 1607 to make such an application work on a smaller screen. --> 1608 <attr name="smallScreens" format="boolean" /> 1609 <!-- Indicates whether an application supports the normal screen 1610 form-factors. Traditionally this is an HVGA normal density 1611 screen, but WQVGA low density and WVGA high density are also 1612 considered to be normal. This attribute is true by default, 1613 and applications currently should leave it that way. --> 1614 <attr name="normalScreens" format="boolean" /> 1615 <!-- Indicates whether the application supports larger screen form-factors. 1616 A large screen is defined as a screen that is significantly larger 1617 than a normal phone screen, and thus may require some special care 1618 on the application's part to make good use of it. An example would 1619 be a VGA <em>normal density</em> screen, though even larger screens 1620 are certainly possible. An application that does not support 1621 large screens will be placed as a postage stamp on such a 1622 screen, so that it retains the dimensions it was originally 1623 designed for. --> 1624 <attr name="largeScreens" format="boolean" /> 1625 <!-- Indicates whether the application supports extra large screen form-factors. --> 1626 <attr name="xlargeScreens" format="boolean" /> 1627 <!-- Indicates whether the application can resize itself to newer 1628 screen sizes. This is mostly used to distinguish between old 1629 applications that may not be compatible with newly introduced 1630 screen sizes and newer applications that should be; it will be 1631 set for you automatically based on whether you are targeting 1632 a newer platform that supports more screens. --> 1633 <attr name="resizeable" format="boolean" /> 1634 <!-- Indicates whether the application can accommodate any screen 1635 density. Older applications are assumed to not be able to, 1636 new ones able to. You can explicitly supply your abilities 1637 here. --> 1638 <attr name="anyDensity" format="boolean" /> 1639 </declare-styleable> 1640 1641 <!-- Private tag to declare system protected broadcast actions. 1642 1643 <p>This appears as a child tag of the root 1644 {@link #AndroidManifest manifest} tag. --> 1645 <declare-styleable name="AndroidManifestProtectedBroadcast" parent="AndroidManifest"> 1646 <attr name="name" /> 1647 </declare-styleable> 1648 1649 <!-- Private tag to declare the original package name that this package is 1650 based on. Only used for packages installed in the system image. If 1651 given, and different than the actual package name, and the given 1652 original package was previously installed on the device but the new 1653 one was not, then the data for the old one will be renamed to be 1654 for the new package. 1655 1656 <p>This appears as a child tag of the root 1657 {@link #AndroidManifest manifest} tag. --> 1658 <declare-styleable name="AndroidManifestOriginalPackage" parent="AndroidManifest"> 1659 <attr name="name" /> 1660 </declare-styleable> 1661 1662 <!-- The <code>provider</code> tag declares a 1663 {@link android.content.ContentProvider} class that is available 1664 as part of the package's application components, supplying structured 1665 access to data managed by the application. 1666 1667 <p>This appears as a child tag of the 1668 {@link #AndroidManifestApplication application} tag. --> 1669 <declare-styleable name="AndroidManifestProvider" parent="AndroidManifestApplication"> 1670 <!-- Required name of the class implementing the provider, deriving from 1671 {@link android.content.ContentProvider}. This is a fully 1672 qualified class name (for example, com.mycompany.myapp.MyProvider); as a 1673 short-hand if the first character of the class 1674 is a period then it is appended to your package name. --> 1675 <attr name="name" /> 1676 <attr name="label" /> 1677 <attr name="description" /> 1678 <attr name="icon" /> 1679 <attr name="banner" /> 1680 <attr name="logo" /> 1681 <attr name="process" /> 1682 <attr name="authorities" /> 1683 <attr name="syncable" /> 1684 <attr name="readPermission" /> 1685 <attr name="writePermission" /> 1686 <attr name="grantUriPermissions" /> 1687 <attr name="permission" /> 1688 <attr name="multiprocess" /> 1689 <attr name="initOrder" /> 1690 <!-- Specify whether this provider is enabled or not (that is, can be instantiated by the system). 1691 It can also be specified for an application as a whole, in which case a value of "false" 1692 will override any component specific values (a value of "true" will not override the 1693 component specific values). --> 1694 <attr name="enabled" /> 1695 <attr name="exported" /> 1696 <attr name="singleUser" /> 1697 <attr name="directBootAware" /> 1698 </declare-styleable> 1699 1700 <!-- Attributes that can be supplied in an AndroidManifest.xml 1701 <code>grant-uri-permission</code> tag, a child of the 1702 {@link #AndroidManifestProvider provider} tag, describing a specific 1703 URI path that can be granted as a permission. This tag can be 1704 specified multiple time to supply multiple paths. --> 1705 <declare-styleable name="AndroidManifestGrantUriPermission" parent="AndroidManifestProvider"> 1706 <!-- Specify a URI path that must exactly match, as per 1707 {@link android.os.PatternMatcher} with 1708 {@link android.os.PatternMatcher#PATTERN_LITERAL}. --> 1709 <attr name="path" format="string" /> 1710 <!-- Specify a URI path that must be a prefix to match, as per 1711 {@link android.os.PatternMatcher} with 1712 {@link android.os.PatternMatcher#PATTERN_PREFIX}. --> 1713 <attr name="pathPrefix" format="string" /> 1714 <!-- Specify a URI path that matches a simple pattern, as per 1715 {@link android.os.PatternMatcher} with 1716 {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}. 1717 Note that because '\' is used as an escape character when 1718 reading the string from XML (before it is parsed as a pattern), 1719 you will need to double-escape: for example a literal "*" would 1720 be written as "\\*" and a literal "\" would be written as 1721 "\\\\". This is basically the same as what you would need to 1722 write if constructing the string in Java code. --> 1723 <attr name="pathPattern" format="string" /> 1724 </declare-styleable> 1725 1726 <!-- Attributes that can be supplied in an AndroidManifest.xml 1727 <code>path-permission</code> tag, a child of the 1728 {@link #AndroidManifestProvider provider} tag, describing a permission 1729 that allows access to a specific path in the provider. This tag can be 1730 specified multiple time to supply multiple paths. --> 1731 <declare-styleable name="AndroidManifestPathPermission" parent="AndroidManifestProvider"> 1732 <attr name="path" /> 1733 <attr name="pathPrefix" /> 1734 <attr name="pathPattern" /> 1735 <attr name="permission" /> 1736 <attr name="readPermission" /> 1737 <attr name="writePermission" /> 1738 </declare-styleable> 1739 1740 <!-- The <code>service</code> tag declares a 1741 {@link android.app.Service} class that is available 1742 as part of the package's application components, implementing 1743 long-running background operations or a rich communication API 1744 that can be called by other packages. 1745 1746 <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter} 1747 tags can be included inside of a service, to specify the Intents 1748 that can connect with it. If none are specified, the service can 1749 only be accessed by direct specification of its class name. 1750 The service tag appears as a child tag of the 1751 {@link #AndroidManifestApplication application} tag. --> 1752 <declare-styleable name="AndroidManifestService" parent="AndroidManifestApplication"> 1753 <!-- Required name of the class implementing the service, deriving from 1754 {@link android.app.Service}. This is a fully 1755 qualified class name (for example, com.mycompany.myapp.MyService); as a 1756 short-hand if the first character of the class 1757 is a period then it is appended to your package name. --> 1758 <attr name="name" /> 1759 <attr name="label" /> 1760 <attr name="description" /> 1761 <attr name="icon" /> 1762 <attr name="banner" /> 1763 <attr name="logo" /> 1764 <attr name="permission" /> 1765 <attr name="process" /> 1766 <!-- Specify whether the service is enabled or not (that is, can be instantiated by the system). 1767 It can also be specified for an application as a whole, in which case a value of "false" 1768 will override any component specific values (a value of "true" will not override the 1769 component specific values). --> 1770 <attr name="enabled" /> 1771 <attr name="exported" /> 1772 <!-- If set to true, this service with be automatically stopped 1773 when the user remove a task rooted in an activity owned by 1774 the application. The default is false. --> 1775 <attr name="stopWithTask" format="boolean" /> 1776 <!-- If set to true, this service will run under a special process 1777 that is isolated from the rest of the system. The only communication 1778 with it is through the Service API (binding and starting). --> 1779 <attr name="isolatedProcess" format="boolean" /> 1780 <attr name="singleUser" /> 1781 <attr name="directBootAware" /> 1782 <!-- If the service is an {@link android.R.attr#isolatedProcess} service, this permits a 1783 client to bind to the service as if it were running it its own package. The service 1784 must also be {@link android.R.attr#exported} if this flag is set. --> 1785 <attr name="externalService" format="boolean" /> 1786 </declare-styleable> 1787 1788 <!-- The <code>receiver</code> tag declares an 1789 {@link android.content.BroadcastReceiver} class that is available 1790 as part of the package's application components, allowing the 1791 application to receive actions or data broadcast by other 1792 applications even if it is not currently running. 1793 1794 <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter} 1795 tags can be included inside of a receiver, to specify the Intents 1796 it will receive. If none are specified, the receiver will only 1797 be run when an Intent is broadcast that is directed at its specific 1798 class name. The receiver tag appears as a child tag of the 1799 {@link #AndroidManifestApplication application} tag. --> 1800 <declare-styleable name="AndroidManifestReceiver" parent="AndroidManifestApplication"> 1801 <!-- Required name of the class implementing the receiver, deriving from 1802 {@link android.content.BroadcastReceiver}. This is a fully 1803 qualified class name (for example, com.mycompany.myapp.MyReceiver); as a 1804 short-hand if the first character of the class 1805 is a period then it is appended to your package name. --> 1806 <attr name="name" /> 1807 <attr name="label" /> 1808 <attr name="description" /> 1809 <attr name="icon" /> 1810 <attr name="banner" /> 1811 <attr name="logo" /> 1812 <attr name="permission" /> 1813 <attr name="process" /> 1814 <!-- Specify whether the receiver is enabled or not (that is, can be instantiated by the system). 1815 It can also be specified for an application as a whole, in which case a value of "false" 1816 will override any component specific values (a value of "true" will not override the 1817 component specific values). --> 1818 <attr name="enabled" /> 1819 <attr name="exported" /> 1820 <attr name="singleUser" /> 1821 <attr name="directBootAware" /> 1822 </declare-styleable> 1823 1824 <!-- The <code>activity</code> tag declares an 1825 {@link android.app.Activity} class that is available 1826 as part of the package's application components, implementing 1827 a part of the application's user interface. 1828 1829 <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter} 1830 tags can be included inside of an activity, to specify the Intents 1831 that it can handle. If none are specified, the activity can 1832 only be started through direct specification of its class name. 1833 The activity tag appears as a child tag of the 1834 {@link #AndroidManifestApplication application} tag. --> 1835 <declare-styleable name="AndroidManifestActivity" parent="AndroidManifestApplication"> 1836 <!-- Required name of the class implementing the activity, deriving from 1837 {@link android.app.Activity}. This is a fully 1838 qualified class name (for example, com.mycompany.myapp.MyActivity); as a 1839 short-hand if the first character of the class 1840 is a period then it is appended to your package name. --> 1841 <attr name="name" /> 1842 <attr name="theme" /> 1843 <attr name="label" /> 1844 <attr name="description" /> 1845 <attr name="icon" /> 1846 <attr name="banner" /> 1847 <attr name="logo" /> 1848 <attr name="launchMode" /> 1849 <attr name="screenOrientation" /> 1850 <attr name="configChanges" /> 1851 <attr name="permission" /> 1852 <attr name="multiprocess" /> 1853 <attr name="process" /> 1854 <attr name="taskAffinity" /> 1855 <attr name="allowTaskReparenting" /> 1856 <attr name="finishOnTaskLaunch" /> 1857 <attr name="finishOnCloseSystemDialogs" /> 1858 <attr name="clearTaskOnLaunch" /> 1859 <attr name="noHistory" /> 1860 <attr name="alwaysRetainTaskState" /> 1861 <attr name="stateNotNeeded" /> 1862 <attr name="excludeFromRecents" /> 1863 <!-- @deprecated use {@link android.R.attr#showForAllUsers} instead. --> 1864 <attr name="showOnLockScreen" /> 1865 <!-- Specify whether the activity is enabled or not (that is, can be instantiated by the system). 1866 It can also be specified for an application as a whole, in which case a value of "false" 1867 will override any component specific values (a value of "true" will not override the 1868 component specific values). --> 1869 <attr name="enabled" /> 1870 <attr name="exported" /> 1871 <!-- Specify the default soft-input mode for the main window of 1872 this activity. A value besides "unspecified" here overrides 1873 any value in the theme. --> 1874 <attr name="windowSoftInputMode" /> 1875 <attr name="immersive" /> 1876 <attr name="hardwareAccelerated" /> 1877 <attr name="uiOptions" /> 1878 <attr name="parentActivityName" /> 1879 <attr name="singleUser" /> 1880 <!-- @hide This broadcast receiver or activity will only receive broadcasts for the 1881 system user--> 1882 <attr name="systemUserOnly" format="boolean" /> 1883 <attr name="persistableMode" /> 1884 <attr name="allowEmbedded" /> 1885 <attr name="documentLaunchMode" /> 1886 <attr name="maxRecents" /> 1887 <attr name="autoRemoveFromRecents" /> 1888 <attr name="relinquishTaskIdentity" /> 1889 <attr name="resumeWhilePausing" /> 1890 <attr name="resizeableActivity" /> 1891 <attr name="supportsPictureInPicture" /> 1892 <attr name="lockTaskMode" /> 1893 <attr name="showForAllUsers" /> 1894 <attr name="directBootAware" /> 1895 <!-- @hide This activity is always focusable regardless of if it is in a task/stack whose 1896 activities are normally not focusable. 1897 For example, {@link android.R.attr#supportsPictureInPicture} activities are placed 1898 in a task/stack that isn't focusable. This flag allows them to be focusable.--> 1899 <attr name="alwaysFocusable" format="boolean" /> 1900 <attr name="enableVrMode" /> 1901 </declare-styleable> 1902 1903 <!-- The <code>activity-alias</code> tag declares a new 1904 name for an existing {@link #AndroidManifestActivity activity} 1905 tag. 1906 1907 <p>Zero or more {@link #AndroidManifestIntentFilter intent-filter} 1908 tags can be included inside of an activity-alias, to specify the Intents 1909 that it can handle. If none are specified, the activity can 1910 only be started through direct specification of its class name. 1911 The activity-alias tag appears as a child tag of the 1912 {@link #AndroidManifestApplication application} tag. --> 1913 <declare-styleable name="AndroidManifestActivityAlias" parent="AndroidManifestApplication"> 1914 <!-- Required name of the class implementing the activity, deriving from 1915 {@link android.app.Activity}. This is a fully 1916 qualified class name (for example, com.mycompany.myapp.MyActivity); as a 1917 short-hand if the first character of the class 1918 is a period then it is appended to your package name. --> 1919 <attr name="name" /> 1920 <!-- The name of the activity this alias should launch. The activity 1921 must be in the same manifest as the alias, and have been defined 1922 in that manifest before the alias here. This must use a Java-style 1923 naming convention to ensure the name is unique, for example 1924 "com.mycompany.MyName". --> 1925 <attr name="targetActivity" format="string" /> 1926 <attr name="label" /> 1927 <attr name="description" /> 1928 <attr name="icon" /> 1929 <attr name="banner" /> 1930 <attr name="logo" /> 1931 <attr name="permission" /> 1932 <!-- Specify whether the activity-alias is enabled or not (that is, can be instantiated by the system). 1933 It can also be specified for an application as a whole, in which case a value of "false" 1934 will override any component specific values (a value of "true" will not override the 1935 component specific values). --> 1936 <attr name="enabled" /> 1937 <attr name="exported" /> 1938 <attr name="parentActivityName" /> 1939 </declare-styleable> 1940 1941 <!-- The <code>meta-data</code> tag is used to attach additional 1942 arbitrary data to an application component. The data can later 1943 be retrieved programmatically from the 1944 {@link android.content.pm.ComponentInfo#metaData 1945 ComponentInfo.metaData} field. There is no meaning given to this 1946 data by the system. You may supply the data through either the 1947 <code>value</code> or <code>resource</code> attribute; if both 1948 are given, then <code>resource</code> will be used. 1949 1950 <p>It is highly recommended that you avoid supplying related data as 1951 multiple separate meta-data entries. Instead, if you have complex 1952 data to associate with a component, then use the <code>resource</code> 1953 attribute to assign an XML resource that the client can parse to 1954 retrieve the complete data. --> 1955 <declare-styleable name="AndroidManifestMetaData" 1956 parent="AndroidManifestApplication 1957 AndroidManifestActivity 1958 AndroidManifestReceiver 1959 AndroidManifestProvider 1960 AndroidManifestService 1961 AndroidManifestPermission 1962 AndroidManifestPermissionGroup 1963 AndroidManifestInstrumentation"> 1964 <attr name="name" /> 1965 <!-- Concrete value to assign to this piece of named meta-data. 1966 The data can later be retrieved from the meta data Bundle 1967 through {@link android.os.Bundle#getString Bundle.getString}, 1968 {@link android.os.Bundle#getInt Bundle.getInt}, 1969 {@link android.os.Bundle#getBoolean Bundle.getBoolean}, 1970 or {@link android.os.Bundle#getFloat Bundle.getFloat} depending 1971 on the type used here. --> 1972 <attr name="value" format="string|integer|color|float|boolean" /> 1973 <!-- Resource identifier to assign to this piece of named meta-data. 1974 The resource identifier can later be retrieved from the meta data 1975 Bundle through {@link android.os.Bundle#getInt Bundle.getInt}. --> 1976 <attr name="resource" format="reference" /> 1977 </declare-styleable> 1978 1979 <!-- The <code>intent-filter</code> tag is used to construct an 1980 {@link android.content.IntentFilter} object that will be used 1981 to determine which component can handle a particular 1982 {@link android.content.Intent} that has been given to the system. 1983 It can be used as a child of the 1984 {@link #AndroidManifestActivity activity}, 1985 {@link #AndroidManifestReceiver receiver} and 1986 {@link #AndroidManifestService service} 1987 tags. 1988 1989 <p> Zero or more {@link #AndroidManifestAction action}, 1990 {@link #AndroidManifestCategory category}, and/or 1991 {@link #AndroidManifestData data} tags should be 1992 included inside to describe the contents of the filter. 1993 1994 <p> The optional label and icon attributes here are used with 1995 an activity to supply an alternative description of that activity 1996 when it is being started through an Intent matching this filter. --> 1997 <declare-styleable name="AndroidManifestIntentFilter" 1998 parent="AndroidManifestActivity AndroidManifestReceiver AndroidManifestService"> 1999 <attr name="label" /> 2000 <attr name="icon" /> 2001 <attr name="banner" /> 2002 <attr name="logo" /> 2003 <attr name="priority" /> 2004 <attr name="autoVerify" /> 2005 </declare-styleable> 2006 2007 <!-- Attributes that can be supplied in an AndroidManifest.xml 2008 <code>action</code> tag, a child of the 2009 {@link #AndroidManifestIntentFilter intent-filter} tag. 2010 See {@link android.content.IntentFilter#addAction} for 2011 more information. --> 2012 <declare-styleable name="AndroidManifestAction" parent="AndroidManifestIntentFilter"> 2013 <!-- The name of an action that is handled, using the Java-style 2014 naming convention. For example, to support 2015 {@link android.content.Intent#ACTION_VIEW Intent.ACTION_VIEW} 2016 you would put <code>android.intent.action.VIEW</code> here. 2017 Custom actions should generally use a prefix matching the 2018 package name. --> 2019 <attr name="name" /> 2020 </declare-styleable> 2021 2022 <!-- Attributes that can be supplied in an AndroidManifest.xml 2023 <code>data</code> tag, a child of the 2024 {@link #AndroidManifestIntentFilter intent-filter} tag, describing 2025 the types of data that match. This tag can be specified multiple 2026 times to supply multiple data options, as described in the 2027 {@link android.content.IntentFilter} class. Note that all such 2028 tags are adding options to the same IntentFilter so that, for example, 2029 <code><data android:scheme="myscheme" android:host="me.com" /></code> 2030 is equivalent to <code><data android:scheme="myscheme" /> 2031 <data android:host="me.com" /></code>. --> 2032 <declare-styleable name="AndroidManifestData" parent="AndroidManifestIntentFilter"> 2033 <!-- Specify a MIME type that is handled, as per 2034 {@link android.content.IntentFilter#addDataType 2035 IntentFilter.addDataType()}. 2036 <p><em>Note: MIME type matching in the Android framework is 2037 case-sensitive, unlike formal RFC MIME types. As a result, 2038 MIME types here should always use lower case letters.</em></p> --> 2039 <attr name="mimeType" format="string" /> 2040 <!-- Specify a URI scheme that is handled, as per 2041 {@link android.content.IntentFilter#addDataScheme 2042 IntentFilter.addDataScheme()}. 2043 <p><em>Note: scheme matching in the Android framework is 2044 case-sensitive, unlike the formal RFC. As a result, 2045 schemes here should always use lower case letters.</em></p> --> 2046 <attr name="scheme" format="string" /> 2047 <!-- Specify a URI scheme specific part that must exactly match, as per 2048 {@link android.content.IntentFilter#addDataSchemeSpecificPart 2049 IntentFilter.addDataSchemeSpecificPart()} with 2050 {@link android.os.PatternMatcher#PATTERN_LITERAL}. --> 2051 <attr name="ssp" format="string" /> 2052 <!-- Specify a URI scheme specific part that must be a prefix to match, as per 2053 {@link android.content.IntentFilter#addDataSchemeSpecificPart 2054 IntentFilter.addDataSchemeSpecificPart()} with 2055 {@link android.os.PatternMatcher#PATTERN_PREFIX}. --> 2056 <attr name="sspPrefix" format="string" /> 2057 <!-- Specify a URI scheme specific part that matches a simple pattern, as per 2058 {@link android.content.IntentFilter#addDataSchemeSpecificPart 2059 IntentFilter.addDataSchemeSpecificPart()} with 2060 {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}. 2061 Note that because '\' is used as an escape character when 2062 reading the string from XML (before it is parsed as a pattern), 2063 you will need to double-escape: for example a literal "*" would 2064 be written as "\\*" and a literal "\" would be written as 2065 "\\\\". This is basically the same as what you would need to 2066 write if constructing the string in Java code. --> 2067 <attr name="sspPattern" format="string" /> 2068 <!-- Specify a URI authority host that is handled, as per 2069 {@link android.content.IntentFilter#addDataAuthority 2070 IntentFilter.addDataAuthority()}. 2071 <p><em>Note: host name matching in the Android framework is 2072 case-sensitive, unlike the formal RFC. As a result, 2073 host names here should always use lower case letters.</em></p> --> 2074 <attr name="host" format="string" /> 2075 <!-- Specify a URI authority port that is handled, as per 2076 {@link android.content.IntentFilter#addDataAuthority 2077 IntentFilter.addDataAuthority()}. If a host is supplied 2078 but not a port, any port is matched. --> 2079 <attr name="port" format="string" /> 2080 <!-- Specify a URI path that must exactly match, as per 2081 {@link android.content.IntentFilter#addDataPath 2082 IntentFilter.addDataPath()} with 2083 {@link android.os.PatternMatcher#PATTERN_LITERAL}. --> 2084 <attr name="path" /> 2085 <!-- Specify a URI path that must be a prefix to match, as per 2086 {@link android.content.IntentFilter#addDataPath 2087 IntentFilter.addDataPath()} with 2088 {@link android.os.PatternMatcher#PATTERN_PREFIX}. --> 2089 <attr name="pathPrefix" /> 2090 <!-- Specify a URI path that matches a simple pattern, as per 2091 {@link android.content.IntentFilter#addDataPath 2092 IntentFilter.addDataPath()} with 2093 {@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB}. 2094 Note that because '\' is used as an escape character when 2095 reading the string from XML (before it is parsed as a pattern), 2096 you will need to double-escape: for example a literal "*" would 2097 be written as "\\*" and a literal "\" would be written as 2098 "\\\\". This is basically the same as what you would need to 2099 write if constructing the string in Java code. --> 2100 <attr name="pathPattern" /> 2101 </declare-styleable> 2102 2103 <!-- Attributes that can be supplied in an AndroidManifest.xml 2104 <code>category</code> tag, a child of the 2105 {@link #AndroidManifestIntentFilter intent-filter} tag. 2106 See {@link android.content.IntentFilter#addCategory} for 2107 more information. --> 2108 <declare-styleable name="AndroidManifestCategory" parent="AndroidManifestIntentFilter"> 2109 <!-- The name of category that is handled, using the Java-style 2110 naming convention. For example, to support 2111 {@link android.content.Intent#CATEGORY_LAUNCHER Intent.CATEGORY_LAUNCHER} 2112 you would put <code>android.intent.category.LAUNCHER</code> here. 2113 Custom actions should generally use a prefix matching the 2114 package name. --> 2115 <attr name="name" /> 2116 </declare-styleable> 2117 2118 <!-- Attributes that can be supplied in an AndroidManifest.xml 2119 <code>instrumentation</code> tag, a child of the root 2120 {@link #AndroidManifest manifest} tag. --> 2121 <declare-styleable name="AndroidManifestInstrumentation" parent="AndroidManifest"> 2122 <!-- Required name of the class implementing the instrumentation, deriving from 2123 {@link android.app.Instrumentation}. This is a fully 2124 qualified class name (for example, com.mycompany.myapp.MyActivity); as a 2125 short-hand if the first character of the class 2126 is a period then it is appended to your package name. --> 2127 <attr name="name" /> 2128 <attr name="targetPackage" /> 2129 <attr name="label" /> 2130 <attr name="icon" /> 2131 <attr name="banner" /> 2132 <attr name="logo" /> 2133 <attr name="handleProfiling" /> 2134 <attr name="functionalTest" /> 2135 </declare-styleable> 2136 2137 <!-- Attributes that can be supplied in an AndroidManifest.xml 2138 <code>screen</code> tag, a child of <code>compatible-screens</code>, 2139 which is itself a child of the root 2140 {@link #AndroidManifest manifest} tag. --> 2141 <declare-styleable name="AndroidManifestCompatibleScreensScreen" 2142 parent="AndroidManifest.AndroidManifestCompatibleScreens"> 2143 <!-- Specifies a compatible screen size, as per the device 2144 configuration screen size bins. --> 2145 <attr name="screenSize"> 2146 <!-- A small screen configuration, at least 240x320dp. --> 2147 <enum name="small" value="200" /> 2148 <!-- A normal screen configuration, at least 320x480dp. --> 2149 <enum name="normal" value="300" /> 2150 <!-- A large screen configuration, at least 400x530dp. --> 2151 <enum name="large" value="400" /> 2152 <!-- An extra large screen configuration, at least 600x800dp. --> 2153 <enum name="xlarge" value="500" /> 2154 </attr> 2155 <!-- Specifies a compatible screen density, as per the device 2156 configuration screen density bins. --> 2157 <attr name="screenDensity" format="integer"> 2158 <!-- A low density screen, approximately 120dpi. --> 2159 <enum name="ldpi" value="120" /> 2160 <!-- A medium density screen, approximately 160dpi. --> 2161 <enum name="mdpi" value="160" /> 2162 <!-- A high density screen, approximately 240dpi. --> 2163 <enum name="hdpi" value="240" /> 2164 <!-- An extra high density screen, approximately 320dpi. --> 2165 <enum name="xhdpi" value="320" /> 2166 <!-- An extra extra high density screen, approximately 480dpi. --> 2167 <enum name="xxhdpi" value="480" /> 2168 <!-- An extra extra extra high density screen, approximately 640dpi. --> 2169 <enum name="xxxhdpi" value="640" /> 2170 </attr> 2171 </declare-styleable> 2172 2173 <!-- The <code>input-type</code> tag is a child of the <code>supports-input</code> tag, which 2174 is itself a child of the root {@link #AndroidManifest manifest} tag. Each 2175 <code>input-type</code> tag specifices the name of a specific input device type. When 2176 grouped with the other elements of the parent <code>supports-input</code> tag it defines 2177 a collection of input devices, which when all used together, are considered a supported 2178 input mechanism for the application. There may be multiple <code>supports-input</code> 2179 tags defined, each containing a different combination of input device types. --> 2180 <declare-styleable name="AndroidManifestSupportsInputInputType" 2181 parent="AndroidManifest.AndroidManifestSupportsInput"> 2182 <!-- Specifices the name of the input device type --> 2183 <attr name="name" /> 2184 </declare-styleable> 2185 2186 <!-- The attribute that holds a Base64-encoded public key. --> 2187 <attr name="publicKey" format="string" /> 2188 2189 <!-- Attributes relating to a package verifier. --> 2190 <declare-styleable name="AndroidManifestPackageVerifier" parent="AndroidManifest"> 2191 <!-- Specifies the Java-style package name that defines this 2192 package verifier. --> 2193 <attr name="name" /> 2194 2195 <!-- The Base64 encoded public key of the package verifier's 2196 signature. --> 2197 <attr name="publicKey" /> 2198 </declare-styleable> 2199 2200 <!-- Attributes relating to resource overlay packages. --> 2201 <declare-styleable name="AndroidManifestResourceOverlay" parent="AndroidManifest"> 2202 <!-- Package name of base package whose resources will be overlaid. --> 2203 <attr name="targetPackage" /> 2204 2205 <!-- Load order of overlay package. --> 2206 <attr name="priority" /> 2207 2208 </declare-styleable> 2209 2210 <!-- Declaration of an {@link android.content.Intent} object in XML. May 2211 also include zero or more {@link #IntentCategory <category> and 2212 {@link #Extra <extra>} tags. --> 2213 <declare-styleable name="Intent"> 2214 <!-- The action name to assign to the Intent, as per 2215 {@link android.content.Intent#setAction Intent.setAction()}. --> 2216 <attr name="action" format="string" /> 2217 <!-- The data URI to assign to the Intent, as per 2218 {@link android.content.Intent#setData Intent.setData()}. 2219 <p><em>Note: scheme and host name matching in the Android framework is 2220 case-sensitive, unlike the formal RFC. As a result, 2221 URIs here should always be normalized to use lower case letters 2222 for these elements (as well as other proper Uri normalization).</em></p> --> 2223 <attr name="data" format="string" /> 2224 <!-- The MIME type name to assign to the Intent, as per 2225 {@link android.content.Intent#setType Intent.setType()}. 2226 <p><em>Note: MIME type matching in the Android framework is 2227 case-sensitive, unlike formal RFC MIME types. As a result, 2228 MIME types here should always use lower case letters.</em></p> --> 2229 <attr name="mimeType" /> 2230 <!-- The package part of the ComponentName to assign to the Intent, as per 2231 {@link android.content.Intent#setComponent Intent.setComponent()}. --> 2232 <attr name="targetPackage" /> 2233 <!-- The class part of the ComponentName to assign to the Intent, as per 2234 {@link android.content.Intent#setComponent Intent.setComponent()}. --> 2235 <attr name="targetClass" format="string" /> 2236 </declare-styleable> 2237 2238 <!-- A category to add to an Intent, as per 2239 {@link android.content.Intent#addCategory Intent.addCategory()}. --> 2240 <declare-styleable name="IntentCategory" parent="Intent"> 2241 <!-- Required name of the category. --> 2242 <attr name="name" /> 2243 </declare-styleable> 2244 2245 <!-- An extra data value to place into a an extra/name value pair held 2246 in a Bundle, as per {@link android.os.Bundle}. --> 2247 <declare-styleable name="Extra" parent="Intent"> 2248 <!-- Required name of the extra data. --> 2249 <attr name="name" /> 2250 <!-- Concrete value to put for this named extra data. --> 2251 <attr name="value" /> 2252 </declare-styleable> 2253 2254 <!-- Groups signing keys into a {@code KeySet} for easier reference in 2255 other APIs. However, currently no APIs use this. --> 2256 <attr name="keySet" /> 2257 <declare-styleable name="AndroidManifestPublicKey"> 2258 <attr name="name" /> 2259 <attr name="value" /> 2260 </declare-styleable> 2261 <declare-styleable name="AndroidManifestKeySet"> 2262 <attr name="name" /> 2263 </declare-styleable> 2264 2265 <!-- Associate declared KeySets with upgrading capability. --> 2266 <declare-styleable name="AndroidManifestUpgradeKeySet" parent="AndroidManifest"> 2267 <attr name="name" /> 2268 </declare-styleable> 2269 2270 <!-- <code>layout</code> tag allows configuring the layout for the activity within multi-window 2271 environment. --> 2272 <declare-styleable name="AndroidManifestLayout" parent="AndroidManifestActivity"> 2273 <!-- Default width of the activity. Can be either a fixed value or fraction, in which case 2274 the width will be constructed as a fraction of the total available width. --> 2275 <attr name="defaultWidth" format="dimension|fraction" /> 2276 <!-- Default height of the activity. Can be either a fixed value or fraction, in which case 2277 the height will be constructed as a fraction of the total available height. --> 2278 <attr name="defaultHeight" format="dimension|fraction" /> 2279 <!-- Where to initially position the activity inside the available space. Uses constants 2280 defined in {@link android.view.Gravity}. --> 2281 <attr name="gravity" /> 2282 <!-- Minimal width of the activity. 2283 2284 <p><strong>NOTE:</strong> A task's root activity value is applied to all additional 2285 activities launched in the task. That is if the root activity of a task set minimal width, 2286 then the system will set the same minimal width on all other activities in the task. It 2287 will also ignore any other minimal width attributes of non-root activities. --> 2288 <attr name="minWidth" /> 2289 <!-- @removed --> 2290 <attr name="minimalWidth" format="dimension" /> 2291 <!-- Minimal height of the activity. 2292 2293 <p><strong>NOTE:</strong> A task's root activity value is applied to all additional 2294 activities launched in the task. That is if the root activity of a task set minimal height, 2295 then the system will set the same minimal height on all other activities in the task. It 2296 will also ignore any other minimal height attributes of non-root activities. --> 2297 <attr name="minHeight" /> 2298 <!-- @removed --> 2299 <attr name="minimalHeight" format="dimension" /> 2300 </declare-styleable> 2301 2302 <!-- <code>restrict-update</code> tag restricts system apps from being updated unless the 2303 SHA-512 hash equals the specified value. 2304 @hide --> 2305 <declare-styleable name="AndroidManifestRestrictUpdate" parent="AndroidManifest"> 2306 <!-- The SHA-512 hash of the only APK that can be used to update a package. 2307 <p>NOTE: This is only applicable to system packages. 2308 @hide --> 2309 <attr name="hash" format="string" /> 2310 </declare-styleable> 2311 2312</resources> 2313