Android 项目优化(一):项目代码规范优化

项目代码规范是软件开发过程中非常重要的优化环节。项目代码规范为主要包含:类,常量,变量,ID等命名规范,注释规范,分包规范,代码风格规范。

严格执行项目代码规范才能保证我们的整体的项目架构在实际的开发过程中有效的实施,并且具有以下优点:

  • 保证代码风格的统一,对于后期的代码维护非常重要。
  • 保证代码的可读性,能够保证其他人相对轻松梳理重要的逻辑。

一、常见的代码规范

 Android 开发目前主流的是 Java 和 Kotlin。在开发时,常见的大家都能接受的代码开发规范如下:

1. Class 命名

任何类名都应该使用 UpperCamelCase (驼峰法)命名。

2. 变量命名

变量名:静态常量使用大写字母,使用下划线“_”分词。

非静态成员变量、局部变量、首字母小写,驼峰式分词。

Activity、Fragment、Adapter、View 的子类的成员变量:m开头、驼峰式分词。

方法名:首字母小写,驼峰式分词。

变量名定义顺序推荐为:公用静态常量、公用静态变量、私用静态常量、私用静态变量、私有非静态变量。

严禁使用魔术数字,避免出现代码不可读或者不可维护的情况。

3. 代码长度规范

 一行代码的长度:不要超过160个字符。

一个方法的长度:不要超过:80行。

一个文件的长度不超过:1000行。

一个方法的参数列表不要超过:7个。

if 嵌套层次:不要超过4层。

4. 冗余代码控制

避免出现无用代码

避免无用的import

避免使用import *

避免声明无用变量。

二、阿里代码规范文档

目前的开发社区提供了很多的开发规范文档,阿里巴巴推出了《阿里巴巴Java开发手册》,并针对 IntelliJ IDEA 提供了 Idea-plugin 插件。

下面我们讲述一下插件的安装和使用。

1. 通过Jetbrains官方仓库安装

打开 Settings >> Plugins >> Browse repositories...

在搜索框输入alibaba即可看到Alibaba Java Code Guidelines插件,点击Install进行安装,然后重启IDE生效 

注意:因为插件zip包托管在Jetbrains官方CDN上,所以是从国外的服务器进行下载,可能会出现超时的情况.

2. 通过下载安装包进行安装

打开插件页面

Settings >> Plugins >> Install plugin from disk...,选择刚刚下载的zip包安装,然后重启IDE

注意

最低支持IDEA版本为14.1(buildNumber 141.0,可以在About Intellij IDEA中查看版本信息),使用IDEA14的同学最好升级到14.1.7及以上版本。

插件基于JDK1.7打包,所以IDEA启动时使用的JDK版本如果是1.6的话就会报Unsupported major.minor version 51.0异常,建议大家都升级一下。

3. 中文乱码解决方法

修改字体——Appearance&Behavior -> Appearance -> UI Options -> Name 里面设置成中文字体——如微软雅黑。

Switch Language to English and restart

三、Idea 插件使用

目前插件实现了开发手册中的的53条规则,大部分基于PMD实现,其中有4条规则基于IDEA实现,并且实现了实时检测功能。部分规则实现了Quick Fix功能,对于可以提供Quick Fix但没有提供的,我们会尽快实现,也欢迎有兴趣的同学加入进来一起努力。 目前插件检测有两种模式:实时检测、手动触发。

实时检测

实时检测功能会在开发过程中对当前文件进行检测,并以高亮的形式提示出来,同时也可以支持Quick Fix,该功能默认开启,可以通过配置关闭。

结果高亮提示

检测结果高亮提示,并且鼠标放上去会弹出提示信息。

Intention QuickFix功能

Alt+Enter键可呼出Intention菜单,不同的规则会提示不同信息的Quick Fix按钮

关闭实时检测

在某些情况下,我们不希望对代码提示违规信息,比如我们在阅读Github开源项目代码的时候,如果界面出现一堆红色、黄色的提示,此时心里肯定是飘过一万只草泥马。这个时候我们可以通过Inspection的设置关闭实时检测功能。

通过右键快速关闭(打开)所有规则的实时检测功能

 

通过Settings >> Editor >> Inspections 进行手动设置

也可以关闭某条规则的实时检测功能或者修改提示级别。

代码扫描

可以通过右键菜单、Toolbar按钮、快捷键三种方式手动触发代码检测。同时结果面板中可以对部分实现了QuickFix功能的规则进行快速修复。

触发扫描

在当前编辑的文件中点击右键,可以在弹出的菜单中触发对该文件的检测。

在左侧的Project目录树种点击右键,可以触发对整个工程或者选择的某个目录、文件进行检测。

如果您打开了IDE的Toolbar,也可以通过Toolbar中的按钮来触发检测,目前Toolbar的按钮触发的检测范围与您IDE当时的焦点有关,如当前编辑的文件或者是Project目录树选中的项,是不是感觉与右键菜单的检测范围类似呢。

使用快捷键(Ctrl+Shift+Alt+J)触发弹出窗口,选择检测范围;您也可自定义快捷键。

扫描结果

检测结果直接使用IDEA Run Inspection By Name功能的结果界面,插件的检测结果分级为Blocker、Critical、Major。默认按等级分组,方便统计每个级别错误的数量。

默认情况我们在结果面板需要双击具体违规项才能打开对应的源文件,开启Autoscroll To Source选项,单击面板中的文件名、或者是具体的违规项的时候IDEA会自动打开对应的源文件。

QuickFix

对于实现Quick Fix的规则,在结果面板中可以直接一键修复 注意:IDEA14、15可以通过左下角的灯泡进行一键修复操作。

其他

面板中其他按钮的功能大家自行探索吧,就不一一赘述了

代码提交时检测

在提交代码框勾选Alibaba Code Guidelines选项 

如果有违反手册的地方会提示是否继续提交,选择取消后会自动对修改的代码进行扫描 

 

posted @ 2019-06-13 10:39  灰色飘零  阅读(2320)  评论(0编辑  收藏  举报