测试基础使用 lint 增强你的代码

恒温 · 2015年08月13日 · 最后由朱光精回复于 2017年11月05日 · 4163 次阅读

本帖已被设为精华帖！

更新：

Android Lint needs sources to be compiled. Please build project before executing SonarQube and check the location of compiled classes.

使用 lint 增强你的代码

除了测试应用的功能需求外，确保代码没有结构性的问题也很重要。结构烂的代码会影响应用的可靠性和性能，而且也会使你的代码难以维护。举个栗子，如果你的 XML 资源文件有很多无用的命名空间，这会占用空间，产生不必要的开销。另外的结构问题，比如使用了 deprecated 的元素，调用了目标 API 版本不支持的接口，会直接导致运行不正确。

概述

Android SDK 提供了代码扫描工具 lint，它能非常容易地帮你找出代码上的结构问题。你不需要执行应用，也不需要写测试用例。lint 找到问题，带上问题的描述信息，严重程度一起报告给你，你可以很快的排好问题的优先级，然后决定哪些需要修复。你也可以定制问题的严重程度，忽略某些问题或者提高某些问题的严重性。lint 提供了命令行接口，你可以非常容易地把它集成到自动化过程中去。

lint 会从几个维度来检查你安卓项目代码可能存在的问题，并提供修复的建议：

正确性（correctness）
安全（security）
性能（performance）
可用性（usability）
可访问性（accessibility）
国际化（internationalization）

你可以从命令行或者 Android Studio 运行 lint。

图 1 lint 如果处理应用源代码

应用源文件

源文件包括 Java，XML，icon 和 ProGuard 配置文件。

lint.xml

lint 的配置文件，你可以在这个文件里配置需要排除的检查或者定制严重程度。

lint 的检查结果

你可以在终端或者在 Android Studio 的 Event 日志里查看 lint 的检查结果。每个问题都会有具体描述，被定为到具体代码的某一行。

lint 工具是 Android SDK（>=16）工具套件中的一个。

在 Android Studio 中运行 lint

在 Android Studio 中，每次构建应用的时候，配置好的 lint 和 IDE 检查会自动运行。因为 Android Studio 是 Intellij idea 社区版本上改的，所以 lint 会和 Intellij 的 IDE 检查一起运行来简化 code review。

Note: 如果想查看或者修改检查的严格程度，通过 File > Setting > Project Settings 来打开设置页面。

在 Android Studio 里，你可以指定某个构建版本来运行 lint，也可以为所有的构建版本运行 lint 检查，一切都在 build.grade 里指定。你也可以在 build.grade 里的 android 设置里添加 lintOptions 属性，比如：

android {
    lintOptions {
       // set to true to turn off analysis progress reporting by lint
       quiet true
       // if true, stop the gradle build if errors are found
       abortOnError false
       // if true, only report errors
       ignoreWarnings true
       }
       ...
    }

如果要手动运行检查的话，选择 Analyze > Inspect Code，按照弹出的对话框操作即可。

从命令行运行 lint

lint [flags] <项目目录>

比如，你可以使用下面的命令，扫描 myproject 目录以及子目录。MissingPrefix 告诉 lint 只扫描那些没加 Android 命名空间前缀的 XML 的属性。

lint --check MissingPrefix myproject

用 lint --help 查看所有的选项。

lint 输出例子

$ lint Earthquake

Scanning Earthquake: ...............................................................................................................................
Scanning Earthquake (Phase 2): .......
AndroidManifest.xml:23: Warning: <uses-sdk> tag appears after <application> tag [ManifestOrder]
  <uses-sdk android:minSdkVersion="7" />
  ^
AndroidManifest.xml:23: Warning: <uses-sdk> tag should specify a target API level (the highest verified version; when running on later versions, compatibility behaviors may be enabled) with android:targetSdkVersion="?" [UsesMinSdkAttributes]
  <uses-sdk android:minSdkVersion="7" />
  ^
res/layout/preferences.xml: Warning: The resource R.layout.preferences appears to be unused [UnusedResources]
res: Warning: Missing density variation folders in res: drawable-xhdpi [IconMissingDensityFolder]
0 errors, 4 warnings

上面的输出列出了四个 warning 和 0 个错误。其中，三个 warning（ManifestOrder，UsesMinSdkAttributes 和 UsesMinSdkAttributes）在 AndroidManifest.xml 里，IconMissingDensityFolder 在 Preferences.xml 的布局文件里。

配置 lint

lint 默认会把它支持的检查都跑一遍。你可以自己配置哪些问题需要检查，也可以自己指定这些问题的严重性。比如，你可以不检查那些和项目无关的问题、降低那些不是很严重的问题的严重程度。

你可以配置 lint 检查：

整个项目
按项目模块
按产品模块
按测试模块
按打开的文件
按类的层级
从版本控制器的角度

在 Android Studio 里配置 lint

Android Studio 允许你激活或者关闭单个文件的检查，也允许你配置整个项目，特定目录，特定文件。你可以在这里配置。

全局选项（Global preferences）

你可以指定整个项目级别。, 在 Project 这里选择项目，然后选择 Analyze > Inspect Code。
指定你检查的 scope 和 profile，然后点击 OK.

这样，每次构建和运行安卓项目或者模块的时候，lint 就按你配置的执行了。

模块和特定文件（Module and file-specific preferences）

Run the lint tool on your module by right-clicking on your module folder or file in the Project View and selecting Analyze > Inspect Code. This displays the lint inspection results with a list of issues that lint detected in your module.
在 Project 视图那里，右击你模块目录，选择 Analyze > Inspect Code，就会开始运行 lint。
从 Lint Warnings 视图，用 toolbar 选项配置单个模块或者文件的 lint 选项，设置问题的显示选项。

配置 lint.xml

在 Android 项目根目录创建 lint.xml。如果你用 Android Studio 配置的，会自动放在你的 Android 项目下。lint.xml 使用如下格式：

<?xml version="1.0" encoding="UTF-8"?>
    <lint>
        <!-- list of issues to configure -->
</lint>

为根节点，然后包含了很多子节点。每个有一个唯一的 id 属性。你可以通过修改这个 tag 的 severity 属性值，来决定是否要检查这个问题或者改变它的严重程度。

Tip: 试试看 lint --list 命令，你会找到所有支持的 issue 和他们的 ID。

Sample lint.xml


<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disable the given check in this project -->
    <issue id="IconMissingDensityFolder" severity="ignore" />

    <!-- Ignore the ObsoleteLayoutParam issue in the specified files -->
    <issue id="ObsoleteLayoutParam">
        <ignore path="res/layout/activation.xml" />
        <ignore path="res/layout-xlarge/activation.xml" />
    </issue>

    <!-- Ignore the UselessLeaf issue in the specified file -->
    <issue id="UselessLeaf">
        <ignore path="res/layout/main.xml" />
    </issue>

    <!-- Change the severity of hardcoded strings to "error" -->
    <issue id="HardcodedText" severity="error" />
</lint>

配置 Java 代码和 XML 文件中的 lint 检查

你可以在 Java 代码和 XML 关闭 lint 检查。

Tip: 在 Android Studio 中，你只需使用 File > Settings > Project Settings > Inspections feature 来控制 lint 即可。

Java 实现

下面的例子就是告诉你，对于 onCreate 方法不需要做 NewApi 的检查。lint 就会略过这个方法，但是这个类中的其他方法还是会做 NewApi 的检查。

@SuppressLint("NewApi")
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

下面的例子是说，对于 FeedProvider 这个类不需要做 ParserError 的检查：

@SuppressLint("ParserError")
public class FeedProvider extends ContentProvider {

啥都不查：

@SuppressLint("all")

配置 XML 的 lint 检查

使用 tools:ignore 这个属性关闭 lint 检查。当然你必须包含下面这个命名空间。

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

下面这个例子告诉你关闭 LinearLayout 这个元素的 UnusedResources 的检查。 ignore 的属性会被子元素继承。所以这个例子中，这个元素也不会去检查 UnusedResources 的问题。

<LinearLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:ignore="UnusedResources" >

    <TextView
        android:text="@string/auto_update_prompt" />
</LinearLayout>

关闭多个检查，以逗号分隔。

tools:ignore="NewApi,StringFormatInvalid"

都不检查：

tools:ignore="all" #节点属性

Available issues:

Correctness

AdapterViewChildren

Summary: AdapterViews cannot have children in XML

Priority: 10 / 10
Severity: Warning
Category: Correctness

AdapterViews such as ListViews must be configured with data from Java code,
such as a ListAdapter.

More information:
http://developer.android.com/reference/android/widget/AdapterView.html

OnClick

Summary: onClick method does not exist

Priority: 10 / 10
Severity: Error
Category: Correctness

The onClick attribute value should be the name of a method in this View's
context to invoke when the view is clicked. This name must correspond to a
public method that takes exactly one parameter of type View.

Must be a string value, using '\;' to escape characters such as '\n' or
'\uxxxx' for a unicode character.

StopShip

Summary: Code contains STOPSHIP marker

Priority: 10 / 10
Severity: Warning
Category: Correctness
NOTE: This issue is disabled by default!
You can enable it by adding --enable StopShip

Using the comment // STOPSHIP can be used to flag code that is incomplete but
checked in. This comment marker can be used to indicate that the code should
not be shipped until the issue is addressed, and lint will look for these.

MissingPermission

Summary: Missing Permissions

Priority: 9 / 10
Severity: Error
Category: Correctness

This check scans through your code and libraries and looks at the APIs being
used, and checks this against the set of permissions required to access those
APIs. If the code using those APIs is called at runtime, then the program will
crash.

Furthermore, for permissions that are revocable (with targetSdkVersion 23),
client code must also be prepared to handle the calls throwing an exception if
the user rejects the request for permission at runtime.

MissingSuperCall

Summary: Missing Super Call

Priority: 9 / 10
Severity: Error
Category: Correctness

Some methods, such as View#onDetachedFromWindow, require that you also call
the super implementation as part of your method.

ResAuto

Summary: Hardcoded Package in Namespace

Priority: 9 / 10
Severity: Fatal
Category: Correctness

In Gradle projects, the actual package used in the final APK can vary; for
example,you can add a .debug package suffix in one version and not the other.
Therefore, you should not hardcode the application package in the resource;
instead, use the special namespace http://schemas.android.com/apk/res-auto
which will cause the tools to figure out the right namespace for the resource
regardless of the actual package used during the build.

SuspiciousImport

Summary: 'import android.R' statement

Priority: 9 / 10
Severity: Warning
Category: Correctness

Importing android.R is usually not intentional; it sometimes happens when you
use an IDE and ask it to automatically add imports at a time when your
project's R class it not present.

Once the import is there you might get a lot of "confusing" error messages
because of course the fields available on android.R are not the ones you'd
expect from just looking at your own R class.

UsesMinSdkAttributes

Summary: Minimum SDK and target SDK attributes not defined

Priority: 9 / 10
Severity: Warning
Category: Correctness

The manifest should contain a element which defines the minimum API
Level required for the application to run, as well as the target version (the
highest API level you have tested the version for.)

More information:
http://developer.android.com/guide/topics/manifest/uses-sdk-element.html

WrongViewCast

Summary: Mismatched view type

Priority: 9 / 10
Severity: Fatal
Category: Correctness

Keeps track of the view types associated with ids and if it finds a usage of
the id in the Java code it ensures that it is treated as the same type.

AaptCrash

Summary: Potential AAPT crash

Priority: 8 / 10
Severity: Fatal
Category: Correctness

Defining a style which sets android:id to a dynamically generated id can cause
many versions of aapt, the resource packaging tool, to crash. To work around
this, declare the id explicitly with instead.

More information:
https://code.google.com/p/android/issues/detail?id=20479

AndroidGradlePluginVersion

Summary: Incompatible Android Gradle Plugin

Priority: 8 / 10
Severity: Error
Category: Correctness

Not all versions of the Android Gradle plugin are compatible with all versions
of the SDK. If you update your tools, or if you are trying to open a project
that was built with an old version of the tools, you may need to update your
plugin version number.

GradleCompatible

Summary: Incompatible Gradle Versions

Priority: 8 / 10
Severity: Error
Category: Correctness

There are some combinations of libraries, or tools and libraries, that are
incompatible, or can lead to bugs. One such incompatibility is compiling with
a version of the Android support libraries that is not the latest version (or
in particular, a version lower than your targetSdkVersion.)

IllegalResourceRef

Summary: Name and version must be integer or string, not resource

Priority: 8 / 10
Severity: Warning
Category: Correctness

For the versionCode attribute, you have to specify an actual integer literal;
you cannot use an indirection with a @dimen/name resource. Similarly, the
versionName attribute should be an actual string, not a string resource url.

MissingRegistered

Summary: Missing registered class

Priority: 8 / 10
Severity: Error
Category: Correctness

If a class is referenced in the manifest, it must also exist in the project
(or in one of the libraries included by the project. This check helps uncover
typos in registration names, or attempts to rename or move classes without
updating the manifest file properly.

More information:
http://developer.android.com/guide/topics/manifest/manifest-intro.html

MockLocation

Summary: Using mock location provider in production

Priority: 8 / 10
Severity: Fatal
Category: Correctness

Using a mock location provider (by requiring the permission
android.permission.ACCESS_MOCK_LOCATION) should only be done in debug builds
(or from tests). In Gradle projects, that means you should only request this
permission in a test or debug source set specific manifest file.

To fix this, create a new manifest file in the debug folder and move the
element there. A typical path to a debug manifest override
file in a Gradle project is src/debug/AndroidManifest.xml.

NamespaceTypo

Summary: Misspelled namespace declaration

Priority: 8 / 10
Severity: Fatal
Category: Correctness

Accidental misspellings in namespace declarations can lead to some very
obscure error messages. This check looks for potential misspellings to help
track these down.

Proguard

Summary: Using obsolete ProGuard configuration

Priority: 8 / 10
Severity: Fatal
Category: Correctness

Using -keepclasseswithmembernames in a proguard config file is not correct; it
can cause some symbols to be renamed which should not be.
Earlier versions of ADT used to create proguard.cfg files with the wrong
format. Instead of -keepclasseswithmembernames use -keepclasseswithmembers,
since the old flags also implies "allow shrinking" which means symbols only
referred to from XML and not Java (such as possibly CustomViews) can get
deleted.

More information:
http://http://code.google.com/p/android/issues/detail?id=16384

ReferenceType

Summary: Incorrect reference types

Priority: 8 / 10
Severity: Fatal
Category: Correctness

When you generate a resource alias, the resource you are pointing to must be
of the same type as the alias

ResourceCycle

Summary: Cycle in resource definitions

Priority: 8 / 10
Severity: Fatal
Category: Correctness

There should be no cycles in resource definitions as this can lead to runtime
exceptions.

ResourceName

Summary: Resource with Wrong Prefix

Priority: 8 / 10
Severity: Fatal
Category: Correctness

In Gradle projects you can specify a resource prefix that all resources in the
project must conform to. This makes it easier to ensure that you don't
accidentally combine resources from different libraries, since they all end up
in the same shared app namespace.

ScrollViewCount

Summary: ScrollViews can have only one child

Priority: 8 / 10
Severity: Warning
Category: Correctness

ScrollViews can only have one child widget. If you want more children, wrap
them in a container layout.

StringShouldBeInt

Summary: String should be int

Priority: 8 / 10
Severity: Error
Category: Correctness

The properties compileSdkVersion, minSdkVersion and targetSdkVersion are
usually numbers, but can be strings when you are using an add-on (in the case
of compileSdkVersion) or a preview platform (for the other two properties).

However, you can not use a number as a string (e.g. "19" instead of 19); that
will result in a platform not found error message at build/sync time.

UnknownId

Summary: Reference to an unknown id

Priority: 8 / 10
Severity: Fatal
Category: Correctness

The @+id/ syntax refers to an existing id, or creates a new one if it has not
already been defined elsewhere. However, this means that if you have a typo in
your reference, or if the referred view no longer exists, you do not get a
warning since the id will be created on demand. This check catches errors
where you have renamed an id without updating all of the references to it.

WrongFolder

Summary: Resource file in the wrong res folder

Priority: 8 / 10
Severity: Fatal
Category: Correctness

Resource files are sometimes placed in the wrong folder, and it can lead to
subtle bugs that are hard to understand. This check looks for problems in this
area, such as attempting to place a layout "alias" file in a layout/ folder
rather than the values/ folder where it belongs.

CommitTransaction

Summary: Missing commit() calls

Priority: 7 / 10
Severity: Warning
Category: Correctness

After creating a FragmentTransaction, you typically need to commit it as well

DalvikOverride

Summary: Method considered overridden by Dalvik

Priority: 7 / 10
Severity: Error
Category: Correctness

The Android virtual machine will treat a package private method in one class
as overriding a package private method in its super class, even if they are in
separate packages. This may be surprising, but for compatibility reasons the
behavior has not been changed (yet).

If you really did intend for this method to override the other, make the
method protected instead.

If you did not intend the override, consider making the method private, or
changing its name or signature.

DeviceAdmin

Summary: Malformed Device Admin

Priority: 7 / 10
Severity: Warning
Category: Correctness

If you register a broadcast receiver which acts as a device admin, you must
also register an for the action
android.app.action.DEVICE_ADMIN_ENABLED, without any , such that the
device admin can be activated/deactivated.

To do this, add

to your .

DuplicateIds

Summary: Duplicate ids within a single layout

Priority: 7 / 10
Severity: Fatal
Category: Correctness

Within a layout, id's should be unique since otherwise findViewById() can
return an unexpected view.

InconsistentArrays

Summary: Inconsistencies in array element counts

Priority: 7 / 10
Severity: Warning
Category: Correctness

When an array is translated in a different locale, it should normally have the
same number of elements as the original array. When adding or removing
elements to an array, it is easy to forget to update all the locales, and this
lint warning finds inconsistencies like these.

Note however that there may be cases where you really want to declare a
different number of array items in each configuration (for example where the
array represents available options, and those options differ for different
layout orientations and so on), so use your own judgement to decide if this is
really an error.

You can suppress this error type if it finds false errors in your project.

NestedScrolling

Summary: Nested scrolling widgets

Priority: 7 / 10
Severity: Warning
Category: Correctness

A scrolling widget such as a ScrollView should not contain any nested
scrolling widgets since this has various usability issues

ResourceAsColor

Summary: Should pass resolved color instead of resource id

Priority: 7 / 10
Severity: Error
Category: Correctness

Methods that take a color in the form of an integer should be passed an RGB
triple, not the actual color resource id. You must call
getResources().getColor(resource) to resolve the actual color value first.

ResourceType

Summary: Wrong Resource Type

Priority: 7 / 10
Severity: Fatal
Category: Correctness

Ensures that resource id's passed to APIs are of the right type; for example,
calling Resources.getColor(R.string.name) is wrong.

ScrollViewSize

Summary: ScrollView size validation

Priority: 7 / 10
Severity: Warning
Category: Correctness

ScrollView children must set their layout_width or layout_height attributes to
wrap_content rather than fill_parent or match_parent in the scrolling
dimension

TextViewEdits

Summary: TextView should probably be an EditText instead

Priority: 7 / 10
Severity: Warning
Category: Correctness

Using a to input text is generally an error, you should be using
instead. EditText is a subclass of TextView, and some of the
editing support is provided by TextView, so it's possible to set some
input-related properties on a TextView. However, using a TextView along with
input attributes is usually a cut & paste error. To input text you should be
using .

This check also checks subclasses of TextView, such as Button and CheckBox,
since these have the same issue: they should not be used with editable
attributes.

WebViewLayout

Summary: WebViews in wrap_content parents

Priority: 7 / 10
Severity: Error
Category: Correctness

The WebView implementation has certain performance optimizations which will
not work correctly if the parent view is using wrap_content rather than
match_parent. This can lead to subtle UI bugs.

AppCompatMethod

Summary: Using Wrong AppCompat Method

Priority: 6 / 10
Severity: Warning
Category: Correctness

When using the appcompat library, there are some methods you should be calling
instead of the normal ones; for example, getSupportActionBar() instead of
getActionBar(). This lint check looks for calls to the wrong method.

More information:
http://developer.android.com/tools/support-library/index.html

Assert

Summary: Assertions

Priority: 6 / 10
Severity: Warning
Category: Correctness

Assertions are not checked at runtime. There are ways to request that they be
used by Dalvik (adb shell setprop debug.assert 1), but the property is ignored
in many places and can not be relied upon. Instead, perform conditional
checking inside if (BuildConfig.DEBUG) { } blocks. That constant is a static
final boolean which is true in debug builds and false in release builds, and
the Java compiler completely removes all code inside the if-body from the
app.

For example, you can replace assert speed > 0 with if (BuildConfig.DEBUG &&
!(speed > 0)) { throw new AssertionError() }.

(Note: This lint check does not flag assertions purely asserting nullness or
non-nullness; these are typically more intended for tools usage than runtime
checks.)

More information:
https://code.google.com/p/android/issues/detail?id=65183

CheckResult

Summary: Ignoring results

Priority: 6 / 10
Severity: Warning
Category: Correctness

Some methods have no side effects, an calling them without doing something
without the result is suspicious.

CommitPrefEdits

Summary: Missing commit() on SharedPreference editor

Priority: 6 / 10
Severity: Warning
Category: Correctness

After calling edit() on a SharedPreference, you must call commit() or apply()
on the editor to save the results.

CustomViewStyleable

Summary: Mismatched Styleable/Custom View Name

Priority: 6 / 10
Severity: Warning
Category: Correctness

The convention for custom views is to use a declare-styleable whose name
matches the custom view class name. The IDE relies on this convention such
that for example code completion can be offered for attributes in a custom
view in layout XML resource files.

(Similarly, layout parameter classes should use the suffix _Layout.)

CutPasteId

Summary: Likely cut & paste mistakes

Priority: 6 / 10
Severity: Warning
Category: Correctness

This lint check looks for cases where you have cut & pasted calls to
findViewById but have forgotten to update the R.id field. It's possible that
your code is simply (redundantly) looking up the field repeatedly, but lint
cannot distinguish that from a case where you for example want to initialize
fields prev and next and you cut & pasted findViewById(R.id.prev) and forgot
to update the second initialization to R.id.next.

DefaultLocale

Summary: Implied default locale in case conversion

Priority: 6 / 10
Severity: Warning
Category: Correctness

Calling String#toLowerCase() or #toUpperCase() without specifying an explicit
locale is a common source of bugs. The reason for that is that those methods
will use the current locale on the user's device, and even though the code
appears to work correctly when you are developing the app, it will fail in
some locales. For example, in the Turkish locale, the uppercase replacement
for i is not I.

If you want the methods to just perform ASCII replacement, for example to
convert an enum name, call String#toUpperCase(Locale.US) instead. If you
really want to use the current locale, call
String#toUpperCase(Locale.getDefault()) instead.

More information:
http://developer.android.com/reference/java/util/Locale.html#default_locale

DuplicateDefinition

Summary: Duplicate definitions of resources

Priority: 6 / 10
Severity: Error
Category: Correctness

You can define a resource multiple times in different resource folders; that's
how string translations are done, for example. However, defining the same
resource more than once in the same resource folder is likely an error, for
example attempting to add a new resource without realizing that the name is
already used, and so on.

DuplicateIncludedIds

Summary: Duplicate ids across layouts combined with include tags

Priority: 6 / 10
Severity: Warning
Category: Correctness

It's okay for two independent layouts to use the same ids. However, if layouts
are combined with include tags, then the id's need to be unique within any
chain of included layouts, or Activity#findViewById() can return an unexpected
view.

GradleDeprecated

Summary: Deprecated Gradle Construct

Priority: 6 / 10
Severity: Warning
Category: Correctness

This detector looks for deprecated Gradle constructs which currently work but
will likely stop working in a future update.

GradleGetter

Summary: Gradle Implicit Getter Call

Priority: 6 / 10
Severity: Error
Category: Correctness

Gradle will let you replace specific constants in your build scripts with
method calls, so you can for example dynamically compute a version string
based on your current version control revision number, rather than hardcoding
a number.

When computing a version name, it's tempting to for example call the method to
do that getVersionName. However, when you put that method call inside the
defaultConfig block, you will actually be calling the Groovy getter for the
versionName property instead. Therefore, you need to name your method
something which does not conflict with the existing implicit getters. Consider
using compute as a prefix instead of get.

InconsistentLayout

Summary: Inconsistent Layouts

Priority: 6 / 10
Severity: Warning
Category: Correctness

This check ensures that a layout resource which is defined in multiple
resource folders, specifies the same set of widgets.

This finds cases where you have accidentally forgotten to add a widget to all
variations of the layout, which could result in a runtime crash for some
resource configurations when a findViewById() fails.

There are cases where this is intentional. For example, you may have a
dedicated large tablet layout which adds some extra widgets that are not
present in the phone version of the layout. As long as the code accessing the
layout resource is careful to handle this properly, it is valid. In that case,
you can suppress this lint check for the given extra or missing views, or the
whole layout

InlinedApi

Summary: Using inlined constants on older versions

Priority: 6 / 10
Severity: Warning
Category: Correctness

This check scans through all the Android API field references in the
application and flags certain constants, such as static final integers and
Strings, which were introduced in later versions. These will actually be
copied into the class files rather than being referenced, which means that the
value is available even when running on older devices. In some cases that's
fine, and in other cases it can result in a runtime crash or incorrect
behavior. It depends on the context, so consider the code carefully and device
whether it's safe and can be suppressed or whether the code needs tbe
guarded.

If you really want to use this API and don't need to support older devices
just set the minSdkVersion in your build.gradle or AndroidManifest.xml files.
If your code is deliberately accessing newer APIs, and you have ensured (e.g.
with conditional execution) that this code will only ever be called on a
supported platform, then you can annotate your class or method with the
@TargetApi annotation specifying the local minimum SDK to apply, such as
@TargetApi(11), such that this check considers 11 rather than your manifest
file's minimum SDK as the required API level.

Instantiatable

Summary: Registered class is not instantiatable

Priority: 6 / 10
Severity: Fatal
Category: Correctness

Activities, services, broadcast receivers etc. registered in the manifest file
must be "instantiatable" by the system, which means that the class must be
public, it must have an empty public constructor, and if it's an inner class,
it must be a static inner class.

InvalidId

Summary: Invalid ID declaration

Priority: 6 / 10
Severity: Fatal
Category: Correctness

An id definition must be of the form @+id/yourname. The tools have not
rejected strings of the form @+foo/bar in the past, but that was an error, and
could lead to tricky errors because of the way the id integers are assigned.

If you really want to have different "scopes" for your id's, use prefixes
instead, such as login_button1 and login_button2.

InvalidPackage

Summary: Package not included in Android

Priority: 6 / 10
Severity: Error
Category: Correctness

This check scans through libraries looking for calls to APIs that are not
included in Android.

When you create Android projects, the classpath is set up such that you can
only access classes in the API packages that are included in Android. However,
if you add other projects to your libs/ folder, there is no guarantee that
those .jar files were built with an Android specific classpath, and in
particular, they could be accessing unsupported APIs such as java.applet.

This check scans through library jars and looks for references to API packages
that are not included in Android and flags these. This is only an error if
your code calls one of the library classes which wind up referencing the
unsupported package.

InvalidResourceFolder

Summary: Invalid Resource Folder

Priority: 6 / 10
Severity: Error
Category: Correctness

This lint check looks for a folder name that is not a valid resource folder
name; these will be ignored and not packaged by the Android Gradle build
plugin.

Note that the order of resources is very important; for example, you can't
specify a language before a network code.

Similarly, note that to use 3 letter region codes, you have to use a special
BCP 47 syntax: the prefix b+ followed by the BCP 47 language tag but with + as
the individual separators instead of -. Therefore, for the BCP 47 language tag
nl-ABW you have to use b+nl+ABW.

More information:
http://developer.android.com/guide/topics/resources/providing-resources.html
https://tools.ietf.org/html/bcp47

LibraryCustomView

Summary: Custom views in libraries should use res-auto-namespace

Priority: 6 / 10
Severity: Fatal
Category: Correctness

When using a custom view with custom attributes in a library project, the
layout must use the special namespace http://schemas.android.com/apk/res-auto
instead of a URI which includes the library project's own package. This will
be used to automatically adjust the namespace of the attributes when the
library resources are merged into the application project.

LocaleFolder

Summary: Wrong locale name

Priority: 6 / 10
Severity: Warning
Category: Correctness

From the java.util.Locale documentation:
"Note that Java uses several deprecated two-letter codes. The Hebrew ("he")
language code is rewritten as "iw", Indonesian ("id") as "in", and Yiddish
("yi") as "ji". This rewriting happens even if you construct your own Locale
object, not just for instances returned by the various lookup methods.

Because of this, if you add your localized resources in for example values-he
they will not be used, since the system will look for values-iw instead.

To work around this, place your resources in a values folder using the
deprecated language code instead.

More information:
http://developer.android.com/reference/java/util/Locale.html

MissingPrefix

Summary: Missing Android XML namespace

Priority: 6 / 10
Severity: Error
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.

Similarly, in manifest files, nearly all attributes should be in the android:
namespace.

MultipleUsesSdk

Summary: Multiple elements in the manifest

Priority: 6 / 10
Severity: Fatal
Category: Correctness

The element should appear just once; the tools will not merge the
contents of all the elements so if you split up the attributes across multiple
elements, only one of them will take effect. To fix this, just merge all the
attributes from the various elements into a single element.

More information:
http://developer.android.com/guide/topics/manifest/uses-sdk-element.html

NewApi

Summary: Calling new methods on older versions

Priority: 6 / 10
Severity: Error
Category: Correctness

This check scans through all the Android API calls in the application and
warns about any calls that are not available on all versions targeted by this
application (according to its minimum SDK attribute in the manifest).

If you really want to use this API and don't need to support older devices
just set the minSdkVersion in your build.gradle or AndroidManifest.xml files.

If your code is deliberately accessing newer APIs, and you have ensured (e.g.
with conditional execution) that this code will only ever be called on a
supported platform, then you can annotate your class or method with the
@TargetApi annotation specifying the local minimum SDK to apply, such as
@TargetApi(11), such that this check considers 11 rather than your manifest
file's minimum SDK as the required API level.

If you are deliberately setting android: attributes in style definitions, make
sure you place this in a values-vNN folder in order to avoid running into
runtime conflicts on certain devices where manufacturers have added custom
attributes whose ids conflict with the new ones on later platforms.

Similarly, you can use tools:targetApi="11" in an XML file to indicate that
the element will only be inflated in an adequate context.

NotSibling

Summary: RelativeLayout Invalid Constraints

Priority: 6 / 10
Severity: Fatal
Category: Correctness

Layout constraints in a given RelativeLayout should reference other views
within the same relative layout (but not itself!)

OldTargetApi

Summary: Target SDK attribute is not targeting latest version

Priority: 6 / 10
Severity: Warning
Category: Correctness

When your application runs on a version of Android that is more recent than
your targetSdkVersion specifies that it has been tested with, various
compatibility modes kick in. This ensures that your application continues to
work, but it may look out of place. For example, if the targetSdkVersion is
less than 14, your app may get an option button in the UI.

To fix this issue, set the targetSdkVersion to the highest available value.
Then test your app to make sure everything works correctly. You may want to
consult the compatibility notes to see what changes apply to each version you
are adding support for:
http://developer.android.com/reference/android/os/Build.VERSION_CODES.html

More information:
http://developer.android.com/reference/android/os/Build.VERSION_CODES.html

Override

Summary: Method conflicts with new inherited method

Priority: 6 / 10
Severity: Error
Category: Correctness

Suppose you are building against Android API 8, and you've subclassed
Activity. In your subclass you add a new method called isDestroyed(). At some
later point, a method of the same name and signature is added to Android. Your
method will now override the Android method, and possibly break its contract.
Your method is not calling super.isDestroyed(), since your compilation target
doesn't know about the method.

The above scenario is what this lint detector looks for. The above example is
real, since isDestroyed() was added in API 17, but it will be true for any
method you have added to a subclass of an Android class where your build
target is lower than the version the method was introduced in.

To fix this, either rename your method, or if you are really trying to augment
the builtin method if available, switch to a higher build target where you can
deliberately add @Override on your overriding method, and call super if
appropriate etc.

OverrideAbstract

Summary: Not overriding abstract methods on older platforms

Priority: 6 / 10
Severity: Fatal
Category: Correctness

To improve the usability of some APIs, some methods that used to be abstract
have been made concrete by adding default implementations. This means that
when compiling with new versions of the SDK, your code does not have to
override these methods.

However, if your code is also targeting older versions of the platform where
these methods were still abstract, the code will crash. You must override all
methods that used to be abstract in any versions targeted by your
application's minSdkVersion.

PropertyEscape

Summary: Incorrect property escapes

Priority: 6 / 10
Severity: Error
Category: Correctness

All backslashes and colons in .property files must be escaped with a backslash
(). This means that when writing a Windows path, you must escape the file
separators, so the path \My\Files should be written as key=\My\Files.

Range

Summary: Outside Range

Priority: 6 / 10
Severity: Error
Category: Correctness

Some parameters are required to in a particular numerical range; this check
makes sure that arguments passed fall within the range. For arrays, Strings
and collections this refers to the size or length.

Registered

Summary: Class is not registered in the manifest

Priority: 6 / 10
Severity: Warning
Category: Correctness

Activities, services and content providers should be registered in the
AndroidManifest.xml file using , and tags.

If your activity is simply a parent class intended to be subclassed by other
"real" activities, make it an abstract class.

More information:
http://developer.android.com/guide/topics/manifest/manifest-intro.html

SdCardPath

Summary: Hardcoded reference to /sdcard

Priority: 6 / 10
Severity: Warning
Category: Correctness

Your code should not reference the /sdcard path directly; instead use
Environment.getExternalStorageDirectory().getPath().

Similarly, do not reference the /data/data/ path directly; it can vary in
multi-user scenarios. Instead, use Context.getFilesDir().getPath().

More information:
http://developer.android.com/guide/topics/data/data-storage.html#filesExternal

ServiceCast

Summary: Wrong system service casts

Priority: 6 / 10
Severity: Fatal
Category: Correctness

When you call Context#getSystemService(), the result is typically cast to a
specific interface. This lint check ensures that the cast is compatible with
the expected type of the return value.

ShortAlarm

Summary: Short or Frequent Alarm

Priority: 6 / 10
Severity: Warning
Category: Correctness

Frequent alarms are bad for battery life. As of API 22, the AlarmManager will
override near-future and high-frequency alarm requests, delaying the alarm at
least 5 seconds into the future and ensuring that the repeat interval is at
least 60 seconds.

If you really need to do work sooner than 5 seconds, post a delayed message or
runnable to a Handler.

ShowToast

Summary: Toast created but not shown

Priority: 6 / 10
Severity: Warning
Category: Correctness

Toast.makeText() creates a Toast but does not show it. You must call show() on
the resulting object to actually make the Toast appear.

SimpleDateFormat

Summary: Implied locale in date format

Priority: 6 / 10
Severity: Warning
Category: Correctness

Almost all callers should use getDateInstance(), getDateTimeInstance(), or
getTimeInstance() to get a ready-made instance of SimpleDateFormat suitable
for the user's locale. The main reason you'd create an instance this class
directly is because you need to format/parse a specific machine-readable
format, in which case you almost certainly want to explicitly ask for US to
ensure that you get ASCII digits (rather than, say, Arabic digits).

Therefore, you should either use the form of the SimpleDateFormat constructor
where you pass in an explicit locale, such as Locale.US, or use one of the get
instance methods, or suppress this error if really know what you are doing.

More information:
http://developer.android.com/reference/java/text/SimpleDateFormat.html

Suspicious0dp

Summary: Suspicious 0dp dimension

Priority: 6 / 10
Severity: Error
Category: Correctness

Using 0dp as the width in a horizontal LinearLayout with weights is a useful
trick to ensure that only the weights (and not the intrinsic sizes) are used
when sizing the children.

However, if you use 0dp for the opposite dimension, the view will be
invisible. This can happen if you change the orientation of a layout without
also flipping the 0dp dimension in all the children.

UniquePermission

Summary: Permission names are not unique

Priority: 6 / 10
Severity: Fatal
Category: Correctness

The unqualified names or your permissions must be unique. The reason for this
is that at build time, the aapt tool will generate a class named Manifest
which contains a field for each of your permissions. These fields are named
using your permission unqualified names (i.e. the name portion after the last
dot).

If more than one permission maps to the same field name, that field will
arbitrarily name just one of them.

UnusedAttribute

Summary: Attribute unused on older versions

Priority: 6 / 10
Severity: Warning
Category: Correctness

This check finds attributes set in XML files that were introduced in a version
newer than the oldest version targeted by your application (with the
minSdkVersion attribute).

This is not an error; the application will simply ignore the attribute.
However, if the attribute is important to the appearance of functionality of
your application, you should consider finding an alternative way to achieve
the same result with only available attributes, and then you can optionally
create a copy of the layout in a layout-vNN folder which will be used on API
NN or higher where you can take advantage of the newer attribute.

Note: This check does not only apply to attributes. For example, some tags can
be unused too, such as the new element in layouts introduced in API 21.

UseAlpha2

Summary: Using 3-letter Codes

Priority: 6 / 10
Severity: Warning
Category: Correctness

For compatibility with earlier devices, you should only use 3-letter language
and region codes when there is no corresponding 2 letter code.

More information:
https://tools.ietf.org/html/bcp47

ValidFragment

Summary: Fragment not instantiatable

Priority: 6 / 10
Severity: Fatal
Category: Correctness

From the Fragment documentation:
Every fragment must have an empty constructor, so it can be instantiated when
restoring its activity's state. It is strongly recommended that subclasses do
not have other constructors with parameters, since these constructors will not
be called when the fragment is re-instantiated; instead, arguments can be
supplied by the caller with setArguments(Bundle) and later retrieved by the
Fragment with getArguments().

More information:
http://developer.android.com/reference/android/app/Fragment.html#Fragment()

WrongCall

Summary: Using wrong draw/layout method

Priority: 6 / 10
Severity: Fatal
Category: Correctness

Custom views typically need to call measure() on their children, not
onMeasure. Ditto for onDraw, onLayout, etc.

WrongManifestParent

Summary: Wrong manifest parent

Priority: 6 / 10
Severity: Fatal
Category: Correctness

The element should be defined as a direct child of the
tag, not the tag or an tag. Similarly, a
tag much be declared at the root level, and so on. This check looks
for incorrect declaration locations in the manifest, and complains if an
element is found in the wrong place.

More information:
http://developer.android.com/guide/topics/manifest/manifest-intro.html

WrongRegion

Summary: Suspicious Language/Region Combination

Priority: 6 / 10
Severity: Warning
Category: Correctness

Android uses the letter codes ISO 639-1 for languages, and the letter codes
ISO 3166-1 for the region codes. In many cases, the language code and the
country where the language is spoken is the same, but it is also often not the
case. For example, while 'se' refers to Sweden, where Swedish is spoken, the
language code for Swedish is not se (which refers to the Northern Sami
language), the language code is sv. And similarly the region code for sv is El
Salvador.

This lint check looks for suspicious language and region combinations, to help
catch cases where you've accidentally used the wrong language or region code.
Lint knows about the most common regions where a language is spoken, and if a
folder combination is not one of these, it is flagged as suspicious.

Note however that it may not be an error: you can theoretically have speakers
of any language in any region and want to target that with your resources, so
this check is aimed at tracking down likely mistakes, not to enforce a
specific set of region and language combinations.

WrongThread

Summary: Wrong Thread

Priority: 6 / 10
Severity: Error
Category: Correctness

Ensures that a method which expects to be called on a specific thread, is
actually called from that thread. For example, calls on methods in widgets
should always be made on the UI thread.

More information:
http://developer.android.com/guide/components/processes-and-threads.html#Threads

DuplicateActivity

Summary: Activity registered more than once

Priority: 5 / 10
Severity: Fatal
Category: Correctness

An activity should only be registered once in the manifest. If it is
accidentally registered more than once, then subtle errors can occur, since
attribute declarations from the two elements are not merged, so you may
accidentally remove previous declarations.

DuplicateUsesFeature

Summary: Feature declared more than once

Priority: 5 / 10
Severity: Warning
Category: Correctness

A given feature should only be declared once in the manifest.

FullBackupContent

Summary: Valid Full Backup Content File

Priority: 5 / 10
Severity: Fatal
Category: Correctness

Ensures that a file, which is pointed to by a
android:fullBackupContent attribute in the manifest file, is valid

IncludeLayoutParam

Summary: Ignored layout params on include

Priority: 5 / 10
Severity: Error
Category: Correctness

Layout parameters specified on an tag will only be used if you also
override layout_width and layout_height on the tag; otherwise they
will be ignored.

More information:
http://stackoverflow.com/questions/2631614/does-android-xml-layouts-include-tag-really-work

InflateParams

Summary: Layout Inflation without a Parent

Priority: 5 / 10
Severity: Warning
Category: Correctness

When inflating a layout, avoid passing in null as the parent view, since
otherwise any layout parameters on the root of the inflated layout will be
ignored.

More information:
http://www.doubleencore.com/2013/05/layout-inflation-as-intended

LogTagMismatch

Summary: Mismatched Log Tags

Priority: 5 / 10
Severity: Error
Category: Correctness

When guarding a Log.v(tag, ...) call with Log.isLoggable(tag), the tag passed
to both calls should be the same. Similarly, the level passed in to
Log.isLoggable should typically match the type of Log call, e.g. if checking
level Log.DEBUG, the corresponding Log call should be Log.d, not Log.i.

LongLogTag

Summary: Too Long Log Tags

Priority: 5 / 10
Severity: Error
Category: Correctness

Log tags are only allowed to be at most 23 tag characters long.

ManifestOrder

Summary: Incorrect order of elements in manifest

Priority: 5 / 10
Severity: Warning
Category: Correctness

The tag should appear after the elements which declare which
version you need, which features you need, which libraries you need, and so
on. In the past there have been subtle bugs (such as themes not getting
applied correctly) when the tag appears before some of these
other elements, so it's best to order your manifest in the logical dependency
order.

ManifestTypo

Summary: Typos in manifest tags

Priority: 5 / 10
Severity: Fatal
Category: Correctness

This check looks through the manifest, and if it finds any tags that look like
likely misspellings, they are flagged.

MissingId

Summary: Fragments should specify an id or tag

Priority: 5 / 10
Severity: Warning
Category: Correctness

If you do not specify an android:id or an android:tag attribute on a
element, then if the activity is restarted (for example for an
orientation rotation) you may lose state. From the fragment documentation:

"Each fragment requires a unique identifier that the system can use to restore
the fragment if the activity is restarted (and which you can use to capture
the fragment to perform transactions, such as remove it).

Supply the android:id attribute with a unique ID.
Supply the android:tag attribute with a unique string. If you provide neither of the previous two, the system uses the ID of the container view.

More information:
http://developer.android.com/guide/components/fragments.html

NfcTechWhitespace

Summary: Whitespace in NFC tech lists

Priority: 5 / 10
Severity: Fatal
Category: Correctness

In a , there can be whitespace around the elements,but not
inside them. This is because the code which reads in the tech list is
currently very strict and will include the whitespace as part of the name.

In other words, use name, not name .

More information:
https://code.google.com/p/android/issues/detail?id=65351

ProtectedPermissions

Summary: Using system app permission

Priority: 5 / 10
Severity: Error
Category: Correctness

Permissions with the protection level signature or signatureOrSystem are only
granted to system apps. If an app is a regular non-system app, it will never
be able to use these permissions.

SQLiteString

Summary: Using STRING instead of TEXT

Priority: 5 / 10
Severity: Warning
Category: Correctness

In SQLite, any column can store any data type; the declared type for a column
is more of a hint as to what the data should be cast to when stored.

There are many ways to store a string. TEXT, VARCHAR, CHARACTER and CLOB are
string types, but STRING is not. Columns defined as STRING are actually
numeric.

If you try to store a value in a numeric column, SQLite will try to cast it to
a float or an integer before storing. If it can't, it will just store it as a
string.

This can lead to some subtle bugs. For example, when SQLite encounters a
string like 1234567e1234, it will parse it as a float, but the result will be
out of range for floating point numbers, so Inf will be stored! Similarly,
strings that look like integers will lose leading zeroes.

To fix this, you can change your schema to use a TEXT type instead.

More information:
https://www.sqlite.org/datatype3.html

StateListReachable

Summary: Unreachable state in a

Priority: 5 / 10
Severity: Warning
Category: Correctness

In a selector, only the last child in the state list should omit a state
qualifier. If not, all subsequent items in the list will be ignored since the
given item will match all.

UnknownIdInLayout

Summary: Reference to an id that is not in the current layout

Priority: 5 / 10
Severity: Warning
Category: Correctness

This is sometimes intentional, for example where you are referring to a view
which is provided in a different layout via an include. However, it is usually
an accident where you have a typo or you have renamed a view without updating
all the references to it.

UnlocalizedSms

Summary: SMS phone number missing country code

Priority: 5 / 10
Severity: Warning
Category: Correctness

SMS destination numbers must start with a country code or the application code
must ensure that the SMS is only sent when the user is in the same country as
the receiver.

GradleDependency

Summary: Obsolete Gradle Dependency

Priority: 4 / 10
Severity: Warning
Category: Correctness

This detector looks for usages of libraries where the version you are using is
not the current stable release. Using older versions is fine, and there are
cases where you deliberately want to stick with an older version. However, you
may simply not be aware that a more recent version is available, and that is
what this lint check helps find.

GradleDynamicVersion

Summary: Gradle Dynamic Version

Priority: 4 / 10
Severity: Warning
Category: Correctness

Using + in dependencies lets you automatically pick up the latest available
version rather than a specific, named version. However, this is not
recommended; your builds are not repeatable; you may have tested with a
slightly different version than what the build server used. (Using a dynamic
version as the major version number is more problematic than using it in the
minor version position.)

GradleIdeError

Summary: Gradle IDE Support Issues

Priority: 4 / 10
Severity: Error
Category: Correctness

Gradle is highly flexible, and there are things you can do in Gradle files
which can make it hard or impossible for IDEs to properly handle the project.
This lint check looks for constructs that potentially break IDE support.

GradleOverrides

Summary: Value overridden by Gradle build script

Priority: 4 / 10
Severity: Warning
Category: Correctness

The value of (for example) minSdkVersion is only used if it is not specified
in the build.gradle build scripts. When specified in the Gradle build scripts,
the manifest value is ignored and can be misleading, so should be removed to
avoid ambiguity.

GradlePath

Summary: Gradle Path Issues

Priority: 4 / 10
Severity: Warning
Category: Correctness

Gradle build scripts are meant to be cross platform, so file paths use
Unix-style path separators (a forward slash) rather than Windows path
separators (a backslash). Similarly, to keep projects portable and repeatable,
avoid using absolute paths on the system; keep files within the project
instead. To share code between projects, consider creating an android-library
and an AAR dependency

GridLayout

Summary: GridLayout validation

Priority: 4 / 10
Severity: Fatal
Category: Correctness

Declaring a layout_row or layout_column that falls outside the declared size
of a GridLayout's rowCount or columnCount is usually an unintentional error.

InOrMmUsage

Summary: Using mm or in dimensions

Priority: 4 / 10
Severity: Warning
Category: Correctness

Avoid using mm (millimeters) or in (inches) as the unit for dimensions.

While it should work in principle, unfortunately many devices do not report
the correct true physical density, which means that the dimension calculations
won't work correctly. You are better off using dp (and for font sizes, sp.)

NewerVersionAvailable

Summary: Newer Library Versions Available

Priority: 4 / 10
Severity: Warning
Category: Correctness
NOTE: This issue is disabled by default!
You can enable it by adding --enable NewerVersionAvailable

This detector checks with a central repository to see if there are newer
versions available for the dependencies used by this project. This is similar
to the GradleDependency check, which checks for newer versions available in
the Android SDK tools and libraries, but this works with any MavenCentral
dependency, and connects to the library every time, which makes it more
flexible but also much slower.

RequiredSize

Summary: Missing layout_width or layout_height attributes

Priority: 4 / 10
Severity: Error
Category: Correctness

All views must specify an explicit layout_width and layout_height attribute.
There is a runtime check for this, so if you fail to specify a size, an
exception is thrown at runtime.

It's possible to specify these widths via styles as well. GridLayout, as a
special case, does not require you to specify a size.

WrongCase

Summary: Wrong case for view tag

Priority: 4 / 10
Severity: Fatal
Category: Correctness

Most layout tags, such as , refer to actual view classes and are
therefore capitalized. However, there are exceptions such as and
. This lint check looks for incorrect capitalizations.

More information:
http://developer.android.com/guide/components/fragments.html

ExtraText

Summary: Extraneous text in resource files

Priority: 3 / 10
Severity: Warning
Category: Correctness

Layout resource files should only contain elements and attributes. Any XML
text content found in the file is likely accidental (and potentially dangerous
if the text resembles XML and the developer believes the text to be
functional)

InnerclassSeparator

Summary: Inner classes should use $ rather than .

Priority: 3 / 10
Severity: Warning
Category: Correctness

When you reference an inner class in a manifest file, you must use '$' instead
of '.' as the separator character, i.e. Outer$Inner instead of Outer.Inner.

(If you get this warning for a class which is not actually an inner class,
it's because you are using uppercase characters in your package name, which is
not conventional.)

LocalSuppress

Summary: @SuppressLint on invalid element

Priority: 3 / 10
Severity: Error
Category: Correctness

The @SuppressAnnotation is used to suppress Lint warnings in Java files.
However, while many lint checks analyzes the Java source code, where they can
find annotations on (for example) local variables, some checks are analyzing
the .class files. And in class files, annotations only appear on classes,
fields and methods. Annotations placed on local variables disappear. If you
attempt to suppress a lint error for a class-file based lint check, the
suppress annotation not work. You must move the annotation out to the
surrounding method.

PrivateResource

Summary: Using private resources

Priority: 3 / 10
Severity: Warning
Category: Correctness

Private resources should not be referenced; the may not be present everywhere,
and even where they are they may disappear without notice.

To fix this, copy the resource into your own project instead.

ProguardSplit

Summary: Proguard.cfg file contains generic Android rules

Priority: 3 / 10
Severity: Warning
Category: Correctness

Earlier versions of the Android tools bundled a single proguard.cfg file
containing a ProGuard configuration file suitable for Android shrinking and
obfuscation. However, that version was copied into new projects, which means
that it does not continue to get updated as we improve the default ProGuard
rules for Android.

In the new version of the tools, we have split the ProGuard configuration into
two halves:

A simple configuration file containing only project-specific flags, in your project
A generic configuration file containing the recommended set of ProGuard options for Android projects. This generic file lives in the SDK install directory which means that it gets updated along with the tools.

In order for this to work, the proguard.config property in the
project.properties file now refers to a path, so you can reference both the
generic file as well as your own (and any additional files too).

To migrate your project to the new setup, create a new proguard-project.txt
file in your project containing any project specific ProGuard flags as well as
any customizations you have made, then update your project.properties file to
contain:
proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-projec
.txt

SpUsage

Summary: Using dp instead of sp for text sizes

Priority: 3 / 10
Severity: Warning
Category: Correctness

When setting text sizes, you should normally use sp, or "scale-independent
pixels". This is like the dp unit, but it is also scaled by the user's font
size preference. It is recommend you use this unit when specifying font sizes,
so they will be adjusted for both the screen density and the user's
preference.

There are cases where you might need to use dp; typically this happens when
the text is in a container with a specific dp-size. This will prevent the text
from spilling outside the container. Note however that this means that the
user's font size settings are not respected, so consider adjusting the layout
itself to be more flexible.

More information:
http://developer.android.com/training/multiscreen/screendensities.html

AccidentalOctal

Summary: Accidental Octal

Priority: 2 / 10
Severity: Error
Category: Correctness

In Groovy, an integer literal that starts with a leading 0 will be interpreted
as an octal number. That is usually (always?) an accident and can lead to
subtle bugs, for example when used in the versionCode of an app.

Deprecated

Summary: Using deprecated resources

Priority: 2 / 10
Severity: Warning
Category: Correctness

Deprecated views, attributes and so on are deprecated because there is a
better way to do something. Do it that new way. You've been warned.

MangledCRLF

Summary: Mangled file line endings

Priority: 2 / 10
Severity: Error
Category: Correctness

On Windows, line endings are typically recorded as carriage return plus
newline: \r\n.

This detector looks for invalid line endings with repeated carriage return
characters (without newlines). Previous versions of the ADT plugin could
accidentally introduce these into the file, and when editing the file, the
editor could produce confusing visual artifacts.

More information:
https://bugs.eclipse.org/bugs/show_bug.cgi?id=375421

MissingVersion

Summary: Missing application name/version

Priority: 2 / 10
Severity: Warning
Category: Correctness

You should define the version information for your application.
android:versionCode: An integer value that represents the version of the
application code, relative to other versions.

android:versionName: A string value that represents the release version of the
application code, as it should be shown to users.

More information:
http://developer.android.com/tools/publishing/versioning.html#appversioning

Orientation

Summary: Missing explicit orientation

Priority: 2 / 10
Severity: Error
Category: Correctness

The default orientation of a LinearLayout is horizontal. It's pretty easy to
believe that the layout is vertical, add multiple children to it, and wonder
why only the first child is visible (when the subsequent children are off
screen to the right). This lint rule helps pinpoint this issue by warning
whenever a LinearLayout is used with an implicit orientation and multiple
children.

It also checks for empty LinearLayouts without an orientation attribute that
also defines an id attribute. This catches the scenarios where children will
be added to the LinearLayout dynamically.

PxUsage

Summary: Using 'px' dimension

Priority: 2 / 10
Severity: Warning
Category: Correctness

For performance reasons and to keep the code simpler, the Android system uses
pixels as the standard unit for expressing dimension or coordinate values.
That means that the dimensions of a view are always expressed in the code
using pixels, but always based on the current screen density. For instance, if
myView.getWidth() returns 10, the view is 10 pixels wide on the current
screen, but on a device with a higher density screen, the value returned might
be 15. If you use pixel values in your application code to work with bitmaps
that are not pre-scaled for the current screen density, you might need to
scale the pixel values that you use in your code to match the un-scaled bitmap
source.

More information:
http://developer.android.com/guide/practices/screens_support.html#screen-independence

Correctness:Messages

StringFormatInvalid

Summary: Invalid format string

Priority: 9 / 10
Severity: Error
Category: Correctness:Messages

If a string contains a '%' character, then the string may be a formatting
string which will be passed to String.format from Java code to replace each
'%' occurrence with specific values.

This lint warning checks for two related problems:
(1) Formatting strings that are invalid, meaning that String.format will throw
exceptions at runtime when attempting to use the format string.
(2) Strings containing '%' that are not formatting strings getting passed to a
String.format call. In this case the '%' will need to be escaped as '%%'.

NOTE: Not all Strings which look like formatting strings are intended for use
by String.format; for example, they may contain date formats intended for
android.text.format.Time#format(). Lint cannot always figure out that a String
is a date format, so you may get false warnings in those scenarios. See the
suppress help topic for information on how to suppress errors in that case.

StringFormatMatches

Summary: String.format string doesn't match the XML format string

Priority: 9 / 10
Severity: Error
Category: Correctness:Messages

This lint check ensures the following:
(1) If there are multiple translations of the format string, then all
translations use the same type for the same numbered arguments
(2) The usage of the format string in Java is consistent with the format
string, meaning that the parameter types passed to String.format matches those
in the format string.

MissingQuantity

Summary: Missing quantity translation

Priority: 8 / 10
Severity: Error
Category: Correctness:Messages

Different languages have different rules for grammatical agreement with
quantity. In English, for example, the quantity 1 is a special case. We write
"1 book", but for any other quantity we'd write "n books". This distinction
between singular and plural is very common, but other languages make finer
distinctions.

This lint check looks at each translation of a and makes sure that
all the quantity strings considered by the given language are provided by this
translation.

For example, an English translation must provide a string for quantity="one".
Similarly, a Czech translation must provide a string for quantity="few".

More information:
http://developer.android.com/guide/topics/resources/string-resource.html#Plurals

MissingTranslation

Summary: Incomplete translation

Priority: 8 / 10
Severity: Fatal
Category: Correctness:Messages

If an application has more than one locale, then all the strings declared in
one language should also be translated in all other languages.

If the string should not be translated, you can add the attribute
translatable="false" on the element, or you can define all your
non-translatable strings in a resource file called donottranslate.xml. Or, you
can ignore the issue with a tools:ignore="MissingTranslation" attribute.

By default this detector allows regions of a language to just provide a subset
of the strings and fall back to the standard language strings. You can require
all regions to provide a full translation by setting the environment variable
ANDROID_LINT_COMPLETE_REGIONS.

You can tell lint (and other tools) which language is the default language in
your res/values/ folder by specifying tools:locale="languageCode" for the root
element in your resource file. (The tools prefix refers to the
namespace declaration http://schemas.android.com/tools.)

Typos

Summary: Spelling error

Priority: 7 / 10
Severity: Warning
Category: Correctness:Messages

This check looks through the string definitions, and if it finds any words
that look like likely misspellings, they are flagged.

ExtraTranslation

Summary: Extra translation

Priority: 6 / 10
Severity: Fatal
Category: Correctness:Messages

If a string appears in a specific language translation file, but there is no
corresponding string in the default locale, then this string is probably
unused. (It's technically possible that your application is only intended to
run in a specific locale, but it's still a good idea to provide a fallback.).

Note that these strings can lead to crashes if the string is looked up on any
locale not providing a translation, so it's important to clean them up.

ImpliedQuantity

Summary: Implied Quantities

Priority: 5 / 10
Severity: Error
Category: Correctness:Messages

Plural strings should generally include a %s or %d formatting argument. In
locales like English, the one quantity only applies to a single value, 1, but
that's not true everywhere. For example, in Slovene, the one quantity will
apply to 1, 101, 201, 301, and so on. Similarly, there are locales where
multiple values match the zero and two quantities.

In these locales, it is usually an error to have a message which does not
include a formatting argument (such as '%d'), since it will not be clear from
the grammar what quantity the quantity string is describing.

More information:
http://developer.android.com/guide/topics/resources/string-resource.html#Plurals

PluralsCandidate

Summary: Potential Plurals

Priority: 5 / 10
Severity: Warning
Category: Correctness:Messages

This lint check looks for potential errors in internationalization where you
have translated a message which involves a quantity and it looks like other
parts of the string may need grammatical changes.

For example, rather than something like this:
Try again in %d seconds.
you should be using a plural:

Try again in %d second
Try again in %d seconds

This will ensure that in other languages the right set of translations are
provided for the different quantity classes.

(This check depends on some heuristics, so it may not accurately determine
whether a string really should be a quantity. You can use tools:ignore to
filter out false positives.

More information:
http://developer.android.com/guide/topics/resources/string-resource.html#Plurals

StringFormatCount

Summary: Formatting argument types incomplete or inconsistent

Priority: 5 / 10
Severity: Warning
Category: Correctness:Messages

When a formatted string takes arguments, it usually needs to reference the
same arguments in all translations (or all arguments if there are no
translations.

There are cases where this is not the case, so this issue is a warning rather
than an error by default. However, this usually happens when a language is not
translated or updated correctly.

UnusedQuantity

Summary: Unused quantity translations

Priority: 3 / 10
Severity: Warning
Category: Correctness:Messages

Android defines a number of different quantity strings, such as zero, one, few
and many. However, many languages do not distinguish grammatically between all
these different quantities.

This lint check looks at the quantity strings defined for each translation and
flags any quantity strings that are unused (because the language does not make
that quantity distinction, and Android will therefore not look it up.).

For example, in Chinese, only the other quantity is used, so even if you
provide translations for zero and one, these strings will not be returned when
getQuantityString() is called, even with 0 or 1.

More information:
http://developer.android.com/guide/topics/resources/string-resource.html#Plurals

Security

AddJavascriptInterface

Summary: addJavascriptInterface Called

Priority: 9 / 10
Severity: Warning
Category: Security

For applications built for API levels below 17, WebView#addJavascriptInterface
presents a security hazard as JavaScript on the target web page has the
ability to use reflection to access the injected object's public fields and
thus manipulate the host application in unintended ways.

More information:
https://labs.mwrinfosecurity.com/blog/2013/09/24/webview-addjavascriptinterface-remote-code-execution/

GetInstance

Summary: Cipher.getInstance with ECB

Priority: 9 / 10
Severity: Warning
Category: Security

Cipher#getInstance should not be called with ECB as the cipher mode or without
setting the cipher mode because the default mode on android is ECB, which is
insecure.

SecureRandom

Summary: Using a fixed seed with SecureRandom

Priority: 9 / 10
Severity: Warning
Category: Security

Specifying a fixed seed will cause the instance to return a predictable
sequence of numbers. This may be useful for testing but it is not appropriate
for secure use.

More information:
http://developer.android.com/reference/java/security/SecureRandom.html

TrulyRandom

Summary: Weak RNG

Priority: 9 / 10
Severity: Warning
Category: Security

Key generation, signing, encryption, and random number generation may not
receive cryptographically strong values due to improper initialization of the
underlying PRNG on Android 4.3 and below.

If your application relies on cryptographically secure random number
generation you should apply the workaround described in
https://android-developers.blogspot.com/2013/08/some-securerandom-thoughts.htm
.

This lint rule is mostly informational; it does not accurately detect whether
cryptographically secure RNG is required, or whether the workaround has
already been applied. After reading the blog entry and updating your code if
necessary, you can disable this lint issue.

More information:
https://android-developers.blogspot.com/2013/08/some-securerandom-thoughts.html

ExportedPreferenceActivity

Summary: PreferenceActivity should not be exported

Priority: 8 / 10
Severity: Warning
Category: Security

Fragment injection gives anyone who can send your PreferenceActivity an intent
the ability to load any fragment, with any arguments, in your process.

More information:
http://securityintelligence.com/new-vulnerability-android-framework-fragment-injection

JavascriptInterface

Summary: Missing @JavascriptInterface on methods

Priority: 8 / 10
Severity: Error
Category: Security

As of API 17, you must annotate methods in objects registered with the
addJavascriptInterface method with a @JavascriptInterface annotation.

More information:
http://developer.android.com/reference/android/webkit/WebView.html#addJavascriptInterfacejava.lang.Object(, java.lang.String)

PackageManagerGetSignatures

Summary: Potential Multiple Certificate Exploit

Priority: 8 / 10
Severity: Information
Category: Security

Improper validation of app signatures could lead to issues where a malicious
app submits itself to the Play Store with both its real certificate and a fake
certificate and gains access to functionality or information it shouldn't have
due to another application only checking for the fake certificate and ignoring
the rest. Please make sure to validate all signatures returned by this
method.

More information:
https://bluebox.com/technical/android-fake-id-vulnerability/

PackagedPrivateKey

Summary: Packaged private key

Priority: 8 / 10
Severity: Fatal
Category: Security

In general, you should not package private key files inside your app.

GrantAllUris

Summary: Content provider shares everything

Priority: 7 / 10
Severity: Warning
Category: Security

The element allows specific paths to be shared. This
detector checks for a path URL of just '/' (everything), which is probably not
what you want; you should limit access to a subset.

EasterEgg

Summary: Code contains easter egg

Priority: 6 / 10
Severity: Warning
Category: Security
NOTE: This issue is disabled by default!
You can enable it by adding --enable EasterEgg

An "easter egg" is code deliberately hidden in the code, both from potential
users and even from other developers. This lint check looks for code which
looks like it may be hidden from sight.

SetJavaScriptEnabled

Summary: Using setJavaScriptEnabled

Priority: 6 / 10
Severity: Warning
Category: Security

Your code should not invoke setJavaScriptEnabled if you are not sure that your
app really requires JavaScript support.

More information:
http://developer.android.com/guide/practices/security.html

UseCheckPermission

Summary: Using the result of check permission calls

Priority: 6 / 10
Severity: Warning
Category: Security

You normally want to use the result of checking a permission; these methods
return whether the permission is held; they do not throw an error if the
permission is not granted. Code which does not do anything with the return
value probably meant to be calling the enforce methods instead, e.g. rather
than Context#checkCallingPermission it should call
Context#enforceCallingPermission.

UsingHttp

Summary: Using HTTP instead of HTTPS

Priority: 6 / 10
Severity: Warning
Category: Security

The Gradle Wrapper is available both via HTTP and HTTPS. HTTPS is more secure
since it protects against man-in-the-middle attacks etc. Older projects
created in Android Studio used HTTP but we now default to HTTPS and recommend
upgrading existing projects.

WrongConstant

Summary: Incorrect constant

Priority: 6 / 10
Severity: Error
Category: Security

Ensures that when parameter in a method only allows a specific set of
constants, calls obey those rules.

ExportedContentProvider

Summary: Content provider does not require permission

Priority: 5 / 10
Severity: Warning
Category: Security

Content providers are exported by default and any application on the system
can potentially use them to read and write data. If the content provider
provides access to sensitive data, it should be protected by specifying
export=false in the manifest or by protecting it with a permission that can be
granted to other applications.

ExportedReceiver

Summary: Receiver does not require permission

Priority: 5 / 10
Severity: Warning
Category: Security

Exported receivers (receivers which either set exported=true or contain an
intent-filter and do not specify exported=false) should define a permission
that an entity must have in order to launch the receiver or bind to it.
Without this, any application can use this receiver.

ExportedService

Summary: Exported service does not require permission

Priority: 5 / 10
Severity: Warning
Category: Security

Exported services (services which either set exported=true or contain an
intent-filter and do not specify exported=false) should define a permission
that an entity must have in order to launch the service or bind to it. Without
this, any application can use this service.

HardcodedDebugMode

Summary: Hardcoded value of android:debuggable in the manifest

Priority: 5 / 10
Severity: Fatal
Category: Security

It's best to leave out the android:debuggable attribute from the manifest. If
you do, then the tools will automatically insert android:debuggable=true when
building an APK to debug on an emulator or device. And when you perform a
release build, such as Exporting APK, it will automatically set it to false.

If on the other hand you specify a specific value in the manifest file, then
the tools will always use it. This can lead to accidentally publishing your
app with debug information.

SignatureOrSystemPermissions

Summary: signatureOrSystem permissions declared

Priority: 5 / 10
Severity: Warning
Category: Security

The signature protection level should probably be sufficient for most needs
and works regardless of where applications are installed. The
signatureOrSystem level is used for certain situations where multiple vendors
have applications built into a system image and need to share specific
features explicitly because they are being built together.

WorldReadableFiles

Summary: openFileOutput() call passing MODE_WORLD_READABLE

Priority: 4 / 10
Severity: Warning
Category: Security

There are cases where it is appropriate for an application to write world
readable files, but these should be reviewed carefully to ensure that they
contain no private data that is leaked to other applications.

WorldWriteableFiles

Summary: openFileOutput() call passing MODE_WORLD_WRITEABLE

Priority: 4 / 10
Severity: Warning
Category: Security

There are cases where it is appropriate for an application to write world
writeable files, but these should be reviewed carefully to ensure that they
contain no private data, and that if the file is modified by a malicious
application it does not trick or compromise your application.

AllowBackup

Summary: Missing allowBackup attribute

Priority: 3 / 10
Severity: Warning
Category: Security

The allowBackup attribute determines if an application's data can be backed up
and restored. It is documented at
http://developer.android.com/reference/android/R.attr.html#allowBackup

By default, this flag is set to true. When this flag is set to true,
application data can be backed up and restored by the user using adb backup
and adb restore.

This may have security consequences for an application. adb backup allows
users who have enabled USB debugging to copy application data off of the
device. Once backed up, all application data can be read by the user. adb
restore allows creation of application data from a source specified by the
user. Following a restore, applications should not assume that the data, file
permissions, and directory permissions were created by the application
itself.

Setting allowBackup="false" opts an application out of both backup and
restore.

To fix this warning, decide whether your application should support backup,
and explicitly set android:allowBackup=(true|false)"

More information:
http://developer.android.com/reference/android/R.attr.html#allowBackup

Performance

DrawAllocation

Summary: Memory allocations within drawing code

Priority: 9 / 10
Severity: Warning
Category: Performance

You should avoid allocating objects during a drawing or layout operation.
These are called frequently, so a smooth UI can be interrupted by garbage
collection pauses caused by the object allocations.

The way this is generally handled is to allocate the needed objects up front
and to reuse them for each drawing operation.

Some methods allocate memory on your behalf (such as Bitmap.create), and these
should be handled in the same way.

Wakelock

Summary: Incorrect WakeLock usage

Priority: 9 / 10
Severity: Warning
Category: Performance

Failing to release a wakelock properly can keep the Android device in a high
power mode, which reduces battery life. There are several causes of this, such
as releasing the wake lock in onDestroy() instead of in onPause(), failing to
call release() in all possible code paths after an acquire(), and so on.

NOTE: If you are using the lock just to keep the screen on, you should
strongly consider using FLAG_KEEP_SCREEN_ON instead. This window flag will be
correctly managed by the platform as the user moves between applications and
doesn't require a special permission. See
http://developer.android.com/reference/android/view/WindowManager.LayoutParams
html#FLAG_KEEP_SCREEN_ON.

Recycle

Summary: Missing recycle() calls

Priority: 7 / 10
Severity: Warning
Category: Performance

Many resources, such as TypedArrays, VelocityTrackers, etc., should be
recycled (with a recycle() call) after use. This lint check looks for missing
recycle() calls.

ObsoleteLayoutParam

Summary: Obsolete layout params

Priority: 6 / 10
Severity: Warning
Category: Performance

The given layout_param is not defined for the given layout, meaning it has no
effect. This usually happens when you change the parent layout or move view
code around without updating the layout params. This will cause useless
attribute processing at runtime, and is misleading for others reading the
layout so the parameter should be removed.

UseCompoundDrawables

Summary: Node can be replaced by a TextView with compound drawables

Priority: 6 / 10
Severity: Warning
Category: Performance

A LinearLayout which contains an ImageView and a TextView can be more
efficiently handled as a compound drawable (a single TextView, using the
drawableTop, drawableLeft, drawableRight and/or drawableBottom attributes to
draw one or more images adjacent to the text).

If the two widgets are offset from each other with margins, this can be
replaced with a drawablePadding attribute.

There's a lint quickfix to perform this conversion in the Eclipse plugin.

ViewTag

Summary: Tagged object leaks

Priority: 6 / 10
Severity: Warning
Category: Performance

Prior to Android 4.0, the implementation of View.setTag(int, Object) would
store the objects in a static map, where the values were strongly referenced.
This means that if the object contains any references pointing back to the
context, the context (which points to pretty much everything else) will leak.
If you pass a view, the view provides a reference to the context that created
it. Similarly, view holders typically contain a view, and cursors are
sometimes also associated with views.

LogConditional

Summary: Unconditional Logging Calls

Priority: 5 / 10
Severity: Warning
Category: Performance
NOTE: This issue is disabled by default!
You can enable it by adding --enable LogConditional

The BuildConfig class (available in Tools 17) provides a constant, "DEBUG",
which indicates whether the code is being built in release mode or in debug
mode. In release mode, you typically want to strip out all the logging calls.
Since the compiler will automatically remove all code which is inside a "if
(false)" check, surrounding your logging calls with a check for
BuildConfig.DEBUG is a good idea.

If you really intend for the logging to be present in release mode, you can
suppress this warning with a @SuppressLint annotation for the intentional
logging calls.

ViewHolder

Summary: View Holder Candidates

Priority: 5 / 10
Severity: Warning
Category: Performance

When implementing a view Adapter, you should avoid unconditionally inflating a
new layout; if an available item is passed in for reuse, you should try to use
that one instead. This helps make for example ListView scrolling much
smoother.

More information:
http://developer.android.com/training/improving-layouts/smooth-scrolling.html#ViewHolder

FieldGetter

Summary: Using getter instead of field

Priority: 4 / 10
Severity: Warning
Category: Performance
NOTE: This issue is disabled by default!
You can enable it by adding --enable FieldGetter

Accessing a field within the class that defines a getter for that field is at
least 3 times faster than calling the getter. For simple getters that do
nothing other than return the field, you might want to just reference the
local field directly instead.

NOTE: As of Android 2.3 (Gingerbread), this optimization is performed
automatically by Dalvik, so there is no need to change your code; this is only
relevant if you are targeting older versions of Android.

More information:
http://developer.android.com/guide/practices/design/performance.html#internal_get_set

HandlerLeak

Summary: Handler reference leaks

Priority: 4 / 10
Severity: Warning
Category: Performance

Since this Handler is declared as an inner class, it may prevent the outer
class from being garbage collected. If the Handler is using a Looper or
MessageQueue for a thread other than the main thread, then there is no issue.
If the Handler is using the Looper or MessageQueue of the main thread, you
need to fix your Handler declaration, as follows: Declare the Handler as a
static class; In the outer class, instantiate a WeakReference to the outer
class and pass this object to your Handler when you instantiate the Handler;
Make all references to members of the outer class using the WeakReference
object.

MergeRootFrame

Summary: FrameLayout can be replaced with tag

Priority: 4 / 10
Severity: Warning
Category: Performance

If a is the root of a layout and does not provide background or
padding etc, it can often be replaced with a tag which is slightly
more efficient. Note that this depends on context, so make sure you understand
how the tag works before proceeding.

More information:
http://android-developers.blogspot.com/2009/03/android-layout-tricks-3-optimize-by.html

UseSparseArrays

Summary: HashMap can be replaced with SparseArray

Priority: 4 / 10
Severity: Warning
Category: Performance

For maps where the keys are of type integer, it's typically more efficient to
use the Android SparseArray API. This check identifies scenarios where you
might want to consider using SparseArray instead of HashMap for better
performance.

This is particularly useful when the value types are primitives like ints,
where you can use SparseIntArray and avoid auto-boxing the values from int to
Integer.

If you need to construct a HashMap because you need to call an API outside of
your control which requires a Map, you can suppress this warning using for
example the @SuppressLint annotation.

UseValueOf

Summary: Should use valueOf instead of new

Priority: 4 / 10
Severity: Warning
Category: Performance

You should not call the constructor for wrapper classes directly, such asnew Integer(42). Instead, call the valueOf factory method, such as
Integer.valueOf(42). This will typically use less memory because common
integers such as 0 and 1 will share a single instance.

DisableBaselineAlignment

Summary: Missing baselineAligned attribute

Priority: 3 / 10
Severity: Warning
Category: Performance

When a LinearLayout is used to distribute the space proportionally between
nested layouts, the baseline alignment property should be turned off to make
the layout computation faster.

FloatMath

Summary: Using FloatMath instead of Math

Priority: 3 / 10
Severity: Warning
Category: Performance

In older versions of Android, using android.util.FloatMath was recommended for
performance reasons when operating on floats. However, on modern hardware
doubles are just as fast as float (though they take more memory), and in
recent versions of Android, FloatMath is actually slower than using
java.lang.Math due to the way the JIT optimizes java.lang.Math. Therefore, you
should use Math instead of FloatMath if you are only targeting Froyo and
above.

More information:
http://developer.android.com/guide/practices/design/performance.html#avoidfloat

InefficientWeight

Summary: Inefficient layout weight

Priority: 3 / 10
Severity: Warning
Category: Performance

When only a single widget in a LinearLayout defines a weight, it is more
efficient to assign a width/height of 0dp to it since it will absorb all the
remaining space anyway. With a declared width/height of 0dp it does not have
to measure its own size first.

NestedWeights

Summary: Nested layout weights

Priority: 3 / 10
Severity: Warning
Category: Performance

Layout weights require a widget to be measured twice. When a LinearLayout with
non-zero weights is nested inside another LinearLayout with non-zero weights,
then the number of measurements increase exponentially.

Overdraw

Summary: Overdraw: Painting regions more than once

Priority: 3 / 10
Severity: Warning
Category: Performance

If you set a background drawable on a root view, then you should use a custom
theme where the theme background is null. Otherwise, the theme background will
be painted first, only to have your custom background completely cover it;
this is called "overdraw".

NOTE: This detector relies on figuring out which layouts are associated with
which activities based on scanning the Java code, and it's currently doing
that using an inexact pattern matching algorithm. Therefore, it can
incorrectly conclude which activity the layout is associated with and then
wrongly complain that a background-theme is hidden.

If you want your custom background on multiple pages, then you should consider
making a custom theme with your custom background and just using that theme
instead of a root element background.

Of course it's possible that your custom drawable is translucent and you want
it to be mixed with the background. However, you will get better performance
if you pre-mix the background with your drawable and use that resulting image
or color as a custom theme background instead.

UnusedResources

Summary: Unused resources

Priority: 3 / 10
Severity: Warning
Category: Performance

Unused resources make applications larger and slow down builds.

UselessLeaf

Summary: Useless leaf layout

Priority: 2 / 10
Severity: Warning
Category: Performance

A layout that has no children or no background can often be removed (since it
is invisible) for a flatter and more efficient layout hierarchy.

UselessParent

Summary: Useless parent layout

Priority: 2 / 10
Severity: Warning
Category: Performance

A layout with children that has no siblings, is not a scrollview or a root
layout, and does not have a background, can be removed and have its children
moved directly into the parent for a flatter and more efficient layout
hierarchy.

TooDeepLayout

Summary: Layout hierarchy is too deep

Priority: 1 / 10
Severity: Warning
Category: Performance

Layouts with too much nesting is bad for performance. Consider using a flatter
layout (such as RelativeLayout or GridLayout).The default maximum depth is 10
but can be configured with the environment variable ANDROID_LINT_MAX_DEPTH.

TooManyViews

Summary: Layout has too many views

Priority: 1 / 10
Severity: Warning
Category: Performance

Using too many views in a single layout is bad for performance. Consider using
compound drawables or other tricks for reducing the number of views in this
layout.

The maximum view count defaults to 80 but can be configured with the
environment variable ANDROID_LINT_MAX_VIEW_COUNT.

UnusedIds

Summary: Unused id

Priority: 1 / 10
Severity: Warning
Category: Performance
NOTE: This issue is disabled by default!
You can enable it by adding --enable UnusedIds

This resource id definition appears not to be needed since it is not
referenced from anywhere. Having id definitions, even if unused, is not
necessarily a bad idea since they make working on layouts and menus easier, so
there is not a strong reason to delete these.

UnusedNamespace

Summary: Unused namespace

Priority: 1 / 10
Severity: Warning
Category: Performance

Unused namespace declarations take up space and require processing that is not
necessary

Usability:Typography

TypographyDashes

Summary: Hyphen can be replaced with dash

Priority: 5 / 10
Severity: Warning
Category: Usability:Typography

The "n dash" (–, –) and the "m dash" (—, —) characters are used
for ranges (n dash) and breaks (m dash). Using these instead of plain hyphens
can make text easier to read and your application will look more polished.

More information:
http://en.wikipedia.org/wiki/Dash

TypographyEllipsis

Summary: Ellipsis string can be replaced with ellipsis character

Priority: 5 / 10
Severity: Warning
Category: Usability:Typography

You can replace the string "..." with a dedicated ellipsis character, ellipsis
character (…, …). This can help make the text more readable.

More information:
http://en.wikipedia.org/wiki/Ellipsis

TypographyFractions

Summary: Fraction string can be replaced with fraction character

Priority: 5 / 10
Severity: Warning
Category: Usability:Typography

You can replace certain strings, such as 1/2, and 1/4, with dedicated
characters for these, such as ½ (½) and ¼ (¼). This can help make
the text more readable.

More information:
http://en.wikipedia.org/wiki/Number_Forms

TypographyQuotes

Summary: Straight quotes can be replaced with curvy quotes

Priority: 5 / 10
Severity: Warning
Category: Usability:Typography
NOTE: This issue is disabled by default!
You can enable it by adding --enable TypographyQuotes

Straight single quotes and double quotes, when used as a pair, can be replaced
by "curvy quotes" (or directional quotes). This can make the text more
readable.

Note that you should never use grave accents and apostrophes to quote, `like
this'.

(Also note that you should not use curvy quotes for code fragments.)

More information:
http://en.wikipedia.org/wiki/Quotation_mark

TypographyOther

Summary: Other typographical problems

Priority: 3 / 10
Severity: Warning
Category: Usability:Typography

This check looks for miscellaneous typographical problems and offers
replacement sequences that will make the text easier to read and your
application more polished.

Usability:Icons

IconNoDpi

Summary: Icon appears in both -nodpi and dpi folders

Priority: 7 / 10
Severity: Warning
Category: Usability:Icons

Bitmaps that appear in drawable-nodpi folders will not be scaled by the
Android framework. If a drawable resource of the same name appears both in a
-nodpi folder as well as a dpi folder such as drawable-hdpi, then the behavior
is ambiguous and probably not intentional. Delete one or the other, or use
different names for the icons.

IconXmlAndPng

Summary: Icon is specified both as .xml file and as a bitmap

Priority: 7 / 10
Severity: Warning
Category: Usability:Icons

If a drawable resource appears as an .xml file in the drawable/ folder, it's
usually not intentional for it to also appear as a bitmap using the same name;
generally you expect the drawable XML file to define states and each state has
a corresponding drawable bitmap.

IconColors

Summary: Icon colors do not follow the recommended visual style

Priority: 6 / 10
Severity: Warning
Category: Usability:Icons

Notification icons and Action Bar icons should only white and shades of gray.
See the Android Design Guide for more details. Note that the way Lint decides
whether an icon is an action bar icon or a notification icon is based on the
filename prefix: ic_menu_ for action bar icons, ic_stat_ for notification
icons etc. These correspond to the naming conventions documented in
http://developer.android.com/guide/practices/ui_guidelines/icon_design.html

More information:
http://developer.android.com/design/style/iconography.html

IconLauncherShape

Summary: The launcher icon shape should use a distinct silhouette

Priority: 6 / 10
Severity: Warning
Category: Usability:Icons

According to the Android Design Guide
(http://developer.android.com/design/style/iconography.html) your launcher
icons should "use a distinct silhouette", a "three-dimensional, front view,
with a slight perspective as if viewed from above, so that users perceive some
depth."

The unique silhouette implies that your launcher icon should not be a filled
square.

More information:
http://developer.android.com/design/style/iconography.html

GifUsage

Summary: Using .gif format for bitmaps is discouraged

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons

The .gif file format is discouraged. Consider using .png (preferred) or .jpg
(acceptable) instead.

More information:
http://developer.android.com/guide/topics/resources/drawable-resource.html#Bitmap

IconDipSize

Summary: Icon density-independent size validation

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons

Checks the all icons which are provided in multiple densities, all compute to
roughly the same density-independent pixel (dip) size. This catches errors
where images are either placed in the wrong folder, or icons are changed to
new sizes but some folders are forgotten.

IconDuplicatesConfig

Summary: Identical bitmaps across various configurations

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons

If an icon is provided under different configuration parameters such as
drawable-hdpi or -v11, they should typically be different. This detector
catches cases where the same icon is provided in different configuration
folder which is usually not intentional.

IconExpectedSize

Summary: Icon has incorrect size

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons
NOTE: This issue is disabled by default!
You can enable it by adding --enable IconExpectedSize

There are predefined sizes (for each density) for launcher icons. You should
follow these conventions to make sure your icons fit in with the overall look
of the platform.

More information:
http://developer.android.com/design/style/iconography.html

IconLocation

Summary: Image defined in density-independent drawable folder

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons

The res/drawable folder is intended for density-independent graphics such as
shapes defined in XML. For bitmaps, move it to drawable-mdpi and consider
providing higher and lower resolution versions in drawable-ldpi, drawable-hdpi
and drawable-xhdpi. If the icon really is density independent (for example a
solid color) you can place it in drawable-nodpi.

More information:
http://developer.android.com/guide/practices/screens_support.html

IconMixedNinePatch

Summary: Clashing PNG and 9-PNG files

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons

If you accidentally name two separate resources file.png and file.9.png, the
image file and the nine patch file will both map to the same drawable
resource, @drawable/file, which is probably not what was intended.

MipmapIcons

Summary: Use Mipmap Launcher Icons

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons

Launcher icons should be provided in the mipmap resource directory. This is
the same as the drawable resource directory, except resources in the mipmap
directory will not get stripped out when creating density-specific APKs.

In certain cases, the Launcher app may use a higher resolution asset (than
would normally be computed for the device) to display large app shortcuts. If
drawables for densities other than the device's resolution have been stripped
out, then the app shortcut could appear blurry.

To fix this, move your launcher icons from drawable-dpi to mipmap-dpi and
change references from @drawable/ and R.drawable to @mipmap/ and R.mipmap.
In Android Studio this lint warning has a quickfix to perform this
automatically.

MissingApplicationIcon

Summary: Missing application icon

Priority: 5 / 10
Severity: Warning
Category: Usability:Icons

You should set an icon for the application as whole because there is no
default. This attribute must be set as a reference to a drawable resource
containing the image (for example @drawable/icon).

More information:
http://developer.android.com/tools/publishing/preparing.html#publishing-configure

IconDensities

Summary: Icon densities validation

Priority: 4 / 10
Severity: Warning
Category: Usability:Icons

Icons will look best if a custom version is provided for each of the major
screen density classes (low, medium, high, extra high). This lint check
identifies icons which do not have complete coverage across the densities.

Low density is not really used much anymore, so this check ignores the ldpi
density. To force lint to include it, set the environment variable
ANDROID_LINT_INCLUDE_LDPI=true. For more information on current density usage,
see http://developer.android.com/resources/dashboard/screens.html

More information:
http://developer.android.com/guide/practices/screens_support.html

IconDuplicates

Summary: Duplicated icons under different names

Priority: 3 / 10
Severity: Warning
Category: Usability:Icons

If an icon is repeated under different names, you can consolidate and just use
one of the icons and delete the others to make your application smaller.
However, duplicated icons usually are not intentional and can sometimes point
to icons that were accidentally overwritten or accidentally not updated.

IconExtension

Summary: Icon format does not match the file extension

Priority: 3 / 10
Severity: Warning
Category: Usability:Icons

Ensures that icons have the correct file extension (e.g. a .png file is really
in the PNG format and not for example a GIF file named .png.)

IconMissingDensityFolder

Summary: Missing density folder

Priority: 3 / 10
Severity: Warning
Category: Usability:Icons

Icons will look best if a custom version is provided for each of the major
screen density classes (low, medium, high, extra-high, extra-extra-high). This
lint check identifies folders which are missing, such as drawable-hdpi.

More information:
http://developer.android.com/guide/practices/screens_support.html

Usability

ButtonOrder

Summary: Button order

Priority: 8 / 10
Severity: Warning
Category: Usability

According to the Android Design Guide,

"Action buttons are typically Cancel and/or OK, with OK indicating the
preferred or most likely action. However, if the options consist of specific
actions such as Close or Wait rather than a confirmation or cancellation of
the action described in the content, then all the buttons should be active
verbs. As a rule, the dismissive action of a dialog is always on the left
whereas the affirmative actions are on the right."

This check looks for button bars and buttons which look like cancel buttons,
and makes sure that these are on the left.

More information:
http://developer.android.com/design/building-blocks/dialogs.html

SelectableText

Summary: Dynamic text should probably be selectable

Priority: 7 / 10
Severity: Warning
Category: Usability
NOTE: This issue is disabled by default!
You can enable it by adding --enable SelectableText

If a is used to display data, the user might want to copy that data
and paste it elsewhere. To allow this, the should specify
android:textIsSelectable="true".

This lint check looks for TextViews which are likely to be displaying data:
views whose text is set dynamically. This value will be ignored on platforms
older than API 11, so it is okay to set it regardless of your minSdkVersion.

BackButton

Summary: Back button

Priority: 6 / 10
Severity: Warning
Category: Usability
NOTE: This issue is disabled by default!
You can enable it by adding --enable BackButton

According to the Android Design Guide,

"Other platforms use an explicit back button with label to allow the user to
navigate up the application's hierarchy. Instead, Android uses the main action
bar's app icon for hierarchical navigation and the navigation bar's back
button for temporal navigation."
This check is not very sophisticated (it just looks for buttons with the label
"Back"), so it is disabled by default to not trigger on common scenarios like
pairs of Back/Next buttons to paginate through screens.

More information:
http://developer.android.com/design/patterns/pure-android.html

AppCompatResource

Summary: Menu namespace

Priority: 5 / 10
Severity: Error
Category: Usability

When using the appcompat library, menu resources should refer to the
showAsAction in the app: namespace, not the android: namespace.

Similarly, when not using the appcompat library, you should be using the
android:showAsAction attribute.

AppIndexingError

Summary: Wrong Usage of App Indexing

Priority: 5 / 10
Severity: Error
Category: Usability

Ensures the app can correctly handle deep links and integrate with App
Indexing for Google search.

More information:
https://g.co/AppIndexing

AppIndexingWarning

Summary: Missing App Indexing Support

Priority: 5 / 10
Severity: Warning
Category: Usability

Ensures the app can correctly handle deep links and integrate with App
Indexing for Google search.

More information:
https://g.co/AppIndexing

ButtonStyle

Summary: Button should be borderless

Priority: 5 / 10
Severity: Warning
Category: Usability

Button bars typically use a borderless style for the buttons. Set the
style="?android:attr/buttonBarButtonStyle" attribute on each of the buttons,
and set style="?android:attr/buttonBarStyle" on the parent layout

More information:
http://developer.android.com/design/building-blocks/buttons.html

MenuTitle

Summary: Missing menu title

Priority: 5 / 10
Severity: Error
Category: Usability

From the action bar documentation:
"It's important that you always define android:title for each menu item — even
if you don't declare that the title appear with the action item — for three
reasons:

If there's not enough room in the action bar for the action item, the menu item appears in the overflow menu and only the title appears.
Screen readers for sight-impaired users read the menu item's title.
If the action item appears with only the icon, a user can long-press the item to reveal a tool-tip that displays the action item's title. The android:icon is always optional, but recommended.

More information:
http://developer.android.com/guide/topics/ui/actionbar.html

TextFields

Summary: Missing inputType or hint

Priority: 5 / 10
Severity: Warning
Category: Usability

Providing an inputType attribute on a text field improves usability because
depending on the data to be input, optimized keyboards can be shown to the
user (such as just digits and parentheses for a phone number). Similarly,a
hint attribute displays a hint to the user for what is expected in the text
field.

The lint detector also looks at the id of the view, and if the id offers a
hint of the purpose of the field (for example, the id contains the phrase
phone or email), then lint will also ensure that the inputType contains the
corresponding type attributes.

If you really want to keep the text field generic, you can suppress this
warning by setting inputType="text".

NegativeMargin

Summary: Negative Margins

Priority: 4 / 10
Severity: Warning
Category: Usability
NOTE: This issue is disabled by default!
You can enable it by adding --enable NegativeMargin

Margin values should be positive. Negative values are generally a sign that
you are making assumptions about views surrounding the current one, or may be
tempted to turn off child clipping to allow a view to escape its parent.
Turning off child clipping to do this not only leads to poor graphical
performance, it also results in wrong touch event handling since touch events
are based strictly on a chain of parent-rect hit tests. Finally, making
assumptions about the size of strings can lead to localization problems.

SmallSp

Summary: Text size is too small

Priority: 4 / 10
Severity: Warning
Category: Usability

Avoid using sizes smaller than 12sp.

AlwaysShowAction

Summary: Usage of showAsAction=always

Priority: 3 / 10
Severity: Warning
Category: Usability

Using showAsAction="always" in menu XML, or MenuItem.SHOW_AS_ACTION_ALWAYS in
Java code is usually a deviation from the user interface style guide.Use
ifRoom or the corresponding MenuItem.SHOW_AS_ACTION_IF_ROOM instead.

If always is used sparingly there are usually no problems and behavior is
roughly equivalent to ifRoom but with preference over other ifRoom items.
Using it more than twice in the same menu is a bad idea.

This check looks for menu XML files that contain more than two always actions,
or some always actions and no ifRoom actions. In Java code, it looks for
projects that contain references to MenuItem.SHOW_AS_ACTION_ALWAYS and no
references to MenuItem.SHOW_AS_ACTION_IF_ROOM.

More information:
http://developer.android.com/design/patterns/actionbar.html

ParcelCreator

Summary: Missing Parcelable CREATOR field

Priority: 3 / 10
Severity: Error
Category: Usability

According to the Parcelable interface documentation, "Classes implementing the
Parcelable interface must also have a static field called CREATOR, which is an
object implementing the Parcelable.Creator interface.

More information:
http://developer.android.com/reference/android/os/Parcelable.html

ViewConstructor

Summary: Missing View constructors for XML inflation

Priority: 3 / 10
Severity: Warning
Category: Usability

Some layout tools (such as the Android layout editor for Studio & Eclipse)
needs to find a constructor with one of the following signatures:

View(Context context)
View(Context context, AttributeSet attrs)
View(Context context, AttributeSet attrs, int defStyle)

If your custom view needs to perform initialization which does not apply when
used in a layout editor, you can surround the given code with a check to see
if View#isInEditMode() is false, since that method will return false at
runtime but true within a user interface editor.

ButtonCase

Summary: Cancel/OK dialog button capitalization

Priority: 2 / 10
Severity: Warning
Category: Usability

The standard capitalization for OK/Cancel dialogs is "OK" and "Cancel". To
ensure that your dialogs use the standard strings, you can use the resource
strings @android:string/ok and @android:string/cancel.

Accessibility

ClickableViewAccessibility

Summary: Accessibility in Custom Views

Priority: 6 / 10
Severity: Warning
Category: Accessibility

If a View that overrides onTouchEvent or uses an OnTouchListener does not also
implement performClick and call it when clicks are detected, the View may not
handle accessibility actions properly. Logic handling the click actions should
ideally be placed in View#performClick as some accessibility services invoke
performClick when a click action should occur.

ContentDescription

Summary: Image without contentDescription

Priority: 3 / 10
Severity: Warning
Category: Accessibility

Non-textual widgets like ImageViews and ImageButtons should use the
contentDescription attribute to specify a textual description of the widget
such that screen readers and other accessibility tools can adequately describe
the user interface.

Note that elements in application screens that are purely decorative and do
not provide any content or enable a user action should not have accessibility
content descriptions. In this case, just suppress the lint warning with a
tools:ignore="ContentDescription" attribute.

Note that for text fields, you should not set both the hint and the
contentDescription attributes since the hint will never be shown. Just set the
hint. See
http://developer.android.com/guide/topics/ui/accessibility/checklist.html#spec
al-cases.

LabelFor

Summary: Missing labelFor attribute

Priority: 2 / 10
Severity: Warning
Category: Accessibility

Text fields should be labelled with a labelFor attribute, provided your
minSdkVersion is at least 17.

If your view is labeled but by a label in a different layout which includes
this one, just suppress this warning from lint.

Internationalization

ByteOrderMark

Summary: Byte order mark inside files

Priority: 8 / 10
Severity: Fatal
Category: Internationalization

Lint will flag any byte-order-mark (BOM) characters it finds in the middle of
a file. Since we expect files to be encoded with UTF-8 (see the EnforceUTF8
issue), the BOM characters are not necessary, and they are not handled
correctly by all tools. For example, if you have a BOM as part of a resource
name in one particular translation, that name will not be considered identical
to the base resource's name and the translation will not be used.

More information:
http://en.wikipedia.org/wiki/Byte_order_mark

EnforceUTF8

Summary: Encoding used in resource files is not UTF-8

Priority: 5 / 10
Severity: Fatal
Category: Internationalization

XML supports encoding in a wide variety of character sets. However, not all
tools handle the XML encoding attribute correctly, and nearly all Android apps
use UTF-8, so by using UTF-8 you can protect yourself against subtle bugs when
using non-ASCII characters.

In particular, the Android Gradle build system will merge resource XML files
assuming the resource files are using UTF-8 encoding.

HardcodedText

Summary: Hardcoded text

Priority: 5 / 10
Severity: Warning
Category: Internationalization

Hardcoding text attributes directly in layout files is bad for several
reasons:

When creating configuration variations (for example for landscape or
portrait) you have to repeat the actual text (and keep it up to date when
making changes)
The application cannot be translated to other languages by just adding new
translations for existing string resources.

In Android Studio and Eclipse there are quickfixes to automatically extract
this hardcoded string into a resource lookup.

RelativeOverlap

Summary: Overlapping items in RelativeLayout

Priority: 3 / 10
Severity: Warning
Category: Internationalization

If relative layout has text or button items aligned to left and right sides
they can overlap each other due to localized text expansion unless they have
mutual constraints like toEndOf/toStartOf.

Bi-directional Text

RtlCompat

Summary: Right-to-left text compatibility issues

Priority: 6 / 10
Severity: Error
Category: Bi-directional Text

API 17 adds a textAlignment attribute to specify text alignment. However, if
you are supporting older versions than API 17, you must also specify a gravity
or layout_gravity attribute, since older platforms will ignore the
textAlignment attribute.

RtlSymmetry

Summary: Padding and margin symmetry

Priority: 6 / 10
Severity: Warning
Category: Bi-directional Text

If you specify padding or margin on the left side of a layout, you should
probably also specify padding on the right side (and vice versa) for
right-to-left layout symmetry.

RtlHardcoded

Summary: Using left/right instead of start/end attributes

Priority: 5 / 10
Severity: Warning
Category: Bi-directional Text

Using Gravity#LEFT and Gravity#RIGHT can lead to problems when a layout is
rendered in locales where text flows from right to left. Use Gravity#START and
Gravity#END instead. Similarly, in XML gravity and layout_gravity attributes,
use start rather than left.

For XML attributes such as paddingLeft and layout_marginLeft, use paddingStart
and layout_marginStart. NOTE: If your minSdkVersion is less than 17, you
should add both the older left/right attributes as well as the new start/right
attributes. On older platforms, where RTL is not supported and the start/right
attributes are unknown and therefore ignored, you need the older left/right
attributes. There is a separate lint check which catches that type of error.

(Note: For Gravity#LEFT and Gravity#START, you can use these constants even
when targeting older platforms, because the start bitmask is a superset of the
left bitmask. Therefore, you can use gravity="start" rather than
gravity="left|start".)

RtlEnabled

Summary: Using RTL attributes without enabling RTL support

Priority: 3 / 10
Severity: Warning
Category: Bi-directional Text

To enable right-to-left support, when running on API 17 and higher, you must
set the android:supportsRtl attribute in the manifest element.

If you have started adding RTL attributes, but have not yet finished the
migration, you can set the attribute to false to satisfy this lint check.

4 个赞

如果觉得我的文章对您有用，请随意打赏。您的支持将鼓励我继续创作！

打赏支持

共收到 16 条回复时间点赞

张全蛋 #1 · 2016年08月13日

挺好的东西，newapi 安卓 api 的等级问题也可以定义到。希望我们的富土康将来也可以这样 do。目前我们一般使用 outside 的方式来做质检，所以比较 out

Monkey #2 · 2015年08月16日

#12 楼 @lihuazhang 吃不吃教训也不是他们的事儿，大多测试吃教训。。除非我们能够很精准的定位到问题的所在，否则他们就扯皮了

恒温 #12 · 2015年08月15日 Author

#11 楼 @monkey 主要是做了开发也不修，除非吃教训了。

Monkey #4 · 2015年08月15日

#10 楼 @zhangzhao_lenovo 这个是对的，一般是 lint＋findbugs＋PMD 一起做 scan 的

zhangzhao_lenovo #10 · 2015年08月15日

我们这边开发好几个都爱用 findbugs.

恒温 #9 · 2015年08月15日 Author

#8 楼 @chichimei 我们开发主动要求的。

chichimei #8 · 2015年08月15日

对于 android 代码扫描，推荐 android lint，而且可以定制检查规则。不过同意推动开发修改是硬伤

恒温 #7 · 2015年08月13日 Author

#6 楼 @allenjchen newAPI 太伤。我们遇到很多次坑了。

陈吉 #9 · 2015年08月13日

我们目前的实践是 Lint 扫一下未使用的图片然后让开发删除。其他的点。。由于问题太多太琐碎，难以推动开发修改。

Tager #5 · 2015年08月13日

#2 楼 @lihuazhang 傻逼开发......会心痛的~

恒温 #4 · 2015年08月13日 Author

测试

Monkey #12 · 2015年08月13日

#2 楼 @lihuazhang 卧槽。。有个鸡巴用。。。傻逼开发看到了就说看不懂。。然后不修。。。

恒温 #13 · 2015年08月13日 Author

#1 楼 @monkey lint 对傻逼开发很有用。

Monkey #14 · 2015年08月13日

lint 是好工具，每次都会用来进行钱包代码的测试。不过结果太多，而且 lint 的检查我感觉有点太遵从 Android 原本的一些定义，不是很能跟上现在 mvn 以及 gradle 的一些工程结构上的定义了。不知道是不是我错觉

需要登录后方可回复, 如果你还没有账号请点击这里注册。

测试基础 使用 lint 增强你的代码

测试基础 使用 lint 增强你的代码

使用 lint 增强你的代码

概述

在 Android Studio 中运行 lint

从命令行运行 lint

lint 输出例子

配置 lint

在 Android Studio 里配置 lint

配置 lint.xml

配置 Java 代码和 XML 文件中的 lint 检查

Correctness

AdapterViewChildren

OnClick

StopShip

MissingPermission

MissingSuperCall

ResAuto

SuspiciousImport

UsesMinSdkAttributes

WrongViewCast

AaptCrash

AndroidGradlePluginVersion

GradleCompatible

IllegalResourceRef

MissingRegistered

MockLocation

NamespaceTypo

Proguard

ReferenceType

ResourceCycle

ResourceName

ScrollViewCount

StringShouldBeInt

UnknownId

WrongFolder

CommitTransaction

DalvikOverride

DeviceAdmin

DuplicateIds

InconsistentArrays

NestedScrolling

ResourceAsColor

ResourceType

ScrollViewSize

TextViewEdits

WebViewLayout

AppCompatMethod

Assert

CheckResult

CommitPrefEdits

CustomViewStyleable

CutPasteId

DefaultLocale

DuplicateDefinition

DuplicateIncludedIds

GradleDeprecated

GradleGetter

InconsistentLayout

InlinedApi

Instantiatable

InvalidId

InvalidPackage

InvalidResourceFolder

LibraryCustomView

LocaleFolder

MissingPrefix

MultipleUsesSdk

NewApi

NotSibling

OldTargetApi

Override

OverrideAbstract

PropertyEscape

Range

Registered

SdCardPath

ServiceCast

ShortAlarm

ShowToast

测试基础使用 lint 增强你的代码

测试基础使用 lint 增强你的代码