[djubinville]

Code snippets are for:

• https://developer.android.com/topic/architecture/views/resources/providing-resources-views
• https://developer.android.com/topic/architecture/views/resources/runtime-changes-views
• https://developer.android.com/topic/architecture/views/resources/localization-views
• https://developer.android.com/topic/architecture/views/resources/string-resource-views

Companion DAC CL: cl/1000932997

views/src/main/res/values/strings.xml declares untagged supporting resources (R.string.hello, R.string.world, R.string.welcome_messages, R.string.title, R.array.planets_array, R.plurals.numberOfSongsAvailable, and <item name="permanent_marker" type="font" /> for R.font.permanent_marker) because the tagged Kotlin regions in StringResourceViews.kt (android_resources_string_views_get_string, android_resources_string_views_get_string_array, android_resources_string_views_get_quantity_string, android_resources_string_views_format_string, android_resources_string_views_from_html, android_resources_string_views_html_encode, android_resources_string_views_spannable_chain, and android_resources_string_views_annotation_typeface) reference those resource IDs and cannot compile without them (D27). Note on D11 bypass: <item name="permanent_marker" type="font" /> is retained as a compilation stand-in for R.font.permanent_marker (android_resources_string_views_annotation_typeface) so :views:compileDebugKotlin succeeds without committing a binary .ttf/.otf font file into views/src/main/res/font/.

List of modifications:

File	Function/Snippet	Description of change	Reason for change
RuntimeChangesViews.kt	android_resources_runtime_changes_views_keyboard	Swapped Configuration.KEYBOARDHIDDEN_YES and Configuration.KEYBOARDHIDDEN_NO branches so KEYBOARDHIDDEN_NO displays "Keyboard available" and KEYBOARDHIDDEN_YES displays "No keyboard"	D24: Fixes inverted boolean logic in the original documentation where KEYBOARDHIDDEN_YES ("hardware keyboard is hidden") toasted "Keyboard available" and KEYBOARDHIDDEN_NO ("hardware keyboard is not hidden") toasted "No keyboard".

• Providing-resources-views page: Extracted the ArrayAdapter Kotlin snippet into views/src/main/java/com/example/example/snippet/views/resources/ProvidingResourcesViews.kt (android_resources_providing_views_list_adapter).
• Runtime-changes-views page: Extracted the onConfigurationChanged Kotlin snippet into views/src/main/java/com/example/example/snippet/views/resources/RuntimeChangesViews.kt (android_resources_runtime_changes_views_keyboard), fixed inverted KEYBOARDHIDDEN_NO / KEYBOARDHIDDEN_YES branches (D24), and added a trailing full stop to the inline comment (D29).
• Localization-views page: Extracted the primary locale lookup Kotlin snippet into views/src/main/java/com/example/example/snippet/views/resources/LocalizationViews.kt (android_resources_localization_views_primary_locale).
• String-resource-views page: Extracted all 12 Kotlin snippets into views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt (android_resources_string_views_get_string, android_resources_string_views_get_string_array, android_resources_string_views_get_quantity_string, android_resources_string_views_format_string, android_resources_string_views_from_html, android_resources_string_views_html_encode, android_resources_string_views_spannable_helpers, android_resources_string_views_spannable_styles, android_resources_string_views_spannable_chain, android_resources_string_views_annotation_typeface, android_resources_string_views_annotation_parcel_send, and android_resources_string_views_annotation_parcel_receive), stripped inline HTML <code><a href="..."> link markup from <pre> blocks (android_resources_string_views_get_string, android_resources_string_views_get_string_array, android_resources_string_views_get_quantity_string, and android_resources_string_views_html_encode), added trailing full stops to natural-language comments (D29), and formatted with Spotless.

Snippets not migrated:

• Providing-resources-views page: Directory tree listings (lines 33–47 and 190–198); two findViewById / getString example blocks inside <section> tabs (lines 650–653 and 688–706) left hardcoded with SNIPPET_GITHUB because they reference 8 hypothetical resources across 4 resource types (R.id.myimageview, R.drawable.myimage, R.drawable.my_background_image, R.string.main_title, R.layout.main_screen, R.anim.hyperspace_in, R.id.msg, R.string.hello_message) not defined on the page (D1 / D11 — unlike the migrated ArrayAdapter block which uses platform android.R.layout.simple_list_item_1 and a single <string-array name="planets_array"> resource); obsolete Java duplicates (lines 657–661, 710–728, and 887–889, removed per D15); and short XML View layout fragments (<merge>, <Button>, <EditText>) and resource/alias syntax examples (<drawable>, <color>/<string>, <bitmap>) left hardcoded on the guide page (D1).
• Runtime-changes-views page: Lines 165–177 obsolete Java duplicate (removed per D15).
• Localization-views page: Lines 109–112 obsolete Java duplicate (removed per D15).
• String-resource-views page: All 12 obsolete Java duplicates (removed per D15); <dl class="xml"> syntax templates containing HTML anchor tags (<string>, <string-array>, <plurals>); <TextView> View layout XML fragment (D1); and <string>, <string-array>, and <plurals> XML resource example blocks left hardcoded with SNIPPET_GITHUB because each block is a complete standalone <?xml version="1.0" encoding="utf-8"?><resources>...</resources> file template (including a localized res/values-pl/strings.xml Polish variant) that cannot be nested inside the module's single views/src/main/res/values/strings.xml <resources> root without omitting the XML declaration and <resources> wrapper shown on the page.

[snippet-bot]

Here is the summary of changes.

You are about to add 15 region tags.

• views/src/main/java/com/example/example/snippet/views/resources/LocalizationViews.kt:23, tag android_resources_localization_views_primary_locale
• views/src/main/java/com/example/example/snippet/views/resources/ProvidingResourcesViews.kt:29, tag android_resources_providing_views_list_adapter
• views/src/main/java/com/example/example/snippet/views/resources/RuntimeChangesViews.kt:24, tag android_resources_runtime_changes_views_keyboard
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:47, tag android_resources_string_views_get_string
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:53, tag android_resources_string_views_get_string_array
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:59, tag android_resources_string_views_get_quantity_string
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:66, tag android_resources_string_views_format_string
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:72, tag android_resources_string_views_from_html
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:79, tag android_resources_string_views_html_encode
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:87, tag android_resources_string_views_spannable_helpers
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:133, tag android_resources_string_views_spannable_styles
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:155, tag android_resources_string_views_spannable_chain
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:166, tag android_resources_string_views_annotation_typeface
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:203, tag android_resources_string_views_annotation_parcel_send
• views/src/main/java/com/example/example/snippet/views/resources/StringResourceViews.kt:216, tag android_resources_string_views_annotation_parcel_receive

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[djubinville]

Addressed review feedback on PR #1194 and companion CL cl/1000932997:

1. Must Fix (D24 — RuntimeChangesViews.kt L29–33): Swapped the Configuration.KEYBOARDHIDDEN_YES and Configuration.KEYBOARDHIDDEN_NO branches in android_resources_runtime_changes_views_keyboard so KEYBOARDHIDDEN_NO ("hardware keyboard is not hidden") displays "Keyboard available" and KEYBOARDHIDDEN_YES ("hardware keyboard is hidden") displays "No keyboard", and added the D24 modification table to the PR description.
2. Warning 1 (Phase 4 CL Description): Updated cl/1000932997's description to use PR: https://github.com/android/snippets/pull/1194, added the pre-merge staging note, and preserved the -------------- (KEEP THIS LINE) --- delimiter and triage metadata.
3. Warnings 3 & 4 (Snippets not migrated: clarifications): Updated Snippets not migrated: in the PR description with the concrete technical reasons why:
   • The two findViewById / getString blocks on providing-resources-views.md (lines 650–653 and 688–706) were left hardcoded with SNIPPET_GITHUB: they reference 8 hypothetical resources across 4 resource types (R.id.myimageview, R.drawable.myimage, R.drawable.my_background_image, R.string.main_title, R.layout.main_screen, R.anim.hyperspace_in, R.id.msg, R.string.hello_message) not defined on the page (D1 / D11), whereas the migrated ArrayAdapter block uses platform android.R.layout.simple_list_item_1 and a single <string-array name="planets_array"> resource.
   • The <string>, <string-array>, and <plurals> XML example blocks on string-resource-views.md were left hardcoded with SNIPPET_GITHUB: each block is a complete standalone <?xml version="1.0" encoding="utf-8"?><resources>...</resources> file template (including a localized res/values-pl/strings.xml Polish variant) that cannot be nested inside the module's single views/src/main/res/values/strings.xml <resources> root without omitting the XML declaration and <resources> wrapper shown on the page.

Documented Rule Bypasses & Rulebook Recommendations

• D11 bypass (views/src/main/res/values/strings.xml — <item name="permanent_marker" type="font" />): Bypassed D11 ("Do not use <item type="..."> stand-in declarations in strings.xml as a shortcut when a real resource file or entry should exist") to retain <item name="permanent_marker" type="font" /> for R.font.permanent_marker (android_resources_string_views_annotation_typeface in StringResourceViews.kt), as accepted in the review with D27 disclosure in the PR description, avoiding committing a binary .ttf/.otf font file into views/src/main/res/font/. Rulebook update recommendation: Update D11 / D27 to explicitly allow <item type="font" /> stand-in declarations in res/values/strings.xml (with D27 disclosure) when a snippet references a custom R.font.* resource and adding a binary font file is undesirable.