[Android] Android Developing Guideline

命名规范

包命名

规则：包名全部小写，采用反域名命名规则，一级包名是顶级域名，通常为com, edu, gov, net, org等，二级包名，通过为公司名或部门名或者个人名，三级包名通常为项目名，四级包名为模块名或者层级名。以下是从层级包名来划分android项目中采用的包划分结构

com.domain.xxx.activity  //用户界面中所有的Activity类
com.domain.xxx.fragment  //界面中所有的Fragment类
com.domain.xxx.adapter   //界面中所有的Adapter类（适配器类）
com.domain.xxx.view      //自定义的View类
com.domain.xxx.service   //后台Service类
com.domain.xxx.util      //项目中常用的公共工具类（网络, IO, 日志等）
com.domain.xxx.bean      //实体模型类
com.domain.xxx.db        //数据库操作相关的类
com.domain.xxx.config    //所有的配置相关的类
com.domain.xxx.api       //网络api接口相关de 类

类命名

规则：采用大驼峰式命名法，首字母大写，尽量避免缩写，除非该缩写是众所周知的，比如HTML，URL,如果类名称包含单词缩写，则单词缩写的每个字母均应大写。以下列举的是android中几种最为常用的类的命名。

class LoginActivity;     //activity类
class DiscoverFragment;  //fragment类
class AnalysisService;   //service类
class WakeupRankAdapter; //adapter类
class StringUtils;       //工具类
class UserBean;          //模型类
class ApiImpl;           //接口实现类

接口命名

规则：命名规则与类命名一样采用大驼峰式命名法，首字母大写，多以able, ible, er结尾

interface Comparable;
interface Accessible;
interface OnClickListener;

方法

规则：采用小驼峰命名法，首字母小写，方法名采用动词或动名词结构。方法的命名应该与方法的真正行为具有对应关系，下面给出一些方法名的动词前缀标示的建议。

变量

规则：采用小驼峰命名法，首字母小写。变量名应简短且能描述其用途，尽量避免拼音，无意义地缩写。除非是临时变量，否则不建议使用单个字符的变量名，如i, j, k。对于变量命名，还有一种风格是google的以字母m为前缀（m为member缩写），在android 源码中随处可见。

private int userName;  //java的一般性风格
private int mUserName; //google的成员变量风格，m为member的缩写

常量

规则：常量使用全大写字母加下划线的方式命名。

public static final int TAG= "tag";
public static final int START_CLASS_NOT_FOUND = -2;

下面介绍的与android关系更加紧密：

控件变量名

规则：首先需要满足第5条变量的规则， 模式：逻辑名 + view缩写

Button sendNewsBtn;
TextView passwordTxt;

控件id

规则：view缩写_模块名_逻辑名

android:id="@+id/btn_news_send"  //样例

view缩写如下：

资源文件名

layout的文件命名

规则：全部小写，采用下划线命名法。layout文件命名：组件类型_{模块_}功能.xml

activity_news_title.xml //样例

drawable的文件命名

模式：前缀{_控件}{_范围}{_后缀}，控件、范围、后缀可选

bg_login_pressed.png //样例

动画的文件命名

规则：{范围_}动画类型_动画方向。

login_fade_in.xml //样例

资源内的name命名

strings.xml

模式：activity名_{范围_}逻辑名

<string name="login_username">用户名</string> //样例

colors.xml

模式：前缀{_控件}{_范围}{_后缀}， 控件、范围、后缀可选，

<color name="bg_login">#FFFFFF</color> //样例

代码风格

原则

• 不要直接忽略Exceptions

  例如下面的示例，永远不要这样做，无法预测未来可能的变化

    void setServerPort(String value) {
        try {
            serverPort = Integer.parseInt(value);
        } catch (NumberFormatException e) { }
  }
  

  正确的做法应该如下：

    void setServerPort(String value) throws ConfigurationException {
        try {
            serverPort = Integer.parseInt(value);
        } catch (NumberFormatException e) {
            throw new ConfigurationException("Port " + value + " is not valid.");
        }
  }
  

• import采用完全限定名

  不提倡：

    import foo.*;
  

  正确做法：

    import foo.Bar;
  

• 括号风格：

  不提倡：

    if (condition)
        body();
  

  正确做法：

    if (condition) {
        body();
  }
  

• 使用空格来缩进

  使用4个空格缩进来代表块，而绝不使用tab键； 使用8个空格来代表行包裹，包括函数调用。

注释

• 1.类注释，每个类完成后应该有作者姓名和联系方式的注释，对自己的代码负责

    /**
      * 作者: xiuyuan
      * 时间: 13-12-20 19：25
      * 描述: 用户登录
      * 联系方式: xiuyuan@gmail.com
    */
    public class Login{
    ...
    }
    

• 2.方法注释，每一个成员方法（包括自定义成员方法、覆盖方法、属性方法）的方法头都必须做方法头注释

    /*
      * 方法名：
      * 功    能：
      * 参    数：
      * 返回值：无
    */
    

• 3.快注释

    private class MessageObserver extends ContentObserver {
        public MessageObserver() {
            super(mainHandler);
        }
      public void onChange(boolean hasChanged) {
         // 发送更新UI的消息
         mHandler.sendMessage(mHandler.obtainMessage(0x2));
        }
  }
  

• 4.资源文件注释

    <!--红色  -->
  <color name="red">#FF0000</color>
  <!--深蓝色  -->
  <color name="dark_blue">#0079FF</color>