DSL의 MSI 및 VSIX 배포

아티클
06/19/2023

도메인 특정 언어를 사용자의 컴퓨터 또는 다른 컴퓨터에 설치할 수 있습니다. Visual Studio가 대상 컴퓨터에 이미 설치되어 있어야 합니다.

VSIX 및 MSI 배포 중에서 선택

도메인 특정 언어를 배포하는 방법에는 다음 두 가지가 있습니다.

메서드	이점
VSX(Visual Studio 확장)	매우 쉬운 배포: DslPackage 프로젝트에서 .vsix 파일을 복사하고 실행합니다. 자세한 내용은 VSX를 사용하여 DSL 설치 및 제거를 참조하세요.
MSI(설치 관리자 파일)	- 사용자가 DSL 파일을 두 번 클릭하여 Visual Studio를 열 수 있습니다. - 대상 컴퓨터에서 아이콘과 DSL 파일 형식을 연결합니다. - XSD(XML 스키마)를 DSL 파일 형식과 연결합니다. 이렇게 하면 Visual Studio에 파일이 로드될 때 경고를 피할 수 있습니다. MSI를 만들려면 솔루션에 설치 프로젝트를 추가해야 합니다. 자세한 내용은 MSI 파일을 사용하여 DSL 배포를 참조하세요.

메서드

이점

VSX(Visual Studio 확장)

매우 쉬운 배포: DslPackage 프로젝트에서 .vsix 파일을 복사하고 실행합니다.

자세한 내용은 VSX를 사용하여 DSL 설치 및 제거를 참조하세요.

MSI(설치 관리자 파일)

- 사용자가 DSL 파일을 두 번 클릭하여 Visual Studio를 열 수 있습니다.
- 대상 컴퓨터에서 아이콘과 DSL 파일 형식을 연결합니다.
- XSD(XML 스키마)를 DSL 파일 형식과 연결합니다. 이렇게 하면 Visual Studio에 파일이 로드될 때 경고를 피할 수 있습니다.

MSI를 만들려면 솔루션에 설치 프로젝트를 추가해야 합니다.

자세한 내용은 MSI 파일을 사용하여 DSL 배포를 참조하세요.

VSX를 사용하여 DSL 설치 및 제거

이 방법으로 DSL을 설치하는 경우 사용자는 Visual Studio 내에서 DSL 파일을 열 수 있지만 Windows 탐색기에서 파일을 열 수는 없습니다.

VSX를 사용하여 DSL을 설치하려면

DSL 패키지 프로젝트에서 빌드된 .vsix 파일을 찾습니다.
1. 솔루션 탐색기에서 DslPackage 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 파일 탐색기에서 폴더 열기를 클릭합니다.
2. binYourProject.DslPackage.vsix 파일을 찾습니다.
DSL을 설치할 대상 컴퓨터에 .vsix 파일을 복사합니다. 이 컴퓨터는 사용 중인 컴퓨터이거나 다른 컴퓨터일 수 있습니다.
- 대상 컴퓨터에는 런타임에 DSL을 지원하는 Visual Studio 버전 중 하나가 있어야 합니다. 자세한 내용은 시각화 및 모델링 SDK에서 지원되는 Visual Studio 버전을 참조하세요.
- 대상 컴퓨터에 DslPackage\source.extensions.manifest에 지정된 Visual Studio 버전 중 하나가 있어야 합니다.
대상 컴퓨터에서 .vsix 파일을 두 번 클릭합니다.

Visual Studio 확장 설치 관리자 에서 확장을 열고 설치합니다.
Visual Studio를 시작하거나 다시 시작합니다.
DSL을 테스트하려면 Visual Studio를 사용하여 DSL에 대해 정의한 확장명이 있는 새 파일을 만듭니다.

VSX를 사용하여 설치된 DSL을 제거하려면

도구 메뉴 모음에서 확장 및 업데이트를 선택합니다.
설치된 확장을 확장합니다.
DSL이 정의된 확장을 선택하고 제거를 클릭합니다.

드물게 결함이 있는 확장은 로드되지 않고 오류 창에 보고서를 생성하지만 확장 관리자에 나타나지 않습니다. 이 경우 다음 위치에서 파일을 삭제하여 확장을 제거할 수 있습니다.

LocalAppData \Microsoft\VisualStudio\10.0\Extensions

MSI에서 DSL 배포

DSL에 대한 MSI(Windows Installer) 파일을 정의하여 사용자가 Windows 탐색기에서 DSL 파일을 열도록 허용할 수 있습니다. 아이콘 및 간단한 설명을 파일 이름 확장명에 연결할 수도 있습니다. 또한 MSI는 DSL 파일의 유효성을 검사하는 데 사용할 수 있는 XSD를 설치할 수 있습니다. 원할 경우 동시에 설치할 다른 구성 요소를 MSI에 추가할 수 있습니다.

MSI 파일 및 기타 배포 옵션에 대한 자세한 내용은 애플리케이션, 서비스 및 구성 요소 배포를 참조하세요.

MSI를 빌드하려면 설치 프로젝트를 Visual Studio 솔루션에 추가합니다. 설치 프로젝트를 만드는 가장 쉬운 방법은 VMSDK 사이트에서 다운로드할 수 있는 CreateMsiSetupProject.tt 템플릿을 사용하는 것입니다.

MSI에서 DSL을 배포하려면

확장 매니페스트에서 InstalledByMsi를 설정합니다. 이렇게 하면 MSI를 사용하지 않고서는 VSX를 설치 및 제거할 수 없습니다. 이는 MSI에 다른 구성 요소를 포함하는 경우에 중요합니다.
1. DslPackage\source.extension.tt 열기
2. 다음 코드 줄을 <SupportedProducts> 앞에 삽입합니다.
```
<InstalledByMsi>true</InstalledByMsi>
```
Windows 탐색기에서 DSL을 나타내는 아이콘을 만들거나 편집합니다. 예를 들어 DslPackage\Resources\File.ico를 편집합니다.
DSL의 다음 특성이 올바른지 확인합니다.
- DSL 탐색기에서 루트 노드를 클릭하고 속성 창에서 다음을 검토합니다.
  - 설명
  - 버전
- 편집기 노드를 클릭하고 속성 창에서 아이콘을 클릭합니다. DslPackage\Resources의 아이콘 파일(예:File.ico)을 참조하도록 값을 설정합니다.
- 빌드 메뉴에서 구성 관리자를 열고 빌드하려는 구성(예: 릴리스 또는 디버그)을 선택합니다.
시각화 및 모델링 SDK 홈 페이지로 이동하여 다운로드 탭에서 CreateMsiSetupProject.tt를 다운로드합니다.
CreateMsiSetupProject.tt를 Dsl 프로젝트에 추가합니다.

Visual Studio가 CreateMsiSetupProject.vdproj라는 파일을 만듭니다.
Windows 탐색기에서 Dsl\*.vdproj를 Setup이라는 새 폴더에 복사합니다.

(원하는 경우 이제 Dsl 프로젝트에서 CreateMsiSetupProject.tt를 제외할 수 있습니다.)
솔루션 탐색기에서 Setup\*.vdproj를 기존 프로젝트로 추가합니다.
프로젝트 메뉴에서 프로젝트 종속성을 클릭합니다.

프로젝트 종속성 대화 상자에서 설치 프로젝트를 선택합니다.

DslPackage 옆의 상자를 선택합니다.
솔루션을 다시 빌드합니다.
Windows 탐색기에서 설치 프로젝트의 기본 MSI 파일을 찾습니다.

DSL을 설치하려는 컴퓨터에 MSI 파일을 복사합니다. MSI 파일을 두 번 클릭합니다. 설치 관리자를 실행합니다.
대상 컴퓨터에서 DSL의 파일 확장명으로 새 파일을 만듭니다. 다음을 확인합니다.
- Windows 탐색기 목록 보기에서 파일이 사용자가 정의한 아이콘 및 설명과 함께 표시됩니다.
- 파일을 두 번 클릭하면 Visual Studio가 시작되고 DSL 편집기에서 DSL 파일이 열립니다.
원하는 경우 텍스트 템플릿을 사용하는 대신 수동으로 설치 프로젝트를 만들 수 있습니다. 이 절차를 포함하는 연습은 시각화 및 모델링 SDK 랩의 5장을 참조하세요.

MSI에서 설치된 DSL을 제거하려면

Windows에서 프로그램 및 기능 제어판을 엽니다.
DSL을 제거합니다.
Visual Studio를 다시 시작합니다.

다음을 통해 공유