Android-Code-Style

1. 约定

2. 命名

2.1. 布局文件中的id命名

规则:使用驼峰命名,前缀+逻辑名称,类变量名和布局文件id名称保持一致,不需要下划线分割

控件 缩写前缀
TextView/EditText text
ImageView img
Button/RadioButton/ImageButton btn
RelativeLayout/LinearLayout/FrameLayout layout
ListView listView
WebView webView
CheckBox checkBox
ProgressBar progressBar
seekBar seekBar
其他控件 控件名首字母缩写作为前缀

2.2. 布局文件命名

规则: 使用前缀_逻辑名称命名,单词全部小写,单词间以 下划线 分割。

布局类型 布局前缀
Activity activity_
Fragment fragment_
Include include_
Dialog dialog_
PopupWindow popup_
Menu menu_
Adapter layout_item_

2.3. 资源文件命名

规则: 使用 前缀_用途 命名,单词全部小写,单词间以 下划线 分割。

前缀 说明
bg_xxx 各类背景图片
btn_xxx 这种按钮没有其他状态
ic_xxx 图标,一般用于单个图标
bg_描述_状态1[_状态2] 用于控件上的不同状态
btn_描述_状态1[_状态2] 用于按钮上的不同状态
chx_描述_状态1[_状态2] 选择框,一般有2态和4态
必须携带第三方资源前缀
umeng_socialize_style.xml
pull_refresh_attrs.xml

2.4. 类和接口命名

规则: 使用驼峰规则,首字母必须大写,使用名词或名词词组。要求简单易懂,富于描述,不允许出现无意义或错误单词。

描述 例如
Application类 Application为后缀标识 XXXApplication
Activity类 Activity为后缀标识 闪屏页面类SplashActivity
解析类 Handler为后缀标识
公共方法类 Utils或Manager为后缀标识
线程池管理类 ThreadPoolManager
日志工具类 LogUtils
数据库类 以DBHelper后缀标识 MySQLiteDBHelper
Service类 以Service为后缀标识 播放服务:PlayService
BroadcastReceiver类 以Broadcast为后缀标识 时间通知:TimeBroadcast
ContentProvider类 以Provider为后缀标识 单词内容提供者:DictProvider
直接写的共享基础类 以Base为前缀 BaseActivity,BaseFragment

2.5. 方法的命名

规则: 使用驼峰规则,首字母必须小写,使用动词。要求简单易懂,富于描述,不允许出现无意义或错误单词。

方法 说明
initXX() 初始化相关方法,使用init为前缀标识,如初始化布局initView()
httpXX() http业务请求方法,以http为前缀标识
getXX() 返回某个值的方法,使用get为前缀标识
saveXX() 与保存数据相关的,使用save为前缀标识
deleteXX() 删除操作
resetXX() 对数据重组的,使用reset前缀标识
clearXX() 清除数据相关的
isXX() 方法返回值为boolean型的请使用is或check为前缀标识
processXX() 对数据进行处理的方法,尽量使用process为前缀标识
displayXX() 弹出提示框和提示信息,使用display为前缀标识
drawXXX() 绘制数据或效果相关的,使用draw前缀标识

2.6. 变量命名

规则: 使用驼峰规则,首字母必须小写,使用名词或名词词组。要求简单易懂,富于描述,不允许出现无意义或错误单词。

3. 其他规范

4. IDE

5. Libraries

Base

UI

View project on GitHub