android 编码规范

无规矩不成方圆，尤为是在团队开发中，没有规范的代码风格各异，既不利于代码的阅读和维护，也会下降整个团度的开发效率，下降代码的质量。关于android的编码规范，其实规则都已经比较成熟，这里总结一下个人开发经历，做为专栏的一个开头！

命名规范

1. 包命名及分包结构规范

   • 包名沿用Java编程的通用风格

2. 类命名规范

   • 基本的类名沿用Java编程的通用风格（采用完整的英文描述符，全部单词第一个字母大写，采用驼峰式命名）

   • android特有的类，如Activity、Fragment、Service、Provider、Adapter、View等，则以对应的类型单词为后缀

3. 接口命名规范

   • 类命名以大写字母I为前缀，若是是监听接口以Listener结尾

   • 在自定义的监听接口里，监听事件以on开头,如onOpenMenu(), onRefresh()...

4. 方法命名规范

   • 方法命名沿用Java编程的通用风格（采用完整的英文描述符，函数名字以表明函数功能的英文单词组成，除首单词小写，其余单词首字母大写；通常的，函数第一个单词要求用动词）

5. 变量命名规范

   • boolean成员要以is开头，或以has开头。如： isFirst, hasMore

   • 控件命名规范： 原则是“view的缩写 + 功能描述”。 好比一个TextView缩写为tv(驼峰命名抽取出来的缩写)， 这个TextView是显示用户名字的， 因此就能够命名为: tvUserName。

   • 常量的名字所有大写，单词之间用’_’分开

   • 控件命名规范： 原则是“view的缩写 + 功能描述”。 好比一个TextView缩写为tv(驼峰命名抽取出来的缩写)， 这个TextView是显示用户名字的， 因此就能够命名为:tvUserName

TextView : tv	EditText : et	Button : btn	ImageButton : ib
ImageView : iv	CheckBox : cb	RadioButton : rb	ProgressBar : pb
Seekbar : sb	ScrollView : sv	ListView : lv	GridView : gv
WebView : wv	ViewPager : vp	ExpandableListView : elv

格式规范

1. 注释规范

   • 文件头注释（文件要加文件头）

     /** * @author xxxx * @date xxxx年xx月xx日 * Copyright xxxx. All rights reserved. */复制代码

   • 类／接口注释(必须注明类／接口的编写目的、用途)

     /** * 类或接口的做用描述 * @author XXX<email> * @version xxxx-xx-xx（xxxx-xx-xx为年月日) * Copyright XXXX. All rights reserved. */复制代码

   • 方法头注释

     /** * 方法的描述 * @param 参数的描述 * @return 返回类型的描述 * @exception 异常信息的描述 */复制代码

   • 方法体注释

     使用"//"进行注释，注释的内容包括：

     • 控制流结构说明
     • 变量说明
     • 复杂代码说明
     • 处理顺序说明

2. 空行使用规范

   • package和import之间要空一行

   • 给不一样功能的代码块之间加上空行， 提高可读性

3. 括弧使用规范

   • 括号沿用Java风格，即左弧号{是在方法声明这一行，而不是C++式的另起一行

   • 即便只有一行内容， if/else/for/while等条件或循环，都要加上大括号{ }

4. 代码位置放置规范

   • Activity以onCreate()做为第一个方法， 其它类以构造函数作为第一个方法。 提升可读性

   • 功能上相近，有调用关系的函数尽可能紧挨在一块儿

   • Activity、Fragment这些android里面具有生命周期的类，尽可能把生命周期的方法按顺序排到一块儿，提升可读性

   • 内部类／接口建议统一放在文件的开头或者结尾

优化

1. 尽可能不要有重复代码。 一发现有重复代码，就要进行重构，抽取出一个公有类/方法

2. 有大量if/else时，考虑下有无可能用策略模式、模板方法模式、面向接口编程来消除这种大量的if/else

3. 一个JavaBean类， 好比就是存一些数据的一个Response类，若是是要开放一个成员给别人用， 这个成员又有getter，又有setter， 那就直接声明为public。

4. layout文件中， 层数不要过多， 尽可能控制在6层之内。 固然，层数越少越好。

5. 对于一个布局文件中的控件具有大量相同的属性的时候，考虑将这些共同属性提取称为style进行使用

6. 写布局文件须要观察布局的效果的时候，使用tools:xxx，不要直接使用android:xxx

7. 对于activity中经常使用的本身定义的initView、initData这些方法抽象出来放到对应的基类当中

8. 在设计某些功能、逻辑复杂的类或模块的时候，建议另外写一份设计文档，方便后人理解。

适配

1. 长宽用dp作单位， 通常不推荐用px。 若是有特殊理由， 能够用px。 好比UED同窗要求一条分隔线就只有1px宽

接下来本身会坚持写专栏，既是对本身学到的东西的总结， 也是跟你们一块儿分享学习。欢迎你们关注。个人我的主页是浅唱android，个人文章也会在上面发布。谢谢你们宝贵的时间！