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