美文网首页AndroidAndroid开发Android技术知识
《Android APP必须有的东西》之维护篇:命名规范

《Android APP必须有的东西》之维护篇:命名规范

作者: 温瑜 | 来源:发表于2016-10-20 00:14 被阅读326次

命名规范要望文知义,简单明了。
命名规范定制太多,就会让人心烦,反而没人遵守了。
---《APP研发录》

命名没有具体的要求,只能说跟上面的要求满足就够了,目前网上能够搜到各种风格的方案,选择一种自己之前没有章法的时候就下意识接近了的,或者自己喜欢的能够快速记住的方案,坚持一两个Demo,大概就能基本记住了。

方案来源于网络,修改添加了部分自己用的习惯。这里整理记录一下本人将默认采用,并且将统一到开发中的方案。

忘了就翻出来瞅瞅!!

命名规范

  • 包命名,单词全部小写

域名反写+项目名称+模块名称,例如:

activity包: cf.paradoxie.demo.activity

实体包: cf.paradoxie.demo.bean

工具包: cf.paradoxie.demo.utils

  • 接口和类命名,单词首字母大写(大驼峰规则)

以下为几种常用类的命名:

公共父类,命名以Base开头,如:BaseActivity, BaseAdapter

activity类,命名以Activity为后缀,如:LoginActivity

fragment类,命名以Fragment为后缀,如:LoginFragment

service类,命名以Service为后缀,如:DownloadService

adapter类,命名以Adapter为后缀,如:MyListAdapter

工具类,命名以Util为后缀,如:StringUtil

接口类,命名以I为前缀(来源于MVP模式),如:IUser

接口实现类,命名以Impl为后缀,如:UserImpl

  • 方法命名,除开第一个单词首字母,其余都大写(小驼峰规则)

以下为几种常用方法的命名:

初始化方法,命名以init开头,例:initView

设置方法,命名以set开头,例:setData

储存方法,命名以save开头,例:saveData

具有返回值的获取方法,命名以get开头,例:getData

通过异步加载数据的方法,命名以load开头,例:loadData

布尔型的判断方法,命名以is或has,或具有逻辑意义的单词如equals,例:isEmpty

  • 常用控件id命名缩写
控件 命名 控件 命名
TextView tv RadioGroup group
EditText et RadioButton rbtn
Button btn ProgressBar progress
ImageView iv CheckBox cb
ImageButton ibtn Spinner spinner
ListView lv ScrollView sv
LinearLayout ll RelativeLayout rl
FramLayout fl TableLayout tl

以上缩写为代表控件的缩写,其id全称需根据配合所在布局及其功能意义而定,缩写_{范围_}意义,例如:

登录按钮:btn_login;

相对布局的tab栏:rl_tab;

标题栏文本:tv_head_title

  • 布局 layout命名

类型_{范围_}功能,范围可选,只在有明确定义的范围内才需要加上。
以下为几种常用的组件类型命名:

activity_{范围_}功能,为Activity的命名格式:activity_login

fragment_{范围_}功能,为Fragment的命名格式

dialog_{范围_}功能,为Dialog的命名格式

header_list_{范围_}功能,为ListView的HeaderView命名格式

footer_list_{范围_}功能,为ListView的FooterView命名格式

  • strings的命名

类型_{范围_}功能,范围可选。
以下为几种常用的命名:

页面标题,命名格式为:title_页面

按钮文字,命名格式为:btn_按钮事件

标签文字,命名格式为:label_标签文字

选项卡文字,命名格式为:tab_选项卡文字

消息框文字,命名格式为:toast_消息

编辑框的提示文字,命名格式为:hint_提示信息

图片的描述文字,命名格式为:desc_图片文字

对话框的文字,命名格式为:dialog_文字

menu的item文字,命名格式为:action_文字

  • colors的命名

前缀{_控件}{_范围}{_后缀},控件、范围、后缀可选,但控件和范围至少要有一个:

背景颜色,添加bg前缀

文本颜色,添加text前缀

分割线颜色,添加div前缀

区分状态时,默认状态的颜色,添加normal后缀

区分状态时,按下时的颜色,添加pressed后缀

区分状态时,选中时的颜色,添加selected后缀

区分状态时,不可用时的颜色,添加disable后缀

  • drawable的命名

跟以上colors的命名类似,此处多了选择器

添加selector后缀(一般为ListView的selector或按钮的selector)

  • 动画文件命名

动画类型_动画方向

fade_in,淡入

fade_out,淡出

push_down_in,从下方推入

push_down_out,从下方推出

slide_in_from_top,从头部滑动进入

zoom_enter,变形进入

shrink_to_middle,中间缩小

  • 变量命名

只能包含字母,单词首字母除第一个外,都为大写,其他字母都为小写

普通变量:mXyxy,或userBean

控件变量,类型为前缀,功能在后面:btnLogin

  • 常量命名

全部大写,采用下划线命名法.例如:MAX_VALUE

注:单词缩写原则:尽量不要用缩写,除非该缩写是约定俗成的

上代码! 这次没有代码!


 注1:单词缩写原则:尽量不要用缩写,除非该缩写是约定俗成的

 注2:方案来源于网络,修改添加了部分自己用的习惯

本文作者:paradoxie
个人主页:谢盒盒的小黑屋,不止说技术
简书地址:简书主页,专注说技术
github地址:paradoxie
转载请注明出处,蟹蟹!
-------我的梦想真的是做一条咸鱼!

相关文章

  • 《Android APP必须有的东西》之维护篇:命名规范

    命名规范要望文知义,简单明了。命名规范定制太多,就会让人心烦,反而没人遵守了。---《APP研发录》 命名没有具体...

  • Android 编码规范

    1 命名规范 1.1 Android包命名规范 因为Android包目录的命名会直接影响到整个App工程后期的开发...

  • android开发编码规范

    命名规范 android包命名规范 因为android包目录的命名会直接影响到整个APP项目工程后期的开发效率和拓...

  • 第一篇简书,记录网上开源自定义View

    1.《Android APP可能有的东西》之UI篇:流式标签&搜索历史:FlowLayout-SearchHist...

  • Android编码规范

    Android开发代码规范相关系列文章: Android命名规范 Android编码规范 Android编码规范有...

  • Unity之命名规范(三)

    笔者在Unity 之命名规范(一)、Unity之命名规范(二)两篇中写了一些在程序编码中需要注意的命名规范,这篇介...

  • android代码规范

    android代码规范 注意:res目录中的所有文件的命名不能出现大写字母,其次必须符合标识符的规范。一但文件命名...

  • Android开发中的优化方案

    一、命名规范 代码规范先从命名规范开始,Android的命名规范主要涉及:Java源代码,xml文件,图片资源。 ...

  • 最全设计尺寸规范+屏幕尺寸 | 设计师必备

    “ 设计尺寸规范之IOS篇 ” “ 设计尺寸规范之Android篇 ” “ 屏幕尺寸之手机篇 ” “ 屏幕尺寸之电...

  • 安卓的切图规范

    Android UI 切图命名规范、标注规范及单位描述 很多UI设计师做APP切图都会有两套,一套是Android...

网友评论

  • 巴图鲁:厉害
    温瑜:@巴图鲁 多谢捧场 :yum:
  • Neo_duan:写的很好。。。类名我觉得最忌讳写MyAdapter或者MyXXX了
    温瑜:@Neo_duan 得加上表示的意义哇,就一个My前缀的话,也就内部类适合。另外,如果想application这种全局就一个的,My前缀也是可以的

本文标题:《Android APP必须有的东西》之维护篇:命名规范

本文链接:https://www.haomeiwen.com/subject/zccfuttx.html