앱 위젯은 구성할 수 있습니다. 예를 들어 시계 위젯을 사용하면 사용자가 표시할 시간대를 구성할 수 있습니다.
사용자가 위젯의 설정을 구성하도록 하려면 위젯 구성 Activity을 만드세요.
구성 활동 선언
매니페스트에서 구성 Activity를 선언하고 제공자 XML 메타데이터 내에서 연결하는 것은 뷰 기반 앱 위젯과 글랜스 기반 앱 위젯 모두에서 동일합니다.
구성 활동을 선언하는 방법을 알아보려면 Glance 구성 문서의 Compose 우선 구성 활동 선언 섹션을 참고하세요.
구성 활동 구현
구성 활동은 플랫폼 런처에서 호출하는 표준 구성요소이므로 기본 수명 주기 콜백은 시스템의 반환 값 규칙을 따라야 합니다.
구성 활동을 구현하는 방법을 알아보려면 Glance 문서의 Compose 우선 구성 활동 구현 섹션을 확인하세요.
구성 활동에서 위젯 업데이트
기존의 뷰 기반 위젯에서는 AppWidgetManager와 RemoteViews 레이아웃 인스턴스를 사용하여 구성이 완료되면 위젯을 업데이트합니다.
기존 뷰 기반 위젯을 빌드하고 RemoteViews 레이아웃을 업데이트해야 하는 경우 GitHub의 기존 뷰 업데이트 샘플 코드를 참고하세요. 최신 Compose 우선 위젯의 경우 Glance 문서의 구성 활동에서 업데이트 섹션을 참고하세요.
위젯 구성 옵션
위젯 동작 (예: 나중에 재구성 허용 또는 초기 구성 설정 단계 완전히 건너뛰기)은 표준 Android 12 플래그를 사용하여 메타데이터 속성 내에 등록됩니다.
동적 위젯 옵션을 활용하는 방법을 알아보려면 Glance 구성 문서의 Compose 우선 위젯 구성 옵션 섹션을 참고하세요.
사용자가 배치된 위젯을 재구성할 수 있도록 함
맞춤 재구성 가능 설정 트리거를 추가하는 방법을 알아보려면 Glance 문서의 Compose 우선 사용자가 배치된 위젯을 재구성할 수 있도록 함 섹션을 참고하세요.
위젯의 기본 구성 사용
기본적으로 구성 설정을 건너뛰는 방법을 알아보려면 Glance 문서의 Compose 우선 위젯의 기본 구성 사용 섹션을 참고하세요.