阿里Android开发规范：资源文件命名与使用规范

以下内容摘自 阿里巴巴Android开发手册

我们的目标是：

• 防患未然，提升质量意识，降低故障率和维护成本；
• 标准统一，提升协作效率；
• 追求卓越的工匠精神，打磨精品代码。
• 【强制】必须遵守，违反本约定或将会引起严重的后果；
• 【推荐】尽量遵守，长期遵守有助于系统稳定性和合作效率的提升；
• 【参考】充分理解，技术意识的引导，是个人学习、团队沟通、项目合作的方向。

阿里Android开发规范：资源文件命名与使用规范
阿里Android开发规范：四大基本组件
阿里Android开发规范：UI 与布局
阿里Android开发规范：进程、线程与消息通信
阿里Android开发规范：文件与数据库
阿里Android开发规范：Bitmap、Drawable 与动画
阿里Android开发规范：安全与其他

1、【推荐】资源文件需带模块前缀。
2、【推荐】layout 文件的命名方式。

Activity 的 layout 以 module_activity 开头
Fragment 的 layout 以 module_fragment 开头
Dialog   的 layout 以 module_dialog 开头
include  的 layout 以 module_include 开头
ListView 的 item layout 以 module_list_item 开头
GridView 的 item layout 以 module_grid_item 开头
RecyclerView 的 item layout 以 module_recycle_item 开头

3、【推荐】 drawable 资源名称以小写单词+下划线的方式命名，根据分辨率不同存放在不同的 drawable 目录下，建议只使用一套,例如 drawable-xhdpi。采用规则如下:

模块名_业务功能描述_控件描述_控件状态限定词
如：module_login_btn_pressed,module_tabs_icon_home_normal

4、【推荐】anim 资源名称以小写单词+下划线的方式命名，采用以下规则：

模块名_逻辑名称_[方向|序号]
tween 动 画 资 源 ： 尽 可 能 以 通 用 的 动 画 名 称 命 名 ， 
如 module_fade_in , module_fade_out , module_push_down_in (动画+方向)；
frame 动画资源：尽可能以模 块+功能命名+序号。
如：module_loading_grey_001

5、【推荐】color 资源使用#AARRGGBB 格式，写入 module_colors.xml 文件中，命名格式采用以下规则：

模块名_逻辑名称_颜色
如： <color name="module_btn_bg_color">#33b5e5e5</color>

6、【推荐】dimen 资源以小写单词+下划线方式命名，写入 module_dimens.xml 文件中，采用以下规则：

模块名_描述信息
如： <dimen name="module_horizontal_line_height">1dp</dimen>

7、【推荐】style 资源采用小写单词+下划线方式命名，写入 module_styles.xml 文件中，采用以下规则：

父 style 名称.当前 style 名称
如：  <style name="ParentTheme.ThisActivityTheme">
		…
	  </style>

8、【推荐】string资源文件或者文本用到字符需要全部写入module_strings.xml文件中，字符串以小写单词+下划线的方式命名，采用以下规则：

模块名_逻辑名称
如：moudule_login_tips,module_homepage_notice_desc

9、【推荐】Id 资源原则上以驼峰法命名，View 组件的资源 id 需要以 View 的缩写作为前缀。常用缩写表如下：

其它控件的缩写推荐使用小写字母并用下划线进行分割，例如： ProgressBar 对应的缩写为 progress_bar DatePicker 对应的缩写为 date_picker

10、【推荐】大分辨率图片（单维度超过 1000）大分辨率图片建议统一放在 xxhdpi 目录下管理，否则将导致占用内存成倍数增加。 说明： 为了支持多种屏幕尺寸和密度，Android 为多种屏幕提供不同的资源目录进行适配。为不同屏幕密度提供不同的位图可绘制对象，可用于密度特定资源的配置限定符（在下面详述） 包括 ldpi（低）、mdpi（中）、 hdpi（高）、xhdpi（超高）、xxhdpi （超超高）和 xxxhdpi（超超超高）。例如，高密度屏幕的位图应使用 drawable-hdpi/。根据当前的设备屏幕尺寸和密度，将会寻找最匹配的资源，如果将高分辨率图片放入低密度目录，将会造成低端机加载过大图片资源，又可能造成 OOM，同时也是资源浪费，没有必要在低端机使用大图。 正例： 将 144144 的应用图标 PNG 文件放在 drawable-xxhdpi 目录 反例： 将 144144 的应用图标 PNG 文件放在 drawable-mhdpi 目录 扩展参考： https://developer.android.com/guide/practices/screens_support.html?hl=zh-cn

阿里Android开发规范：资源文件命名与使用规范
阿里Android开发规范：四大基本组件
阿里Android开发规范：UI 与布局 阿里Android开发规范：进程、线程与消息通信
阿里Android开发规范：文件与数据库
阿里Android开发规范：Bitmap、Drawable 与动画
阿里Android开发规范：安全与其他