Android资源文件命名规范

时间:2022-10-20 13:06:17

在复杂Android应用的开发中,资源文件的规范命名非常重要,能帮助设计人员和开发人员减小沟通成本。资源的名字尽量力求准确,可以适当长一些,但换回的价值是值得的。

关于WCC的Android开发,资源文件命名规范(v_0.1版)如下:

根据Android官方SDK显示:资源文件只能以小写字母下划线做首字母,随后的字符只能在[a-z0-9_.]中选择。

1. 图片资源 (设计人员和开发人员)

对于通用的图片资源,采用格式:缩写_描述[_状态]

缩写

全称

职能

备注意见

ic_描述

icon

用于信息展示,不关联任何点击属性。如app的图标,llistivew上的小图标。

 

bg_描述

background

用于布局和子布局的背景,布局层级较为偏向底层,一般比较大。

 

bg_描述_状态1 [_状态2]

background

再资源文件和Java中一般不会直接引用,而是通过定义”slector”文件的方式引用,实现动态变换的效果,

 

btn_描述

button

用于任何能响应用户点击的view,而且这种按钮没有其他的状态

 

btn_描述_状态1 [_状态2]

button

主要用于表示按钮和listview的不同状态,一般通过selector方式进行引用,一般有三种状态或者六种状态。_pressed, _focused, _selected, _checked, _enabled, _window_focused. (见补充说明)

 

chx_描述

checkbox

用于展示check box的自定义背景

 

chx_描述_状态1 [_状态2]

checkbox

check box选择框,一般有2态和4态

 

spr_描述

spinner

下拉列表的子项

 

spr_描述_状态1 [_状态2]

spinner

下拉列表的子项的显示状态

 

     

     

如果某些图片资源并不通用,只在特定的页面中使用,则可采用格式:缩写_页面_描述[_状态]。

如果图片资源有很多套风格,采用格式:缩写_style_页面_描述[_状态],将style放到相当高的层级,是为了能在整个应用中进行风格统一。

待考虑问题:诸如menu这样功能属性过强的字段是不是合适放到通用的图片描述里。

1. 自定义图层资源(程序开发人员)

缩写

职能

备注意见

layout_

   

dialog_

   

list