Android 编程 设计规范

Android 编程 设计规范

命名规范

1.包名:  组件的根包名为“hance”,包名继承android的包的命名规范，

             如：android.widget则改为hance.widget

2.类名:  自定义控件的类名前面统一加上“C”，如果是继承重写控件，则C+控件类名

             如：重写android.widget.Buttom则命名为Cbutton，其他的类名，如适配器或服务类，可不加C

3.方法:  每个控件最好都实现父控件的所有构造函数

4.属性：只要在android范围内的类（指跟android有关的类，像uitl类和dao类便是这个范围之外，属性统一不加m），内部的属性都统一在前面加“m”，这样做的好处是可以区别方法内定义的变量跟类的属性。特别注意一点，在写属性的get跟set存取器时，m要去掉。如mButton->(getButton(),setButton())。

l监听器规范

1.存放路径:所有监听器都放在hance.widget.CListener类文件中，以方便共享使用

2.命名规范: I + On +名称+ Listener，其中，加I是为了避免跟系统的监听器冲突

                  如：IonItemClickListener

3.使用规范:如果在某个类中要使用到监听器（比较典型的例子是Activity类中要设置Button的监听器），建议让该类实现该监听器的接口，    然后在该类的方法中实现监听器的实现代码。如btn.setOnClickListener(this)。

l日志输出规范

1. 日志总共分五个等级，平时在调试的时候不要贪图方便随便定义日志的等级。建议不重要的信息定义在debug等级或者info等级，较为严重的情况把日志定义的warn等级和error等级。正常情况下尽量不使用System.out.println();作为日志的输出。为了查看方便，建议多增加几个日志的查看规则，以方便查看日志。

2. 假如某个类中要使用到日志的输出或调试，统一在类的声明后面（即第一个属性的位置）加上“Private static final String TAG = “类名”;”这句话，输出日志的时候便可使用Log.e(TAG, “content”)进行输出。

lhance.activity包
1. 所有控件的例子都放在该包中，其中Main.java为默认启动类，通过该类的导航，可以导航到任意一个Activity的例子，详情请看Main中的注释
2. 每新增一个新的控件，都必须在该包内新增一个例子作为使用的教程，方便交流和使用

lhance.util包
1. 该包主要用来保存一些常用的工具类，如字符串的转换，日期转换，单位转换等常用的操作，都封装好一个类放到该包中

l文件命名规范
1.res/layout文件夹命名规范：统一用小写和下划线"_"组合命名，建议xml文件加个前缀以便区分，如对话框的xml配置文件:dlg_name.xml;

2.res/drawable文件命名规范：统一用小写加下划线“_”组合命名，同上，每个资源文件最好加个前缀以便区分，如:btn_01_default.png,btn_01_pressed.png,btn_01.xml;