위젯은 홈 화면 맞춤설정의 필수적인 부분입니다. 사용자의 홈 화면에서 바로 액세스할 수 있는 앱의 가장 중요한 데이터와 기능을 '한눈에' 볼 수 있는 것으로 생각하면 됩니다. 사용자는 홈 화면 패널에서 위젯을 이동할 수 있으며, 지원되는 경우 위젯의 크기를 조절하여 위젯의 정보량을 원하는 대로 조정할 수 있습니다.
이 문서에서는 만들 수 있는 다양한 유형의 위젯과 따라야 할 디자인 원칙을 소개합니다. Remote View API 및 XML 레이아웃을 사용하여 앱 위젯을 빌드하려면 기본 위젯 만들기를 참고하세요. Kotlin 및 Compose 스타일 API를 사용하여 위젯을 빌드하려면 Jetpack Glance를 참고하세요.
위젯 유형
위젯을 계획할 때 어떤 종류의 위젯을 빌드할지 생각해 보세요. 위젯은 일반적으로 다음 카테고리 중 하나에 속합니다.
정보 위젯

정보 위젯은 일반적으로 중요한 정보 요소를 표시하고 시간 경과에 따라 정보가 어떻게 변경되는지 추적합니다. 정보 위젯의 예로는 날씨 위젯, 시계 위젯, 스포츠 점수 추적 위젯이 있습니다. 정보 위젯을 탭하면 일반적으로 연결된 앱이 실행되고 위젯 정보의 세부정보 보기가 열립니다.
컬렉션 위젯
컬렉션 위젯은 갤러리 앱의 사진 모음, 뉴스 앱의 기사 모음, 커뮤니케이션 앱의 이메일 또는 메시지 모음과 같이 동일한 유형의 여러 요소를 표시하는 데 특화되어 있습니다. 컬렉션 위젯은 세로로 스크롤할 수 있습니다.
컬렉션 위젯은 일반적으로 다음 사용 사례에 중점을 둡니다.
- 컬렉션 탐색
- 연결된 앱에서 컬렉션의 요소를 세부정보 뷰로 엽니다.
- 요소와 상호작용(예: 완료로 표시) - Android 12(API 수준 31)에서 복합 버튼 지원
관리 위젯

컨트롤 위젯의 주된 목적은 자주 사용하는 기능을 표시하여 사용자가 앱을 열지 않고도 홈 화면에서 기능을 트리거할 수 있도록 하는 것입니다. 앱의 리모컨이라고 생각하면 됩니다. 컨트롤 위젯의 예로는 사용자가 집안의 조명을 켜거나 끌 수 있는 홈 컨트롤 위젯이 있습니다.
컨트롤 위젯과 상호작용하면 앱에서 연결된 세부정보 뷰가 열릴 수 있습니다. 이는 검색 위젯의 경우와 같이 컨트롤 위젯의 기능이 데이터를 출력하는지 여부에 따라 다릅니다.
하이브리드 위젯

일부 위젯은 이전 섹션의 유형(정보, 컬렉션 또는 컨트롤) 중 하나를 나타내지만, 많은 위젯은 다양한 유형의 요소를 결합하는 하이브리드입니다. 예를 들어 음악 플레이어 위젯은 주로 제어 위젯이지만 정보 위젯과 같이 현재 재생 중인 트랙을 사용자에게 표시하기도 합니다.
위젯을 계획할 때는 기본 유형 중 하나를 중심으로 설계하고 필요에 따라 다른 유형의 요소를 추가합니다.
Google 어시스턴트와 위젯 통합
모든 유형의 위젯은 사용자 음성 명령에 대한 응답으로 Google 어시스턴트에 의해 표시될 수 있습니다. 앱 작업을 처리하도록 위젯을 구성하여 사용자가 Android 및 Android Auto와 같은 어시스턴트 표시 경로에서 빠른 답변과 대화형 앱 환경을 이용할 수 있도록 할 수 있습니다. 어시스턴트의 위젯 처리에 관한 자세한 내용은 Android 위젯과 앱 작업 통합을 참고하세요.
위젯 제한사항
위젯은 '미니 앱'으로 이해할 수 있지만 위젯을 디자인하기 전에 이해해야 하는 특정 제한사항이 있습니다.
동작
위젯은 홈 화면에 있으므로 홈 화면에 설정된 탐색과 공존해야 합니다. 이로 인해 전체 화면 앱과 비교하여 위젯에서 사용할 수 있는 동작 지원이 제한됩니다. 앱에서는 사용자가 화면 간에 가로로 이동할 수 있지만, 홈 화면에서는 홈 화면 간에 이동하기 위해 이 동작이 이미 사용되고 있습니다.
위젯에 사용할 수 있는 동작은 터치와 세로 스와이프뿐입니다.
요소
위젯에 사용할 수 있는 동작에는 제한이 있으므로 제한된 동작을 사용하는 일부 UI 구성요소는 위젯에 사용할 수 없습니다. 지원되는 구성요소의 전체 목록과 레이아웃 제한사항에 관한 자세한 내용은 위젯 레이아웃 만들기 및 유연한 위젯 레이아웃 제공을 참고하세요.
디자인 가이드라인
다음 디자인 가이드라인에 따라 홈 화면에서 매력적이고 유연하며 일관된 위젯 환경을 만드세요.
위젯 콘텐츠
위젯은 앱에서 사용할 수 있는 새롭고 흥미로운 콘텐츠를 '광고'하여 사용자를 앱으로 유도하는 좋은 방법입니다.
신문 첫 페이지의 티저와 마찬가지로 위젯은 앱의 정보를 통합하고 집중시키며 앱 내에서 더 풍부한 세부정보를 제공합니다. 위젯은 정보 '간식'이고 앱은 '식사'라고 할 수 있습니다. 앱이 위젯에 표시되는 것보다 정보 항목에 관한 세부정보를 더 많이 표시하는지 확인합니다.
위젯 탐색
순수한 정보 콘텐츠 외에도 위젯이 앱의 자주 사용하는 영역으로 연결되는 탐색 링크를 제공하도록 하는 것이 좋습니다. 이렇게 하면 사용자가 작업을 더 빠르게 완료할 수 있고 앱의 기능적 범위가 홈 화면으로 확장됩니다.
위젯의 탐색 링크에 적합한 후보는 다음과 같습니다.
생성 함수: 사용자가 새 문서나 새 메시지를 만드는 등 앱의 새 콘텐츠를 만들 수 있는 함수입니다.
최상위 수준에서 앱 열기: 정보 요소를 탭하면 일반적으로 사용자가 하위 수준 세부정보 화면으로 이동합니다. 애플리케이션의 최상위 수준에 대한 액세스를 제공하면 탐색 유연성이 향상되고 사용자가 홈 화면에서 앱으로 이동하는 데 사용하는 전용 앱 바로가기를 대체할 수 있습니다. 이 기능에 애플리케이션 아이콘을 사용하면 표시하는 데이터가 모호한 경우 위젯에 명확한 ID를 제공할 수도 있습니다.
위젯 크기 조절

크기 조절 가능한 위젯을 길게 터치한 후 손을 떼면 위젯이 크기 조절 모드로 전환됩니다. 사용자는 드래그 핸들이나 위젯 모서리를 사용하여 원하는 크기를 설정할 수 있습니다.
크기 조절을 통해 사용자는 홈 화면 배치 그리드의 제약 조건 내에서 위젯의 높이와 너비를 조정할 수 있습니다. 위젯의 크기를 자유롭게 조절할 수 있는지 아니면 가로 또는 세로 크기 변경으로 제한할지 결정할 수 있습니다. 위젯이 본질적으로 고정 크기인 경우 크기 조절을 지원할 필요가 없습니다.
사용자가 위젯의 크기를 조절할 수 있도록 하면 다음과 같은 중요한 이점이 있습니다.
- 사용자가 각 위젯에 표시할 정보의 양을 미세하게 조정할 수 있습니다.
- 홈 패널에서 위젯과 바로가기의 레이아웃에 더 큰 영향을 미칠 수 있습니다.
만들려는 위젯 유형에 따라 위젯의 크기 조절 전략을 계획합니다. 목록 또는 그리드 기반 컬렉션 위젯은 위젯 크기를 조절하면 세로 스크롤 영역이 확장되거나 축소되므로 일반적으로 간단합니다. 위젯 크기와 관계없이 사용자는 모든 정보 요소를 스크롤하여 볼 수 있습니다.
정보 위젯은 스크롤할 수 없고 모든 콘텐츠가 지정된 크기에 맞아야 하므로 더 정확한 계획이 필요합니다. 사용자가 크기 조절 작업을 통해 정의하는 크기에 맞게 위젯의 콘텐츠와 레이아웃을 동적으로 조정해야 합니다.
다음 예에서 사용자는 날씨 위젯의 크기를 3단계로 조절할 수 있으며, 위젯이 커질수록 현재 위치의 날씨에 관한 더 풍부한 정보를 표시할 수 있습니다.



각 위젯 크기에 따라 표시되는 앱 정보의 양을 결정합니다. 크기가 작은 경우 필수 정보에 집중한 다음 위젯이 가로 및 세로로 커짐에 따라 문맥 정보를 추가합니다.
레이아웃 고려사항
개발에 사용하는 기기의 배치 그리드 크기에 따라 위젯을 배치하고 싶을 수 있습니다. 이는 유용한 초기 근사치일 수 있지만 다음 사항에 유의하세요.
- 가변 그리드 크기가 아닌 '크기 버킷' 전반에서 위젯 크기 조절 전략을 계획하면 가장 안정적인 결과를 얻을 수 있습니다.
- 셀의 수, 크기, 간격은 기기마다 크게 다를 수 있습니다. 따라서 위젯은 유연해야 하며 예상보다 많거나 적은 공간을 수용할 수 있어야 합니다.
- 사용자가 위젯의 크기를 조절하면 시스템은 위젯이 자체적으로 다시 그릴 수 있는 dp 크기 범위로 응답합니다.
- Android 12부터는 더 세분화된 크기 속성과 더 유연한 레이아웃을 제공할 수 있습니다. 여기에는 다음이 포함됩니다.
- 위젯 크기 제약 조건 지정 예를 들어 위젯의 타겟 크기(그리드 셀 단위)와 가능한 최대 크기를 지정할 수 있습니다.
- 위젯 크기에 따라 변경되는 반응형 레이아웃 제공
- 정확한 크기 레이아웃을 제공하여 런처가 휴대전화의 세로 모드 및 가로 모드 크기 옵션 또는 폴더블의 네 가지 크기로 응답할 수 있습니다.
- 업데이트된 가이드 및 새 API를 사용하여 위젯의 적절한 크기를 결정합니다.
사용자의 위젯 구성
위젯이 유용해지려면 사용자가 위젯을 설정해야 하는 경우도 있습니다. 받은편지함을 표시하기 전에 사용자가 메일 폴더를 선택해야 하는 이메일 위젯이나 표시할 갤러리의 사진을 사용자가 할당해야 하는 정적 사진 위젯을 생각해 보세요. Android 위젯은 사용자가 홈 화면에 위젯을 드롭한 직후에 구성 선택사항을 표시합니다.
위젯 디자인 체크리스트
- 위젯에서 한눈에 파악할 수 있는 정보의 작은 부분에 초점을 맞춥니다. 앱의 정보를 확장합니다.
- 용도에 적합한 위젯 유형을 선택합니다.
- 위젯의 콘텐츠가 다양한 크기에 맞게 조정되는 방식을 계획합니다.
- 레이아웃을 늘리거나 줄일 수 있도록 하여 위젯 레이아웃이 방향 및 기기와 독립적으로 작동하도록 합니다.
- 위젯에 추가 구성이 필요한지 고려합니다.