레이어 다이어그램에 대해 코드 유효성 검사

코드 디자인과 충돌 하지 않는지 확인 하려면 Visual Studio Ultimate 및 Visual Studio Premium에서 레이어 다이어그램을 코드를 확인할 수 있습니다.이렇게 하면 도움이 됩니다.

  • 레이어 다이어그램에 코드에서 종속성 및 종속성 간의 충돌을 찾습니다.

  • 제안된 변경 내용의 영향을 받을 수 있는 종속성을 찾습니다.

    예를 들어 레이어 다이어그램을 편집하여 잠재적인 아키텍처 변경을 나타낸 다음, 코드의 유효성을 검사하여 영향을 받는 종속성을 확인할 수 있습니다.

  • 코드를 다른 디자인으로 리팩터링 또는 마이그레이션합니다.

    코드 또는 코드를 다른 아키텍처로 이동할 때 작업을 해야 하는 종속성을 찾습니다.

명령 프롬프트 또는 Visual Studio 열려 있는 레이어 다이어그램에서 수동으로 코드 유효성을 검사할 수 있습니다.코드가 자동으로 로컬 빌드 또는 Team Foundation Build를 실행할 때 확인할 수도 있습니다.볼 채널 9 비디오: 디자인 아키텍처 레이어 다이어그램을 사용 하 여 유효성을 검사 하 고.

요구 사항

  • Visual Studio Ultimate 또는 Visual Studio Premium

  • 레이어 다이어그램은 모델링 프로젝트에 있는 솔루션입니다.이 레이어 다이어그램의 유효성을 검사 하려는 Visual C#.NET 또는 Visual Basic.NET 프로젝트 아티팩트에 연결 되어야 합니다.자세한 내용은 코드에서 레이어 다이어그램 만들기를 참조하십시오.

To

  • 항목에서 유효성 검사를 지원 하는지 확인

  • 다른.NET 어셈블리 및 프로젝트에 대한 유효성 검사를 포함 합니다.

  • 수동으로 코드 유효성을 검사합니다

  • 코드를 자동으로 확인 합니다.

  • 레이어 유효성 검사 문제 해결

  • 이해 하 고 레이어 유효성 검사 오류를 해결 합니다.

항목에서 유효성 검사를 지원 하는지 확인

  1. 레이어 다이어그램에서 하나 이상의 레이어를 선택, 선택 항목을 마우스 오른쪽 단추로 클릭 하 고 누른 다음 링크 보기.

  2. 레이어 탐색기에서 유효성 검사 지원 열을 검토합니다.항목의 값이 false 이면 유효성 검사를 지원 하지 않습니다.

웹 사이트에서 Office 문서를 연결할 수 있습니다 및 일반 텍스트 파일에 레이어를 있지만 유효성 검사 프로세스에 포함 되지 않습니다.유효성 검사 오류는 해당 레이어 간에 종속성을 표시 하는 경우 별도 레이어에 연결 된 어셈블리 또는 프로젝트에 대한 참조에 나타나지 않습니다.이러한 참조는 코드에서 사용하지 않는 한 종속성으로 처리되지 않습니다.

다른.NET 어셈블리 및 프로젝트에 대한 유효성 검사를 포함 합니다.

레이어 다이어그램으로 항목을 끌어 오면 해당.NET 어셈블리 또는 프로젝트에 대한 참조가 자동으로 추가 되는 레이어 참조 모델링 프로젝트의 폴더에에서.이 폴더에는 어셈블리 및 유효성 검사 중 분석할 프로젝트에 대한 참조가 있습니다.수동으로 레이어 다이어그램으로 끌어 않고 다른.NET 어셈블리 및 프로젝트에 대한 유효성 검사를 포함할 수 있습니다.

  1. 솔루션 탐색기에서 모델링 프로젝트를 마우스 오른쪽 단추로 클릭 또는 레이어 참조 폴더를 클릭 하 고 참조 추가.

  2. 참조 추가 대화 상자에서 어셈블리 또는 프로젝트를 선택하고 확인을 클릭합니다.

수동으로 코드 유효성을 검사합니다

열려 있는 레이어 다이어그램 솔루션 항목에 연결 되어 있는 경우 실행할 수 있는 유효성 검사 다이어그램에서 단축 명령을.실행 하려면 명령 프롬프트를 사용할 수 있습니다는 msbuild 명령에 /p:ValidateArchitecture 사용자 지정 속성을 설정 True.코드를 변경할 때 레이어 유효성 검사를 정기적으로 수행 예를 들어, 초기 종속성 충돌을 catch 할 수 있도록 합니다.

열려 있는 레이어 다이어그램에서 코드 유효성을 검사하려면

  1. 다이어그램 화면을 마우스 오른쪽 단추로 클릭하고 아키텍처 유효성 검사를 클릭합니다.

    [!참고]

    기본적으로 레이어 다이어그램 파일(.layerdiagram)의 빌드 작업 속성은 유효성 검사로 설정되어 있으므로 해당 다이어그램이 유효성 검사 프로세스에 포함됩니다.

    오류 목록 창에는 발생하는 모든 오류가 보고됩니다.유효성 검사 오류에 대한 자세한 내용은 이해 하 고 레이어 유효성 검사 오류 해결.

  2. 각 오류의 소스를 보려면 오류 목록 창에서 오류 항목을 두 번 클릭합니다.

    [!참고]

    Visual Studio에서는 오류 소스 대신 종속성 그래프가 표시될 수도 있습니다.레이어 다이어그램에 지정되지 않은 어셈블리에 대한 종속성이 코드에 있거나 레이어 다이어그램에 지정된 종속성이 코드에 없는 경우 종속성 그래프가 표시됩니다.이 경우 종속성 그래프나 코드를 검토하여 종속성이 있어야 하는지 여부를 확인할 수 있습니다.종속성 그래프에 대한 자세한 내용은 종속성 그래프에서 코드 종속성 시각화을 참조하십시오.

  3. 오류를 관리 하려면 다음을 참조 하십시오 유효성 검사 오류 관리.

명령 프롬프트에서 코드 유효성을 검사 하려면

  1. Visual Studio 명령 프롬프트를 엽니다.

  2. 다음 중 하나를 선택합니다.

    • 솔루션의 특정 모델링 프로젝트를 기준으로 코드 유효성을 검사하려면 다음 사용자 지정 속성을 사용하여 MSBuild를 실행합니다.

      msbuild <FilePath+ModelProjectFileName>.modelproj /p:ValidateArchitecture=true
      

      -또는-

      모델링 프로젝트 파일(.modelproj)과 레이어 다이어그램이 포함된 폴더로 이동한 후 다음 사용자 지정 속성을 사용하여 MSBuild를 실행합니다.

      msbuild /p:ValidateArchitecture=true
      
    • 솔루션의 모든 모델링 프로젝트를 기준으로 코드 유효성을 검사하려면 다음 사용자 지정 속성을 사용하여 MSBuild를 실행합니다.

      msbuild <FilePath+SolutionName>.sln /p:ValidateArchitecture=true 
      

      -또는-

      솔루션 폴더로 이동한 후 다음 사용자 지정 속성을 사용하여 MSBuild를 실행합니다. 이 솔루션 폴더에는 레이어 다이어그램이 포함된 모델링 프로젝트가 들어 있어야 합니다.

      msbuild /p:ValidateArchitecture=true 
      

    발생하는 모든 오류가 나열됩니다.MSBuild에 대한 자세한 내용은 MSBuildMSBuild 작업을 참조하십시오.

유효성 검사 오류에 대한 자세한 내용은 이해 하 고 레이어 유효성 검사 오류 해결.

Dd409395.collapse_all(ko-kr,VS.110).gif유효성 검사 오류 관리

개발 과정에서 유효성 검사 중 보고된 충돌 문제 중 일부를 표시하지 않을 수 있습니다.예를 들어 이미 해결되었거나 특정 시나리오와 관계가 없는 오류를 표시하지 않을 수 있습니다.오류를 표시하지 않는 경우에는 Team Foundation에 작업 항목을 기록하는 것이 좋습니다.

유효성 검사 오류에 대한 작업 항목을 만들려면

  • 오류 목록 창에서 오류를 마우스 오른쪽 단추로 클릭하고 작업 항목 만들기를 가리킨 다음 만들려는 작업 항목 형식을 클릭합니다.

다음 작업을 수행하여 오류 목록 창의 유효성 검사 오류를 관리할 수 있습니다.

To

수행할 단계

선택한 오류를 유효성 검사 중에 표시 안 함

선택한 하나 이상의 오류를 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 오류 표시 안 함을 클릭합니다.

표시되지 않는 오류는 취소선 서식을 사용하여 나타납니다.다음에 유효성 검사를 실행하면 이러한 오류가 나타나지 않습니다.

표시되지 않는 오류는 해당하는 레이어 다이어그램 파일의 .suppressions 파일에서 추적됩니다.

선택한 오류 표시 안 함 중지

표시하지 않도록 선택한 하나 이상의 오류를 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 오류 표시 안 함 중지를 클릭합니다.

다음에 유효성 검사를 실행하면 표시하지 않도록 선택한 오류는 나타나지 않습니다.

오류 목록 창에서 표시되지 않는 모든 오류 복원

오류 목록 창에서 아무 곳이나 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 표시 안 한 오류 표시를 클릭합니다.

표시되지 않는 모든 오류를 오류 목록 창에서 숨기기

오류 목록 창에서 아무 곳이나 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 표시 안 한 오류 숨기기를 클릭합니다.

코드를 자동으로 확인 합니다.

로컬 빌드를 실행할 때마다 레이어 유효성 검사를 수행할 수 있습니다.팀 Team Foundation Build를 사용 하는 경우 제어 된 체크 인 사용 빌드 보고서를 사용 하 여 유효성 검사 오류를 수집 하 고 사용자 지정 MSBuild 작업을 작성 하 여 지정할 수 있습니다, 레이어 유효성 검사를 수행할 수 있습니다. 제어 된 체크 인 빌드를 만들려면를 참조 하십시오 변경 내용의 유효성을 검사하는 제어된 체크 인 빌드 프로세스 정의.

로컬 빌드 중 자동으로 코드를 확인 하려면

  • 텍스트 편집기를 사용하여 모델링 프로젝트 파일(.modelproj)을 열고 다음 속성을 포함합니다.
<ValidateArchitecture>true</ValidateArchitecture>

-또는-

  1. 솔루션 탐색기에서 하나 이상의 레이어 다이어그램이 포함된 모델링 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 클릭합니다.

  2. 속성 창에서 모델링 프로젝트의 아키텍처 유효성 검사 속성을 True로 설정합니다.

    이렇게 하면 모델링 프로젝트가 유효성 검사 프로세스에 포함됩니다.

  3. 솔루션 탐색기에서 유효성 검사에 사용할 레이어 다이어그램 파일(.layerdiagram)을 클릭합니다.

  4. 속성 창에서 다이어그램의 빌드 작업 속성이 유효성 검사로 설정되어 있는지 확인합니다.

    이렇게 하면 레이어 다이어그램이 유효성 검사 프로세스에 포함됩니다.

오류 목록 창에서 오류를 관리 하려면 참조 하십시오 유효성 검사 오류 관리.

Team Foundation Build 중 자동으로 코드를 확인 하려면

  1. 팀 탐색기에서 빌드 정의를 두 번 클릭하고 프로세스를 클릭합니다.

  2. 빌드 프로세스 매개 변수에서 컴파일을 확장하고 MSBuild 인수 매개 변수에 다음과 같이 입력합니다.

    /p:ValidateArchitecture=true

유효성 검사 오류에 대한 자세한 내용은 이해 하 고 레이어 유효성 검사 오류 해결.Team Foundation Build에 대한 자세한 내용은 다음을 참조하십시오.

레이어 유효성 검사 문제 해결

다음 표에서는 레이어 유효성 검사 문제와 해결 방법에 대해 설명합니다.이 문제는 코드와 디자인 간의 충돌로 인해 발생하는 오류와 다릅니다.이러한 오류에 대한 자세한 내용은 이해 하 고 레이어 유효성 검사 오류 해결.

문제

가능한 원인

해결

유효성 검사 오류가 예상대로 발생하지 않습니다.

같은 모델링 프로젝트에 있는 레이어 다이어그램과 솔루션 탐색기의 다른 다이어그램에서 복사한 레이어 다이어그램에 대해서는 유효성 검사가 수행되지 않습니다.이렇게 복사한 레이어 다어어그램은 원본 레이어 다이어그램과 동일한 참조를 포함합니다.

  1. 모델링 프로젝트에 새 레이어 다이어그램을 추가합니다.

  2. 소스 레이어 다이어그램에서 새 다이어그램으로 요소를 복사합니다.

이해 하 고 레이어 유효성 검사 오류 해결

레이어 다이어그램에 대해 코드 유효성을 검사할 때 코드가 디자인과 충돌 하는 경우 유효성 검사 오류가 발생 합니다.예를 들어, 다음과 같은 경우 유효성 검사 오류가 발생할 수 발생할 수 있습니다.

  • 잘못된 레이어에 아티팩트가 할당되었습니다.이 경우 아티팩트를 이동합니다.

  • 클래스 등의 아티팩트가 아키텍처에 맞지 않는 방식으로 다른 클래스를 사용합니다.이 경우 코드를 리팩터링하여 종속성을 제거합니다.

이러한 오류를 해결하려면 유효성 검사 중 더 이상 오류가 나타나지 않을 때까지 코드를 업데이트합니다.이 작업은 반복적으로 수행할 수 있습니다.

다음 섹션에서 이러한 오류를 사용 하는, 이러한 오류는 의미를 설명 및 해결 또는 관리를 수행 하는 방법을 제시 하는 구문에 설명 합니다.

구문

설명

ArtifactN(ArtifactTypeN)

ArtifactN은 레이어 다이어그램의 레이어와 연결된 아티팩트입니다.

ArtifactTypeN은 ArtifactN의 클래스 또는 메서드와 같은 형식입니다. 예를 들면 다음과 같습니다.

MySolution.MyProject.MyClass.MyMethod(메서드)

NamespaceNameN

네임스페이스의 이름입니다.

LayerNameN

레이어 다이어그램에 있는 레이어의 이름입니다.

DependencyType

Artifact1과 Artifact2 간의 종속 관계 유형입니다.예를 들어 Artifact1은 Artifact2와 호출 관계에 있습니다.

구문 오류

오류 설명

AV0001: 잘못된 종속성: Artifact1(ArtifactType1) --> Artifact2(ArtifactType2)

   레이어: LayerName1, LayerName2 | 종속성: DependencyType

LayerName1은 LayerName2에 직접적으로 종속되어 있지 않으므로 LayerName1의 Artifact1은 LayerName2의 Artifact2 에 종속되지 않아야 합니다.

AV1001: 잘못된 네임스페이스: Artifact

   레이어: LayerName | 필요한 네임스페이스: NamespaceName1 | 현재 네임스페이스: NamespaceName2

LayerName에서는 연결된 아티팩트가 NamespaceName1에 속해야 합니다.그런데 Artifact가 NamespaceName1이 아니라 NamespaceName2에 있습니다.

AV1002: 사용할 수 없는 네임스페이스 사용: Artifact1(ArtifactType1) | Artifact2(ArtifactType2)

   레이어: LayerName | 사용할 수 없는 네임스페이스: NamespaceName | 종속성: DependencyType

LayerName에서는 연결된 아티팩트가 NamespaceName을 사용하지 않아야 합니다.Artifact2는 NamespaceName에 있으므로 Artifact1이 Artifact2를 사용할 수 없습니다.

AV1003: 사용할 수 없는 네임스페이스에 있음: Artifact(ArtifactType)

   레이어: LayerName | 사용할 수 없는 네임스페이스: NamespaceName

LayerName에서는 연결된 아티팩트가 NamespaceName에 속할 수 없습니다.그런데 Artifact가 NamespaceName에 속해 있습니다.

AV3001: 없는 링크: 레이어 'LayerName'이(가) 찾을 수 없는 'Artifact'에 연결되어 있습니다.어셈블리 참조가 있는지 확인하십시오.

LayerName이 찾을 수 없는 아티팩트에 연결되어 있습니다.예를 들어 모델링 프로젝트에 클래스가 포함된 어셈블리에 대한 참조가 없어서 해당 클래스에 대한 링크가 없을 수 있습니다.

AV9001: 아키텍처 유효성 검사에서 내부 오류가 발생했습니다.결과가 불완전할 수 있습니다.자세한 내용은 상세 빌드 이벤트 로그를 참조하십시오.

빌드 이벤트 로그 또는 자세한 내용은 출력 창을 참조 하십시오.

참고 항목

개념

개발하는 동안 시스템 유효성 검사