위젯은 사용자의 홈 화면을 맞춤설정하는 데 중요한 구성요소입니다. 카드는 사용자가 탭 한 번으로 앱의 중요한 사용자 여정을 달성하거나 앱의 가장 중요한 데이터를 빠르게 요약하는 데 도움이 될 수 있습니다. 사용자의 요구사항에 맞게 맞춤설정하고 개인의 선호도에 맞게 조정할 수도 있습니다.
위젯의 품질은 앱 콘텐츠 및 기능에 대한 사용자의 참여에 영향을 줄 수 있습니다. 위젯 품질에는 세 가지 주요 등급이 있습니다.
- Tier 3: 품질이 낮음 - 최소 품질 기준을 충족하지 않고 우수한 사용자 환경을 제공하지 않습니다.
- Tier 2: 품질 표준 - 유용하고 사용 가능하며 우수한 환경을 제공합니다.
- Tier 1: Differentiated(차별화됨)는 맞춤설정된 히어로 환경을 제공하는 대표적인 위젯으로, 사용자가 고유하고 생산적인 홈 화면을 만들도록 도와줍니다.
Tier 3: 품질이 낮음
표준 레이아웃, 색상, 탐색, 콘텐츠 기준을 충족하지 않는 위젯은 품질이 낮은 것으로 간주됩니다. 권장사항에 따라 고품질 위젯을 빌드하는 방법에 관한 자세한 내용은 다음 가이드라인을 참고하세요.
Tier 2 - 품질 표준
우수한 품질로 간주되려면 위젯이 다음과 같은 레이아웃, 색상, 검색, 콘텐츠 기준을 모두 충족합니다.
레이아웃
- 위젯은 홈 화면에 드롭될 때 런처 그리드에서 설정한 경계를 채워야 합니다. 위젯 크기는 2x2, 4x2 (런처 그리드 셀) 중 하나 이상으로 조절할 수 있습니다.
자세한 내용은 크기 가이드라인을 참고하세요.
- 위젯은 세로 또는 가로 축의 다른 홈 화면 요소에 올바르게 정렬되어야 하며 불필요한 공간을 차지해서는 안 됩니다.
- 위젯이 그리드의 서로 마주보는 두 개 이상의 가장자리에 닿아야 합니다. 즉, 위젯은 직사각형일 필요가 없습니다. 도형의 가장자리가 그리드의 두 가장자리 이상과 닿는 한 맞춤 도형을 사용할 수 있습니다.
- 크기를 조절할 수 있는 경우 위젯에는 적절한 최소 또는 최대 크기가 있어야 하며, 이는 AppWidgetProviderInfo XML에서
minWidth,minHeight,maxResizeWidth,maxResizeHeight로 설정할 수 있습니다.- 위젯 크기를 조절해도 빈 공간만 추가되는 경우 최대 크기를 설정해야 합니다.
- 최소 크기는 위젯이 여전히 값을 제공하고 터치 영역 요구사항 (48x48)을 충족하는 최소 크기를 기준으로 설정해야 합니다.
권장사항
금지사항
색상
- 위젯 텍스트 및 아이콘 버튼은 접근성 요구사항을 충족하기에 충분한 대비율을 가져야 합니다(썸네일 및 이미지 제외).
권장사항
금지사항
탐색
위젯 선택 도구에 정확한 위젯 미리보기가 있어야 합니다. 이는 AppWidgetProviderInfo XML에서
previewImage및previewLayout로 설정하거나 생성된 미리보기로 설정할 수 있습니다.- 위젯 미리보기는 홈 화면에 추가할 때 제공되는 기능과 일관되게 표시됩니다.
동영상 1: 미리보기가 부정확한 위젯
콘텐츠
- 위젯 콘텐츠는 지속적으로 오래되거나 시의적절하지 않아야 합니다.
- 사용자가 위젯에서 작업을 완료한 후 위젯이 업데이트되어야 합니다.
- 사용자가 앱 내에서 관련 작업을 완료하면 위젯이 업데이트되어야 함
- 데이터가 UI보다 자주 새로고침될 것으로 예상되는 경우 위젯에서 사용자가 콘텐츠를 수동으로 새로고침할 수 있어야 합니다.
- 위젯 UI가 작동해야 하며 그렇지 않으면 콘텐츠가 잘립니다.
- 위젯 0 및 빈 상태는 의도된 것이어야 하며, 위젯은 설치되었지만 사용자가 아직 로그인하지 않은 경우 위젯의 값을 표시하거나 클릭 유도 문구를 제공해야 합니다.
Tier 1 - 차별화된
가장 좋은 위젯은 모든 Tier 2 기준과 다음과 같은 레이아웃, 색상, 탐색, 시스템 일관성 기준을 모두 충족합니다.
레이아웃
- 위젯이 경계를 채우고 세로 또는 가로 축의 다른 홈 화면 요소에 올바르게 정렬되며 불필요한 공간을 차지하지 않습니다.
- 모든 도형은 그리드 경계의 네 가장자리에 모두 맞아야 합니다(MUST).
권장사항
금지사항
위젯이 기본 크기를 지원함
- 위젯 크기는 2x2, 4x2 중 하나 이상으로 조절할 수 있습니다.
위젯 헤더가 일관되게 사용되고 적용됨
- 다음의 경우 헤더를 사용하는 것이 좋습니다.
- 검색과 같은 특정 앱 기능에 딥 링크를 제공하려고 합니다.
- 탭 시 앱으로 돌아가는 일관된 링크 역할을 하는 앱 브랜딩 아이콘을 적용하려고 합니다.
- 위젯에 스크롤 콘텐츠 (목록, 그리드 등)가 있음
- 헤더 콘텐츠가 유용한 맥락을 제공합니다 (할 일 목록의 이름).
- 다음과 같은 경우 헤더가 선택사항입니다.
- 위젯이 전체 크기 이미지임 (사진)
- 공간이 제한적임(높이 2줄 미만)
- 헤더 콘텐츠가 중복된 경우
- 헤더를 사용하는 경우 다음 사양을 준수하세요.
- 아이콘, 제목, 작업
- 아이콘이 항상 표시됨
- 공간이 충분하면 제목이 표시됨
- 위젯 컨텍스트에 기반한 작업
- 높이 48dp, 패딩 14dp
- 아이콘, 제목, 작업
- 다음의 경우 헤더를 사용하는 것이 좋습니다.
권장사항
금지사항
색상
- 위젯은 시스템 테마 설정, 콘텐츠 색상 또는 브랜드 색상을 기반으로 색상 팔레트를 지원합니다.
- 위젯은 밝은 모드 및 어두운 모드 팔레트를 지원합니다.
- 동적 색상은 기기 컨텍스트 테마 설정의 한 가지 예입니다.
- 로컬 색상 추출은 앱 콘텐츠 기반 테마 설정의 한 가지 예입니다.
- 시맨틱 색상은 앱 콘텐츠 기반 테마 설정의 한 가지 예입니다.
탐색
- 미리보기에 사용자 콘텐츠가 포함되거나 시스템 테마가 적용됩니다 (생성된 미리보기 API 또는 AppWidgetProviderInfo XML의
previewLayout).
- 위젯에는 사용자가 위젯의 값을 이해하는 데 도움이 되는 이름이나 설명이 있습니다.
- 이름은 50자(영문 기준) 미만이어야 합니다.
- 이름과 설명은 앱 내에서 고유합니다. 예를 들어 앱에는 같은 이름의 위젯이 여러 개 있을 수 없습니다.
권장사항
금지사항
시스템 일관성
- 직사각형 위젯은 시스템에서 제공하는 모서리 반경을 사용해야 합니다(OEM별).
권장사항
금지사항
- 진행률 표시기(테마 색상 또는 상응하는 브랜드 표시가 있는
initialLayout내)와 함께 로드 상태를 표시합니다.
- 맞춤 위젯 설정 진입점 대신 시스템 구성을 사용합니다.
- 앱에서 위젯으로 진입/종료할 때 시스템 실행 전환을 사용합니다.
위젯을 만들 때 이 가이드에 제공된 도움말을 기억하세요. 최상의 품질과 우수한 사용자 환경을 제공하려고 합니다. 표준 레이아웃으로 많은 품질 막대를 충족할 수 있습니다. 품질 표시줄에 관해 자세히 알아보려면 디자이너는 Android 위젯 템플릿을, 개발자는 플랫폼 샘플의 레이아웃 코드 샘플 및 레이아웃 개발자 가이드를 참고하세요.