| /* |
| * Copyright (C) 2018 The Android Open Source Project |
| * |
| * 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. |
| */ |
| |
| @file:Suppress("UnstableApiUsage") |
| |
| package androidx.build.lint |
| |
| import com.android.tools.lint.client.api.UElementHandler |
| |
| import com.android.tools.lint.detector.api.Category |
| import com.android.tools.lint.detector.api.Detector |
| import com.android.tools.lint.detector.api.Implementation |
| import com.android.tools.lint.detector.api.Issue |
| import com.android.tools.lint.detector.api.JavaContext |
| import com.android.tools.lint.detector.api.Scope |
| import com.android.tools.lint.detector.api.Severity |
| import org.jetbrains.uast.UAnnotation |
| |
| /** |
| * Enforces policy banning use of the `@TargetApi` annotation. |
| */ |
| class TargetApiAnnotationUsageDetector : Detector(), Detector.UastScanner { |
| |
| override fun getApplicableUastTypes() = listOf(UAnnotation::class.java) |
| |
| override fun createUastHandler(context: JavaContext): UElementHandler { |
| return AnnotationChecker(context) |
| } |
| |
| private inner class AnnotationChecker(val context: JavaContext) : UElementHandler() { |
| override fun visitAnnotation(node: UAnnotation) { |
| if (node.qualifiedName == "android.annotation.TargetApi") { |
| context.report( |
| ISSUE, node, context.getNameLocation(node), |
| "Use `@RequiresApi` instead of `@TargetApi`", |
| fix().name("Replace with `@RequiresApi`") |
| .replace() |
| .pattern("(?:android\\.annotation\\.)?TargetApi") |
| .with("androidx.annotation.RequiresApi") |
| .shortenNames() |
| .autoFix(true, true) |
| .build(), |
| ) |
| } |
| } |
| } |
| |
| companion object { |
| val ISSUE = Issue.create( |
| "BanTargetApiAnnotation", |
| "Replace usage of `@TargetApi` with `@RequiresApi`", |
| "The `@TargetApi` annotation satisfies the `NewApi` lint check, but it does " + |
| "not ensure that calls to the annotated API are correctly guarded on an `SDK_INT`" + |
| " (or equivalent) check. Instead, use the `@RequiresApi` annotation to ensure " + |
| "that all calls are correctly guarded.", |
| Category.CORRECTNESS, 5, Severity.ERROR, |
| Implementation(TargetApiAnnotationUsageDetector::class.java, Scope.JAVA_FILE_SCOPE) |
| ) |
| } |
| } |