安卓编码规范.doc

安卓编程规范
包
包命名全部采用小写,不用下划线区分单词
主包名采用[公司性质].[公司名称].[项目名称]的命名方式
例如:.
通用功能子包名采用[主包名].[通用名称]的命名方式
常见通用功能如下表:
包名
含义
[主包名].main
基础Activity及入口Activity所在的包
[主包名].util
通用工具类所在的包
[主包名].view
自定义View所在的包
[主包名].db
数据库操作相关所在的包
[主包名].pref
首选项
[主包名].provider
内容提供者所在的包
[主包名].receiver
广播接收器所在的包
[主包名].service
后台服务所在的包
一般功能子包名采用[主包名].[模块名称].[子模块名称]的命名方式
例如:
.
只需导入用到的类,不得用*导入包下所有类
导入类时,系统类在上方,自定义类在下方
代码
代码主要采用大/小驼峰命名法,即除首字母外,每个单词首字母大写,整体首字母大小根据其它规范决定
类名、接口名、枚举名等首字母大写,若由多个单词组成,则其后每个单词首字母大写
例如:
class ConfigManager{}
接口一般使用able、ible、er等作为后缀
例如:
interface Observable{}
继承自安卓组件的类,采用父类名作为后缀
例如:
class LoginActivity extends Activity{}
自定义异常必须以Exception结尾
除for循环变量外,一律不得使用i、j、k等单字符作为变量名
定义数组时方括号紧随在原始类型之后,数组名称一般使用复数形式
例如:
int[] arrays;
常量、枚举等均采用大写形式,用下划线区分各单词
例如:
final static int DIALOG_ID_ALARM = 1;
enum Season{SPRING, SUMMER, AUTUMN, WINTER};
全局变量添加所有者前缀:实例成员变量前缀m(表示member),类
静态变量前缀s(表示static)
例如:
实例变量mRun
类静态变量sInstance
控件变量添加组件前缀,顺序在所有者前缀之后
例如:
全局名称mBtnNext
局部名称btnNext
常见控件前缀如下表:
缩写
全称
含义
缩写
全称
含义
alc
AnalogClock
模拟时钟
rdo
RadioButton
单选按钮
btn
Button
按钮
rtb
RatingBar
评分条
cal
CalendarView
日历
scr
ScrollView
滚动框
chb
CheckBox
复选框
sdr
SlidingDrawer
滑动抽屉
chm
Chronometer
秒表
sfc
SurfaceView
表面视图
dgc
DigitalClock
数字时钟
skb
SeekBar
进度条
dpk
DatePicker
日期选择器
spn
Spinner
下拉框
edt
Ed