Android 资源管理全解析:Color、String、Style、Dimen、Array
1. 资源(Resource)概述
在 Android 开发中,资源文件(res/values 目录)用于存储 颜色、文本、样式、尺寸、数组 等 非代码 内容,便于:
- 统一管理 UI 风格,增强可维护性
- 支持 多语言(国际化)
- 适配 不同屏幕密度、尺寸、模式(夜间模式等)
- 提高应用的 复用性和灵活性
2. 颜色资源(Color)
2.1 定义颜色(colors.xml)
颜色资源用于 定义 UI 组件的颜色 ,可存储在 res/values/colors.xml
:
xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- 基础颜色 -->
<color name="black">#000000</color>
<color name="white">#FFFFFF</color>
<!-- 主题颜色 -->
<color name="primary">#6200EE</color>
<color name="primaryVariant">#3700B3</color>
<color name="secondary">#03DAC6</color>
<!-- 自定义动态色彩 -->
<color name="md_theme_light_primary">#6750A4</color>
<color name="md_theme_dark_primary">#D0BCFF</color>
</resources>
2.2 颜色的引用
(1) 在 XML 布局中
ini
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textColor="@color/primary" />
(2) 在 styles.xml
bash
<item name="android:textColor">@color/primary</item>
(3) 在 Kotlin 代码中
scss
val color = ContextCompat.getColor(context, R.color.primary)
textView.setTextColor(color)
2.3 适配夜间模式(values-night/colors.xml)
xml
<resources>
<color name="primary">#BB86FC</color> <!-- 夜间模式颜色 -->
</resources>
3. 字符串资源(String)
3.1 定义字符串(strings.xml)
字符串资源存放在 res/values/strings.xml
,用于 文本国际化、多语言适配:
xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name">My Material3 App</string>
<string name="hello_world">Hello, Material3!</string>
<!-- 带格式参数 -->
<string name="welcome_message">Welcome, %1$s!</string>
<!-- HTML 富文本 -->
<string name="html_text"><![CDATA[<b>Bold Text</b>]]></string>
</resources>
3.2 字符串的引用
(1) 在 XML 布局中
ini
xml复制编辑<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/hello_world" />
(2) 在 Kotlin 代码中
ini
val welcome = getString(R.string.welcome_message, "Alice")
(3) 支持多语言
在 res/values-es/strings.xml
定义西班牙语:
xml
<resources>
<string name="hello_world">¡Hola, Material3!</string>
</resources>
4. 样式资源(Style)
4.1 定义样式(styles.xml)
styles.xml
允许 复用 UI 属性,减少代码冗余:
xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- 自定义按钮样式 -->
<style name="CustomButton" parent="Widget.Material3.Button">
<item name="android:backgroundTint">@color/primary</item>
<item name="android:textColor">@color/white</item>
</style>
</resources>
4.2 样式的引用
(1) 在 XML 布局中
ini
<Button
style="@style/CustomButton"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Click Me" />
(2) 主题(Theme)
themes.xml
设定全局主题:
xml
<style name="Theme.MaterialTest" parent="Theme.Material3.Light.NoActionBar">
<item name="colorPrimary">@color/primary</item>
<item name="android:buttonStyle">@style/CustomButton</item>
</style>
(3) 在代码中应用
css
button.setTextAppearance(R.style.CustomButton)
5. 尺寸资源(Dimen)
5.1 定义尺寸(dimens.xml)
dimens.xml
用于定义 像素、dp、sp、pt 等尺寸:
xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<dimen name="padding_small">8dp</dimen>
<dimen name="padding_medium">16dp</dimen>
<dimen name="text_size_large">24sp</dimen>
</resources>
5.2 尺寸的引用
(1) 在 XML 布局中
ini
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textSize="@dimen/text_size_large"
android:padding="@dimen/padding_medium" />
(2) 在 Kotlin 代码中
scss
val padding = resources.getDimension(R.dimen.padding_small)
textView.setPadding(padding.toInt(), padding.toInt(), padding.toInt(), padding.toInt())
5.3 适配不同屏幕密度
values-sw600dp/dimens.xml
:适配 大屏values-land/dimens.xml
:适配 横屏
6. 数组资源(Array)
6.1 定义数组(arrays.xml)
arrays.xml
用于存储 字符串、颜色或整数数组:
xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- 字符串数组 -->
<string-array name="fruit_array">
<item>Apple</item>
<item>Banana</item>
<item>Cherry</item>
</string-array>
<!-- 颜色数组 -->
<array name="color_array">
<item>@color/primary</item>
<item>@color/secondary</item>
</array>
</resources>
6.2 数组的引用
(1) 在 Kotlin 代码中
ini
复制编辑val fruits = resources.getStringArray(R.array.fruit_array)
val colors = resources.obtainTypedArray(R.array.color_array)
(2) 在 Spinner 中
ini
<Spinner
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:entries="@array/fruit_array" />
7. 总结与优化建议
- Color :定义在
colors.xml
,配合 夜间模式 使用values-night/colors.xml
- String:所有文本集中管理,支持多语言
- Style:提高 UI 复用性,避免重复代码
- Dimen:统一管理尺寸,支持不同屏幕适配
- Array:用于存储列表数据,如 Spinner 下拉项
掌握 color、string、style、dimen、array
资源管理,让你的 Android 代码更整洁、易维护,并支持 Material3 最新特性! 🚀