타일 및 알림 메시지의 세계화 및 접근성(Windows 런타임 앱)

Applies to Windows and Windows Phone

이 항목에서는 지역화, 크기 조정 및 접근성을 통해 타일과 알림 메시지를 세계화하는 데 필요한 단계에 대해 설명합니다. 또한 앱 패키지의 일부이거나 로컬 저장소에 저장되는 텍스트 및 이미지를 참조하는 데 사용하는 프로토콜, 다른 언어 및 문화권의 주소, 접근성 설정, 다른 장치의 이미지 크기 조정 등과 같은 기능에 대해 알아봅니다. 앱에서 앱 리소스 플랫폼을 이미 사용하고 있다면 이러한 구조와 명명 규칙에 대해 잘 알고 있을 것입니다.

다른 언어로 된 문자열을 리소스 파일—(Resources.resjson[JavaScript] 또는 Resources.resw[C# 및 C++])에 저장하여 텍스트를 지역화할 수 있습니다.

고대비를 통해 이미지를 지역화, 크기 조정 및 액세스할 수 있습니다. 이미지를 처리하는 방법은 이미지의 원본에 따라 다릅니다.

  • 로컬 이미지. 로컬 저장소(ms-appdata:///local/)의 이미지는 이 항목에서 설명하는 리소스 플랫폼에서 처리되지 않습니다. 시스템에서 적절한 파일 버전을 선택하지 않으므로 앱 자체에서 적절한 파일 버전이 로컬 저장소에 배치되도록 해야 합니다.
  • 클라우드 이미지. 쿼리 문자열은 이미지의 URL에 추가됩니다. 다음 표는 다양한 쿼리 문자열을 보여 줍니다.

    참고  웹 서버에서 이미지를 검색하는 경우 이미지 URI(Uniform Resource Identifier) 이미지에 쿼리 문자열을 추가하려면 기본값을 재정의하고 타일 또는 알림 메시지 XML 페이로드에서 addImageQuery 특성을 "true"로 설정해야 합니다. addImageQuery 특성은 타일알림 스키마 모두의 시각, 바인딩 및 이미지 요소에 표시됩니다. 이러한 두 개 이상의 요소에서 addImageQuery가 명시적으로 설정되어 있으면 자식 요소의 값이 부모 또는 다른 상위 값을 재정의합니다. 예를 들어, 이미지 요소에 있는 addImageQuery의 "true" 값이 부모 바인딩 요소에 있는 addImageQuery의 "false"를 재정의합니다.

    유형쿼리 문자열가능한 값예제
    배율ms-scale
    • 80(시작 화면 전용)
    • 100
    • 140
    • 180
    ?ms-scale=100
    접근성ms-contrast
    • standard
    • black
    • white
    ?ms-contrast=standard
    지역화ms-lang알림 템플릿의 lang 특성에 지정된 BCP-47 언어 태그이거나 lang이 생략된 경우 기본 앱 언어입니다.?ms-lang=en-US

     

세계화 및 접근성을 위한 앱 패키지 구성 방법

참고  이 항목에 표시되는 구조와 명명 규칙은 세계화를 위한 유일한 파일 이름 지정 및 구성 체계입니다. 이 항목에 설명한 대로 파일 이름 장식(예: "scale-140")을 사용하거나 적절한 이름의 폴더에 파일을 정렬하거나, 두 가지 방법을 함께 사용할 수 있습니다.

  • 텍스트
    • "문자열" 폴더를 만듭니다. 이 컨테이너는 옵션 항목이나 사용할 경우 더 나은 구성이 가능합니다.
    • "문자열" 폴더에서 기본 언어용 하위 폴더를 만들고 해당 BCP-47 사양(예를 들어 "en-US")으로 명명합니다. 해당 하위 폴더에서 기본 언어용 문자열이 포함된 Resources.resjson 파일(JavaScript의 경우) 또는 Resources.resw 파일(C# 및 C++의 경우)을 추가합니다. 예를 들어 다음과 같습니다.
      
      /ProjectFolder
          /strings
              /en-US
                  resources.resjson
      
    • 지역화: 지원되는 비기본 언어 각각에 대해 또 다른 폴더를 추가하고 해당 BCP-47 사양으로 명명합니다. 해당 언어로 지역화된 문자열이 포함된 Resources.resjson 또는 Resources.resw 파일을 각 폴더에 지정합니다. 예를 들어 다음과 같습니다.
      
      /ProjectFolder
          /strings
              /en-US
                  resources.resjson
              /fr-FR
                  resources.resjson
              /ja-JP
                  resources.resjson
      
  • 이미지

    참고  앱 패키지(ms-appx)에 있는 이미지에만 적용되고 로컬 저장소(ms-appdata:///local/)에 있는 이미지에는 적용되지 않습니다.

    • "이미지" 폴더를 만듭니다. 이 폴더의 루트에 직접 기본 언어용 이미지를 추가하고 해당 BCP-47 사양으로 명명합니다.
    • 지역화: "이미지" 폴더 내에서 지원되는 비기본 언어 각각에 대해 폴더를 만들고 해당 BCP-47 사양으로 각각 명명합니다. 다음에 표시된 것처럼 각 언어의 이미지를 각각의 해당 폴더에 추가합니다.
      
      /ProjectFolder
          /images
              welcome.png
              /fr-FR
                  welcome.png
              /ja-JP
                  welcome.png
      

      참고  다른 언어의 해당 이미지 파일은 모두 파일 이름이 동일해야 합니다.

    • 접근성: 기본 언어를 비롯한 각각의 언어별 폴더에서 지원되는 각 대비 설정에 대해 폴더를 만듭니다. 이러한 폴더 각각에 해당 대비 설정에 관한 이미지 파일을 지정합니다. 아직까지 파일은 모두 파일 이름이 동일합니다.
      
      /ProjectFolder
          /images
              welcome.png
              /contrast-black
                  welcome.png
              /contrast-white
                  welcome.png
              /fr-FR
                  welcome.png
                  /contrast-black
                      welcome.png
                  /contrast-white
                      welcome.png
              /ja-JP
                  welcome.png
                  /contrast-black
                      welcome.png
                  /contrast-white
                      welcome.png
      
    • 크기 조정: 위에 설명된 각각의 이미지는 해당 파일 이름을 적절한 크기 식별자로 데코레이트하여 크기별 변형으로 제공되어야 합니다. 이러한 장식은 앱 리소스 플랫폼에서 파일 이름의 일부로 인식되지 않으므로 이러한 파일 모두가 계속 동일한 이름을 갖게 됩니다. 다음 예는 en-US 및 ja-JP 언어 리소스의 이미지 구조를 나타냅니다. 두 언어 모두에서 크기 및 대비 값마다 하나의 이미지를 사용할 수 있습니다.
      
      /ProjectFolder
          /images
              welcome.scale-80.png
              welcome.scale-100.png
              welcome.scale-140.png
          
              /contrast-black
                  welcome.scale-80.png
                  welcome.scale-100.png
                  welcome.scale-140.png
              /contrast-white
                  welcome.scale-80.png
                  welcome.scale-100.png
                  welcome.scale-140.png
              /ja-JP
                  welcome.scale-80.png
                  welcome.scale-100.png
                  welcome.scale-140.png
              
                  /contrast-black
                      welcome.scale-80.png
                      welcome.scale-100.png
                      welcome.scale-140.png
                  /contrast-white
                      welcome.scale-80.png
                      welcome.scale-100.png
                      welcome.scale-140.png
      

자세한 내용은 아래 항목을 참조하세요.

알림에서 지역화된 이미지 및 텍스트를 사용하는 방법

이 섹션에서는 Windows에서 장치 설정을 기반으로 적절한 버전을 선택할 수 있도록 알림에서 세계화된 리소스를 참조하는 방법에 대해 설명합니다.

텍스트

템플릿 콘텐츠의 text 요소에서 텍스트 본문에 "ms-resource:" 접두사를 사용하고 Resources.resjson 또는 Resources.resw 파일에 정의된 문자열 태그를 그 뒤에 사용합니다. 예를 들어 다음과 같은 항목을 포함하는 \fr-FR\Resources.resjson 파일이 있다고 가정합니다.

"greeting" : "Bonjour",

템플릿 XML 콘텐츠의 <text id="1">ms-resource:greeting</text> 요소는 UI 언어가 프랑스어일 경우 해당 문자열을 검색합니다.

text 요소의 본문에서 "ms-resource:" 접두사를 생략하면 리터럴 텍스트로 처리됩니다.

로컬 이미지

앱 패키지에 포함된 이미지

템플릿의 image 요소에서 리소스 경로에 "ms-appx:///" 접두사를 추가합니다. 예를 들면 다음과 같습니다.


<image id="1" src="ms-appx:///images/welcome.png"/>

이미지가 앱 패키지에 포함되어 있는 경우 Windows에서는 파일 구조 및/또는 파일 이름 장식을 통해 정확한 이미지를 식별합니다. 따라서 템플릿에 세계화된 이미지 리소스를 제공할 경우 파일 이름만 제공하세요.

  • 올바름: <image id="1" src="ms-appx:///images/welcome.png"/>
  • 잘못됨: <image id="1" src="ms-appx:///images/welcome.scale-100.png"/>
  • 잘못됨: <image id="1" src="ms-appx:///images/contrast-black/welcome.scale-100.png"/>

로컬 저장소에 저장된 이미지

로컬 저장소(Windows.Storage.ApplicationData.current.localFolder)를 기준으로 파일 경로에 "ms-appdata:///local/" 접두사를 추가합니다. 저장소 구조를 기반으로 하는 Windows에서는 로컬 저장소의 이미지 버전을 앱 리소스 플랫폼에 있는 것으로 인식할 수 없습니다.


<image id="1" src="ms-appdata:///local/welcome.png"/>

로밍 또는 임시 폴더에 저장된 이미지

이 이미지는 사용할 수 없습니다.

웹 이미지

HTTP 처리기를 사용하여 쿼리 문자열에서 언어, 배율, 대비 및 사용 가능한 값을 검사합니다.

관련 항목

앱 세계화
앱 이미지 선택
타일에 접근성 구현
응용 프로그램 리소스 및 지역화 샘플(영문)
타일 XML 스키마
알림 XML 스키마
타일 및 타일 알림 개요
빠른 시작: Microsoft Visual Studio 매니페스트 편집기를 사용하여 기본 타일 만들기
빠른 시작: 알림 보내기
타일 템플릿 카탈로그
알림 템플릿 카탈로그
타일 및 배지에 대한 지침 및 검사 목록
알림에 대한 지침 및 검사 목록

 

 

표시:
© 2014 Microsoft