위젯 공급자

Windows 위젯은 Windows 앱 또는 PWA(프로그레시브 웹앱)에서 제공하는 콘텐츠를 표시하는 작은 UI 컨테이너입니다. 적응형 카드 템플릿 및 데이터를 제공하거나 웹 위젯을 사용하여 URL에서 HTML을 표시할 수 있습니다. 웹 위젯은 여전히 적응형 카드 JSON 페이로드를 사용하여 콘텐츠 URL을 지정합니다.

패키지된 데스크톱 앱의 경우 위젯 호스트의 요청에 응답하고 WidgetManager를 통해 업데이트를 보내는 위젯 공급자를 구현합니다. PWA는 웹앱 매니페스트에서 위젯 정의를 사용하고 서비스 워커에서 위젯 이벤트를 처리합니다.

고유한 위젯을 만들기 위한 Windows 위젯 환경 및 디자인 지침에 대한 개요는 Windows 위젯을 참조하세요.

현재 패키지된 Win32 데스크톱 앱 또는 PWA(프로그레시브 웹앱)를 사용하여 위젯 공급자를 구현할 수 있습니다. 자세한 내용은 다음을 참조하세요.

데스크톱 위젯 공급자 API 및 기능

위젯 만들기, 삭제, 활성화, 컨텍스트 변경 및 사용자 작업을 위해 IWidgetProvider 를 구현합니다. 사용자 지정 또는 웹 콘텐츠에 대한 선택적 인터페이스를 추가할 때 기본 인터페이스는 계속 필요합니다.

Capability API 또는 지침 Availability
위젯 수명 주기 및 적응형 카드 업데이트 IWidgetProvider 및 WidgetManager Windows 앱 SDK 1.2
사용자 사용자 지정 IWidgetProvider2 및 매니페스트의 IsCustomizable 특성 Windows 앱 SDK 1.4
웹 콘텐츠, 리소스 요청 및 메시징 웹 위젯 공급자, IWidgetResourceProvider, IWidgetProviderMessage 및 WidgetManager.SendMessageToContent Windows 앱 SDK 1.6.3; 웹 위젯 호스트 및 지역 요구 사항도 확인하세요.
아직 개인 설정되지 않았거나 조치할 수 없는 콘텐츠 표시 WidgetUpdateRequestOptions.IsPlaceholderContent Windows 앱 SDK 1.6.6
위젯 분석 콜백 IWidgetProviderAnalytics Windows 위젯 보드는 Windows 11 빌드 26900부터 이러한 콜백을 지원합니다. 다른 호스트도 인터페이스를 지원해야 합니다. API 비고를 참조하세요.

SDK 버전은 설치해야 하는 릴리스가 아니라 API를 사용할 수 있게 된 시기를 나타냅니다. Windows 앱 SDK 릴리스 채널에서 현재 지원되는 안정적인 릴리스를 사용하고 대상 Windows 디바이스 및 위젯 호스트에서 사용하는 기능을 테스트합니다. 머리글 프레젠테이션 옵션은 위젯 머리글 영역 사용자 지정을 참조하세요. PWA 서비스 작업자 API는 별도의 구현 경로입니다. 이 테이블의 데스크톱 인터페이스는 여기에는 적용되지 않습니다.

위젯 호스트는 고정된 위젯의 수명과 독립적으로 사용자의 공급자를 활성화하고 해제할 수 있습니다. 공급자가 시작될 때 위젯 상태를 복원하고 IWidgetProvider 콜백이 반환된 후에는 콜백 인수 개체를 유지하지 않습니다. 자세한 내용은 IWidgetProvider 설명을 참조하세요.

전체 API 참조는 Microsoft.Windows.Widgets.Providers 네임스페이스를 참조하세요.

위젯을 만들고 위젯 공급자를 구현하는 기본 사항에 대한 연습은 Tabs 및 Spaces 에피소드 "Windows 11 위젯 만들기"를 시청하세요.

추가 리소스

  • 에 마지막으로 업데이트됨