린트 검사로 코드 개선

앱이 기능 요구사항을 충족하는지 확인하는 테스트를 빌드하는 것 외에도 린트 도구를 통해 코드를 실행하여 코드에 구조적 문제가 없는지 확인하는 것이 중요합니다. 린트 도구를 사용하면 구조적 문제로 인해 Android 앱의 안정성과 효율성에 영향을 미치거나 코드 관리에 지장을 줄 가능성이 있는 코드를 찾을 수 있습니다. 앱을 게시하기 전에 린트에서 감지하는 오류를 수정하는 것이 좋습니다.

예를 들어 XML 리소스 파일에 사용되지 않는 네임스페이스가 있다면 공간을 차지하며 불필요한 처리가 필요합니다. 지원 중단된 요소 또는 타겟 API 버전에서 지원하지 않는 API 호출의 사용과 같은 다른 구조적 문제가 발생하는 경우 코드가 올바르게 실행되지 않을 수 있습니다. 린트를 사용하면 이런 문제를 해결할 수 있습니다.

린트 성능을 개선하기 위해 코드에 주석을 추가할 수도 있습니다.

개요

Android 스튜디오에서 제공하는 린트라는 코드 스캔 도구를 사용하면 앱을 실행하거나 테스트 사례를 작성할 필요 없이 코드의 구조적 품질 문제를 식별하고 수정할 수 있습니다. 도구에서 감지된 각 문제는 설명 메시지 및 심각도 수준과 함께 보고되므로 개선이 필요한 중요한 문제의 우선순위를 정할 수 있습니다. 또한 문제의 심각도 수준을 낮춰 프로젝트와 관련이 없는 문제를 무시하거나 심각도 수준을 높여 특정 문제를 강조 표시할 수도 있습니다.

린트 도구는 Android 프로젝트 소스 파일을 검사하여 잠재적 버그를 찾아내고 정확성, 보안, 성능, 사용성, 접근성, 국제화 등을 최적화합니다. Android 스튜디오를 사용하면 앱을 빌드할 때 구성된 린트 및 IDE 검사가 실행됩니다. 그러나 이 페이지에 설명된 대로 수동으로 검사를 실행하거나 명령줄에서 린트를 실행할 수도 있습니다.

Android 스튜디오를 사용하는 동안 내장된 린트 도구가 코드를 검사합니다. 경고와 오류를 확인할 수 있는 2가지 방법이 있습니다.

  • 편집기 창에 팝업 텍스트로 표시됩니다. 린트가 문제를 발견하면 문제가 있는 코드를 노란색으로 강조표시합니다. 더 심각한 문제는 코드에 빨간색 밑줄이 표시됩니다.
  • Code > Inspect Code 클릭 시 린트 Inspection Results 창에서 확인

참고: Android 스튜디오에서 코드를 컴파일할 때는 IntelliJ 코드 검사가 추가로 실행되어 코드 검토가 간소화됩니다.

그림 1은 린트 도구가 앱 소스 파일을 처리하는 방법을 보여줍니다.

린트 도구를 사용한 코드 스캔 워크플로
그림 1. 린트 도구를 사용한 코드 스캔 워크플로
앱 소스 파일
소스 파일은 Kotlin, 자바, XML 파일, 아이콘 및 ProGuard 구성 파일을 포함하여 Android 프로젝트를 구성하는 파일로 구성됩니다.
lint.xml 파일
제외할 린트 검사를 지정하고 문제 심각도 수준을 맞춤설정하는 데 사용할 수 있는 구성 파일입니다.
린트 도구
명령줄 또는 Android 스튜디오를 사용하여 Android 프로젝트에서 실행할 수 있는 정적 코드 스캔 도구입니다. 린트 도구는 Android 앱의 품질과 성능에 영향을 미칠 수 있는 구조적 코드 문제를 검사합니다.
린트 검사 결과
Android 스튜디오의 콘솔 또는 Inspection Results 창에서 결과를 확인할 수 있습니다. 명령줄에서 lint를 실행하면 결과는 build/ 폴더에 기록됩니다. 자세한 내용은 수동으로 검사 실행 섹션을 참고하세요.

명령줄에서 린트 실행

Android 스튜디오 또는 Gradle을 사용하는 경우 프로젝트의 루트 디렉터리에서 다음 명령어 중 하나를 입력하여 프로젝트의 lint 작업을 호출하도록 Gradle 래퍼를 사용합니다.

  • Windows의 경우:
    gradlew lint
    
  • Linux 또는 macOS:
    ./gradlew lint
    

다음과 비슷한 출력이 표시됩니다.

> Task :app:lintDebug
Wrote HTML report to file:<path-to-project>/app/build/reports/lint-results-debug.html

린트 도구에서 검사가 완료되면 XML 버전 및 HTML 버전의 린트 보고서 경로가 제공됩니다. 그러면 HTML 보고서로 이동하여 브라우저에서 보고서를 열 수 있습니다(그림 2 참조).

HTML 린트 보고서 샘플
그림 2. HTML 린트 보고서 샘플

프로젝트에 빌드 변형이 포함되어 있는 경우 린트는 기본 변형만 검사합니다. 다른 변형에서 린트를 실행하려면 변형 이름을 대문자로 쓰고 lint 접두사를 붙여야 합니다.

./gradlew lintRelease

명령줄에서 Gradle 작업을 실행하는 방법에 관한 자세한 내용은 명령줄에서 앱 빌드를 참고하세요.

독립형 도구를 사용하여 린트 실행

Android 스튜디오나 Gradle을 사용하지 않는 경우 Android SDK 명령줄 도구를 설치하여 독립형 린트 도구를 사용합니다. android_sdk/cmdline-tools/version/bin/lint에서 린트 도구를 찾습니다.

참고: Gradle 프로젝트에서 독립형 도구를 실행하려고 하면 오류가 발생합니다. Gradle 프로젝트에서 린트를 실행하려면 항상 gradle lint (Windows의 경우) 또는 ./gradlew lint (macOS 또는 Linux의 경우)를 사용해야 합니다.

프로젝트 디렉터리에서 파일 목록에 린트를 실행하려면 다음 명령어를 사용합니다.

lint [flags] <project directory>

예를 들어 다음 명령어를 실행하여 myproject 디렉터리 및 그 하위 디렉터리에 있는 파일을 스캔할 수 있습니다. 문제 ID MissingPrefix는 Android 네임스페이스 접두사가 없는 XML 속성만 스캔하도록 린트에 지시합니다.

lint --check MissingPrefix myproject 

도구에서 지원하는 플래그 및 명령줄 인수의 전체 목록을 보려면 다음 명령어를 사용하세요.

lint --help

다음 예에서는 Earthquake라는 프로젝트에서 린트 명령어가 실행될 때의 콘솔 출력을 보여줍니다.

$ 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

예시 출력에는 경고 4개가 나열되고 오류는 없습니다.

프로젝트의 AndroidManifest.xml 파일과 관련된 두 가지 경고는 다음과 같습니다.

  • ManifestOrder
  • UsesMinSdkAttributes
한 가지 경고는 Preferences.xml 레이아웃 파일(UnusedResources)과 관련이 있습니다.

한 가지 경고는 res 디렉터리(IconMissingDensityFolder)와 관련이 있습니다.

경고를 표시하지 않도록 린트 구성

기본적으로 린트 스캔을 실행하면 도구는 린트에서 지원하는 모든 문제를 검사합니다. 또한 린트가 검사할 문제를 제한하고 문제에 심각도 수준을 할당할 수 있습니다. 예를 들어 프로젝트와 관련이 없는 특정 문제에 대해서는 린트 검사를 금지하고 심각도가 낮은 문제를 보고하도록 린트를 구성할 수 있습니다.

심각도 수준은 다음과 같습니다.

  • enable
  • disable 또는 ignore
  • informational
  • warning
  • error
  • fatal

다양한 수준으로 린트 검사를 구성할 수 있습니다.

  • 전역(전체 프로젝트)
  • 프로젝트 모듈
  • 프로덕션 모듈
  • 테스트 모듈
  • 열린 파일
  • 클래스 계층 구조
  • 버전 제어 시스템(VCS) 범위

린트 파일 구성

lint.xml 파일에서 린트 검사 환경설정을 지정할 수 있습니다. 이 파일을 수동으로 만드는 경우 Android 프로젝트의 루트 디렉터리에 파일을 넣습니다.

lint.xml 파일은 하위 <issue> 요소가 하나 이상 포함된 인클로징 <lint> 상위 태그로 구성됩니다. 린트는 각 <issue>에 고유한 id 속성 값을 정의합니다.

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

문제의 심각도 수준을 변경하거나 문제의 린트 검사를 사용 중지하려면 <issue> 태그에 심각도 속성을 설정하세요.

도움말: 린트에서 지원하는 문제 및 상응하는 문제 ID의 전체 목록을 확인하려면 lint --list 명령어를 실행하세요.

lint.xml 파일 샘플

다음 예는 lint.xml 파일의 콘텐츠를 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disable the IconMissingDensityFolder 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>

이 예에서는 다양한 문제 유형이 보고되는 방식을 보여줍니다. IconMissingDensityFolder 검사는 완전히 사용 중지되며 ObsoleteLayoutParam 검사는 포함된 <ignore ... /> 선언에 지정된 파일에서만 사용 중지됩니다.

Kotlin, Java, XML 소스 파일의 린트 검사 구성

Preferences 대화상자에서 Kotlin, Java, XML 소스 파일의 린트 검사를 사용 중지할 수 있습니다.

  1. File > Settings (Windows) 또는 Android Studio > Preferences(macOS 또는 Linux)를 선택합니다.
  2. Editor > Inspections를 선택합니다.
  3. 사용 중지하려면 적절한 소스 파일을 선택 해제합니다.

적절한 프로필을 선택하여 IDE 또는 개별 프로젝트에 대해 이를 설정할 수 있습니다.

자바 또는 Kotlin에서 린트 검사 구성

특히 Android 프로젝트에서 클래스 또는 메서드의 린트 검사를 사용 중지하려면 코드에 @SuppressLint 주석을 추가합니다.

다음 예는 onCreate 메서드에서 NewApi 문제의 린트 검사를 사용 중지할 수 있는 방법을 보여줍니다. 린트 도구는 이 클래스의 다른 메서드에서 NewApi 문제를 계속 검사합니다.

Kotlin

@SuppressLint("NewApi")
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

Java

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

컴포저블에서도 같은 작업을 할 수 있습니다. 다음 코드 스니펫은 컴포저블에서 NewApi 검사를 사용 중지하는 방법을 보여줍니다.

Kotlin

  @SuppressLint("NewApi")
  @Composable
  fun MyComposable{
    ...
  }
  

다음 예는 FeedProvider 클래스에서 ParserError 문제의 린트 검사를 사용 중지하는 방법을 보여줍니다.

Kotlin

@SuppressLint("ParserError")
class FeedProvider : ContentProvider() {

Java

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

파일에서 모든 린트 문제 검사를 금지하려면 all 키워드를 사용합니다.

Kotlin

@SuppressLint("all")

Java

@SuppressLint("all")

동일한 주석을 사용하여 구성 가능한 함수에서 린트 검사를 억제할 수 있습니다.

XML에서 린트 검사 구성

XML 파일의 특정 섹션을 대상으로 하는 린트 검사를 사용 중지하려면 tools:ignore 속성을 사용합니다. 다음 네임스페이스 값을 lint.xml 파일에 입력하여 린트 도구에서 속성을 인식하도록 합니다.

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

다음 예는 XML 레이아웃 파일의 <LinearLayout> 요소에서 UnusedResources 문제의 린트 검사를 사용 중지할 수 있는 방법을 보여줍니다. ignore 속성은 속성이 선언된 상위 요소의 하위 요소에서 상속됩니다. 이 예에서 린트 검사는 하위 <TextView> 요소에도 사용 중지됩니다.

<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"

XML 요소에서 모든 린트 문제 검사를 금지하려면 all 키워드를 사용합니다.

tools:ignore="all"

Gradle에서 린트 옵션 구성

Gradle용 Android 플러그인을 사용하면 모듈 수준 build.gradle 파일에서 lint{} 블록을 사용하여 실행하거나 무시할 검사와 같은 특정 린트 옵션을 구성할 수 있습니다.

다음 코드 스니펫은 구성 가능한 속성 중 일부를 보여줍니다.

Kotlin

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable += "TypographyFractions" + "TypographyQuotes"
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable += "RtlHardcoded" + "RtlCompat" + "RtlEnabled"
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly += "NewApi" + "InlinedApi"
        // If set to true, turns off analysis progress reporting by lint.
        quiet = true
        // If set to true (default), stops the build if errors are found.
        abortOnError = false
        // If set to true, lint only reports errors.
        ignoreWarnings = true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies = true
    }
}
...

Groovy

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable 'TypographyFractions','TypographyQuotes'
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable 'RtlHardcoded','RtlCompat', 'RtlEnabled'
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly 'NewApi', 'InlinedApi'
        // If set to true, turns off analysis progress reporting by lint.
        quiet true
        // If set to true (default), stops the build if errors are found.
        abortOnError false
        // If set to true, lint only reports errors.
        ignoreWarnings true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies true
    }
}
...

문제의 지정된 심각도 수준을 재정의하는 모든 린트 메서드는 구성 순서를 따릅니다. 예를 들어 finalizeDsl()에서 문제를 심각한 것으로 설정하면 기본 DSL에서 사용 중지가 재정의됩니다.

경고 기준 만들기

프로젝트의 현재 경고 세트의 스냅샷을 만든 후 해당 스냅샷을 이후 검사 실행의 기준으로 사용하여 새로운 문제만 보고되도록 할 수 있습니다. 기준 스냅샷을 사용하면 먼저 모든 기존 문제로 돌아가 문제를 해결하지 않고도 린트를 사용해 빌드를 통과시키지 않게 만들 수 있습니다.

기준 스냅샷을 만들려면 다음과 같이 프로젝트의 build.gradle 파일을 수정합니다.

Kotlin

android {
    lint {
        baseline = file("lint-baseline.xml")
    }
}

Groovy

android {
    lintOptions {
        baseline file("lint-baseline.xml")
    }
}

이 줄을 처음 추가하면 기준을 설정하는 lint-baseline.xml 파일이 만들어집니다. 그런 다음에는 도구가 파일만 읽어 기준을 확인합니다. 새 기준을 만들려면 수동으로 파일을 삭제하고 린트를 다시 실행하여 파일을 다시 만듭니다.

그런 다음, 다음과 같이 명령줄에서 코드 > 코드 검사를 선택하여 IDE에서 린트를 실행합니다. 출력에는 lint-baseline.xml 파일 위치가 표시됩니다. 설정의 파일 위치는 여기 표시된 것과 다를 수 있습니다.

$ ./gradlew lintDebug -Dlint.baselines.continue=true
...
Wrote XML report to file:///app/lint-baseline.xml
Created baseline file /app/lint-baseline.xml

lint를 실행하면 lint-baseline.xml 파일의 현재 문제가 모두 기록됩니다. 이러한 현재의 문제 집합을 기준이라고 합니다. 다른 사람과 공유하려면 lint-baseline.xml 파일을 버전 제어로 체크인하면 됩니다.

기준 맞춤설정

특정 문제 유형만 기준에 추가하려면 다음과 같이 프로젝트의 build.gradle 파일을 수정하여 추가할 문제를 지정합니다.

Kotlin

android {
    lint {
        checkOnly += "NewApi" + "HandlerLeak"
        baseline = file("lint-baseline.xml")
    }
}

Groovy

android {
    lintOptions {
        checkOnly 'NewApi', 'HandlerLeak'
        baseline file("lint-baseline.xml")
    }
}

기준을 만든 후 코드베이스에 새로운 경고를 추가하면 새로 발생한 버그만 린트에 나열됩니다.

기준 경고

기준이 적용되면 하나 이상의 문제가 기준에 나열되어 있어 필터링되었다는 정보성 경고가 표시됩니다. 이 경고를 통해 기준을 구성했으며 특정 시점에 모든 문제를 해결해야 한다는 점을 기억할 수 있습니다.

이 정보성 경고는 더 이상 보고되지 않는 문제도 추적합니다. 이 정보를 통해 실제로 문제를 해결했는지 알 수 있으므로 선택적으로 기준을 다시 만들어 오류가 감지되지 않은 상태로 재발하는 것을 방지할 수 있습니다.

참고: 기준은 IDE에서 일괄 모드로 검사를 실행하면 사용 설정되지만 파일을 수정할 때 백그라운드에서 실행되는 편집기 내 검사에서는 무시됩니다. 이는 코드베이스에 기존 경고가 많지만 개발자가 코드를 터치하는 동안 로컬에서 문제를 해결하려는 경우를 대상으로 하기 때문입니다.

수동으로 검사 실행하기

구성된 린트 및 다른 IDE 검사를 수동으로 실행하려면 Code > Inspect Code를 선택합니다. 검사 결과는 Inspection Results 창에 표시됩니다.

검사 범위 및 프로필 설정

분석할 파일 (검사 범위)과 실행할 검사 (검사 프로필)를 다음과 같이 선택합니다.

  1. Android 뷰에서 프로젝트를 열고 분석할 프로젝트, 폴더, 파일을 선택합니다.
  2. 메뉴 바에서 Code > Inspect Code를 선택합니다.
  3. Specify Inspection Scope 대화상자에서 설정을 검토합니다.

    검사 범위 지정
    그림 3. 검사 범위 설정을 검토합니다.

    Specify Inspection Scope 대화상자에 표시되는 옵션은 프로젝트, 폴더, 파일 중 무엇을 선택했는지에 따라 다릅니다.

    • 프로젝트, 파일, 디렉터리를 하나 선택하면 Specify Inspection Scope 대화상자에 선택한 프로젝트, 파일, 디렉터리의 경로가 표시됩니다.
    • 프로젝트, 파일, 디렉터리를 두 개 이상 선택하면 Specify Inspection Scope 대화상자에 선택한 파일의 선택된 라디오 버튼이 표시됩니다.

    검사할 항목을 변경하려면 다른 라디오 버튼 중 하나를 선택합니다. Specify Inspection Scope 대화상자의 모든 가능한 필드에 관한 설명은 Specify Inspection Scope 대화상자를 참고하세요.

  4. Inspection Profile에서 사용할 프로필을 선택합니다.
  5. OK를 클릭하여 검사를 실행합니다.

    그림 4는 Inspect Code 실행 시 Lint 및 다른 IDE 검사 결과를 보여줍니다.

    문제를 선택하여 해결 방법을 확인하세요.
    그림 4. 검사 결과 문제를 선택하여 해결 방법을 확인하세요.
  6. Inspection Results 창에서 오류 카테고리, 유형, 문제를 펼치고 선택하여 검사 결과를 확인합니다.

    Inspection Report 창에는 Inspection Results 창에서 선택한 오류 카테고리, 유형 또는 문제의 검사 보고서가 표시되고 오류의 이름과 위치가 표시됩니다. 해당하는 경우 검사 보고서는 문제 개요와 같은 다른 정보를 표시하여 문제를 해결하는 데 도움을 줍니다.

  7. Inspection Results 창 트리 보기에서 카테고리, 유형 또는 문제를 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 표시합니다.

    상황에 따라 다음 작업을 수행할 수 있습니다.

    • 소스로 이동합니다.
    • 선택한 항목을 제외하고 포함합니다.
    • 문제 억제
    • 설정을 변경합니다.
    • 검사 알림을 관리합니다.
    • 검사를 다시 실행합니다.

툴바 버튼, 컨텍스트 메뉴 항목, 검사 보고서 필드에 관한 설명은 검사 결과 도구 창을 참고하세요.

맞춤 범위 사용

다음과 같이 Android 스튜디오에서 제공되는 맞춤 범위 중 하나를 사용합니다.

  1. Specify Inspection Scope 대화상자에서 Custom scope를 선택합니다.
  2. Custom scope 목록을 클릭하여 옵션을 표시합니다.

    검사 범위 선택
    그림 5. 사용할 커스텀 범위를 선택하세요.
    • 모든 장소: 모든 파일
    • Project Files: 현재 프로젝트의 모든 파일입니다.
    • Project Source Files: 현재 프로젝트의 소스 파일만 해당합니다.
    • Project Production Files: 현재 프로젝트의 프로덕션 파일만 해당합니다.
    • Project Test Files: 현재 프로젝트의 테스트 파일만 해당합니다.
    • 스크래치 및 콘솔: 현재 프로젝트에서 연 스크래치 파일과 콘솔만 해당합니다.
    • Recent Viewed Files(최근 본 파일): 현재 프로젝트에서 최근에 본 파일만 해당합니다.
    • Current File: 현재 프로젝트에 있는 현재 파일만 해당합니다. 파일 또는 폴더를 선택했을 때 나타납니다.
    • Selected Directory(선택한 디렉터리): 현재 프로젝트의 현재 폴더만 해당합니다. 폴더를 선택했을 때 나타납니다.
    • Class Hierarchy: 이 옵션을 선택하고 OK를 클릭하면 현재 프로젝트의 모든 클래스와 함께 대화상자가 표시됩니다. 대화상자에서 Search by Name 필드를 사용하여 검사할 클래스를 필터링하고 선택합니다. 클래스 목록을 필터링하지 않으면 코드 검사에서 모든 클래스를 검사합니다.

    프로젝트에 VCS를 구성한 경우 수정된 파일로만 검색을 제한하는 옵션도 있습니다.

  3. OK를 클릭합니다.

맞춤 범위 만들기

현재 이용 가능한 맞춤 범위에 포함되지 않는 파일과 디렉터리를 검사하려면 맞춤 범위를 만들면 됩니다.

  1. Specify Inspection Scope 대화상자에서 Custom scope를 선택합니다.
  2. Custom Scope 목록 뒤에 있는 점 3개를 클릭합니다.

    Specify Inspection Scope 대화상자
    그림 6. Inspection Scope 대화상자 지정

    Scopes 대화상자가 나타납니다.

    맞춤 범위 만들기
    그림 7. 맞춤 범위를 만듭니다.
  3. 대화상자의 왼쪽 상단에 있는 버튼을 클릭하여 새 범위를 정의합니다.
  4. 표시되는 Add Scope 목록에서 Local을 선택합니다.

    로컬 범위와 공유 범위는 모두 프로젝트 내에서 Inspect Code 기능에 사용됩니다. Shared 범위는 범위 필드가 있는 다른 프로젝트 기능에서도 사용할 수 있습니다. 예를 들어 Edit Settings 를 클릭하여 Find Usages의 설정을 변경하면 이후 표시되는 대화상자의 Scope 필드에서 공유 범위를 선택할 수 있습니다.

    Find Usages 대화상자에서 공유 범위 선택
    그림 8. Find Usages 대화상자에서 공유 범위를 선택합니다.
  5. 범위에 이름을 지정하고 OK를 클릭합니다.

    Scopes 대화상자의 오른쪽 창에 맞춤 범위를 정의할 수 있는 옵션이 채워집니다.

  6. 목록에서 Project를 선택합니다.

    이용 가능한 프로젝트 목록이 나타납니다.

    참고: 프로젝트 또는 패키지의 맞춤 범위를 만들 수 있습니다. 단계는 동일합니다.

  7. 프로젝트 폴더를 펼치고 맞춤 범위에 추가할 항목을 선택한 다음, 이를 포함할지 또는 제외할지 선택합니다.

    맞춤 범위 정의하기
    그림 9. 맞춤 범위를 정의합니다.
    • Include: 이 폴더와 그 안의 파일을 포함하지만 하위 폴더는 포함하지 않습니다.
    • Include Recursively: 이 폴더와 그 안의 파일, 하위 폴더 및 그 안의 파일까지 포함합니다.
    • Exclude: 이 폴더와 그 안의 파일을 제외하지만 하위 폴더는 제외하지 않습니다.
    • Exclude Recursively: 이 폴더와 그 안의 파일뿐만 아니라 하위 폴더와 그 안의 파일까지 제외합니다.

    그림 10은 main 폴더가 포함되어 있고 javares 폴더는 재귀적으로 포함된 상태를 보여줍니다. 파란색은 부분적으로 포함된 폴더를 나타내고 녹색은 재귀적으로 포함된 폴더와 파일을 나타냅니다.

    맞춤 범위 패턴의 예
    그림 10. 맞춤 범위 패턴의 예
    • java 폴더를 선택하고 Exclude Recursively를 클릭하면 java 폴더와 그 안의 모든 폴더 및 파일을 강조표시하는 녹색이 사라집니다.
    • 녹색으로 강조표시된 MainActivity.kt 파일을 선택하고 Exclude를 클릭하면 MainActivity.kt가 더 이상 녹색으로 강조표시되지 않지만 java 폴더 아래의 다른 모든 항목은 녹색으로 유지됩니다.
  8. OK(확인)을 클릭합니다. 맞춤 범위는 목록 하단에 표시됩니다.

검사 프로필 검토 및 수정

Android 스튜디오에는 Android 업데이트를 통해 업데이트된 린트 및 기타 검사 프로필 선택 항목이 있습니다. 이러한 프로필을 그대로 사용하거나 이름, 설명, 심각도, 범위를 수정할 수 있습니다. 또한 프로필 그룹 전체 또는 그룹 내 개별 프로필을 활성화/비활성화할 수도 있습니다.

검사 설정에 액세스하려면 다음 단계를 따르세요.

  1. 파일 > 설정을 선택합니다. (Windows의 경우) 또는 Android Studio > Preferences(macOS 또는 Linux의 경우)를 선택합니다.
  2. Editor > Inspections를 선택합니다.
  3. Inspections 창에 지원되는 검사 및 설명 목록이 표시됩니다.

    지원되는 검사 및 설명
    그림 11. 지원되는 검사 및 설명
  4. Profile 목록을 선택하여 Default 검사 (Android 스튜디오)와 Project Default 검사 (활성 프로젝트) 간에 전환합니다.

    자세한 내용은 IntelliJ 프로필 관리 페이지를 참고하세요.

  5. 왼쪽 창의 Inspections 목록에서 최상위 프로필 카테고리를 선택하거나 그룹을 펼치고 특정 프로필을 선택합니다.

    프로필 카테고리를 선택하면 카테고리의 모든 검사를 단일 검사로 수정할 수 있습니다.

  6. Show Schema Actions 스키마 작업 표시 아이콘 목록을 선택하여 검사 복사, 이름 바꾸기, 설명 추가, 내보내기, 가져오기를 수행합니다.
  7. 완료되면 OK를 클릭합니다.