Apple Developer Documentation

홈 화면, 오늘 보기 또는 알림 센터에 앱 콘텐츠를 표시하도록 확장 프로그램을 추가하고 구성한다.

Overview

• 위젯은 관련성 있고 한 눈에 볼 수 있는 콘텐츠를 표시하므로 사용자가 앱에 빠르게 액세스하여 자세한 내용을 확인할 수 있다.
• 앱은 사용자가 가장 중요한 정보에 집중할 수 있도록 다양한 위젯을 제공할 수 있다.
• 동일한 위젯의 여러 복사본을 추가하고 각각의 고유한 요구 사항과 레이아웃에 맞게 조정할 수 있다.
• 위젯에 사용자 정의 의도를 포함하면 사용자가 각 위젯을 개별적으로 개인화할 수도 있다.
• 위젯은 다양한 크기를 지원합니다. 앱 콘텐츠에 가장 적합한 크기를 선택하라.
• 공간이 제한되어 있으므로 위젯이 사람들이 가장 중요하게 여기는 정보를 표시해야 한다.

앱에 위젯을 추가하려면 최소한의 설정과 사용자 인터페이스의 구성 및 스타일에 대한 몇 가지 결정이 필요하다. 위젯은 SwiftUI 보기를 사용하여 콘텐츠를 표시한다. 자세한 내용은 SwiftUI를 참조.

Add a Widget Target to Your App

위젯 확장 템플릿은 위젯 생성을 위한 시작점을 제공한다. 단일 위젯 확장에는 여러 위젯이 포함될 수 있다. 예를 들어, 스포츠 앱에는 팀 정보를 표시하는 위젯과 경기 일정을 표시하는 위젯이 있을 수 있다. 단일 위젯 확장에는 두 위젯이 모두 포함될 수 있다.

1. Open your app project in Xcode and choose File > New > Target.
2. From the Application Extension group, select Widget Extension, and then click Next.
3. Enter the name of your extension.
4. If the widget provides user-configurable properties, check the Include Configuration Intent checkbox.
5. Click Finish.

앱에 여러 확장이 포함될 수 있지만 일반적으로 모든 위젯을 단일 위젯 확장에 포함한다. 예를 들어, 일부 위젯이 위치 정보를 사용하고 다른 위젯이 사용하지 않는 경우 위치 정보를 사용하는 위젯을 별도의 확장 프로그램에 보관하라. 이를 통해 시스템은 사용자에게 위치 정보를 사용하는 확장의 위젯에 대해서만 위치 정보를 사용하도록 권한을 부여하도록 프롬프트를 표시할 수 있다.