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

아티클
06/10/2015

코드가 디자인과 충돌하지 않는지 확인하기 위해 Visual Studio 및 Visual Studio Premium에서 레이어 다이어그램을 사용하여 코드의 유효성을 검사할 수 있습니다. 이 경우 다음에 도움이 됩니다.

코드의 종속성과 레이어 다이어그램의 종속성 사이의 충돌을 찾을 수 있습니다.
제안된 변경 내용의 영향을 받을 수 있는 종속성을 찾습니다.

예를 들어 레이어 다이어그램을 편집하여 잠재적인 아키텍처 변경을 나타낸 다음, 코드의 유효성을 검사하여 영향을 받는 종속성을 확인할 수 있습니다.
코드를 다른 디자인으로 리팩터링 또는 마이그레이션합니다.

코드를 다른 아키텍처로 이동할 때 아직 작업이 필요한 코드 또는 종속성을 찾을 수 있습니다.

Visual Studio의 열린 레이어 다이어그램 또는 명령 프롬프트에서 코드 유효성 검사를 수동으로 수행할 수 있습니다. 또한 로컬 빌드 또는 Team Foundation Build를 실행할 때 자동으로 코드 유효성 검사를 실행할 수도 있습니다. Channel 9 비디오: 레이어 다이어그램을 사용하여 아키텍처 디자인 및 유효성 검사를 참조하세요.

중요

Team Foundation Build를 사용하여 레이어 유효성 검사를 실행하려면 빌드 서버에 Visual Studio Ultimate을 설치해야 합니다.

요구 사항

Visual Studio Ultimate 또는 Visual Studio Premium
Team Foundation Build를 사용하여 자동으로 코드의 유효성을 검사하는 Team Foundation Build 서버의 Visual Studio Ultimate
레이어 다이어그램을 사용하는 모델링 프로젝트가 포함된 솔루션 이 레이어 다이어그램은 유효성 검사를 하려는 Visual C# .NET 또는 Visual Basic .NET 프로젝트의 아티팩트에 연결해야 합니다. 코드에서 레이어 다이어그램 만들기을 참조하십시오.

항목에서 유효성 검사를 지원하는지 확인
유효성 검사에 다른.NET 어셈블리 및 프로젝트 포함
수동으로 코드 유효성 검사
자동으로 코드 유효성 검사
레이어 유효성 검사 문제 해결
레이어 유효성 검사 오류 이해 및 해결

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

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

레이어 다이어그램에서 하나 이상의 레이어를 선택하고 선택한 레이어를 마우스 오른쪽 단추로 클릭한 다음 링크 보기를 클릭합니다.
레이어 탐색기에서 유효성 검사 지원 열을 검토합니다. 값이 false일 경우 해당 항목은 유효성 검사를 지원하지 않습니다.

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

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

솔루션 탐색기에서 모델링 프로젝트 또는 레이어 참조 폴더를 마우스 오른쪽 단추로 클릭한 다음 참조 추가를 클릭합니다.
참조 추가 대화 상자에서 어셈블리 또는 프로젝트를 선택하고 확인을 클릭합니다.

수동으로 코드 유효성 검사

솔루션 항목에 연결된 레이어 다이어그램이 열린 상태에서는 다이어그램에서 유효성 검사 바로 가기 명령을 실행할 수 있습니다. 또한 명령 프롬프트를 사용하여 /p:ValidateArchitecture 사용자 지정 속성이 True로 설정된 msbuild 명령을 실행할 수 있습니다. 예를 들어, 코드를 변경할 때 종속성 충돌을 빠르게 찾을 수 있도록 레이어 유효성 검사를 정기적으로 수행합니다.

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

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

참고

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

오류 목록 창에는 발생하는 모든 오류가 보고됩니다. 유효성 검사 오류에 대한 자세한 내용은 레이어 유효성 검사 오류 이해 및 해결을 참조하십시오.
각 오류의 소스를 보려면 오류 목록 창에서 오류 항목을 두 번 클릭합니다.

참고

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

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

Visual Studio 명령 프롬프트를 엽니다.
다음 중 하나를 선택합니다.
- 솔루션의 특정 모델링 프로젝트를 기준으로 코드 유효성을 검사하려면 다음 사용자 지정 속성을 사용하여 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에 대한 자세한 내용은 MSBuild 및 MSBuild 작업을 참조하십시오.

유효성 검사 오류에 대한 자세한 내용은 레이어 유효성 검사 오류 이해 및 해결을 참조하십시오.

유효성 검사 오류 관리

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

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

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

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

후	수행할 단계
선택한 오류를 유효성 검사 중에 표시 안 함	선택한 하나 이상의 오류를 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 오류 표시 안 함을 클릭합니다. 표시되지 않는 오류는 취소선 서식을 사용하여 나타납니다. 다음에 유효성 검사를 실행하면 이러한 오류가 나타나지 않습니다. 표시되지 않는 오류는 해당하는 레이어 다이어그램 파일의 .suppressions 파일에서 추적됩니다.
선택한 오류 표시 안 함 중지	표시하지 않도록 선택한 하나 이상의 오류를 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 오류 표시 안 함 중지를 클릭합니다. 다음에 유효성 검사를 실행하면 표시하지 않도록 선택한 오류는 나타나지 않습니다.
오류 목록 창에서 표시되지 않는 모든 오류 복원	오류 목록 창에서 아무 곳이나 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 표시 안 한 오류 표시를 클릭합니다.
표시되지 않는 모든 오류를 오류 목록 창에서 숨기기	오류 목록 창에서 아무 곳이나 마우스 오른쪽 단추로 클릭하고 유효성 검사 오류 관리를 가리킨 다음, 표시 안 한 오류 숨기기를 클릭합니다.

자동으로 코드 유효성 검사

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

로컬 빌드 중 자동으로 코드의 유효성을 검사하려면

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

<ValidateArchitecture>true</ValidateArchitecture>

또는

솔루션 탐색기에서 하나 이상의 레이어 다이어그램이 포함된 모델링 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 클릭합니다.
속성 창에서 모델링 프로젝트의 아키텍처 유효성 검사 속성을 True로 설정합니다.

이렇게 하면 모델링 프로젝트가 유효성 검사 프로세스에 포함됩니다.
솔루션 탐색기에서 유효성 검사에 사용할 레이어 다이어그램 파일(.layerdiagram)을 클릭합니다.
속성 창에서 다이어그램의 빌드 작업 속성이 유효성 검사로 설정되어 있는지 확인합니다.

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

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

Team Foundation Build 중 자동으로 코드의 유효성을 검사하려면

팀 탐색기에서 빌드 정의를 두 번 클릭하고 프로세스를 클릭합니다.
빌드 프로세스 매개 변수에서 컴파일을 확장하고 MSBuild 인수 매개 변수에 다음과 같이 입력합니다.

/p:ValidateArchitecture=true

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

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

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

문제	가능한 원인	해결 방법
유효성 검사 오류가 예상대로 발생하지 않습니다.	같은 모델링 프로젝트에 있는 레이어 다이어그램과 솔루션 탐색기의 다른 다이어그램에서 복사한 레이어 다이어그램에 대해서는 유효성 검사가 수행되지 않습니다. 이렇게 복사한 레이어 다어어그램은 원본 레이어 다이어그램과 동일한 참조를 포함합니다.	모델링 프로젝트에 새 레이어 다이어그램을 추가합니다. 소스 레이어 다이어그램에서 새 다이어그램으로 요소를 복사합니다.

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

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

잘못된 레이어에 아티팩트가 할당되었습니다. 이 경우 아티팩트를 이동합니다.
클래스 등의 아티팩트가 아키텍처에 맞지 않는 방식으로 다른 클래스를 사용합니다. 이 경우 코드를 리팩터링하여 종속성을 제거합니다.

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

다음 섹션에서는 이러한 오류에 사용되는 구문과 이러한 오류의 의미를 설명하고 오류의 해결 및 관리 방법을 제안합니다.

구문	설명
ArtifactN(ArtifactTypeN)	ArtifactN은 레이어 다이어그램의 레이어와 연결된 아티팩트입니다. ArtifactTypeN은 클래스 또는 메서드와 같은 ArtifactN의 형식입니다. 예를 들면 다음과 같습니다. MySolution.MyProject.MyClass.MyMethod(메서드)
NamespaceNameN	네임스페이스의 이름입니다.
LayerNameN	레이어 다이어그램에 있는 레이어의 이름입니다.
DependencyType	Artifact1과 Artifact2 사이의 종속 관계 유형입니다. 예를 들어, Artifact1은 Artifact2와 Calls 관계입니다.

오류 구문	오류 설명
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: 링크 누락: 찾을 수 없는 'Artifact'에 대한 레이어 'LayerName' 링크 어셈블리 참조가 있는지 확인하십시오.	아티팩트에 연결된 LayerName 링크를 찾을 수 없습니다. 예를 들어 모델링 프로젝트에 클래스가 포함된 어셈블리에 대한 참조가 없어서 해당 클래스에 대한 링크가 없을 수 있습니다.
AV9001: 아키텍처 유효성 검사에서 내부 오류가 발생했습니다. 결과가 불완전할 수 있습니다. 자세한 내용은 상세 빌드 이벤트 로그를 참조하십시오.	자세한 내용은 빌드 이벤트 로그 또는 출력 창을 참조하십시오.

참고 항목

개념

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

다음을 통해 공유