위젯 품질

위젯은 사용자의 홈 화면을 맞춤설정하는 데 중요한 구성요소입니다. 사용자는 위젯을 사용하여 한 번의 탭으로 앱의 중요한 사용자 여정을 달성하거나 중요한 업데이트의 빠른 요약을 확인할 수 있습니다. 사용자는 위젯을 맞춤설정하여 개인 환경설정에 맞게 조정할 수도 있습니다.

위젯 호환성 체크리스트

위젯 품질은 앱 콘텐츠 및 기능에 대한 사용자 참여에 영향을 미칩니다. 호환성 체크리스트는 위젯의 품질을 평가하는 데 도움이 되는 기준을 정의합니다. 등급은 다음과 같습니다.

Tier 3 저품질 아이콘

등급 3 - 품질이 낮음

이러한 위젯은 최소 품질 기준을 충족하지 못하며 열악한 사용자 환경을 제공합니다. 위젯이 표준 레이아웃, 색상, 검색, 콘텐츠 기준을 충족하지 않으면 품질이 낮은 것으로 간주됩니다.

Tier 2 스탠더드 아이콘

등급 2 - 스탠더드

이러한 위젯은 유용하고 사용 가능하며 우수한 환경을 제공합니다.표준으로 간주되려면 위젯이 다음 레이아웃, 색상, 검색, 콘텐츠 기준을 모두 충족해야 합니다.

Tier 1 차별화 아이콘

등급 1 - 차별화

이러한 위젯은 맞춤설정된 히어로 환경을 제공하고 사용자가 고유하고 생산적인 홈 화면을 만들 수 있도록 지원하는 모범적인 위젯입니다.


Tier 3 저품질 아이콘

등급 3

품질이 낮은 위젯의 특징

위젯이 다음 중 하나에 해당하는 경우 품질이 낮은 것으로 간주됩니다.

카테고리 ID 설명
레이아웃 WL-1

사용자가 호스트 표시 경로에 위젯을 배치할 때 위젯이 호스트 그리드의 경계를 채우지 않습니다.

WL-1.1

위젯이 그리드의 반대쪽 가장자리 2개 이상에 닿지 않습니다. 즉, 위젯이 모두 직사각형일 필요는 없으며, 도형의 가장자리가 그리드의 가장자리 중 2개 이상에 닿는 한 맞춤 도형을 가질 수 있습니다.

색상 WC-3

위젯 텍스트 및 아이콘 버튼의 색상 대비율이 접근성 요구사항을 충족하기에 충분하지 않습니다.

탐색 WD-4.2

위젯 이름이 위젯 디자인에 포함되지 않습니다.

WD-4.3

위젯에 미리보기 이미지가 없습니다.

콘텐츠 WT-3

위젯 콘텐츠가 지속적으로 오래되었거나 시의적절하지 않습니다.

WT-3.1

사용자가 위젯에서 작업을 완료한 후 위젯이 업데이트되지 않습니다.

WT-3.2

사용자가 앱 내에서 관련 작업을 완료한 후 위젯이 업데이트되지 않습니다.

WT-4

위젯 UI가 작동하지 않거나 콘텐츠가 잘립니다.

Tier 2 스탠더드 아이콘

등급 2

표준 위젯 요구사항

이 기준 품질 기준을 충족하는 위젯은 표준으로 간주되지만 추천되거나 추천되는 쇼케이스 위젯으로 간주되지는 않습니다.

카테고리 ID 설명
레이아웃 WL-1

위젯은 세로 또는 가로축의 다른 호스트 요소와 정렬되며 추가 공간을 차지하지 않습니다.

WL-1.2

모든 도형은 그리드 경계의 반대쪽 가장자리 중 최소 2개에 닿아야 합니다.

WL-4

위젯의 크기를 조절할 수 있는 경우 최소 크기와 최대 크기를 정의합니다. 위젯이 커짐에 따라 더 많은 콘텐츠를 표시하도록 레이아웃을 재정렬합니다. 텍스트와 아이콘을 선형으로 확장하지 마세요.

WL-4.1

위젯 크기가 커지면 빈 공간만 추가되는 경우 최대 너비 또는 높이를 설정합니다. 더 큰 위젯이 더 많은 콘텐츠(예: 더 긴 스크롤 목록)를 표시하는 경우 크기 조절을 제한하지 마세요.

WL-4.2

최소 위젯 크기는 명확한 사용 사례를 보여주고 48x48dp 터치 영역 요구사항을 충족할 만큼 충분히 커야 합니다. 시스템은 데스크톱 또는 자동차 화면에 맞게 터치 영역을 확장할 수 있습니다.

탐색 WD-4

위젯 선택 도구에 위젯의 정확한 미리보기 (정적 애셋)가 있어야 합니다.

콘텐츠 WT-1

0 및 빈 상태는 희소 영역 없이 더 큰 위젯 경계로 확장되어야 합니다. 사용자가 로그인하기 전에 위젯을 설치하는 경우 위젯은 명확한 사용 사례 또는 클릭 유도 문구를 표시해야 합니다.

WT-2

데이터가 UI보다 더 자주 새로고침될 것으로 예상되는 경우 위젯을 사용하면 사용자가 콘텐츠를 수동으로 새로고침할 수 있습니다.

48x48dp의 터치 영역을 제공합니다.
터치 영역을 너무 작게 만듭니다.
색상 대비가 충분한지 확인합니다.
색상 대비가 충분하지 않은 색상을 사용합니다.
그림 1: 미리보기가 부정확한 위젯을 만들지 마세요.

Tier 1 차별화 아이콘

등급 1

차별화된 위젯 요구사항

이러한 위젯은 프리미엄 홈 화면 맞춤설정을 지원하며 사용자에게 추천되고 개발자에게 권장사항으로 표시됩니다. 차별화된 위젯은 히어로 환경을 제공하며 Android에서 생태계에 영감을 주고 활력을 불어넣는 데 활용됩니다. 차별화된 레이아웃, 색상, 탐색, 콘텐츠 기준을 모두 충족합니다.

카테고리 ID 설명
레이아웃 WL-1

위젯은 세로 또는 가로축의 다른 호스트 요소와 정렬되며 추가 공간을 차지하지 않습니다.

WL-1.1

모든 직사각형 위젯은 그리드 경계의 네 가장자리를 모두 채워야 합니다(MUST). 모든 맞춤형 위젯은 정사각형 그리드 경계의 4개 가장자리에 모두 닿아야 합니다(MUST). 크기가 4x1이고 검색창이 포함된 경우 가장자리를 2개만 터치할 수 있습니다.

WL-2

사용자는 위젯의 크기를 2x1로 조절할 수 있으며 1x1, 2x2, 4x2, 4x4 중 최소 두 가지 크기로 조절할 수 있습니다.

WL-3

위젯 헤더가 일관되게 사용되고 적용됩니다.

  • 다음과 같은 경우 헤더를 사용하는 것이 좋습니다.
    • 위젯에 스크롤 콘텐츠가 포함되어 있습니다.
    • 헤더 콘텐츠는 목록 이름과 같은 유용한 컨텍스트를 제공합니다.
  • 다음과 같은 경우 헤더 사용은 선택사항입니다.
    • 위젯이 사진 위젯과 같이 풀 블리드입니다.
    • 참석 인원이 제한되어 있으니
    • 헤더 콘텐츠가 중복되는 경우
  • 헤더를 사용하는 경우 다음 사항을 확인하세요.
    • 아이콘이 항상 표시됨
    • 공간이 충분한 경우 제목이 표시됩니다.
    • 작업은 위젯 컨텍스트를 기반으로 합니다.
WL-5

컬렉션 및 피드 위젯은 세로 스크롤 컨테이너를 지원합니다. 4x2 및 4x4와 같은 더 큰 크기에서는 이러한 위젯이 더 많은 항목과 항목당 더 많은 세부정보를 표시합니다.

색상 WC-1

위젯은 기기 또는 앱 컨텍스트를 기반으로 색상 테마 설정을 지원합니다.

WC-2

위젯은 밝은 테마와 어두운 테마 팔레트를 지원합니다.

탐색 WD-1

미리보기는 타겟 폼 팩터의 레이아웃 비율을 보여주며 사용자 콘텐츠를 포함하거나 시스템 테마를 적용하거나 둘 다 적용합니다.

WD-4.4

위젯에 사용자가 위젯의 가치를 이해하는 데 도움이 되는 설명이 있습니다.

WD-4.5

위젯 이름은 설명적이며 앱의 다른 위젯과 구별됩니다.

시스템 일관성 WS-2

직사각형 위젯은 시스템에서 제공하는 모서리 반경 (OEM별)을 사용해야 합니다.

WS-3

위젯은 로드 상태 사양을 사용하고 위젯 UI에 직접 오류를 표시합니다.

WS-4

위젯은 맞춤 위젯 설정 진입점 대신 시스템 구성을 사용합니다.

WS-5

위젯에서 앱을 시작하거나 종료할 때 위젯이 시스템 시작 전환을 사용합니다.

위젯이 그리드 경계의 네 가장자리 모두로 확장됩니다.
그리드 경계를 채우지 않는 맞춤 크기를 만듭니다.
위젯 사양을 충족하는 헤더를 제공합니다.
크기와 제목에 맞춤 사양을 사용합니다.
고유하고 간결한 설명을 포함합니다.
일반적인 설명을 제공합니다.
시스템 모서리 반경을 사용합니다.
맞춤 모서리 반경을 설정합니다.