Share via

VSIX 패키지 지역화

  • 아티클

각 대상 언어에 대한 Extension.vsixlangpack 파일을 만든 다음, 올바른 폴더에 넣어 VSIX 패키지를 지역화하는 방법을 알아봅니다. 지역화된 패키지가 설치되면 지역화된 설명과 함께 확장의 지역화된 이름이 표시됩니다. 지역화된 라이선스 파일 또는 지역화된 정보를 가리키는 URL을 제공하면 해당 파일도 표시됩니다.

VSIX 패키지 콘텐츠에 메뉴 명령 또는 기타 UI를 추가하는 VSPackage가 포함된 경우 새 UI 요소 지역화에 대한 정보는 메뉴 명령 지역화를 참조하세요.

디렉터리 구조

사용자가 확장을 설치하면 확장 및 업데이트가 대상 컴퓨터의 Visual Studio 로캘과 이름이 일치하는 폴더에 대해 VSIX 패키지의 최상위 수준을 확인합니다. 확장 및 업데이트가 폴더에서 .vsixlangpack 파일을 찾으면 해당 파일의 지역화된 값을 .vsixmanifest 파일의 해당 값으로 대체합니다. 이러한 값은 확장이 설치될 때 표시됩니다. 다음 예제에서는 스페인어(es-ES) 및 프랑스어(fr-FR)로 지역화된 VSIX 패키지의 디렉터리 구조를 보여 줍니다.

.
├── MyExtension.dll
├── Extension.vsixmanifest
├── [Content_Types].xml
├── es-ES
│   └── Extension.vsixlangpack
└── fr-FR
    └── Extension.vsixlangpack

참고 항목

Visual Studio SDK에서 VSIX 지원 프로젝트 템플릿은 VSIX 매니페스트를 생성하고 이름을 source.extension.vsixmanifest로 지정합니다. Visual Studio는 프로젝트를 빌드할 때 해당 파일의 콘텐츠를 VSIX 패키지의 Extension.VsixManifest에 복사합니다.

Extension.vsixlangpack 파일

Extension.vsixlangpack 파일은 VSIX 언어 팩 스키마 2.0을 따릅니다. 이 스키마에는 바로 뒤에 Metadata 자식 요소가 오는 PackageLanguagePackManifest가 있습니다. 메타데이터 요소는 최대 6개의 자식 요소인 DisplayName, Description, MoreInfoLicenseReleaseNotes및 Icon를 포함할 수 있습니다. 이러한 자식 요소는 Extension.vsixmanifest 파일 Metadata 요소의 DisplayName, Description, MoreInfo, License, ReleaseNotes 및 Icon 자식 요소에 해당합니다.

vsixlangpack 파일을 만드는 경우 Include in Vsix 속성을 true로 설정해야 합니다. 설정하지 않으면 지역화된 설치 텍스트가 무시됩니다.

Include in Vsix 속성을 설정하려면

  1. 솔루션 탐색기에서 Extension.vsixlangpack 파일을 마우스 오른쪽 단추로 클릭한 다음, 속성을 클릭합니다.

  2. 속성 표에서 Include in Vsix를 클릭하고 해당 값을 true로 설정합니다.

예제

설명

다음 예제에서는 Extension.vsixmanifest 파일의 관련 부분을 보여 줍니다. 이 파일에는 스페인어용 해당 Extension.vsixlangpack 파일도 포함되어 있습니다. 대상 컴퓨터의 Visual Studio 로캘이 스페인어로 설정된 경우 언어 팩의 값이 매니페스트의 값을 대체합니다.

코드

  • [Extension.vsixmanifest]
<?xml version="1.0" encoding="utf-8"?>
<PackageManifest ...>
  <Metadata ...>
    <DisplayName>Family Tree</DisplayName>
    <Description>This extension places a custom treeview control in the toolbox that is optimized for handling family tree information.</Description>
    <MoreInfo>http://www.contoso.com/products/FamilyTree.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
  <Installation .../>
  <Dependencies .../>
  <Prerequisites .../>
  <Assets .../>
</PackageManifest>
  • [Extension.vsixlangpack]
<?xml version="1.0" encoding="utf-8"?>
<PackageLanguagePackManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011">
  <Metadata>
    <DisplayName>Arbol de Familia</DisplayName>
    <Description> Esta extensión pone control personalizado en la caja de herramientas por manejar información de familia.</Description>
    <MoreInfo> http://www.contoso.com/products/es/ArbolDeFamilia.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
</PackageLanguagePackManifest>

참고 항목

제목 설명
VSIX 언어 팩 스키마 2.0 참조 VSIX 언어 팩은 .vsix 배포 파일의 지역화 정보를 설명합니다.
VSIX 패키지 분석 vsix 패키지의 구조 및 내용을 설명합니다.
메뉴 명령 지역화 확장에서 다른 텍스트 리소스를 지역화하는 방법을 보여 줍니다.