Android命名规范（重点讲解：包名）

Android程序开发中，使用规范的命名有益于程序的开发和后期阅读。本文主要对Android程序包名的定义作详细介绍，并附带一些简单的命名规则。

一．标识符命名方法
1 .小驼峰命名法，除首单词外，其他全部单词的第一个字母大写。如：allPrice，getAllNames
2.大驼峰命名法，全部单词的第一个字母大写。如：GuideActivity，StudentInfoBean
3.下划线命名法:单词与单词间用下划线作间隔。如：activity_main,select_backGround_color
二．命名规范
（一）包（packages）的命名规范:
          采用反域名命名规则，所有使用小写字母。一级包名为com，二级包名lwz（为我的或公司名称，能够简写），三级包名guidecity（根据应用进行命名），四级包名ui或utils等（模块名或层级名），根据实际状况也是能够用五级包名，六级包名。
         这里的四级包名是要重点理解和分类的，例如：com.lwz.应用.utils ，此包中包含：公共工具方法类

1.utils
         此包中包含：公共工具方法类，好比：SPHelperUtil、TimeUitl、FileUtil等

2.adapter
         此包中包含：一些适配器的类，好比：ArticleAdapter、FansAdapter，HistorAdaper等

3.base
         此包中包含：一些共同类的基类，好比：BaseActivity（全部的Activity类都继承这个类）、BaseFragment（全部的Fragment都继承这个类），ListItemAdapter（封装了Base Adapter的基类）等

4.bean
         此包中包含：一些属性对象类，好比：StudentBean、LonginBean、ArticleBean等

5.config
         此包中包含：最顶级的配置类，好比：MyApp（继承了Application）

6.httpservice
         此包中包含：Http数据的请求接口类，好像Retrofit网络框架请求网络数据才要使用。如：ILogin接口，IAddTopic接口，IUpdate等

7.interface
         此包中包含：某个页面或对象的所用操做接口类，这个接口主要是定义这个对象的全部方法。如：IUser接口，IArticle接口，ITopic接口等

8.model
         这是MVC或MVP框架设计中的M。此包中包含：某个页面或对象的所用操做类，这个类继承了上面定义的interface接口，重写并实现厘米那的方法。如：UserModel，ArticleMode类，TopicMode类等

9.ui
         这个ui表示的页面的意思，也是MVC或MVP中的V，不少人把这个包名写成activity，实际上是不许确的，由于ui包含了activity和fragment，因此ui是四级包名，而activity和fragment是ui包下的五级包名。
         activity此包中包含：Activity对象类。如：MainActivity类，HomeActivity类，FansListActivity类等。若是是使用了MVP框架模式，activity包名下还能够有六级包名，好比：loginMVP（包含ILoginView接口类，LoginPresenter类）、seleteTopicMVP
         fragment此包中包含：Fragment对象类。可是Fragment通常都是多个存在的，因此fragment包下通常还有六级包名，表示里面是哪一个页面的Fragment对象。

10.weight
         此包中包含：自定义View或自定义对话框等视图类。如：CursroDialog类，SpringScrollView类，ScrollListView类等

11.db
         此包中包含：数据库操做类

12.service
         此包中包含：Service服务类

13.broadcast
         此包中包含：Broadcast广播接收者类

14.provider
         此包中包含：Provider内容提供者类（用得不多）

         包名规划我感受对程序后期阅读或修改有很大的帮助，特别是很大的程序，文件太多，不规划的话本身都不知道这个类是干什么的！
         固然若是程序中没有这一类的文件，这个包名是能够不写，可是一些基本的包名，基本每一个程序都是须要的好比：ui、utils、adapter、weight、bean等

（二）类（classes）的命名规范：
         通常用名词，采用大驼峰命名法，尽可能避免缩写，除非该缩写是众所周知的，好比HTML,URL，若是类名称中包含单词缩写，则单词缩写的每一个字母均应大写。

如下是部分示例说明：
1.activity 类，如欢迎页面类WelcomeActivity.
2.adapter类,如商品详情适配器ProductDetailAdapter
3.util公共方法类，如：线程池管理类：ThreadPoolManager，日志工具类：LogUtil
4.db数据库类，以DBHelper后缀标识。如城市数据库：CityDBHelper
5.Service类，以Service为后缀标识
6.BroadcastReceive，以Broadcast为后缀标识
7.ContentProvider，以Provider为后缀标识

（三）接口（interface）：
         命名规则与类同样采用大驼峰命名法，多以able或ible结尾或以I开头，如Runnable、Accessible、IUser。

（四）方法（methods）的命名规则：
         通常使用动词或动名词，采用小驼峰命名法 例如:onCreate(),run()

>1.initXXX()初始化相关方法,使用init为前缀标识
2.isXXX()、checkXXX() 方法返回值为boolean型的请使用is或check为前缀标识
3.getXXX()返回某个值的方法，使用get为前缀标识
4.processXXX() 对数据进行处理的方法，尽可能使用process为前缀标识
5.displayXXX() 弹出提示框和提示信息，使用display为前缀标识
6.saveXXX() 与保存数据相关的，使用sav为e前缀标识
7.resetXXX() 对数据重组的，使用reset前缀标识
8.clearXXX()removeXXX() 清除数据相关的，使用clear或remove为前缀标识
9.drawXXX() 绘制数据或效果相关的，使用draw前缀标识
1
2
3
4
5
6
7
8
9
（五）变量（variables）采用小驼峰命名法。类中控件名称通常与xml布局id保持一致
（六）常量（constants）所有大写,采用下划线命名法.例如：MIN_WIDTH
（七）XML文件（布局文件）：所有小写，采用下划线命名法，
例如：main_activity.xml， item_activity.xml、homeposter_item_poster.xml

（八）资源文件（图片）： 所有小写，采用下划线命名法，加前缀区分
命名 说明
btn_login_normal 按钮图片使用btn_功能_说明
bg_head 背景图片使用bg_功能_说明
def_search_cell 默认图片使用def_功能_说明
icon_more_help 图标图片使用icon_功能_说明
seg_list_line 具备分隔特征的图片使用seg_功能_说明
sel_ok 选择图标使用sel_功能_说明
（九）动画文件（anim包）：所有小写，采用下划线命名法，加前缀区分。
动画命名例子：

规范写法 备注
click_head_left 点击背景切换动画使用click前缀标识
bg_shape_rectangle 背景自定义图形使用bg前缀标识
show_shopcar_add 小动画效果使用show前缀标识
（十）资源ID（resources id）：大小写规范与方法名一致，采用小驼峰命名法。
         命名规范为“资源控件的缩写名”+“变量名”。例如TextView的id=“tv_userName”。注意：页面控件名称应该和控件id名通常是一致，例如：TextView tv_userName=(TextView)findViewById(R.id.tv_userName);

三．图解包名规范示例
本文主要是想对程序包名的命名规划，这里展现我以前开发的程序的包名图片，供你们参考：

（一）总显示

上面example这个包名通常是不用的！

（二）ui包下
fragment展现

activity 展现：

（三）utils和weight包下

（四）res文件夹下的部分文件展现：

drawable包下：

layout包下：

         上面就是一个完成程序的主要文件展现，这个程序大概有三百多个文件（包括java文件和资源文件），这里就不一一展现了！          你们能够想象一下，若是这个程序包名和文件名都没有很好规划，那么你要找你想要的几个文件是一个多么麻烦的事情！          通常地，我在建立每一个java程序文件都会在上面作几句话的注解，说明一下这个文件的做用，有些布局文件也是有简单说明。这样更加有利于后期的程序代码迭代或版本更新！          命名规范是必须的吗？有些是！有些不是。好比包名、类的定义，系统没有硬性规定，可是资源文件res文件夹下的命名，系统要求资源文件名必须小写，不然，你的程序一直运行不了，你都不知道为啥。          最后说一句：程序开发中命名规范是一个很好的开发习惯！--------------------- 做者：峥嵘life 来源：CSDN 原文：https://blog.csdn.net/wenzhi20102321/article/details/61650405 版权声明：本文为博主原创文章，转载请附上博文连接！