Android开发命名规范

俗话说的好:工欲善其事必先利其器,良好的规范是好代码的基础,便于自己和别人阅读与修改,任何人都可以轻松驾驭。

标识符命名法最要有四种

  • Camel(骆驼)命名法:除首单词外,其余所有单词的第一个字母大写,如:fooBar;
  • Pascal命名法:所有单词的第一个字母大写,如:FooBar;
  • 下划线命名法:单词与单词间用下划线做间隔,如:foo_bar;
  • 匈牙利命名法:广泛应用于微软编程环境中,在以Pascal命名法的变量,首字母小写,说明该变量的类型,取名方式为: scope_prefixqualifier 范围前缀\类型前缀_限定词,如:g_foo_bar。
安卓App层开发主要是Java语言,所以基本使用除了匈牙利命名法外的命名方式。

缩写命名规则

  • 较短的单词可通过去掉“元音”形成缩写,如icon->ic;
  • 较长的单词可取单词的头几个字母形成缩写,如average-> avg;
  • 此外还有一些约定成俗的英语单词缩写,如Internationalization->I18N;
  • 程序中不要用缩写,除非该缩写是约定俗称的

命名规范

包(packages)

采用反域名命名规则,全部使用小写字母。一级包名为地顶级域名如com,二级包名为xx(可以是公司或则个人的随便),三级包名根据应用进行命名,四级包名为模块名或层级名;如 com.tinyx.myapp.activities。

类(classes)

用Pascal命名法,尽量避免缩写,如:MyActivity;缩写是众所周知的,如HTML,URL;类名称中包含单词缩写,则单词缩写的每个字母均应大写,如:PublicHTML,CommonURL。
      接口(interface):与类一样用Pascal命名法,多以able或ible结尾,多用作表示行为,如Runnable,Accessible;
      方法(methods):动词或动名词,采用Camel命名法,如:onCreate(),run(),下面是一些建议。

  • 初始化相关方法,使用init为前缀标识,如:初始化布局initView();
  • boolean型使用is或check为前缀标识, 如:checkValue()、isValidate();
  • 返回某个值的方法,使用get为前缀标识,如:getName();
  • 数据进行处理相关,尽量使用process为前缀标识,如:processUpdate();
  • 保存数据相关,使用save为前缀标识,如:saveData();
  • 对数据重置的,使用reset前缀标识,如:resetData();
  • 清除数据相关,使用clear前缀标识,如:clearData();
  • 移除某些项目,使用remove前缀标识,如:removeItem();
  • 绘制数据或效果相关的,使用draw前缀标识,如:drawCircle();

变量(variables)

采用Pascal命名法,建议采用有意义的命名如:firstName,lastName; 模型类变量默认以上规则。

public class User {
    public String name;
    public String phone;
    public int sex; //1,男 2,女
   public User() {
         this.name = "myname";
         this.phone = "123“
         this.sex = 0;
    }
}
  • 非模型类全局参数建议加上小写m开头
public class TestActivity extends Activity {
    private ZoomableImageView mZoomableView;
    private TabLayout mTabLayout;
    private int mItemsCount;
   @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.test_activity);
    }
}

常量(constants)

全部大写,采用下划线命名法。

public static final int MAX_ITEMS= 10
public static final String TAG = User.class.getSimpleName()

资源文件命名(resources)

采用下划线命名法吗,全部小写,针对不同资源,建议用下面的命名方法

  • drawable资源,加前缀命名:前缀功能模块_说明.xml/png。

如

  • layout 资源文件,前缀命名:类型模块功能_说明.xml,举一些常用的例子如下:

这里写图片描述

  • 动画anim资源文件(anim只有一种资源,所以不必加前缀区分):模块功能动画_方向.xml

这里写图片描述

  • 菜单资源文件(只有一种资源,所以不必加前缀区分)模块功能说明.xml

这里写图片描述

  • values资源,这个主要分下面几种资源:

ids资源,主要存放是界面控件的id值,用下划线小写命名法,前缀方式:前缀模块功能_说明,常用界面控件命名如下:

这里写图片描述

strings/arrays/dimens资源,用下划线小写命名法,不加任何前后缀,格式,模块功能说明。
attrs/colors/ids的属性和名称使用 Camel命名法; styles的属性使用Camel命名法,名称使用Pascal命名法。

<!--attrs-->
<attr name="text" format="string" />
<attr name="itemIcon" format="reference" />
<attr name="showToggle" format="boolean" />
<attr name="showVersion" format="boolean" />
<style name="Theme.AppCompat.Light.NoActionBar">
        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>
</style>
<!--colors-->
<color name="colorPrimary">#009688</color>
<color name="colorPrimaryDark">#00796b</color>
<color name="colorAccent">#cddc39</color>
<!--ids-->
<item name="tabLayout" type="id"/>
<item name="viewPager" type="id"/>
<item name="viewContainer" type="id"/>

希望这篇博客能帮助到别人,同时也能警惕自己要注意命名规范的重要性,最后附上参考链接

  • 2
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值