Android_编程开发规范

                                                Android编程开发规范                                            

        原文地址 http://www.jianshu.com/p/9b8aeca9b281 

一.约定

Activity.onCreate(),Fragment.onActivityCreated(),作为程序入口,不用写入太多代码,尽量保持仅仅调用initXXX()方法,简单明了展示调用过程。如:initData()。initView()。
单个方法体不要过长
代码不论什么地方不要拼错单词
杜绝整个类代码格式化
调用方法保持“临近原则”,被调用的方法,放在调用方法下方
统一调整IDE的Tab缩进为4个空格
空行的使用,拒绝拖沓无切割,关联代码段放一块并与后面代码切割
用好TODO标记
    记录想法,记录功能点,开发过程中能够利用TODO记录一下暂时想法或为了不打搅思路留下待完好的说明
    删除无用TODO。开发工具自己主动生成的TODO,或则已经完好的TODO,一定要删除。
处理“魔数”等看不懂的神奇数字
    代码中不要出现数字。特别是一些标识不同类型的数字。

所有意义数字所有抽取到Constant公共类中,避免散布在各位类中。

二.命名 
1. 布局文件里的id命名

规则:使用驼峰命名。前缀+逻辑名称,类变量名和布局文件id名称保持一致,不须要下划线切割

控件前缀规则:

TextView/EditText: tv/et
Button/RadioButton/ImageButton: btn
ImageView: img
RelativeLayout/LinearLayout/FrameLayout: layout,
ListView: listView
WebView: webView
CheckBox: chBox

如:TextView @+id/tvTitle
如:EditView @+id/etName
如:Button @+id/btnSearch

2.布局文件命名

规则: 使用前缀_逻辑名称命名,单词所有小写,单词间以 下划线 切割。

前缀规则:

Activity相应的布局使用activity_  有时候类名过长 可简写为aty

Fragment相应的布局使用fragment_   简写 fgt

如:PublishActivity: activity_publish.xml   PublishAty 

3.资源文件命名

规则: 使用 前缀_用途 命名,单词所有小写。单词间以 下划线 切割。

drawable:
    btn_back_selector.xml 控件前缀命名
    common_circle_gray.xml 通用资源多处使用common_
    chat_image_selector.xml 功能相关业务使用加用途前缀

drawable_hdpi:
    btn_back_normal.9.png 控件前缀名称
    btn_back_press.9.png 控件前缀名称
    icon_login_lock.png icon_+用途

values/color:
    pull_refresh_attrs.xml 引入的第三方资源。携带资源简拼的前缀

4.类和接口命名

规则: 使用驼峰规则,首字母必须大写,使用名词或名词词组。要求简单易懂,富于描写叙述,不同意出现无意义或错误单词。

如:class BookMarkAdd 正确
如:class AddBookReadPlan 错误! 应为 class BookReadPlanAdd 

5.方法命名

规则: 使用驼峰规则。首字母必须小写,使用动词。

要求简单易懂。富于描写叙述,不同意出现无意义或错误单词。

如:public void run();
如:public String getBookName(); 

6.变量命名

规则: 使用驼峰规则,首字母必须小写,使用名词或名词词组。要求简单易懂,富于描写叙述,不同意出现无意义或错误单词。

成员变量命名,不要在私有变量前加入m字样
常量命名。所有大写,单词间用下划线隔开

7.其它

空行:空行将逻辑相关代码段隔开。简洁清楚。提高可读性
    成员变量之间,依据业务形成分组加空行
    方法之间加空行
控制语句
    降低条件嵌套,不要超过3层
    if推断使用“卫语句”。降低层级
    if(obj != null) { doSomething();}
    改动为:
    if(obj == null) { return;}doSomething();
    if语句必须用{}包含起来,即便是仅仅有一句
方法
    拆分臃肿方法,每一个方法仅仅作一件事
    做同一个逻辑的方法,尽量靠近放到一块。方便查看
    不要使用 try catch 处理业务逻辑
    使用JSON工具类,不要手动解析和拼装数据
Activity继承BaseFragmentActivity或SwipeBackActivity,能够使用ButterKnife注解取代findViewById。

三.IDE

Android Studio (越早使用越好)
Android SDK 4.4W (API 20 统一开发版本号)
JDK 1.8(统一开发版本号)

四.Libraries

Base

fastjson-android-1.2.4.jar
okhttp-2.2.0.jar
okio-1.2.0.jar
picasso-2.5.0.jar
butterknife:7.0.1
ormlite-android:4.48
volley

UI

PullToRefresh
QuickAdapter
PagerSlidingTabStrip
SystemBarTint 状态栏以及导航栏设置背景颜色
SwipeBackLayout 左滑返回
PullToZoomView 能够下拉缩放HeaderView
AutoLoopViewPager 轮播图
PhotoView
ViewPageIndicator
posted @ 2017-08-21 14:25  cxchanpin  阅读(425)  评论(0编辑  收藏  举报