android中values的良好实践

最新推荐文章于 2025-03-13 13:57:44 发布

原创最新推荐文章于 2025-03-13 13:57:44 发布 · 1.8k 阅读

1 ·

CC 4.0 BY-SA版权

本文分享了如何通过规范使用Android项目的values文件来提高代码质量和可维护性，包括字符串、颜色值、尺寸和样式的命名及组织建议。

初衷

在我的项目中，使用values文件并不很规范，为了规范values的使用，特参考开源项目（oschina，iosched，androidCleanArchitecture，androidBestPractices，MPAndroidChart），学习借鉴优秀开源代码的values使用经验，提高代码规范性。

string

分为公共区和模块区
模块里的，按照模块名＋功能名方式命名
最好加注释

color

分为常用（公共）颜色值和模块颜色值
公共颜色值以颜色值命名
模块颜色值以模块名加功能命名
oschina，iosched这两个项目，命名也有不利于维护的地方swiperefresh_color1，theme_accent_1，这点不值得借鉴

dimens

分为公共字体大小，常用边距，和模块用的dimens

公共字体大小命名

<!-- App Primary Text Sizes -->
<dimen name="app_text_size_xsmall">11sp</dimen>
<dimen name="app_text_size_small">12sp</dimen>
<dimen name="app_text_size_medium">14sp</dimen>
<dimen name="app_text_size_large">18sp</dimen>
<dimen name="app_text_size_xlarge">20sp</dimen>
<dimen name="app_text_size_diff_large_small">6sp</dimen>

公共间距命名

<!-- standard metrics -->
<dimen name="spacing_normal">8dp</dimen>
<dimen name="spacing_micro">4dp</dimen>
<dimen name="padding_normal">16dp</dimen>

模块dimens 命名方式，模块名＋功能

styles

和text相关的样式比较少
命名方式为主题＋功能，中间用“.”分隔
字体styles一般仅定义颜色和字体大小