다음을 통해 공유


VSIX 패키지 지역화

각 대상 언어에 대한 Extension.vsixlangpack 파일을 만들고 해당 파일을 올바른 폴더에 배치하여 VSIX 패키지를 지역화할 수 있습니다. 지역화된 패키지가 설치되면 확장의 지역화된 이름이 지역화된 설명과 함께 표시됩니다. 지역화된 라이선스 파일 또는 지역화된 정보를 가리키는 URL 을 제공한 경우 이들 또한 표시됩니다.

콘텐츠 추가 있는 VSPackage VSIX 패키지가 포함 되어 있는지 표시 메뉴 명령 또는 다른 UI 방법: 지역화할 메뉴 명령 새로운 UI 요소를 지역화 하는 방법에 대 한 정보.

디렉터리 구조

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

    MyExtension.dll

        Extension.vsixmanifest

        [Content_Types].xml

        es-ES

            Extension.vsixlangpack

        fr-FR

            Extension.vsixlangpack

참고

VSIX 지원 프로젝트 서식 파일에는 Visual Studio SDK VSIX 매니페스트를 생성 하 고 source.extension.vsixmanifest 이름을 지정 합니다.Visual Studio 프로젝트를 빌드할 경우이 파일의 내용을 extension.vsixmanifest로 VSIX 패키지를 복사 합니다.

Extension.vsixlangpack 파일

Extension.vsixlangpack 파일은 VSIX 언어 팩 스키마를 따릅니다. 이 스키마에는 VSIXLanguagePack 루트 요소와 LocalizedName, LocalizedDescription, MoreInfoURLLicense라는 자식 요소 네 개가 있습니다. 이러한 자식 요소에 해당는 이름, 설명, MoreInfoURL, 및 라이센스 의 자식 요소는 식별자 Extension.vsixmanifest 파일의 요소.

Vsixlangpack 파일을 만들 때 설정 합니다는 Include in Vsix 속성을 true. 그렇지 않으면 설치 지역화 된 텍스트는 무시 됩니다.

포함 Vsix 속성을 설정 하려면

  1. 솔루션 탐색기Extension.vsixlangpack 파일을 마우스 오른쪽 단추로 클릭 하 고 다음을 클릭 속성이.

  2. 속성 표에서 클릭 Vsix에 포함, 그 값을 설정 고 true.

예제

설명

다음 예제에서는 해당 Extension.vsixlangpack 파일 스페인어와 함께 하는 Extension.vsixmanifest 파일의 관련 부분을 보여 줍니다. 대상 컴퓨터의 시스템 로캘이 스페인어로 설정되어 있으면 매니페스트의 값이 해당 언어 팩의 값으로 대체됩니다.

코드

[Extension.vsixmanifest]

<?xml version="1.0" encoding="utf-8"?>
<VSIX ...>
  <Identifier ...>
    <Name>Family Tree</Name>
    <Description>This extension places a custom treeview control in the toolbox that is optimized for handling family tree information.</Description>
    <License>EULA.rtf</License>
    <MoreInfoURL>https://www.contoso.com/products/FamilyTree.htm</MoreInfoURL>
    ...
  </Identifier>
  <References .../>
  <Content .../>
</VSIX>

[Extension.vsixlangpack]

<?xml version="1.0" encoding="utf-8"?>
<VsixLanguagePack Version="1.0.0" xmlns="https://schemas.microsoft.com/developer/vsx-schema-lp/2010">
  <LocalizedName>Arbol de Familia</LocalizedName>
  <LocalizedDescription> Esta extensión pone control personalizado en la caja de herramientas por manejar información de familia.</LocalizedDescription>
  <License>es\Eula.rtf</License>
  <MoreInfoUrl> https://www.contoso.com/products/es/ArbolDeFamilia.htm</MoreInfoUrl>
</VsixLanguagePack>

참고 항목

참조

VSIXLanguagePack 요소(VSIX 언어 팩 스키마)

개념

VSIX 프로젝트 서식 파일

기타 리소스

VSIX 패키지 분석