Android团队项目开发之统一代码规范

21CTO

资讯 0 2907 2017-04-12 12:00:50

前言
团队项目开发前的统一三要素：统一需求/开发文档，统一代码规范，统一环境（编译/测试/发布）。
一个项目团队，要想有高效的产出，必须在团队协作上下好功夫，必须在项目开发统一进度上做好协调。只有在高效的协同环境下，才能有优质的产出。这是我多年的经验之谈。也是配合过多个团队之后的深刻感悟。
每一个程序员都是有独立开发思维模式，都有自己的编码行为和操作习惯。所以，在一个团队中，怎么做到更高效的协同，不仅仅是每个开发者自身的协同配合能力，更重要的是项目管理者，怎样做到统一要求和统一实行。
举个很简单的例子。以前在一个小团队里，每次进行代码更新的时候，都是有一大堆更新。最后发现很多不是代码功能的个性，而只是大家的code style不一样。每次merge代码都要diff查看修改的地方，这样很影响效率。而且如果你只是做为一个普通的开发者，要求其它人和你用统一style，别人未必接受。这时的项目管理者，才是最需要去统一规范的。保持规范统一，才是高效协作产出的前提。
Android项目开发需要统一哪些规范呢？
在些列出一些常用规范，和容易出问题的地方，方便自己查找，也方便和更多的朋友交流！
一、编码方式统一：UTF-8。一般项目都用utf-8。有其它编码的，可自行要求修改。
在项目代码中右键，就能出现如下：
　　

或者去个性配置文件：
　　

二、代码样式code style：比如，tab缩进4个空格，或者 tab size等。

自定义的编码格式xml 文件。没有的话，可以下载
把xml文件复制到 C:/Users/YourUserName/.AndroidStudio/config/codestyles 目录下，如果没有codestyles目录可以自己新建一个。 (目前还不支持导入)
重启android studio
android studio 中 Setting-> Editor-> Code Style-> JAVA-> Scheme 选择自定义的编码格式文件。

具体如下图：
　　

保持代码格式的一致性，对项目的协同开发很有必要。优秀的代码习惯是，提交代码前格式化代码，让代码统一规则上传，保证代码的整洁。所以，在团队中必须支持规范代码。提交前所有修改的类都必须ctrl+f（规范代码），然后再提前。良好的编码习惯，能让代码变得更优雅漂亮。
命名规范
Java代码一般使用驼峰式规则，用名词或名词词组命名，每个单词的首字母大写。常用类的命名：
· activity类，命名以Activity为后缀，如：LoginActivity
· fragment类，命名以Fragment为后缀，如：ShareDialogFragment
· service类，命名以Service为后缀，如：DownloadService
· adapter类，命名以Adapter为后缀，如：CouponListAdapter
· 工具类，命名以Util为后缀，如：EncryptUtil
· 模型类，命名以BO为后缀，如：CouponBO
· 接口实现类，命名以Impl为后缀，如：ApiImpl
方法命名
· 初始化方法，命名以init开头，例：initView
· 按钮点击方法，命名以to开头，例：toLogin
· 设置方法，命名以set开头，例：setData
· 具有返回值的获取方法，命名以get开头，例：getData
· 通过异步加载数据的方法，命名以load开头，例：loadData
· 布尔型的判断方法，命名以is或has，或具有逻辑意义的单词如equals，例：isEmpty
控件命名
控件命名，一般都有各自习惯。但为了保证代码的整洁，尽量保持统一风格。
　　

常量命名
全部为大写单词，单词之间用下划线分开。
public final static int PAGE_SIZE = 20;
变量命名
{范围描述+}意义描述+类型描述的组合，用驼峰式，首字母小
private TextView headerTitleTxt; // 标题栏的标题
private Button loginBtn; // 登录按钮
控件id命名
控件缩写{范围}意义，范围可选，只在有明确定义的范围内才需要加上。
　　