2005년 11월 18일
Visual Studio Express Edition을 열고 새 프로젝트를 만들면 템플릿 목록이 나타납니다. 하지만 늘 사용하는 유형의 프로젝트가 이 목록에 없으면 어떻게 할까요? 가장 유사한 프로젝트를 시작하여 매번 코드를 직접 추가하게 될 것입니다. 아니면 필요한 사항이 모두 포함된 프로젝트를 가져와 템플릿으로 변환한 다음 친구 및 동료와 공유할 수도 있을 것입니다. 이 기사에서는 프로젝트 템플릿을 직접 만드는 데 필요한 절차를 단계별로 살펴보겠습니다.
필자가 http://www.ircomm.net/(영문)의 기사를 작성할 때 항상 사용하는 프로젝트는 관리되는 DirectX 템플릿입니다. 대개 모든 프로젝트의 코드는 상당 부분이 동일하거나 유사합니다. Microsoft DirectX SDK (영문)에는 좋은 시작 지점으로 활용할 수 있는 프로젝트가 있지만 Visual Studio 템플릿으로 제공되지는 않습니다. 이 기사에서는 Microsoft DirectX SDK의 EmptyProject 샘플을 사용하여 Visual Studio 템플릿을 만든 다음, 이 템플릿을 관리되는 DirectX 응용 프로그램을 위한 시작 지점으로 사용하겠습니다.
이 기사에 소개된 내용은 Visual Studio 2005 또는 Express Edition을 사용하여 모든 유형의 응용 프로그램 템플릿을 만드는 데 사용할 수 있습니다.
프로젝트 파일 설치
먼저, 새 Windows Forms 응용 프로그램을 만들고 "DirectXApplication"으로 이름을 지정한 후 기본 프로젝트로 저장합니다.
저장되었으면 "Form1.cs" 및 "Program.cs" 파일은 응용 프로그램에 필요 없으므로 제거합니다.
다음 단계에서는 응용 프로그램에 사용되는 폴더 구조를 설정합니다. 솔루션 탐색기에서 "DirectXApplication"이라는 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 추가 > 새 폴더를 선택합니다. 두 개의 폴더를 추가하고 각각 "Common" 및 "Media"로 이름을 지정합니다. "Media" 폴더 내에 또 다른 두 개의 폴더를 추가한 다음 각각 "SharedFx" 및 "UI"로 이름을 지정합니다.
프로젝트 참조 추가
모든 관리되는 DirectX 응용 프로그램에서는 프로젝트에 올바른 참조가 추가되었는지 확인해야 합니다. 기본 응용 프로그램의 경우 DirectX에 대한 표준 참조가 추가되었는지 확인해야 합니다. 이러한 표준 참조는 다음과 같습니다.
참조를 추가하려면 솔루션 탐색기의 참조 섹션을 마우스 오른쪽 단추로 클릭하고 메뉴에서 "참조 추가"를 선택합니다. 대화 상자가 나타나면 아래로 스크롤하여 위에 나열된 참조를 강조 표시한 다음 확인을 클릭합니다.
참조 섹션은 위의 그림과 같은 모양이어야 합니다.
샘플 프레임워크를 사용하는 경우 프로젝트가 "안전하지 않은 코드 허용"으로 설정되어 있는지 확인해야 합니다. 솔루션 탐색기에서 "DirectXApplication" 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 그런 다음 속성 페이지의 빌드 탭으로 가서 "안전하지 않은 코드 허용" 옵션이 선택되어 있는지 확인합니다.
Common Framework 설치
이제 폴더 구조가 완성되었으니 Microsoft DirectX SDK의 Common Framework를 추가할 차례입니다. 솔루션 탐색기에서 "Common" 폴더를 마우스 오른쪽 단추로 클릭하고 추가 > 기존 항목을 선택한 다음, SDK의 샘플 디렉터리 위치(일반적으로 "C:\Program Files\Microsoft DirectX 9.0 SDK (October 2005)\Samples\Managed\Common")로 이동하여 dxmut*.cs 파일을 모두 추가합니다. assembly.cs 파일이나 w로 시작하는 파일은 .NET Framework 2.0용이므로 추가할 필요가 없습니다.
다음에 추가할 파일 집합은 Common Framework에서 GUI 시스템을 표시하는 데 사용되는 미디어 파일입니다. 솔루션 탐색기에서 "UI" 디렉터리를 강조 표시하고 "C:\Program Files\Microsoft DirectX 9.0 SDK (October 2005)\Samples\Media\UI" 디렉터리에서 이들 파일을 모두 추가합니다.
마지막으로 필요한 파일 집합은 주 프로그램 파일입니다. SDL의 EmptyProject 샘플(C:\Program Files\Microsoft DirectX 9.0 SDK (October 2005)\Samples\Managed\Direct3D\EmptyProject)로 이동하여 EmptyProject.cs와 EmptyProject.fx를 추가합니다.
응용 프로그램에 콘텐츠 파일 포함
새 SDK에 포함된 새로운 기능 중 하나는 콘텐츠 파일을 응용 프로그램의 출력 디렉터리에 복사하는 기능입니다. 이 기능을 사용하도록 설정하면 컴파일러가 솔루션에 있는 것과 동일한 디렉터리 구조를 출력 디렉터리에 만듭니다. 콘텐츠 파일과 관련하여 선택할 수 있는 복사 옵션은 다음과 같습니다.
- "복사 안 함": 파일이 출력 디렉터리에 복사되지 않습니다. 배포 시에는 사용하지 않고 개발 중에만 사용할 참조 문서를 응용 프로그램에 추가하고자 할 때 이 옵션을 선택합니다.
- "항상 복사": 응용 프로그램을 빌드할 때마다 파일이 출력 디렉터리에 복사됩니다.
- "변경된 내용만 복사": 파일이 출력 디렉터리에 있는 것보다 최신 버전인 경우에만 출력 디렉터리에 복사됩니다. 파일이 없으면 새 파일이 만들어집니다. 대부분의 콘텐츠 파일에 이 옵션을 사용하면 VS에서 파일을 전송할 필요가 없으므로 컴파일에 걸리는 시간이 줄어듭니다.
현재 프로젝트에서는 콘텐츠 파일이 출력 디렉터리의 파일보다 최신 버전일 때마다 복사되도록 해야 합니다. 이렇게 하려면 솔루션 탐색기로 가서 아래 그림에서처럼 해당 파일을 강조 표시합니다.
그런 다음 속성 창(보이지 않는 경우 F4를 누름)에서 "출력 디렉터리로 복사"를 "변경된 내용만 복사"로 변경합니다.
응용 프로그램을 저장한 다음 템플릿을 만들기 전에 실행하여 테스트합니다.
응용 프로그램을 템플릿 파일로 변환
이 기사의 주요 논점이기도 한 다음 단계에서는 프로젝트를 템플릿으로 변환합니다. Visual Studio 2005 및 Express 시스템에서는 기본 제공되는 기능과 마법사를 사용하여 이 작업을 바로 수행할 수 있습니다.
먼저 응용 프로그램이 저장되었는지 확인하고, 저장되었으면 파일 메뉴에서 "템플릿 내보내기"를 선택합니다.
이렇게 하면 템플릿 내보내기 마법사가 열립니다.
주 대화 상자에서 "프로젝트 템플릿" 및 "항목 템플릿"이라는 두 가지 유형의 템플릿이 선택 항목으로 표시됩니다. 프로젝트 템플릿은 전체 프로젝트에서 템플릿을 만들지만, "항목 템플릿"은 프로젝트의 특정 항목에서 템플릿을 만듭니다. 항목 템플릿은 시작 폼 또는 구성 클래스 같이 여러 프로젝트에 사용하는 Windows Form 또는 클래스 파일에 사용됩니다.
"프로젝트 템플릿" 옵션을 선택한 다음 템플릿 이름을 입력합니다. 여기서는 이름을 "DirectXApplication"으로 유지하겠습니다. "다음"을 눌러 계속합니다.
응용 프로그램 템플릿에 대해 이해하기 쉬운 이름과 설명을 입력합니다. 이 이름과 설명은 새 응응 프로그램에서 템플릿을 선택할 때 사용하는 프로젝트 선택 대화 상자에 나타납니다. 응용 프로그램 아이콘은 응용 프로그램을 잘 나타내는 것이어야 하므로, 찾아보기 단추를 선택하고 SDK 및 Common Framework가 처음 만들어진 디렉터리(C:\Program Files\Microsoft DirectX 9.0 SDK (October 2005)\Samples\Managed\Common)로 이동한 다음, 모든 파일을 표시하도록 선택 항목을 변경하고 DirectX 아이콘을 선택합니다.
템플릿 테스트
템플릿 응용 프로그램이 완성되었으니 이제 시스템이 올바르게 작동하는지 테스트를 통해 확인해야 합니다. 응용 프로그램 템플릿을 테스트하려면 현재 솔루션을 닫고 새 솔루션을 만듭니다. 그러면 다음과 같은 대화 상자가 나타납니다.
"DirectXApplication" 템플릿(또는 지정한 다른 이름)을 선택합니다. 응용 프로그램 이름을 원하는 새 프로젝트 이름(여기서는 "GameEngine"으로 선택함)으로 변경한 다음 확인을 눌러 계속합니다. Visual Studio IDE에서 임시 공간에 프로젝트를 만들어 필요한 모든 파일을 설치합니다. 이와 동시에 해당 응용 프로그램의 루트 네임스페이스를 포함하여 "DirectXApplication"에 대한 모든 참조가 "GameEngine"으로 자동 변경됩니다. 마지막으로 수행해야 할 단계는 응용 프로그램을 저장하는 것입니다. 이렇게 하면 프로젝트가 디스크에 저장되어 사용할 준비를 마치게 됩니다.
리소스 및 링크
Glenn Wilson은 오스트레일리아의 전자 통신 및 모바일 전자 통신 업계에서 약 7년간 경력을 쌓은 시스템/데이터베이스 관리자입니다. 그는 7년 동안 주로 Microsoft 기술을 연구해 왔습니다. 여가 시간에는 디지털 미디어와 게임 프로그래밍을 즐기는 것은 물론, Windows Forms, 웹 응용 프로그램 및 Microsoft의 Small Business Server 시스템을 포함한 다양한 도구를 사용하여 솔루션을 개발하기도 합니다. Glenn은 커뮤니티 웹 사이트(http://www.ircomm.net/ (영문))를 열어 관리되는 DirectX 및 게임 프로그래밍 관련 리소스를 중점적으로 소개하고 있습니다.
페이지 맨 위로
이 기사의 코드
인쇄용 버전
기사에 대한 논의 (영문)