| /* |
| * Copyright (C) 2016 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. |
| */ |
| package com.android.tools.lint.checks; |
| |
| import com.android.SdkConstants; |
| import com.android.annotations.NonNull; |
| import com.android.annotations.Nullable; |
| import com.android.tools.lint.client.api.JavaEvaluator; |
| 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 com.android.tools.lint.detector.api.SourceCodeScanner; |
| import com.intellij.psi.PsiMethod; |
| import java.util.Collections; |
| import java.util.List; |
| import org.jetbrains.uast.UClass; |
| |
| /** |
| * Check that looks for override of getContentDescription() in any class that descends from View. |
| */ |
| public class GetContentDescriptionOverrideDetector extends Detector implements SourceCodeScanner { |
| |
| public static final Issue ISSUE = |
| Issue.create( |
| "GetContentDescriptionOverride", |
| "Overriding `getContentDescription()` on a View", |
| "Overriding `getContentDescription()` may prevent some accessibility services from " |
| + "properly navigating content exposed by your view. Instead, call " |
| + "`setContentDescription()` when the content description needs to be changed.", |
| Category.A11Y, |
| 9, |
| Severity.ERROR, |
| new Implementation( |
| GetContentDescriptionOverrideDetector.class, |
| Scope.JAVA_FILE_SCOPE)) |
| .setAndroidSpecific(true); |
| |
| /** Constructs a new GetContentDescriptionOverrideDetector check. */ |
| public GetContentDescriptionOverrideDetector() {} |
| |
| @Nullable |
| @Override |
| public List<String> applicableSuperClasses() { |
| return Collections.singletonList(SdkConstants.CLASS_VIEW); |
| } |
| |
| @Override |
| public void visitClass(@NonNull JavaContext context, @NonNull UClass declaration) { |
| JavaEvaluator evaluator = context.getEvaluator(); |
| for (PsiMethod method : declaration.findMethodsByName("getContentDescription", false)) { |
| if (evaluator.getParameterCount(method) == 0) { |
| context.report( |
| ISSUE, |
| method, |
| context.getNameLocation(method), |
| "Overriding `getContentDescription()` on a View is not recommended"); |
| } |
| } |
| } |
| } |