关闭

android官方技术文档翻译——Android Lint

标签: Android技术文档Android官方文档Android文档翻译LintAndroid Lint
5057人阅读 评论(0) 收藏 举报
分类:

本文译自androd官方技术文档《Android Lint》,原文地址:http://tools.android.com/tips/lint

本文地址:http://blog.csdn.net/maosidiaoxian/article/details/41592783。转载请注明出处。翻译如有错讹,敬请指正。



Android Lint

Android Lint是在ADT 16(和 Tools 16)引入的一个新工具,可以扫描Android 项目源码中潜在的bug 。它可同时作为一个命令行工具,以及集​​成在Eclipse(如下所述),和IntelliJ(详细信息)中。这个架构是有意独立于IDE的,因此它有希望与其他的IDE,其他的构建工具和持续集成系统集成。


以下是它进行扫描的一些错误类型的例子:

  • 缺少翻译(和未使用的翻译)
  • 布局性能问题(老的layoutopt工具会用于查找所有这样的问题,和除此之外更多的问题)
  • 未使用的资源
  • 不一致的数组大小(当在多个配置中定义数组)
  • 可访问性和国际化问题(硬编码字符串,缺少contentDescription等)
  • 图标问题 (如丢失密度、 重复图标、 错误尺寸等)
  • 可用性问题 (如不在文本字段上指定输入的类型)
  • 清单错误
以及其他更多的问题。

请参阅此文档以了解当前 lint 检查的问题的完整列表。
有关如何取消显示(suppress)特定的 lint 警告信息,请参阅取消警告显示的文档.

如果你对编写自定义的lint 检查有兴趣,可以参阅编写新的 Lint 检查编写自定义 Lint 规则

命令行用法

在 SDK 工具目录有一个命令行工具叫做 lint
如果在你的path上已经配置了 SDK 的tools/ 目录,您可以使用“lint”来调用它。只需指向一个特定的 Android 项目目录。你也可以指向一个随机的目录,(如果它不是一个 Android 的项目)将以递归方式搜索,并将检查该目录下的所有项目。(你还可以指定通过空格分隔的多个项目)。
$ lint /src/astrid/
Scanning GreenDroid-GoogleAPIs: ..
Scanning stream: ...
Scanning api: ...........................
Scanning GDCatalog: .......................
Scanning GreenDroid: ...........................................................
Scanning tests: ...
Scanning filters: ....
Scanning tests: .....
Scanning astrid: ....................................................................................................................................................
Scanning simple: .......
api/res/values-ca: Error: Locale ca is missing translations for: sync_SPr_bgwifi_key, sync_SPr_forget_key, sync_SPr_interval_values, sync_SPr_logged_in_prefix... (2 more) [MissingTranslation]
astrid/res/values-ca: Error: Locale ca is missing translations for: DLG_cancel, DLG_dismiss, DLG_ok, EPr_deactivated... (117 more) [MissingTranslation]
api/res/values-cs: Error: Locale cs is missing translations for: sync_SPr_bgwifi_key, sync_SPr_forget_key, sync_SPr_interval_values, sync_SPr_logged_in_prefix... (2 more) [MissingTranslation]
(many lines omitted)
43 errors, 466 warnings

禁用检查

每种错误类型的“ID”都显示在错误消息后面的括号中,如上面的“MissingTranslation”。

您可以通过添加 --disable argument,禁用一个特定的检查,或一列的检查,例如: 
$ lint --disable MissingTranslation,UnusedIds,Usability:Icons /src/astrid/

注意,您也可以列出类别,比如上面的“Usability:Icons”,就是用性类别的图标子类别。 

有些检查默认情况下牌禁用状态。可以通过添加--enable标志启用它们。

最后,您可以通过--check标志指定运行哪些确切的检查。这让你可以在代码库中查找一个具体的问题,比如: 
$ lint --check MissingPrefix /src/astrid/

如果要找出哪个 id 和类别是可用的,请运行 
$ lint --list
Valid issue categories:
Correctness
Security
Performance
Usability
Usability:Icons
Accessibility
Internationalization

Valid issue id's:
"ContentDescription": Ensures that image widgets provide a contentDescription
"DuplicateIds": Checks for duplicate ids within a single layout
"StateListReachable": Looks for unreachable states in a <selector>
"InefficientWeight": Looks for inefficient weight declarations in LinearLayouts
"ScrollViewSize": Checks that ScrollViews use wrap_content in scrolling dimension
"MergeRootFrame": Checks whether a root <FrameLayout> can be replaced with a <merge> tag
...

使用--show命令加上 id 列表或类别 (或不带参数查看全部)可以获取指定的问题的解释:

$ lint --show MissingPrefix
MissingPrefix
-------------
Summary: Detect XML attributes not using the Android namespace

Priority: 8 / 10
Severity: Warning
Category: Correctness

Most Android views have attributes in the Android namespace. When
referencing these attributes you *must* include the namespace prefix,
or your attribute will be interpreted by aapt as just a custom
attribute.

HTML 报表

这个命令行工具还可以生成HTML报告。这相比普通的 lint 输出有一定的优势:
  • 它包含每个问题相关的更长的解释,并通过一个More info 的属性提供关于这个问题的更详细信息的链接。
  • 它包含有错误的实际的源代码行 (上下各有三行代码的一个窗口)。
  • 它可以包含关联到该源代码文件的链接
  • 对于错误图标,为能够比较起见,在报告中会显示图标本身
要生成 HTML 报告,只需要添加--html 文件名 作为参数:
$ lint --html /tmp/report.html

默认情况下,链接到源代码文件将只使用本地的 file:// 路径资源。您可以通过 --url 选项把 URL 重新映射向不同的前缀。例如:
$ lint --html /tmp/report.html --url /src/MyProj=http://buildserver/src/MyProj

其他命令行选项

运行lint --help以获取可用参数的相关信息。

Eclipse 中的用法

: 此文档是在 lint 首次发布时编写的。Eclipse 集成已经有了显著的提高。欲了解更多最新的详细信息,请参阅新的Eclipse Lint UI(New Eclipse Lint UI)

Lint 在 ADT 16及更高的版本上集成。该集成 提供了上述 Lint 命令行版本的几个功能:
  • 自动修复许多警告
  • Lint 可以在各种编辑器操作中自动运行
  • 屏幕某些错误类型及特定的错误实例
  • 配置问题检查严重程度
  • 从 lint 视图直接跳转到问题源码

Lint 自动化

在以下情况时 lint 会自动运行:
  • 导出 APK。在这种情况下,会以特殊模式运行 lint,它将只查找致命错误 (这样会更快),并且如果发现了任何错误的时候会中止导出。你可以在 Lint 选项中关闭它。
  • 编辑并保存和 XML 文件,例如布局文件或清单文件。在这种情况下,所有适用于给定文件的文件范围检查都会运行,并且会为任何已发现的问题加上编辑器的标记。
  • 使用布局编辑器。每个 UI 操作后,在布局文件上会运行文件范围检查 (如各种 layoutopt 规则),并且结果将显示在一个特别的 lint 窗口(当发现错误时它可以从显示在布局编辑器的右上角的错误标记中打开)。

Lint 窗口

要在一个项目上运行 Lint,请在包浏览器中选择项目,然后单击 Lint 工具栏上的功能(见下面的图片)。

或者您可以在项目上右击,在 Android Tools 子菜单中,有一个“运行 Lint”的功能。它将打开一个 Lint 窗口,其中包含各种错误。选择一个错误将会在右侧的文本区显示相关联的解释。

如果 lint 视图上有任何错误,你可以在错误上双击,来跳转到相关联的源代码位置。每个警告图标将显示其严重程度,并具对于已修复的警告(见下一节)会有一个小灯泡重叠。

该窗口也有一个操作栏(在右上角),它可以让你
  • 再次运行 lint 检查以刷新结果 (在刷新期间它会变成一个 Stop 按钮,用于中止检查)
  • 如果有错误,运行与此错误相关联的修复
  • 忽略此修复
  • 删除警告标记
  • 删除所有的警告标记

快速修复

许多 lint 警告有自动修复功能。例如,各种 layoutopt 修复的替换提示 (如替换 wrap_content 为 0dp)。 
  • 从 lint 视图中,单击灯泡来调用一个修复程序。
  • 从布局编辑器警告摘要中,单击修复按钮来修复。
  • 从 XML 代码编辑器中,调用快速修复 (Ctrl+1 或Command+1)并选择与该警告关联的快速修复。

取消错误警告的显示

从编辑器快速修复菜单中,你也可以选择
  • 仅忽略此文件中的这个警告
  • 忽略此项目中的这个警告
  • 在此期间忽略此警告。
  • 通过添加注解或属性忽略此广告, 此处有解释。


(如果你在 quickfix 列表找不到 lint 的修复操作,请参阅 已知 Bug 章节)

这些选择都存储项目里名为lint.xml的文件中,可以通过命令行工具读取。因此,您可以在 UI 中忽略警告,并在你的源项目关联的lint.xml文件中进行记录,其他运行着的lint将不会看到你已经忽略的警告(大概是因为已经手动验证了)。

选项

要编辑用于所有项目备用选项的 lint 全局选项,可以调用正常的 Eclipse 选项对话框,并选择 Android > Lint Options:


如果你选择了一个问题,您可以在右下角的下拉列表中编辑其严重程度。这使您可以把某些问题指定为 Error(即会在启用了靠近顶部的对话框中的选项的情况下中止导出 APK)。

要完全关闭问题检查,请选择“Ignore”作为严重程度。 
请注意此操作不会编辑每个项目的 lint 设置
。打开项目设置对话框 (右击该项目),你将在这里找到 Android Lint 的属性页。在选项对话框中手动严重性编辑也会与取消显示的错误一起被记录在lint.xml文件中,所以您的团队中的其他人将会获得你对这个项目编辑的相同的严重性设置。 

1
1
查看评论
发表评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场

android lint check的学习和自定义以及lint语法

lint介绍android lint是一个静态代码分析工具,通过lint工具,你可以不用边运行边调试,或者通过单元测试进行代码检查,可以检测代码中不规范、不和要求的问题,解决一些潜在的bug。lint工具可以在命令行上使用,也可以在adt中使用。比如当想检查在manifest.xml中是否有acti...
  • u010360371
  • u010360371
  • 2015-12-13 21:45
  • 2035

Android Studio使用Lint进行代码检查

Android Lint的使用 找到Analyze目录下的Inspect Code检查代码选项点击 然后弹出下面这个框框,在这个列表选项中我们可以选择Inspect Code的范围, 整个工程 某个module 当前文件 自定义范围 点击OK ...
  • huangxiaominglipeng
  • huangxiaominglipeng
  • 2016-10-20 17:37
  • 1600

Android代码优化——使用Android lint工具

作为移动应用开发者,我们总希望发布的apk文件越小越好,不希望资源文件没有用到的图片资源也被打包进apk,不希望应用中使用了高于minSdk的api,也不希望AndroidManifest文件存在异常,lint就能解决我们的这些问题。Android lint是在ADT 16提供的新工具,它是一个代码...
  • xyz_lmn
  • xyz_lmn
  • 2013-12-27 11:21
  • 50158

Android 静态代码工具-lint命令

1.工具位置 lint 工具位置在android-sdk目录下的tools里 2. lint使用 1>在命令行窗口 输入lint,得到lint 帮助说明如下: Usage: lint [flags] Flags: --help         ...
  • testdeveloper
  • testdeveloper
  • 2017-03-19 18:30
  • 767

团队项目必备神器——自定义Lint

Lint在android studio中内置了大概200个左右的lint检查,比如定义变量未使用,直接Handler报内存泄漏提醒,时时刻刻在监督着我们的代码。自己定制了一些Lint规则,项目开源在GitHub上 https://github.com/xsfelvis/LintDemo 为什么...
  • XSF50717
  • XSF50717
  • 2016-12-16 22:37
  • 1378

gradle入门--11.疏忽lint毛病这特别重要 不加发布会出各种问题

随着Android Studio愈来愈完善,更多的开发者舍弃掉Eclipse。但是新的IDE与以往的Eclipse有很大区分,这致使部份开发者望而生畏,其中1个大家觉得比较麻烦的是Android Studio采取的新的构建系统,gradle。那末这篇文章我将对gradle进行1个简单介绍(主要讲gr...
  • muyanfei
  • muyanfei
  • 2016-08-25 18:39
  • 850

代码检查工具(FindBugs和Android Lint)

FindBugs IDEA 简称 FBI 点击Browse repositories进去搜索findbugs, 能发现规范和bug的,只能静态分析,搜到之后点击install进行安装 ,安装成功之后,下面工具栏就会出现这样的图标 ...
  • yunnihao
  • yunnihao
  • 2016-07-12 19:29
  • 1571

Android工具:被你忽视的Lint

一、Lint简介测试你的Android应用除了确保它满足功能要求,确保代码没有结构问题也是非常重要的。结构不好的代码可能会影响你的Android应用的可靠性和效率,并且使得你的代码难于维护。例如,如果你的XML资源文件包含没有使用的命名空间,它会占用空间并导致不必要的处理。其它结构性问题,如使用过时...
  • p106786860
  • p106786860
  • 2017-01-07 23:52
  • 1411

【分享笔记】使用lint来改善你的代码

一.lint简介什么是静态代码分析静态代码分析是指无需运行被测代码,仅通过分析或检查源程序的语法、结构、过程、接口等来检查程序的正确性,找出代码隐藏的错误和缺陷,如参数不匹配,有歧义的嵌套语句,错误的递归,非法计算,可能出现的空指针引用等等。在软件开发过程中,静态代码分析往往先于动态测试之前进行,同...
  • a910626
  • a910626
  • 2016-06-22 22:22
  • 643

自定义 Lint 规则简介

上个月,笔者在巴黎 Droidcon 的 BarCamp 研讨会上聆听了 Matthew Compton 关于编写自己的 Lint 规则的讲话。深受启发之后,笔者想就此话题做进一步的探索。
  • wangpeng198688
  • wangpeng198688
  • 2016-02-26 17:16
  • 490
    个人资料
    • 访问:2132517次
    • 积分:14252
    • 等级:
    • 排名:第1011名
    • 原创:139篇
    • 转载:0篇
    • 译文:90篇
    • 评论:891条
    欢迎访问我的博客
    个人博客:http://githang.com
    QQ群
    博客专栏
    最新评论
    我的公众号
    微信关注我的公众号
    站长统计