다음을 통해 공유

Android 레이아웃 진단

  • 아티클

Android 레이아웃 진단 일반적인 품질 문제와 유용한 최적화를 강조 표시하여 Android 레이아웃 파일의 품질을 개선하는 데 도움이 되도록 설계되었습니다. 이 기능은 Visual Studio 16.5 이상 및 Mac용 Visual Studio 8.5 이상에서 모두 사용할 수 있습니다.

다양한 문제에 대해 기본 분석기 집합이 제공되며 각 분석기는 프로젝트의 특정 요구 사항을 충족하도록 사용자 지정할 수 있습니다. 분석기는 Android Linting 시스템을 기반으로 합니다.

Visual Studio 2019에서 Android 레이아웃 진단 사용

레이아웃 진단 설정인 레이아웃 진단 사용하도록 설정되었는지 확인합니다. 이 옵션 페이지에 액세스하려면 도구>옵션을 선택한 다음 텍스트 편집기>Android XML>고급을 선택합니다.

Options dialog showing how to enable diagnostics option

사용하도록 설정하면 Android 레이아웃 편집기에서 다음과 같은 문제가 표시됩니다.

Android diagnostics enabled on Visual Studio 2019

기능

다음 섹션에서는 Android 레이아웃 진단 사용 가능한 기능을 간략하게 설명합니다.

분석기

분석기는 레이아웃 파일에서 문제를 감지하고, 하드 코딩된 값을 줄이고, 성능을 향상시키고, 오류에 플래그를 지정하는 데 사용됩니다. 분석기 목록은 Android 디자이너 진단 분석기를 참조 하세요.

진단 구성

XML 파일을 사용하여 분석기를 구성할 수 있으므로 기본 심각도 수준을 변경하고 특정 파일을 무시하고 변수를 전달할 수 있습니다.

여러 Android 앱에서 공유하려는 구성 집합이 있는 경우 기준 파일을 사용할 수 있습니다. 이 기능을 사용하려면 새 구성 파일을 만들고 파일 이름에 추가 -baseline 합니다. 기준 구성이 먼저 적용된 다음 다시 기본 구성 파일이 적용됩니다.

팁

이 기능은 신규 또는 기존 Android 앱에서 일련의 문제를 무시하려는 경우에 유용할 수 있습니다.

형식:

<?xml version="1.0" encoding="utf-8" ?> 
<configuration>
    <issue id="DuplicateIDs" severity="warning">
        <ignore path="Resources/layout/layout1.xml" />
    </issue>
    <issue id="HardcodedText" severity="informational">
        <ignore path="Resources/layout/layout1.xml" />
        <ignore path="Resource/layout/layout2.xml" />
    </issue>
    <issue id="TooManyViews">
        <variable name="MAX_VIEW_COUNT" value="12" />
    </issue>
    <issue id="TooDeepLayout">
        <variable name="MAX_DEPTH" value="12" />
    </issue>
</configuration>

참고 항목

현재 유일한 변수는 MAX_VIEW_COUNT 각각 (기본값: 80) 및 MAX_DEPTH (기본값: 10) TooManyViewsTooDeepLayout 입니다.

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

  • 제안 해결 방법
  • 정보
  • Warning
  • Error
  • 무시

구성 파일 추가

Android 앱 프로젝트의 루트에 새 XML 파일을 만듭니다. 파일 이름은 중요하지 않지만 이 예제에서는 다음을 사용합니다.AndroidLayoutDiagnostics.xml

Add New Item

새 XML 파일이 추가되면 Android 앱 프로젝트 트리에 표시됩니다.

Android App Project Tree

빌드 작업이 속성 패널에서 AndroidResourceAnalysisConfig로 설정되어 있는지 확인합니다. 새 파일에 대한 속성 패널을 끌어오는 가장 쉬운 방법은 파일을 마우스 오른쪽 단추로 클릭하고 속성을 선택하는 것입니다. 속성 패널이 표시되면 빌드 작업을 AndroidResourceAnalysisConfig로 변경해야 합니다.

Set Build Action in Item Properties

이제 빈 XML 파일이 있으므로 루트 요소를 추가 <configuration> 해야 합니다. 이 시점에서 지원되는 모든 문제의 기본 동작을 조정할 수 있습니다. 하드 코딩된 문자열이 오류로 처리되도록 하려면 다음을 추가합니다.

<issue="HardcodedText" severity="error">
</issue>

Diagnostics Configuration File

하드 코딩된 텍스트가 오류로 간주되었으므로 이제 레이아웃 편집기에서 빨간색 물결선으로 플래그가 지정됩니다.

Layout using Diagnostics Configuration

참고 항목

새 구성 파일 변경 내용을 적용하려면 현재 열려 있는 레이아웃 파일을 다시 열어야 합니다.

문제 해결

다음은 몇 가지 일반적인 문제입니다.

  • XML 형식 오류가 없는지 확인합니다.
  • 빌드 작업이 AndroidResourceAnalysisConfig로 올바르게 설정됩니다.

알려진 문제

  • 오류 패드는 파일이 처음 변경될 때까지 채워지지 않습니다.