위젯 선택과 통합

현재 릴리스에서 유일한 위젯 호스트는 Windows 11에 기본 제공된 위젯 보드입니다. 위젯 보드는 위젯을 표시하고 보드에서 위젯의 레이아웃을 관리합니다. 또한 사용자가 보드에 표시되는 사용 가능한 위젯을 선택할 수 있는 위젯 선택기를 제공합니다. 이 문서에서는 위젯이 위젯 선택기에 성공적으로 통합되는 데 필요한 자산을 설명합니다.

위젯 스크린샷 이미지

각 위젯은 위젯에 포커스가 있을 때 위젯 선택기에서 미리 보기로 표시되는 스크린샷 이미지를 제공해야 합니다. 스크린샷은 앱에 대한 패키지 매니페스트의 위젯 공급자에 의해 지정됩니다. 위젯 스크린샷에 사용할 이미지 파일을 지정하는 방법에 대한 기술 정보는 win32 앱에서 위젯 공급자를 구현하고 위젯 공급자 패키지 매니페스트 XML 형식으로 위젯 공급자 구현을 참조하세요.

다음 스크린샷은 위젯 선택기 내에서 스크린샷 이미지의 배치를 보여 줍니다.

스크린샷 이미지 요구 사항

일관된 사용자 환경을 제공하려면 위젯 선택기의 위젯 스크린샷이 다음 지침을 따르십시오.

• 스크린샷은 중간 크기의 위젯 버전을 표시해야 합니다.
• 이미지는 너비 300픽셀, 높이 304픽셀이어야 합니다.
• 이미지에는 투명하고 둥근 모서리가 있어야 합니다.

위젯 공급자 매니페스트에는 설정할 수 있는 세 가지 스크린샷 요소가 포함되어 있습니다. 최상위 스크린샷은 필수이며 위젯 선택기에서 기본값으로 사용됩니다. 매니페스트의 LightMode 및 DarkMode 섹션은 선택 사항이며 밝은 모드와 어두운 모드에서 위젯에 대한 별도의 스크린샷을 지정할 수 있습니다. 이러한 선택적 스크린샷 중 하나 또는 둘 다를 제공하는 경우 위젯 선택기는 디바이스의 현재 테마와 일치하는 스크린샷을 사용합니다. 현재 테마에 대해 특별히 이미지를 제공하지 않으면 위젯 선택기에서 기본 최상위 스크린샷을 대신 사용합니다.

여러 로캘에 대한 위젯 스크린샷을 제공할 수 있습니다. 각 스크린샷 로캘은 앱 패키지를 기준으로 자산에 대한 경로로 지정됩니다.

• 이미지 자산에 대한 패키징 프로젝트에 디렉터리를 만듭니다. 예: '자산'.
• 언어 중립적이거나 대체 자산의 경우 이 폴더에 직접 배치할 수 있습니다. 예: 'Assets/Screenshot.png'
• 언어별 자산은 적용되는 로캘의 이름을 따서 명명된 하위 디렉터리에 배치할 수 있습니다. 예:
  • '영어(미국)' 자산은 'en-us'라는 하위 디렉터리에 배치되어야 합니다. 'Assets/en-us/Screenshot.png'
  • '프랑스어(프랑스)' 자산은 'fr-fr'이라는 하위 디렉터리에 배치되어야 합니다. 'Assets/fr-fr/Screenshot.png'
• ms-appx: URI 체계를 사용하여 appxmanifest에서 이러한 이미지를 참조합니다. 예: 스크린샷='ms-appx:Assets\Screenshot.png'
• 특정 로캘에 대한 이미지를 포함하지 않으면 루트 디렉터리의 대체 이미지가 사용됩니다.

리소스 로더는 표시할 언어에 적합한 자산을 자동 선택합니다. 자세한 정보는 배율, 테마, 고대비 등에 맞춘 이미지 및 자산 로드를 참조하세요.

다음은 위젯 스크린샷 이미지의 예를 보여줍니다.