阿里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

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

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

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 的缩写作为前缀。常用缩写表如下：

控件	缩写
LinearLayout	ll
RelativeLayout	rl
ConstraintLayout	cl
ListView	lv
ScollView	sv
TextView	tv
Button	btn
ImageView	iv
CheckBox	cb
RadioButton	rb
EditText	et

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

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

更多相关文章

随机推荐