2020-06-03 11:09:13 +08:00
|
|
|
// Copyright 2020 Google Inc. All rights reserved.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
//
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
|
|
|
|
package java
|
|
|
|
|
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
"sort"
|
2020-07-17 08:32:17 +08:00
|
|
|
"strings"
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-02-15 23:41:33 +08:00
|
|
|
"github.com/google/blueprint/proptools"
|
|
|
|
|
2020-06-03 11:09:13 +08:00
|
|
|
"android/soong/android"
|
2021-03-05 02:44:12 +08:00
|
|
|
"android/soong/java/config"
|
|
|
|
"android/soong/remoteexec"
|
2020-06-03 11:09:13 +08:00
|
|
|
)
|
|
|
|
|
2021-04-22 05:01:55 +08:00
|
|
|
// lint checks automatically enforced for modules that have different min_sdk_version than
|
|
|
|
// sdk_version
|
|
|
|
var updatabilityChecks = []string{"NewApi"}
|
|
|
|
|
2020-06-03 11:09:13 +08:00
|
|
|
type LintProperties struct {
|
|
|
|
// Controls for running Android Lint on the module.
|
|
|
|
Lint struct {
|
|
|
|
|
|
|
|
// If true, run Android Lint on the module. Defaults to true.
|
|
|
|
Enabled *bool
|
|
|
|
|
|
|
|
// Flags to pass to the Android Lint tool.
|
|
|
|
Flags []string
|
|
|
|
|
|
|
|
// Checks that should be treated as fatal.
|
|
|
|
Fatal_checks []string
|
|
|
|
|
|
|
|
// Checks that should be treated as errors.
|
|
|
|
Error_checks []string
|
|
|
|
|
|
|
|
// Checks that should be treated as warnings.
|
|
|
|
Warning_checks []string
|
|
|
|
|
|
|
|
// Checks that should be skipped.
|
|
|
|
Disabled_checks []string
|
2020-06-19 06:56:48 +08:00
|
|
|
|
|
|
|
// Modules that provide extra lint checks
|
|
|
|
Extra_check_modules []string
|
2021-02-15 23:41:33 +08:00
|
|
|
|
|
|
|
// Name of the file that lint uses as the baseline. Defaults to "lint-baseline.xml".
|
|
|
|
Baseline_filename *string
|
2021-04-22 07:17:25 +08:00
|
|
|
|
|
|
|
// If true, baselining updatability lint checks (e.g. NewApi) is prohibited. Defaults to false.
|
|
|
|
Strict_updatability_linting *bool
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
type linter struct {
|
2021-02-26 00:23:22 +08:00
|
|
|
name string
|
|
|
|
manifest android.Path
|
|
|
|
mergedManifest android.Path
|
|
|
|
srcs android.Paths
|
|
|
|
srcJars android.Paths
|
|
|
|
resources android.Paths
|
|
|
|
classpath android.Paths
|
|
|
|
classes android.Path
|
|
|
|
extraLintCheckJars android.Paths
|
|
|
|
test bool
|
|
|
|
library bool
|
|
|
|
minSdkVersion string
|
|
|
|
targetSdkVersion string
|
|
|
|
compileSdkVersion string
|
2021-06-09 02:11:21 +08:00
|
|
|
compileSdkKind android.SdkKind
|
2021-02-26 00:23:22 +08:00
|
|
|
javaLanguageLevel string
|
|
|
|
kotlinLanguageLevel string
|
|
|
|
outputs lintOutputs
|
|
|
|
properties LintProperties
|
|
|
|
extraMainlineLintErrors []string
|
2020-07-04 02:56:24 +08:00
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
reports android.Paths
|
|
|
|
|
2020-07-04 02:56:24 +08:00
|
|
|
buildModuleReportZip bool
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
type lintOutputs struct {
|
2020-07-22 11:31:17 +08:00
|
|
|
html android.Path
|
|
|
|
text android.Path
|
|
|
|
xml android.Path
|
2020-07-04 02:56:24 +08:00
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
depSets LintDepSets
|
2020-07-04 02:56:24 +08:00
|
|
|
}
|
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
type lintOutputsIntf interface {
|
2020-07-04 02:56:24 +08:00
|
|
|
lintOutputs() *lintOutputs
|
|
|
|
}
|
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
type lintDepSetsIntf interface {
|
|
|
|
LintDepSets() LintDepSets
|
2021-05-11 06:30:00 +08:00
|
|
|
|
|
|
|
// Methods used to propagate strict_updatability_linting values.
|
|
|
|
getStrictUpdatabilityLinting() bool
|
|
|
|
setStrictUpdatabilityLinting(bool)
|
2020-07-22 11:31:17 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
type LintDepSets struct {
|
|
|
|
HTML, Text, XML *android.DepSet
|
|
|
|
}
|
|
|
|
|
|
|
|
type LintDepSetsBuilder struct {
|
|
|
|
HTML, Text, XML *android.DepSetBuilder
|
|
|
|
}
|
|
|
|
|
|
|
|
func NewLintDepSetBuilder() LintDepSetsBuilder {
|
|
|
|
return LintDepSetsBuilder{
|
|
|
|
HTML: android.NewDepSetBuilder(android.POSTORDER),
|
|
|
|
Text: android.NewDepSetBuilder(android.POSTORDER),
|
|
|
|
XML: android.NewDepSetBuilder(android.POSTORDER),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
func (l LintDepSetsBuilder) Direct(html, text, xml android.Path) LintDepSetsBuilder {
|
|
|
|
l.HTML.Direct(html)
|
|
|
|
l.Text.Direct(text)
|
|
|
|
l.XML.Direct(xml)
|
|
|
|
return l
|
|
|
|
}
|
|
|
|
|
|
|
|
func (l LintDepSetsBuilder) Transitive(depSets LintDepSets) LintDepSetsBuilder {
|
|
|
|
if depSets.HTML != nil {
|
|
|
|
l.HTML.Transitive(depSets.HTML)
|
|
|
|
}
|
|
|
|
if depSets.Text != nil {
|
|
|
|
l.Text.Transitive(depSets.Text)
|
|
|
|
}
|
|
|
|
if depSets.XML != nil {
|
|
|
|
l.XML.Transitive(depSets.XML)
|
|
|
|
}
|
|
|
|
return l
|
|
|
|
}
|
|
|
|
|
|
|
|
func (l LintDepSetsBuilder) Build() LintDepSets {
|
|
|
|
return LintDepSets{
|
|
|
|
HTML: l.HTML.Build(),
|
|
|
|
Text: l.Text.Build(),
|
|
|
|
XML: l.XML.Build(),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
func (l *linter) LintDepSets() LintDepSets {
|
|
|
|
return l.outputs.depSets
|
|
|
|
}
|
|
|
|
|
2021-05-11 06:30:00 +08:00
|
|
|
func (l *linter) getStrictUpdatabilityLinting() bool {
|
|
|
|
return BoolDefault(l.properties.Lint.Strict_updatability_linting, false)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (l *linter) setStrictUpdatabilityLinting(strictLinting bool) {
|
|
|
|
l.properties.Lint.Strict_updatability_linting = &strictLinting
|
|
|
|
}
|
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
var _ lintDepSetsIntf = (*linter)(nil)
|
|
|
|
|
|
|
|
var _ lintOutputsIntf = (*linter)(nil)
|
2020-07-04 02:56:24 +08:00
|
|
|
|
|
|
|
func (l *linter) lintOutputs() *lintOutputs {
|
|
|
|
return &l.outputs
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
func (l *linter) enabled() bool {
|
|
|
|
return BoolDefault(l.properties.Lint.Enabled, true)
|
|
|
|
}
|
|
|
|
|
2020-06-19 06:56:48 +08:00
|
|
|
func (l *linter) deps(ctx android.BottomUpMutatorContext) {
|
|
|
|
if !l.enabled() {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2020-07-17 08:32:17 +08:00
|
|
|
extraCheckModules := l.properties.Lint.Extra_check_modules
|
|
|
|
|
|
|
|
if checkOnly := ctx.Config().Getenv("ANDROID_LINT_CHECK"); checkOnly != "" {
|
|
|
|
if checkOnlyModules := ctx.Config().Getenv("ANDROID_LINT_CHECK_EXTRA_MODULES"); checkOnlyModules != "" {
|
|
|
|
extraCheckModules = strings.Split(checkOnlyModules, ",")
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
ctx.AddFarVariationDependencies(ctx.Config().BuildOSCommonTarget.Variations(),
|
|
|
|
extraLintCheckTag, extraCheckModules...)
|
2020-06-19 06:56:48 +08:00
|
|
|
}
|
|
|
|
|
2021-03-11 01:45:40 +08:00
|
|
|
// lintPaths contains the paths to lint's inputs and outputs to make it easier to pass them
|
|
|
|
// around.
|
2021-03-05 02:44:12 +08:00
|
|
|
type lintPaths struct {
|
|
|
|
projectXML android.WritablePath
|
|
|
|
configXML android.WritablePath
|
|
|
|
cacheDir android.WritablePath
|
|
|
|
homeDir android.WritablePath
|
|
|
|
srcjarDir android.WritablePath
|
|
|
|
}
|
|
|
|
|
2021-03-11 02:40:58 +08:00
|
|
|
func lintRBEExecStrategy(ctx android.ModuleContext) string {
|
|
|
|
return ctx.Config().GetenvWithDefault("RBE_LINT_EXEC_STRATEGY", remoteexec.LocalExecStrategy)
|
|
|
|
}
|
|
|
|
|
2021-03-05 02:44:12 +08:00
|
|
|
func (l *linter) writeLintProjectXML(ctx android.ModuleContext, rule *android.RuleBuilder) lintPaths {
|
|
|
|
projectXMLPath := android.PathForModuleOut(ctx, "lint", "project.xml")
|
2020-06-03 11:09:13 +08:00
|
|
|
// Lint looks for a lint.xml file next to the project.xml file, give it one.
|
2021-03-05 02:44:12 +08:00
|
|
|
configXMLPath := android.PathForModuleOut(ctx, "lint", "lint.xml")
|
|
|
|
cacheDir := android.PathForModuleOut(ctx, "lint", "cache")
|
|
|
|
homeDir := android.PathForModuleOut(ctx, "lint", "home")
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-03-13 09:56:51 +08:00
|
|
|
srcJarDir := android.PathForModuleOut(ctx, "lint", "srcjars")
|
2020-06-03 11:09:13 +08:00
|
|
|
srcJarList := zipSyncCmd(ctx, rule, srcJarDir, l.srcJars)
|
|
|
|
|
|
|
|
cmd := rule.Command().
|
2021-04-20 08:58:22 +08:00
|
|
|
BuiltTool("lint_project_xml").
|
2020-06-03 11:09:13 +08:00
|
|
|
FlagWithOutput("--project_out ", projectXMLPath).
|
|
|
|
FlagWithOutput("--config_out ", configXMLPath).
|
|
|
|
FlagWithArg("--name ", ctx.ModuleName())
|
|
|
|
|
|
|
|
if l.library {
|
|
|
|
cmd.Flag("--library")
|
|
|
|
}
|
|
|
|
if l.test {
|
|
|
|
cmd.Flag("--test")
|
|
|
|
}
|
|
|
|
if l.manifest != nil {
|
2021-03-24 08:07:14 +08:00
|
|
|
cmd.FlagWithInput("--manifest ", l.manifest)
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
if l.mergedManifest != nil {
|
2021-03-24 08:07:14 +08:00
|
|
|
cmd.FlagWithInput("--merged_manifest ", l.mergedManifest)
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
2021-03-24 08:07:14 +08:00
|
|
|
// TODO(ccross): some of the files in l.srcs are generated sources and should be passed to
|
|
|
|
// lint separately.
|
|
|
|
srcsList := android.PathForModuleOut(ctx, "lint-srcs.list")
|
|
|
|
cmd.FlagWithRspFileInputList("--srcs ", srcsList, l.srcs)
|
2020-06-03 11:09:13 +08:00
|
|
|
|
|
|
|
cmd.FlagWithInput("--generated_srcs ", srcJarList)
|
|
|
|
|
2021-03-24 08:07:14 +08:00
|
|
|
if len(l.resources) > 0 {
|
|
|
|
resourcesList := android.PathForModuleOut(ctx, "lint-resources.list")
|
|
|
|
cmd.FlagWithRspFileInputList("--resources ", resourcesList, l.resources)
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
if l.classes != nil {
|
2021-03-24 08:07:14 +08:00
|
|
|
cmd.FlagWithInput("--classes ", l.classes)
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
2021-03-24 08:07:14 +08:00
|
|
|
cmd.FlagForEachInput("--classpath ", l.classpath)
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-03-24 08:07:14 +08:00
|
|
|
cmd.FlagForEachInput("--extra_checks_jar ", l.extraLintCheckJars)
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-03-13 09:56:51 +08:00
|
|
|
cmd.FlagWithArg("--root_dir ", "$PWD")
|
2020-06-24 01:25:26 +08:00
|
|
|
|
|
|
|
// The cache tag in project.xml is relative to the root dir, or the project.xml file if
|
|
|
|
// the root dir is not set.
|
|
|
|
cmd.FlagWithArg("--cache_dir ", cacheDir.String())
|
2020-06-03 11:09:13 +08:00
|
|
|
|
|
|
|
cmd.FlagWithInput("@",
|
|
|
|
android.PathForSource(ctx, "build/soong/java/lint_defaults.txt"))
|
|
|
|
|
2021-02-26 00:23:22 +08:00
|
|
|
cmd.FlagForEachArg("--error_check ", l.extraMainlineLintErrors)
|
2020-06-03 11:09:13 +08:00
|
|
|
cmd.FlagForEachArg("--disable_check ", l.properties.Lint.Disabled_checks)
|
|
|
|
cmd.FlagForEachArg("--warning_check ", l.properties.Lint.Warning_checks)
|
|
|
|
cmd.FlagForEachArg("--error_check ", l.properties.Lint.Error_checks)
|
|
|
|
cmd.FlagForEachArg("--fatal_check ", l.properties.Lint.Fatal_checks)
|
|
|
|
|
2021-05-11 06:30:00 +08:00
|
|
|
if l.getStrictUpdatabilityLinting() {
|
2021-04-23 02:01:36 +08:00
|
|
|
// Verify the module does not baseline issues that endanger safe updatability.
|
2021-04-22 07:17:25 +08:00
|
|
|
if baselinePath := l.getBaselineFilepath(ctx); baselinePath.Valid() {
|
|
|
|
cmd.FlagWithInput("--baseline ", baselinePath.Path())
|
|
|
|
cmd.FlagForEachArg("--disallowed_issues ", updatabilityChecks)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-03-05 02:44:12 +08:00
|
|
|
return lintPaths{
|
|
|
|
projectXML: projectXMLPath,
|
|
|
|
configXML: configXMLPath,
|
|
|
|
cacheDir: cacheDir,
|
|
|
|
homeDir: homeDir,
|
|
|
|
}
|
|
|
|
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
2020-07-29 02:32:07 +08:00
|
|
|
// generateManifest adds a command to the rule to write a simple manifest that contains the
|
2020-06-03 11:09:13 +08:00
|
|
|
// minSdkVersion and targetSdkVersion for modules (like java_library) that don't have a manifest.
|
2021-03-13 09:56:51 +08:00
|
|
|
func (l *linter) generateManifest(ctx android.ModuleContext, rule *android.RuleBuilder) android.WritablePath {
|
2020-06-03 11:09:13 +08:00
|
|
|
manifestPath := android.PathForModuleOut(ctx, "lint", "AndroidManifest.xml")
|
|
|
|
|
|
|
|
rule.Command().Text("(").
|
|
|
|
Text(`echo "<?xml version='1.0' encoding='utf-8'?>" &&`).
|
|
|
|
Text(`echo "<manifest xmlns:android='http://schemas.android.com/apk/res/android'" &&`).
|
|
|
|
Text(`echo " android:versionCode='1' android:versionName='1' >" &&`).
|
|
|
|
Textf(`echo " <uses-sdk android:minSdkVersion='%s' android:targetSdkVersion='%s'/>" &&`,
|
|
|
|
l.minSdkVersion, l.targetSdkVersion).
|
|
|
|
Text(`echo "</manifest>"`).
|
|
|
|
Text(") >").Output(manifestPath)
|
|
|
|
|
|
|
|
return manifestPath
|
|
|
|
}
|
|
|
|
|
2021-04-19 23:54:36 +08:00
|
|
|
func (l *linter) getBaselineFilepath(ctx android.ModuleContext) android.OptionalPath {
|
|
|
|
var lintBaseline android.OptionalPath
|
|
|
|
if lintFilename := proptools.StringDefault(l.properties.Lint.Baseline_filename, "lint-baseline.xml"); lintFilename != "" {
|
|
|
|
if String(l.properties.Lint.Baseline_filename) != "" {
|
|
|
|
// if manually specified, we require the file to exist
|
|
|
|
lintBaseline = android.OptionalPathForPath(android.PathForModuleSrc(ctx, lintFilename))
|
|
|
|
} else {
|
|
|
|
lintBaseline = android.ExistentPathForSource(ctx, ctx.ModuleDir(), lintFilename)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return lintBaseline
|
|
|
|
}
|
|
|
|
|
2020-06-03 11:09:13 +08:00
|
|
|
func (l *linter) lint(ctx android.ModuleContext) {
|
|
|
|
if !l.enabled() {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2021-02-26 00:23:22 +08:00
|
|
|
if l.minSdkVersion != l.compileSdkVersion {
|
2021-04-22 05:01:55 +08:00
|
|
|
l.extraMainlineLintErrors = append(l.extraMainlineLintErrors, updatabilityChecks...)
|
|
|
|
_, filtered := android.FilterList(l.properties.Lint.Warning_checks, updatabilityChecks)
|
|
|
|
if len(filtered) != 0 {
|
|
|
|
ctx.PropertyErrorf("lint.warning_checks",
|
|
|
|
"Can't treat %v checks as warnings if min_sdk_version is different from sdk_version.", filtered)
|
|
|
|
}
|
|
|
|
_, filtered = android.FilterList(l.properties.Lint.Disabled_checks, updatabilityChecks)
|
|
|
|
if len(filtered) != 0 {
|
|
|
|
ctx.PropertyErrorf("lint.disabled_checks",
|
|
|
|
"Can't disable %v checks if min_sdk_version is different from sdk_version.", filtered)
|
|
|
|
}
|
2021-02-26 00:23:22 +08:00
|
|
|
}
|
|
|
|
|
2020-06-19 06:56:48 +08:00
|
|
|
extraLintCheckModules := ctx.GetDirectDepsWithTag(extraLintCheckTag)
|
|
|
|
for _, extraLintCheckModule := range extraLintCheckModules {
|
2021-02-02 05:59:03 +08:00
|
|
|
if ctx.OtherModuleHasProvider(extraLintCheckModule, JavaInfoProvider) {
|
|
|
|
dep := ctx.OtherModuleProvider(extraLintCheckModule, JavaInfoProvider).(JavaInfo)
|
|
|
|
l.extraLintCheckJars = append(l.extraLintCheckJars, dep.ImplementationAndResourcesJars...)
|
2020-06-19 06:56:48 +08:00
|
|
|
} else {
|
|
|
|
ctx.PropertyErrorf("lint.extra_check_modules",
|
|
|
|
"%s is not a java module", ctx.OtherModuleName(extraLintCheckModule))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-03-13 09:56:51 +08:00
|
|
|
rule := android.NewRuleBuilder(pctx, ctx).
|
|
|
|
Sbox(android.PathForModuleOut(ctx, "lint"),
|
|
|
|
android.PathForModuleOut(ctx, "lint.sbox.textproto")).
|
|
|
|
SandboxInputs()
|
|
|
|
|
|
|
|
if ctx.Config().UseRBE() && ctx.Config().IsEnvTrue("RBE_LINT") {
|
|
|
|
pool := ctx.Config().GetenvWithDefault("RBE_LINT_POOL", "java16")
|
|
|
|
rule.Remoteable(android.RemoteRuleSupports{RBE: true})
|
|
|
|
rule.Rewrapper(&remoteexec.REParams{
|
|
|
|
Labels: map[string]string{"type": "tool", "name": "lint"},
|
|
|
|
ExecStrategy: lintRBEExecStrategy(ctx),
|
|
|
|
ToolchainInputs: []string{config.JavaCmd(ctx).String()},
|
2021-06-10 03:48:53 +08:00
|
|
|
Platform: map[string]string{remoteexec.PoolKey: pool},
|
2021-03-13 09:56:51 +08:00
|
|
|
})
|
|
|
|
}
|
2020-06-03 11:09:13 +08:00
|
|
|
|
|
|
|
if l.manifest == nil {
|
|
|
|
manifest := l.generateManifest(ctx, rule)
|
|
|
|
l.manifest = manifest
|
2021-03-13 09:56:51 +08:00
|
|
|
rule.Temporary(manifest)
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
2021-03-05 02:44:12 +08:00
|
|
|
lintPaths := l.writeLintProjectXML(ctx, rule)
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-03-13 09:56:51 +08:00
|
|
|
html := android.PathForModuleOut(ctx, "lint", "lint-report.html")
|
|
|
|
text := android.PathForModuleOut(ctx, "lint", "lint-report.txt")
|
|
|
|
xml := android.PathForModuleOut(ctx, "lint", "lint-report.xml")
|
2020-07-04 02:56:24 +08:00
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
depSetsBuilder := NewLintDepSetBuilder().Direct(html, text, xml)
|
2020-07-04 02:56:24 +08:00
|
|
|
|
|
|
|
ctx.VisitDirectDepsWithTag(staticLibTag, func(dep android.Module) {
|
2020-07-22 11:31:17 +08:00
|
|
|
if depLint, ok := dep.(lintDepSetsIntf); ok {
|
|
|
|
depSetsBuilder.Transitive(depLint.LintDepSets())
|
2020-07-04 02:56:24 +08:00
|
|
|
}
|
|
|
|
})
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-03-05 02:44:12 +08:00
|
|
|
rule.Command().Text("rm -rf").Flag(lintPaths.cacheDir.String()).Flag(lintPaths.homeDir.String())
|
|
|
|
rule.Command().Text("mkdir -p").Flag(lintPaths.cacheDir.String()).Flag(lintPaths.homeDir.String())
|
2021-03-05 02:01:34 +08:00
|
|
|
rule.Command().Text("rm -f").Output(html).Output(text).Output(xml)
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-06-09 02:11:21 +08:00
|
|
|
var apiVersionsName, apiVersionsPrebuilt string
|
|
|
|
if l.compileSdkKind == android.SdkModule {
|
|
|
|
// When compiling an SDK module we use the filtered database because otherwise lint's
|
|
|
|
// NewApi check produces too many false positives; This database excludes information
|
|
|
|
// about classes created in mainline modules hence removing those false positives.
|
|
|
|
apiVersionsName = "api_versions_public_filtered.xml"
|
|
|
|
apiVersionsPrebuilt = "prebuilts/sdk/current/public/data/api-versions-filtered.xml"
|
|
|
|
} else {
|
|
|
|
apiVersionsName = "api_versions.xml"
|
|
|
|
apiVersionsPrebuilt = "prebuilts/sdk/current/public/data/api-versions.xml"
|
|
|
|
}
|
|
|
|
|
2020-07-07 02:45:51 +08:00
|
|
|
var annotationsZipPath, apiVersionsXMLPath android.Path
|
2020-07-08 00:09:23 +08:00
|
|
|
if ctx.Config().AlwaysUsePrebuiltSdks() {
|
2020-07-07 02:45:51 +08:00
|
|
|
annotationsZipPath = android.PathForSource(ctx, "prebuilts/sdk/current/public/data/annotations.zip")
|
2021-06-09 02:11:21 +08:00
|
|
|
apiVersionsXMLPath = android.PathForSource(ctx, apiVersionsPrebuilt)
|
2020-07-07 02:45:51 +08:00
|
|
|
} else {
|
|
|
|
annotationsZipPath = copiedAnnotationsZipPath(ctx)
|
2021-06-09 02:11:21 +08:00
|
|
|
apiVersionsXMLPath = copiedAPIVersionsXmlPath(ctx, apiVersionsName)
|
2020-07-07 02:45:51 +08:00
|
|
|
}
|
|
|
|
|
2021-03-05 02:44:12 +08:00
|
|
|
cmd := rule.Command()
|
|
|
|
|
2021-04-07 01:49:19 +08:00
|
|
|
cmd.Flag(`JAVA_OPTS="-Xmx3072m --add-opens java.base/java.util=ALL-UNNAMED"`).
|
2021-03-05 02:44:12 +08:00
|
|
|
FlagWithArg("ANDROID_SDK_HOME=", lintPaths.homeDir.String()).
|
2020-07-07 02:45:51 +08:00
|
|
|
FlagWithInput("SDK_ANNOTATIONS=", annotationsZipPath).
|
2021-03-05 02:44:12 +08:00
|
|
|
FlagWithInput("LINT_OPTS=-DLINT_API_DATABASE=", apiVersionsXMLPath)
|
|
|
|
|
2021-03-13 09:56:51 +08:00
|
|
|
cmd.BuiltTool("lint").ImplicitTool(ctx.Config().HostJavaToolPath(ctx, "lint.jar")).
|
2020-06-03 11:09:13 +08:00
|
|
|
Flag("--quiet").
|
2021-03-05 02:44:12 +08:00
|
|
|
FlagWithInput("--project ", lintPaths.projectXML).
|
|
|
|
FlagWithInput("--config ", lintPaths.configXML).
|
2020-07-04 02:56:24 +08:00
|
|
|
FlagWithOutput("--html ", html).
|
|
|
|
FlagWithOutput("--text ", text).
|
|
|
|
FlagWithOutput("--xml ", xml).
|
2020-06-03 11:09:13 +08:00
|
|
|
FlagWithArg("--compile-sdk-version ", l.compileSdkVersion).
|
|
|
|
FlagWithArg("--java-language-level ", l.javaLanguageLevel).
|
|
|
|
FlagWithArg("--kotlin-language-level ", l.kotlinLanguageLevel).
|
|
|
|
FlagWithArg("--url ", fmt.Sprintf(".=.,%s=out", android.PathForOutput(ctx).String())).
|
|
|
|
Flag("--exitcode").
|
|
|
|
Flags(l.properties.Lint.Flags).
|
2021-03-05 02:44:12 +08:00
|
|
|
Implicit(annotationsZipPath).
|
2021-03-24 08:07:14 +08:00
|
|
|
Implicit(apiVersionsXMLPath)
|
2020-07-17 08:32:17 +08:00
|
|
|
|
2021-03-13 09:56:51 +08:00
|
|
|
rule.Temporary(lintPaths.projectXML)
|
|
|
|
rule.Temporary(lintPaths.configXML)
|
|
|
|
|
2020-07-17 08:32:17 +08:00
|
|
|
if checkOnly := ctx.Config().Getenv("ANDROID_LINT_CHECK"); checkOnly != "" {
|
|
|
|
cmd.FlagWithArg("--check ", checkOnly)
|
|
|
|
}
|
|
|
|
|
2021-04-19 23:54:36 +08:00
|
|
|
lintBaseline := l.getBaselineFilepath(ctx)
|
|
|
|
if lintBaseline.Valid() {
|
|
|
|
cmd.FlagWithInput("--baseline ", lintBaseline.Path())
|
2021-02-15 23:41:33 +08:00
|
|
|
}
|
|
|
|
|
2021-03-05 02:44:12 +08:00
|
|
|
cmd.Text("|| (").Text("if [ -e").Input(text).Text("]; then cat").Input(text).Text("; fi; exit 7)")
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-03-05 02:44:12 +08:00
|
|
|
rule.Command().Text("rm -rf").Flag(lintPaths.cacheDir.String()).Flag(lintPaths.homeDir.String())
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-04-06 09:38:05 +08:00
|
|
|
// The HTML output contains a date, remove it to make the output deterministic.
|
|
|
|
rule.Command().Text(`sed -i.tmp -e 's|Check performed at .*\(</nav>\)|\1|'`).Output(html)
|
|
|
|
|
2020-11-17 09:32:30 +08:00
|
|
|
rule.Build("lint", "lint")
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2020-07-04 02:56:24 +08:00
|
|
|
l.outputs = lintOutputs{
|
|
|
|
html: html,
|
|
|
|
text: text,
|
|
|
|
xml: xml,
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
depSets: depSetsBuilder.Build(),
|
2020-07-04 02:56:24 +08:00
|
|
|
}
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2020-07-04 02:56:24 +08:00
|
|
|
if l.buildModuleReportZip {
|
2020-07-22 11:31:17 +08:00
|
|
|
l.reports = BuildModuleLintReportZips(ctx, l.LintDepSets())
|
|
|
|
}
|
|
|
|
}
|
2020-07-04 02:56:24 +08:00
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
func BuildModuleLintReportZips(ctx android.ModuleContext, depSets LintDepSets) android.Paths {
|
|
|
|
htmlList := depSets.HTML.ToSortedList()
|
|
|
|
textList := depSets.Text.ToSortedList()
|
|
|
|
xmlList := depSets.XML.ToSortedList()
|
2020-07-04 02:56:24 +08:00
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
if len(htmlList) == 0 && len(textList) == 0 && len(xmlList) == 0 {
|
|
|
|
return nil
|
2020-07-04 02:56:24 +08:00
|
|
|
}
|
2020-07-22 11:31:17 +08:00
|
|
|
|
|
|
|
htmlZip := android.PathForModuleOut(ctx, "lint-report-html.zip")
|
|
|
|
lintZip(ctx, htmlList, htmlZip)
|
|
|
|
|
|
|
|
textZip := android.PathForModuleOut(ctx, "lint-report-text.zip")
|
|
|
|
lintZip(ctx, textList, textZip)
|
|
|
|
|
|
|
|
xmlZip := android.PathForModuleOut(ctx, "lint-report-xml.zip")
|
|
|
|
lintZip(ctx, xmlList, xmlZip)
|
|
|
|
|
|
|
|
return android.Paths{htmlZip, textZip, xmlZip}
|
2020-07-04 02:56:24 +08:00
|
|
|
}
|
2020-06-03 11:09:13 +08:00
|
|
|
|
|
|
|
type lintSingleton struct {
|
|
|
|
htmlZip android.WritablePath
|
|
|
|
textZip android.WritablePath
|
|
|
|
xmlZip android.WritablePath
|
|
|
|
}
|
|
|
|
|
|
|
|
func (l *lintSingleton) GenerateBuildActions(ctx android.SingletonContext) {
|
|
|
|
l.generateLintReportZips(ctx)
|
|
|
|
l.copyLintDependencies(ctx)
|
|
|
|
}
|
|
|
|
|
2021-06-09 02:11:21 +08:00
|
|
|
func findModuleOrErr(ctx android.SingletonContext, moduleName string) android.Module {
|
|
|
|
var res android.Module
|
2020-06-03 11:09:13 +08:00
|
|
|
ctx.VisitAllModules(func(m android.Module) {
|
2021-06-09 02:11:21 +08:00
|
|
|
if ctx.ModuleName(m) == moduleName {
|
|
|
|
if res == nil {
|
|
|
|
res = m
|
2020-06-03 11:09:13 +08:00
|
|
|
} else {
|
2021-06-09 02:11:21 +08:00
|
|
|
ctx.Errorf("lint: multiple %s modules found: %s and %s", moduleName,
|
|
|
|
ctx.ModuleSubDir(m), ctx.ModuleSubDir(res))
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
})
|
2021-06-09 02:11:21 +08:00
|
|
|
return res
|
|
|
|
}
|
2020-06-03 11:09:13 +08:00
|
|
|
|
2021-06-09 02:11:21 +08:00
|
|
|
func (l *lintSingleton) copyLintDependencies(ctx android.SingletonContext) {
|
|
|
|
if ctx.Config().AlwaysUsePrebuiltSdks() {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
frameworkDocStubs := findModuleOrErr(ctx, "framework-doc-stubs")
|
2020-06-03 11:09:13 +08:00
|
|
|
if frameworkDocStubs == nil {
|
|
|
|
if !ctx.Config().AllowMissingDependencies() {
|
|
|
|
ctx.Errorf("lint: missing framework-doc-stubs")
|
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2021-06-09 02:11:21 +08:00
|
|
|
filteredDb := findModuleOrErr(ctx, "api-versions-xml-public-filtered")
|
|
|
|
if filteredDb == nil {
|
|
|
|
if !ctx.Config().AllowMissingDependencies() {
|
|
|
|
ctx.Errorf("lint: missing api-versions-xml-public-filtered")
|
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2020-06-03 11:09:13 +08:00
|
|
|
ctx.Build(pctx, android.BuildParams{
|
2021-03-05 02:00:09 +08:00
|
|
|
Rule: android.CpIfChanged,
|
2020-06-03 11:09:13 +08:00
|
|
|
Input: android.OutputFileForModule(ctx, frameworkDocStubs, ".annotations.zip"),
|
2020-07-07 02:45:51 +08:00
|
|
|
Output: copiedAnnotationsZipPath(ctx),
|
2020-06-03 11:09:13 +08:00
|
|
|
})
|
|
|
|
|
|
|
|
ctx.Build(pctx, android.BuildParams{
|
2021-03-05 02:00:09 +08:00
|
|
|
Rule: android.CpIfChanged,
|
2020-06-03 11:09:13 +08:00
|
|
|
Input: android.OutputFileForModule(ctx, frameworkDocStubs, ".api_versions.xml"),
|
2021-06-09 02:11:21 +08:00
|
|
|
Output: copiedAPIVersionsXmlPath(ctx, "api_versions.xml"),
|
|
|
|
})
|
|
|
|
|
|
|
|
ctx.Build(pctx, android.BuildParams{
|
|
|
|
Rule: android.CpIfChanged,
|
|
|
|
Input: android.OutputFileForModule(ctx, filteredDb, ""),
|
|
|
|
Output: copiedAPIVersionsXmlPath(ctx, "api_versions_public_filtered.xml"),
|
2020-06-03 11:09:13 +08:00
|
|
|
})
|
|
|
|
}
|
|
|
|
|
2020-07-07 02:45:51 +08:00
|
|
|
func copiedAnnotationsZipPath(ctx android.PathContext) android.WritablePath {
|
2020-06-03 11:09:13 +08:00
|
|
|
return android.PathForOutput(ctx, "lint", "annotations.zip")
|
|
|
|
}
|
|
|
|
|
2021-06-09 02:11:21 +08:00
|
|
|
func copiedAPIVersionsXmlPath(ctx android.PathContext, name string) android.WritablePath {
|
|
|
|
return android.PathForOutput(ctx, "lint", name)
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
func (l *lintSingleton) generateLintReportZips(ctx android.SingletonContext) {
|
2020-07-07 02:45:51 +08:00
|
|
|
if ctx.Config().UnbundledBuild() {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2020-06-03 11:09:13 +08:00
|
|
|
var outputs []*lintOutputs
|
|
|
|
var dirs []string
|
|
|
|
ctx.VisitAllModules(func(m android.Module) {
|
2020-11-23 13:22:30 +08:00
|
|
|
if ctx.Config().KatiEnabled() && !m.ExportedToMake() {
|
2020-06-03 11:09:13 +08:00
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2020-09-16 09:30:11 +08:00
|
|
|
if apex, ok := m.(android.ApexModule); ok && apex.NotAvailableForPlatform() {
|
|
|
|
apexInfo := ctx.ModuleProvider(m, android.ApexInfoProvider).(android.ApexInfo)
|
|
|
|
if apexInfo.IsForPlatform() {
|
|
|
|
// There are stray platform variants of modules in apexes that are not available for
|
|
|
|
// the platform, and they sometimes can't be built. Don't depend on them.
|
|
|
|
return
|
|
|
|
}
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
2020-07-22 11:31:17 +08:00
|
|
|
if l, ok := m.(lintOutputsIntf); ok {
|
2020-06-03 11:09:13 +08:00
|
|
|
outputs = append(outputs, l.lintOutputs())
|
|
|
|
}
|
|
|
|
})
|
|
|
|
|
|
|
|
dirs = android.SortedUniqueStrings(dirs)
|
|
|
|
|
|
|
|
zip := func(outputPath android.WritablePath, get func(*lintOutputs) android.Path) {
|
|
|
|
var paths android.Paths
|
|
|
|
|
|
|
|
for _, output := range outputs {
|
2020-07-22 11:31:17 +08:00
|
|
|
if p := get(output); p != nil {
|
|
|
|
paths = append(paths, p)
|
|
|
|
}
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
2020-07-04 02:56:24 +08:00
|
|
|
lintZip(ctx, paths, outputPath)
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
l.htmlZip = android.PathForOutput(ctx, "lint-report-html.zip")
|
|
|
|
zip(l.htmlZip, func(l *lintOutputs) android.Path { return l.html })
|
|
|
|
|
|
|
|
l.textZip = android.PathForOutput(ctx, "lint-report-text.zip")
|
|
|
|
zip(l.textZip, func(l *lintOutputs) android.Path { return l.text })
|
|
|
|
|
|
|
|
l.xmlZip = android.PathForOutput(ctx, "lint-report-xml.zip")
|
|
|
|
zip(l.xmlZip, func(l *lintOutputs) android.Path { return l.xml })
|
|
|
|
|
|
|
|
ctx.Phony("lint-check", l.htmlZip, l.textZip, l.xmlZip)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (l *lintSingleton) MakeVars(ctx android.MakeVarsContext) {
|
2020-07-07 02:45:51 +08:00
|
|
|
if !ctx.Config().UnbundledBuild() {
|
|
|
|
ctx.DistForGoal("lint-check", l.htmlZip, l.textZip, l.xmlZip)
|
|
|
|
}
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
var _ android.SingletonMakeVarsProvider = (*lintSingleton)(nil)
|
|
|
|
|
|
|
|
func init() {
|
|
|
|
android.RegisterSingletonType("lint",
|
|
|
|
func() android.Singleton { return &lintSingleton{} })
|
2021-05-11 06:30:00 +08:00
|
|
|
|
|
|
|
registerLintBuildComponents(android.InitRegistrationContext)
|
|
|
|
}
|
|
|
|
|
|
|
|
func registerLintBuildComponents(ctx android.RegistrationContext) {
|
|
|
|
ctx.PostDepsMutators(func(ctx android.RegisterMutatorsContext) {
|
|
|
|
ctx.TopDown("enforce_strict_updatability_linting", enforceStrictUpdatabilityLintingMutator).Parallel()
|
|
|
|
})
|
2020-06-03 11:09:13 +08:00
|
|
|
}
|
2020-07-04 02:56:24 +08:00
|
|
|
|
|
|
|
func lintZip(ctx android.BuilderContext, paths android.Paths, outputPath android.WritablePath) {
|
|
|
|
paths = android.SortedUniquePaths(android.CopyOfPaths(paths))
|
|
|
|
|
|
|
|
sort.Slice(paths, func(i, j int) bool {
|
|
|
|
return paths[i].String() < paths[j].String()
|
|
|
|
})
|
|
|
|
|
2020-11-17 09:32:30 +08:00
|
|
|
rule := android.NewRuleBuilder(pctx, ctx)
|
2020-07-04 02:56:24 +08:00
|
|
|
|
2020-11-17 09:32:30 +08:00
|
|
|
rule.Command().BuiltTool("soong_zip").
|
2020-07-04 02:56:24 +08:00
|
|
|
FlagWithOutput("-o ", outputPath).
|
|
|
|
FlagWithArg("-C ", android.PathForIntermediates(ctx).String()).
|
2021-03-13 09:48:14 +08:00
|
|
|
FlagWithRspFileInputList("-r ", outputPath.ReplaceExtension(ctx, "rsp"), paths)
|
2020-07-04 02:56:24 +08:00
|
|
|
|
2020-11-17 09:32:30 +08:00
|
|
|
rule.Build(outputPath.Base(), outputPath.Base())
|
2020-07-04 02:56:24 +08:00
|
|
|
}
|
2021-05-11 06:30:00 +08:00
|
|
|
|
|
|
|
// Enforce the strict updatability linting to all applicable transitive dependencies.
|
|
|
|
func enforceStrictUpdatabilityLintingMutator(ctx android.TopDownMutatorContext) {
|
|
|
|
m := ctx.Module()
|
|
|
|
if d, ok := m.(lintDepSetsIntf); ok && d.getStrictUpdatabilityLinting() {
|
|
|
|
ctx.VisitDirectDepsWithTag(staticLibTag, func(d android.Module) {
|
|
|
|
if a, ok := d.(lintDepSetsIntf); ok {
|
|
|
|
a.setStrictUpdatabilityLinting(true)
|
|
|
|
}
|
|
|
|
})
|
|
|
|
}
|
|
|
|
}
|