| <?xml version="1.0" encoding="utf-8"?> |
| <!-- |
| Exposing a new resource: |
| To add a new entry, find the corresponding "staging-public-group" with the correct type for |
| your resource, and add a new entry to the BOTTOM of the list. This ensures that indexes |
| don't shift for previously added resources, and the new one will be appended to the end. |
| |
| To add R.attr.exampleAttrName: |
| <staging-public-group type="attr" first-id="0x1ff0000"> |
| <public name="previouslyAdded1"/> |
| <public name="previouslyAdded2"/> |
| <public name="exampleAttrName"/> |
| </staging-public-group> |
| |
| Deleting a resource: |
| If a resource is no longer supported/used, it can be marked removed by renaming the |
| resource with a `removed_` prefix. This preserves the indexes of other resources so as not |
| to break apps that have compiled with their integers previously. |
| |
| To remove R.attr.previouslyAdded2: |
| <staging-public-group type="attr" first-id="0x1ff0000"> |
| <public name="previouslyAdded1"/> |
| <public name="removed_previouslyAdded2"/> |
| <public name="exampleAttrName"/> |
| </staging-public-group> |
| |
| IMPORTANT: Deleting an entry is never allowed, even across branches or reverts. Please take |
| this into account before merging a change which edits this file. Small, isolated changes |
| which only add/remove resources is recommended to avoid reverts due to build/test failures. |
| |
| Renaming a resource: |
| This is generally fine and can be done to the entry directly, with no other changes. But |
| note that any apps/tooling that resolve against resource names rather than IDs may break |
| as a result. This is uncommon, but not rare. |
| |
| Finalizing a release's resources: |
| 1. $ANDROID_BUILD_TOP/frameworks/base/tools/aapt2/tools/finalize_res.py \ |
| $ANDROID_BUILD_TOP/frameworks/base/core/res/res/values/public-staging.xml \ |
| $ANDROID_BUILD_TOP/frameworks/base/core/res/res/values/public-final.xml |
| 2. Rename "NEXT" in the new public-staging.xml resources header to the next platform short |
| version code |
| |
| Finalizing a release's resources (manually; only for reference): |
| 1. Delete all "staging-public-group" blocks for the release with no entries inside them |
| 2. Rename the remaining "staging-public-group" blocks for that release to |
| "staging-public-group-final" |
| 3. Cut them out this file and place at the bottom of public-final.xml; also move the |
| "Resources added in version ? of the platform" header |
| 4. Copy-paste all of the non-"removed_" resources outside of the staging blocks into being |
| siblings alongside them |
| 5. Assign them final public IDs in the form of |
| <public type="attr" name="exampleAttrName" id="0x0101088a" /> |
| by finding the last ID for that type and incrementing the last 4 characters by 1 in |
| hexadecimal |
| 6. Back in this file, seed the next release's resources by adding "staging-public-group" |
| tags with their "first-id" value shifted by -0x00010000 from the lowest "first-id" |
| in the last used "staging-public-group-final" |
| |
| Example: |
| Starting public-staging.xml: |
| <!\- =============================================================== |
| Resources added in version ? of the platform |
| =============================================================== -\> |
| <eat-comment /> |
| |
| <staging-public-group type="attr" first-id="0x01ff0000"> |
| <public name="exampleAttr1"/> |
| <public name="removed_exampleAttr2"/> |
| <public name="exampleAttr3"/> |
| </staging-public-group> |
| |
| <staging-public-group type="id" first-id="0x01fe0000"> |
| </staging-public-group> |
| |
| Resulting public-final.xml: |
| <!\- =============================================================== |
| Resources added in version ? of the platform |
| =============================================================== -\> |
| <eat-comment /> |
| |
| <staging-public-group-final type="attr" first-id="0x01ff0000"> |
| <public name="exampleAttr1"/> |
| <public name="removed_exampleAttr2"/> |
| <public name="exampleAttr3"/> |
| </staging-public-group-final> |
| |
| <public type="id" name="exampleAttr1" id="0x0101088a"/> |
| <public type="id" name="exampleAttr3" id="0x0101088b"/> |
| |
| Resulting public-staging.xml: |
| <!\- =============================================================== |
| Resources added in version (? + 1) of the platform |
| =============================================================== -\> |
| <eat-comment /> |
| |
| <staging-public-group type="attr" first-id="0x01fd0000"> |
| </staging-public-group> |
| |
| <staging-public-group type="id" first-id="0x01fc0000"> |
| </staging-public-group> |
| --> |
| <resources> |
| |
| <!-- =============================================================== |
| Resources added in version U of the platform |
| |
| NOTE: After this version of the platform is forked, changes cannot be made to the root |
| branch's groups for that release. Only merge changes to the forked platform branch. |
| =============================================================== --> |
| <eat-comment/> |
| |
| <staging-public-group type="attr" first-id="0x01ce0000"> |
| <public name="handwritingBoundsOffsetLeft" /> |
| <public name="handwritingBoundsOffsetTop" /> |
| <public name="handwritingBoundsOffsetRight" /> |
| <public name="handwritingBoundsOffsetBottom" /> |
| <public name="accessibilityDataSensitive" /> |
| <public name="enableTextStylingShortcuts" /> |
| <public name="requiredDisplayCategory"/> |
| <public name="removed_maxConcurrentSessionsCount" /> |
| <public name="visualQueryDetectionService" /> |
| <public name="physicalKeyboardHintLanguageTag" /> |
| <public name="physicalKeyboardHintLayoutType" /> |
| <public name="allowSharedIsolatedProcess" /> |
| <public name="keyboardLocale" /> |
| <public name="keyboardLayoutType" /> |
| <public name="allowUpdateOwnership" /> |
| <public name="isCredential"/> |
| <public name="searchResultHighlightColor" /> |
| <public name="focusedSearchResultHighlightColor" /> |
| <public name="stylusHandwritingSettingsActivity" /> |
| <public name="windowNoMoveAnimation" /> |
| </staging-public-group> |
| |
| <staging-public-group type="id" first-id="0x01cd0000"> |
| <public name="bold" /> |
| <public name="italic" /> |
| <public name="underline" /> |
| <public name="accessibilityActionScrollInDirection" /> |
| </staging-public-group> |
| |
| <staging-public-group type="style" first-id="0x01cc0000"> |
| </staging-public-group> |
| |
| <staging-public-group type="string" first-id="0x01cb0000"> |
| <!-- @hide @SystemApi --> |
| <public name="config_systemWearHealthService" /> |
| <!-- @hide @SystemApi --> |
| <public name="config_defaultNotes" /> |
| <!-- @hide @SystemApi --> |
| <public name="config_systemFinancedDeviceController" /> |
| <!-- @hide @SystemApi --> |
| <public name="config_systemCallStreaming" /> |
| </staging-public-group> |
| |
| <staging-public-group type="dimen" first-id="0x01ca0000"> |
| <!-- @hide @SystemApi --> |
| <public name="config_viewConfigurationHandwritingGestureLineMargin" /> |
| </staging-public-group> |
| |
| <staging-public-group type="color" first-id="0x01c90000"> |
| <public name="system_primary_container_light" /> |
| <public name="system_on_primary_container_light" /> |
| <public name="system_primary_light" /> |
| <public name="system_on_primary_light" /> |
| <public name="system_secondary_container_light" /> |
| <public name="system_on_secondary_container_light" /> |
| <public name="system_secondary_light" /> |
| <public name="system_on_secondary_light" /> |
| <public name="system_tertiary_container_light" /> |
| <public name="system_on_tertiary_container_light" /> |
| <public name="system_tertiary_light" /> |
| <public name="system_on_tertiary_light" /> |
| <public name="system_background_light" /> |
| <public name="system_on_background_light" /> |
| <public name="system_surface_light" /> |
| <public name="system_on_surface_light" /> |
| <public name="system_surface_container_low_light" /> |
| <public name="system_surface_container_lowest_light" /> |
| <public name="system_surface_container_light" /> |
| <public name="system_surface_container_high_light" /> |
| <public name="system_surface_container_highest_light" /> |
| <public name="system_surface_bright_light" /> |
| <public name="system_surface_dim_light" /> |
| <public name="system_surface_variant_light" /> |
| <public name="system_on_surface_variant_light" /> |
| <public name="system_outline_light" /> |
| <public name="system_error_light" /> |
| <public name="system_on_error_light" /> |
| <public name="system_error_container_light" /> |
| <public name="system_on_error_container_light" /> |
| <public name="system_primary_fixed_light" /> |
| <public name="system_primary_fixed_dim_light" /> |
| <public name="system_on_primary_fixed_light" /> |
| <public name="system_on_primary_fixed_variant_light" /> |
| <public name="system_secondary_fixed_light" /> |
| <public name="system_secondary_fixed_dim_light" /> |
| <public name="system_on_secondary_fixed_light" /> |
| <public name="system_on_secondary_fixed_variant_light" /> |
| <public name="system_tertiary_fixed_light" /> |
| <public name="system_tertiary_fixed_dim_light" /> |
| <public name="system_on_tertiary_fixed_light" /> |
| <public name="system_on_tertiary_fixed_variant_light" /> |
| <public name="system_control_activated_light" /> |
| <public name="system_control_normal_light" /> |
| <public name="system_control_highlight_light" /> |
| <public name="system_text_primary_inverse_light" /> |
| <public name="system_text_secondary_and_tertiary_inverse_light" /> |
| <public name="system_text_primary_inverse_disable_only_light" /> |
| <public name="system_text_secondary_and_tertiary_inverse_disabled_light" /> |
| <public name="system_text_hint_inverse_light" /> |
| <public name="system_palette_key_color_primary_light" /> |
| <public name="system_palette_key_color_secondary_light" /> |
| <public name="system_palette_key_color_tertiary_light" /> |
| <public name="system_palette_key_color_neutral_light" /> |
| <public name="system_palette_key_color_neutral_variant_light" /> |
| <public name="system_primary_container_dark"/> |
| <public name="system_on_primary_container_dark"/> |
| <public name="system_primary_dark"/> |
| <public name="system_on_primary_dark"/> |
| <public name="system_secondary_container_dark"/> |
| <public name="system_on_secondary_container_dark"/> |
| <public name="system_secondary_dark"/> |
| <public name="system_on_secondary_dark"/> |
| <public name="system_tertiary_container_dark"/> |
| <public name="system_on_tertiary_container_dark"/> |
| <public name="system_tertiary_dark"/> |
| <public name="system_on_tertiary_dark"/> |
| <public name="system_background_dark"/> |
| <public name="system_on_background_dark"/> |
| <public name="system_surface_dark"/> |
| <public name="system_on_surface_dark"/> |
| <public name="system_surface_container_low_dark"/> |
| <public name="system_surface_container_lowest_dark"/> |
| <public name="system_surface_container_dark"/> |
| <public name="system_surface_container_high_dark"/> |
| <public name="system_surface_container_highest_dark"/> |
| <public name="system_surface_bright_dark"/> |
| <public name="system_surface_dim_dark"/> |
| <public name="system_surface_variant_dark"/> |
| <public name="system_on_surface_variant_dark"/> |
| <public name="system_outline_dark"/> |
| <public name="system_error_dark"/> |
| <public name="system_on_error_dark"/> |
| <public name="system_error_container_dark"/> |
| <public name="system_on_error_container_dark"/> |
| <public name="system_primary_fixed_dark"/> |
| <public name="system_primary_fixed_dim_dark"/> |
| <public name="system_on_primary_fixed_dark"/> |
| <public name="system_on_primary_fixed_variant_dark"/> |
| <public name="system_secondary_fixed_dark"/> |
| <public name="system_secondary_fixed_dim_dark"/> |
| <public name="system_on_secondary_fixed_dark"/> |
| <public name="system_on_secondary_fixed_variant_dark"/> |
| <public name="system_tertiary_fixed_dark"/> |
| <public name="system_tertiary_fixed_dim_dark"/> |
| <public name="system_on_tertiary_fixed_dark"/> |
| <public name="system_on_tertiary_fixed_variant_dark"/> |
| <public name="system_control_activated_dark"/> |
| <public name="system_control_normal_dark"/> |
| <public name="system_control_highlight_dark"/> |
| <public name="system_text_primary_inverse_dark"/> |
| <public name="system_text_secondary_and_tertiary_inverse_dark"/> |
| <public name="system_text_primary_inverse_disable_only_dark"/> |
| <public name="system_text_secondary_and_tertiary_inverse_disabled_dark"/> |
| <public name="system_text_hint_inverse_dark"/> |
| <public name="system_palette_key_color_primary_dark"/> |
| <public name="system_palette_key_color_secondary_dark"/> |
| <public name="system_palette_key_color_tertiary_dark"/> |
| <public name="system_palette_key_color_neutral_dark"/> |
| <public name="system_palette_key_color_neutral_variant_dark"/> |
| <public name="system_primary_fixed" /> |
| <public name="system_primary_fixed_dim" /> |
| <public name="system_on_primary_fixed" /> |
| <public name="system_on_primary_fixed_variant" /> |
| <public name="system_secondary_fixed" /> |
| <public name="system_secondary_fixed_dim" /> |
| <public name="system_on_secondary_fixed" /> |
| <public name="system_on_secondary_fixed_variant" /> |
| <public name="system_tertiary_fixed" /> |
| <public name="system_tertiary_fixed_dim" /> |
| <public name="system_on_tertiary_fixed" /> |
| <public name="system_on_tertiary_fixed_variant" /> |
| <public name="system_outline_variant_light" /> |
| <public name="system_outline_variant_dark" /> |
| </staging-public-group> |
| |
| <staging-public-group type="array" first-id="0x01c80000"> |
| </staging-public-group> |
| |
| <staging-public-group type="drawable" first-id="0x01c70000"> |
| </staging-public-group> |
| |
| <staging-public-group type="layout" first-id="0x01c60000"> |
| </staging-public-group> |
| |
| <staging-public-group type="anim" first-id="0x01c50000"> |
| </staging-public-group> |
| |
| <staging-public-group type="animator" first-id="0x01c40000"> |
| </staging-public-group> |
| |
| <staging-public-group type="interpolator" first-id="0x01c30000"> |
| </staging-public-group> |
| |
| <staging-public-group type="mipmap" first-id="0x01c20000"> |
| </staging-public-group> |
| |
| <staging-public-group type="integer" first-id="0x01c10000"> |
| </staging-public-group> |
| |
| <staging-public-group type="transition" first-id="0x01c00000"> |
| </staging-public-group> |
| |
| <staging-public-group type="raw" first-id="0x01bf0000"> |
| </staging-public-group> |
| |
| <staging-public-group type="bool" first-id="0x01be0000"> |
| <!-- @hide @SystemApi --> |
| <public name="config_safetyProtectionEnabled" /> |
| <!-- @hide @SystemApi --> |
| <public name="config_enableDefaultNotes" /> |
| <!-- @hide @SystemApi --> |
| <public name="config_enableDefaultNotesForWorkProfile" /> |
| </staging-public-group> |
| |
| <staging-public-group type="fraction" first-id="0x01bd0000"> |
| </staging-public-group> |
| |
| </resources> |