Android规范文档

android手机常见分辨率：800*480（854*480），960*540，1280*720（1280*800），1920*1080

dpi：mdpi160，hdpi240，xhdpi320，xxhdpi480，xxxhdpi640

sp和px的换算公式：分辨率为800*480时：1sp=1dp=1.5px分辨率为720*1280时：1sp=1dp=2px

操作栏图标：64，48，32，24

通知图标：24

小/语境图标：16

button：40

可触摸的ui组件：48

ui元素之间的间距：8

（参见http://keeganlee.me/post/android/20150709）

包名：

域名反写+项目名称+模块名称，全部单词用小写字母

类和接口命名：

使用大驼峰规则，用名词或名词词组命名，每个单词的首字母大写。以下为几种常用类的命名形式：

activity：命名以activity为后缀，如：loginactivityfragment：命名以fragment为后缀，如：sharedialogfragmentservice：命名以service为后缀，如：downloadserviceadapter：命名以adapter为后缀，如：couponlistadapter工具类：命名以util为后缀，如：encryptutil模型类：命名以bo为后缀，如：couponbo接口实现类：命名以impl为后缀，如：apiimpl

方法命名：

使用小驼峰规则，用动词命名，第一个单词的首字母小写，其他单词的首字母大写。以下为几种常用方法的命名：

初始化方法，命名以init开头，例：initview按钮点击方法，命名以to开头，例：tologin设置方法，命名以set开头，例：setdata具有返回值的获取方法，命名以get开头，例：getdata通过异步加载数据的方法，命名以load开头，例：loaddata布尔型的判断方法，命名以is或has，或具有逻辑意义的单词如equals，例：isempty

控件缩写：

常量命名：

全部为大写单词，单词之间用下划线分开

变量命名：

{范围描述+}意义描述+类型描述的组合，用驼峰式，首字母小写

eg：privatetextviewheadertitletxt;//标题栏的标题

控件id命名：

控件缩写_{范围_}意义，范围可选，只在有明确定义的范围内才需要加上

eg：android:id="@+id/txt_header_title"

layout命名：

组件类型_{范围_}功能，范围可选，只在有明确定义的范围内才需要加上

activity_{范围_}功能，为activity的命名格式fragment_{范围_}功能，为fragment的命名格式dialog_{范围_}功能，为dialog的命名格式item_list_{范围_}功能，为listview的item命名格式item_grid_{范围_}功能，为gridview的item命名格式header_list_{范围_}功能，为listview的headerview命名格式footer_list_{范围_}功能，为listview的footerview命名格式

strings命名：

类型_{范围_}功能

页面标题：title_页面按钮文字：btn_按钮事件标签文字：label_标签文字选项卡文字：tab_选项卡文字消息框文字：toast_消息编辑框的提示文字：hint_提示信息图片的描述文字：desc_图片文字对话框的文字：dialog_文字menu的item文字：action_文字

color命名：

直接用颜色英文名命名，注释标注使用位置

drawable资源命名：

前缀{_控件}{_范围}{_后缀}

图标类，添加ic前缀背景类，添加bg前缀分隔类，添加div前缀默认类，添加def前缀区分状态时，默认状态，添加normal后缀区分状态时，按下时的状态，添加pressed后缀区分状态时，选中时的状态，添加selected后缀区分状态时，不可用时的状态，添加disable后缀多种状态的，添加selector后缀（一般为listview的selector或按钮的selector）

动画文件命名：

动画类型_动画方向。

fade_in，淡入fade_out，淡出push_down_in，从下方推入push_down_out，从下方推出slide_in_from_top，从头部滑动进入zoom_enter，变形进入shrink_to_middle，中间缩小

文件头注释：

文件顶部统一添加版权声明，声明的格式如下：

/***copyright(c)2015.keegan小钢inc.allrightsreserved.*/

类和接口注释：

类和接口统一添加javadoc注释，格式如下：

/***类或接口的描述信息**@author${user}*@date${date}*/

方法注释：

下面几种方法，都必须添加javadoc注释，说明该方法的用途和参数说明，以及返回值的说明

接口中定义的所有方法抽象类中自定义的抽象方法抽象父类的自定义公用方法工具类的公用方法

变量和常量注释：

下面几种情况下的常量和变量，都要添加注释说明，优先采用右侧//来注释，若注释说明太长则在上方添加注释

接口中定义的所有常量公有类的公有常量枚举类定义的所有枚举常量实体类的所有属性变量

法的第一条逻辑语句之间、常量和变量间

当一个表达式无法容纳在一行内时，可换行显示，另起的新行用8个空格缩进

范围型的常量用枚举类定义，而不要直接用整型或字符，这样可以减少范围值的有效性检查

文字大小的单位统一用sp，元素大小的单位统一用dp

应用中的字符串统一在strings.xml中定义，然后在代码和布局文件中引用