专栏名称: Carson_Ho
走在产品路上的Android研究生
目录
相关文章推荐
开发者全社区  ·  大佬总爱找空姐 ·  20 小时前  
鸿洋  ·  Android WebView ... ·  昨天  
开发者全社区  ·  陆家嘴某基金老登被曝光 ·  2 天前  
鸿洋  ·  HarmonyOS ... ·  2 天前  
开发者全社区  ·  前公司客户「相中」我当儿媳妇... ·  2 天前  
51好读  ›  专栏  ›  Carson_Ho

Android:这是一份全面 & 详细的Android代码命名规范

Carson_Ho  · 掘金  · android  · 2019-03-25 01:54

正文

前言

  • Android代码规范内容非常多,但对我们最有用& 最有影响的莫过于 Android代码的命名规范

  • 可是,有很多人容易忽略 Android 代码的命名规范,从而导致代码的可读性 & 维护性非常差, 最终导致开发效率 & 维护效率降低

  • 今天,我将根据 Google Java 编程规范 & Google 官方 Android 编码规范 ,为大家带来 一份全面 & 清晰的 Android 代码命名规范 ,希望你们会喜欢。

  • ps:最近在筹备一个”和我一起写Android“的活动,需要各大读者的帮忙,希望能看文章参与哦: 我想邀请您和我一起写Android(福利回赠)


目录

示意图


1. 为什么 规范 Android 代码命名?

  • 增强代码的可读性
  • 增强代码的可维护性

正由于上述两个作用,从而使得 开发效率 & 维护效率 得到大幅度的提高。


2. Android需要命名的代码(对象)有哪些?

示意图


3. 具体命名规范

下面,我将对 Android 代码对象中的命名规范进行详细讲解

注:由于 Android 主要用 Java 实现,所以Android规范会涵盖部分Java规范

3.1 包

  • 基础规则:小写、单词间连续无间隔、反域名法(分为4级,具体如下图)

示意图

  • 第4级包名会随着功能的不同而不同 。下面我列举出一些常见 & 需要规范的4级功能包名

示意图

3.2 类

  • 基础规则
    1. 类型 = 名词 / 名词短语;
    2. 形式 = 驼峰形式中的 大骆驼拼写法 UpperCamelCase

即名称中的每个词的首字母都大写,如 AndroidStudio

  • 在具体命名类时,会根据 该类的类型不同而附加额外的命名规则 。具体如下图

示意图


3.3 变量

  • 基础规则
    1. 类型 = 名词 / 名词短语;
    2. 形式 = 驼峰形式中的 小骆驼拼写法 LowerCamelCase

即名称中的第1个词的首字母小写,后面每个词的首字母大写,如 androidStudioTool

  • 在具体命名变量时,会根据 该变量的类型不同而 附加额外的命名规则 。具体如下图

示意图

3.4 方法

  • 基础规则
    1. 类型 = 动词 / 动词短语;
    2. 形式 = 驼峰形式中的 小骆驼拼写法 LowerCamelCase

即名称中的第1个词的首字母小写,后面每个词的首字母大写,如 androidStudioTool

  • 在具体命名 方法名时,会根据 该方法名的作用不同而 附加额外的命名规则 。具体如下图

示意图

3.5 参数名

  • 基础规则:驼峰形式中的 小骆驼拼写法 LowerCamelCase

即名称中的第1个词的首字母小写,后面每个词的首字母大写,如 androidStudioTool

  • 附加命名规则:功能名,如 userName

3.6 资源

  • Android的资源包括:

示意图

示意图

下面,我将对每种 Android 资源的命名规则进行详细讲解

3.6.1 布局文件资源

示意图

3.6.2 图片资源

示意图

3.6.3 参数值资源

示意图







请到「今天看啥」查看全文