Android自定义Lint实践(一)-白红宇

Android自定义Lint实践(一)

阅读量：5746 次

发布时间：2019-06-18

本文共 4813 字，大约阅读时间需要 16 分钟。

1 Android Lint介绍

1.1 Google开发者文档

先来段developer的官方引用:

Android Studio provides a code scanning tool called Lint that can help you to easily identify and correct problems with the structural quality of your code, without having to execute the app or write any test cases.

该图诠释了Lint工具是如何检测应用源代码的：

1.2 各类Android博客

1.2.1 CSDN博客专家-张兴业

作为移动应用开发者，我们总希望发布的apk文件越小越好，不希望资源文件没有用到的图片资源也被打包进apk，不希望应用中使用了高于minSdk的api，也不希望AndroidManifest文件存在异常，lint就能解决我们的这些问题。

1.2.2 美团点评技术团队

Android Lint是Google提供给Android开发者的静态代码检查工具。使用Lint对Android工程代码进行扫描和检查，可以发现代码潜在的问题，提醒程序员及早修正。

为保证代码质量，美团在开发流程中加入了代码检查，如果代码检测到问题，则无法合并到正式分支中，这些检查中就包括Lint。

其他博客就不一一列举了。

2 Android Lint使用

2.1 使用前的相关术语

再来段官方文档：

The Lint tool checks your Android project source files for potential bugs and optimization improvements for correctness, security, performance, usability, accessibility, and internationalization. You can run Lint from the command-line or from Android Studio.

简要来说：

布局性能（以前是 layoutopt工具，可以解决无用布局、嵌套太多、布局太多）

未使用到资源

不一致的数组大小

国际化问题（硬编码）

图标的问题（重复的图标，错误的大小）

可用性问题（如不指定的文本字段的输入型）

manifest文件的错误

内存泄露 --- 如：handle的不当使用。

占内存的资源及时回收 --- 如：cursor未关闭等

2.1.1 lint.xml

Lint检查的配置文件，该文件即为你修改的某些Lint配置项，其需要在对应模块的根目录，Lint Tool会自动扫描模块目录下是否有对应的lint配置文件。

该lint文件如下所示：

其中severity是严重级别：error，ignore，warning。注意其也可以只指定部分文件

2.2 Java和xml间的配置

2.2.1 java层

@SuppressLint注解，其允许在任何地方定义，如在方法体上定义，则忽略该方法体的Lint检测。

@SuppressLint("NewApi")最为常见，@SuppressLint("all")意为忽略所有规则。

2.2.2 xml层

在xml文件，首先引入：

namespace xmlns:tools="http://schemas.android.com/tools"

简单介绍下tool，用于告知as，哪些属性可被忽略，只在设计布局时有效:

Lint提示。tools:ignore = "contentDescription" 意为忽略lint的imageview的contentDescription属性，该属性用于视力障碍者。

预览布局。
1. tools:text 如某控件在Java代码层动态设置text属性，而你需要看预览效果，通常会设置 android:text="I am a title"，等预览完毕再进行删除，使用tools，则完全达到预览效果。
2. tools:context 预览布局时，ide可知采用哪种主题，还可Go to Related files。

具体tools分析：

2.3 AS使用指南

分析了那么多，意在说明Lint工具的重要性，那么下一阶段则是如何在as中使用，以及配置，以及结合公司代码进行项目检查。

2.3.1 使用GUI

Analyze”菜单中选择“Inspect Code”，其中可以选择scope，即检测范围，也可以选择不同的检测配置，我们先进行默认的配置检测吧。检测需要一定的时间，结果会在EventLog显示：

可以看到，我们的项目有很多问题，比如我选择了Correctness中的Using dp instead of sp for text sizes属性，发现应用中有2处在textSize中误用了dp，其给出了类的具体位置和解决方案。可能你觉得这些无关大雅，那么可以查看Probable bugs项，在其中找到一项 String comparison using '=='，instead of 'equals()'，可以看到SecurityBankCardListActivity类中的有一行代码：

this.mBankCard.getCardId() == mBankCard.getCardId()//cardId为String类型

在此就不一一列举。

可能你会觉得Lint分析的太过详细，我无法迅速找到问题，那么你可以点击，其分为四类，我们应只关注前2类。

2.3.2 使用命令行

运行gradle lint，然后在app/build/outputs打开lint-results.xml

2.3.3 AS的Lint配置

打开设置对话框，找到Editor，然后是Inspections，选择某一个Lint选项，修改严重等级，如图：

gradle中的Android插件的lintOptions，具体lintOptions属性，可参照

3 为什么需要自定义

我们在实际使用Lint中遇到了以下问题：

原生Lint无法满足我们团队特有的需求，例如：编码规范。

原生Lint存在一些检测缺陷或者缺少一些我们认为有必要的检测。

基于上面的考虑，我们开始调研并开发自定义Lint。

那我们的项目需要自定义Lint吗，我觉得很有必要，举几个例子：

我们有MuLog模块，但是仍然有开发同事会使用android自带的Log工具类或java的System.out.print，显然我们应该可以选择强制开发同事调用MuLog，如果调用Log等，编译器会报错等提示。

增强HashMap检测，Lint检测中有一项是Java性能检测，常见的就是：HashMap can be replaced with SparseArray。例如下面代码，原生Lint只能检测第一种情况。

public static void testHashMap() {    HashMap
      
        map1 = new HashMap
       
        ();    map1.put(1, "name");    HashMap
        
          map2 = new HashMap<>();    map2.put(1, "name");    Map
         
           map3 = new HashMap<>();    map3.put(1, "name");}

Intent携参，activity页面间的跳转需要intent，而需要传输数据时，需要extra，对应的该extra都需要一个key，该key应该是跳转类中的命名常量，而不是写死在putExtra("key","value")里，我们可以强制开发同事Intent携参的key必须为按照EXTRA_<name>格式命名的常量。