고급 위젯 만들기

Compose 방식으로 시도
Jetpack Compose는 Android에 권장되는 UI 도구 키트입니다. Compose 스타일 API를 사용하여 위젯을 빌드하는 방법을 알아봅니다.
Jetpack Glance →

이 페이지에서는 더 나은 사용자 환경을 위해 고급 위젯을 만드는 권장사항을 설명합니다.

위젯 콘텐츠 업데이트 최적화

위젯 콘텐츠를 업데이트하는 데는 컴퓨팅 비용이 많이 들 수 있습니다. 배터리 소모를 줄이려면 업데이트 유형, 빈도, 타이밍을 최적화하세요.

위젯 업데이트 유형

위젯을 업데이트하는 방법에는 전체 업데이트, 부분 업데이트, 컬렉션 위젯의 경우 데이터 새로고침의 세 가지가 있습니다. 각각의 계산 비용과 결과가 다릅니다.

다음은 각 업데이트 유형을 설명하고 각 유형의 코드 스니펫을 제공합니다.

  • 전체 업데이트: AppWidgetManager.updateAppWidget(int, android.widget.RemoteViews)를 호출하여 위젯을 완전히 업데이트합니다. 이전 RemoteViews이 새 RemoteViews으로 대체됩니다. 이 업데이트는 컴퓨팅 비용이 가장 많이 듭니다.

    Kotlin

    val appWidgetManager = AppWidgetManager.getInstance(context)
val remoteViews = RemoteViews(context.getPackageName(), R.layout.widgetlayout).also {
setTextViewText(R.id.textview_widget_layout1, "Updated text1")
setTextViewText(R.id.textview_widget_layout2, "Updated text2")
}
appWidgetManager.updateAppWidget(appWidgetId, remoteViews)

    자바

    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widgetlayout);
remoteViews.setTextViewText(R.id.textview_widget_layout1, "Updated text1");
remoteViews.setTextViewText(R.id.textview_widget_layout2, "Updated text2");
appWidgetManager.updateAppWidget(appWidgetId, remoteViews);

  • 부분 업데이트: AppWidgetManager.partiallyUpdateAppWidget를 호출하여 위젯의 일부를 업데이트합니다. 이렇게 하면 새 RemoteViews가 이전에 제공된 RemoteViews와 병합됩니다. 이 메서드는 위젯이 updateAppWidget(int[], RemoteViews)을 통해 하나 이상의 전체 업데이트를 수신하지 않는 경우 무시됩니다.

    Kotlin

    val appWidgetManager = AppWidgetManager.getInstance(context)
val remoteViews = RemoteViews(context.getPackageName(), R.layout.widgetlayout).also {
setTextViewText(R.id.textview_widget_layout, "Updated text")
}
appWidgetManager.partiallyUpdateAppWidget(appWidgetId, remoteViews)

    자바

    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widgetlayout);
remoteViews.setTextViewText(R.id.textview_widget_layout, "Updated text");
appWidgetManager.partiallyUpdateAppWidget(appWidgetId, remoteViews);

  • 컬렉션 데이터 새로고침: AppWidgetManager.notifyAppWidgetViewDataChanged를 호출하여 위젯의 컬렉션 뷰 데이터를 무효화합니다. 그러면 RemoteViewsFactory.onDataSetChanged가 트리거됩니다. 그동안은 이전 데이터가 위젯에 표시됩니다. 이 메서드를 사용하면 비용이 많이 드는 작업을 동기식으로 안전하게 실행할 수 있습니다.

    Kotlin

    val appWidgetManager = AppWidgetManager.getInstance(context)
appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, R.id.widget_listview)

    자바

    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, R.id.widget_listview);

앱이 해당 AppWidgetProvider 클래스와 동일한 UID를 갖는 한 앱의 어느 곳에서나 이러한 메서드를 호출할 수 있습니다.

위젯 업데이트 빈도 결정

위젯은 updatePeriodMillis 속성에 제공된 값에 따라 주기적으로 업데이트됩니다. 위젯은 사용자 상호작용에 응답하여 업데이트하거나 업데이트를 브로드캐스트하거나 둘 다 할 수 있습니다.

주기적으로 업데이트

appwidget-provider XML에서 AppWidgetProviderInfo.updatePeriodMillis 값을 지정하여 주기적 업데이트의 빈도를 제어할 수 있습니다. 각 업데이트는 AppWidgetProvider.onUpdate() 메서드를 트리거합니다. 여기에 위젯을 업데이트하는 코드를 배치할 수 있습니다. 하지만 위젯이 비동기적으로 데이터를 로드해야 하거나 업데이트하는 데 10초 이상 걸리는 경우 다음 섹션에 설명된 브로드캐스트 리시버 업데이트의 대안을 고려하세요. 10초가 지나면 시스템에서 BroadcastReceiver이 응답하지 않는 것으로 간주하기 때문입니다.

updatePeriodMillis는 30분 미만의 값을 지원하지 않습니다. 하지만 주기적인 업데이트를 사용 중지하려면 0을 지정하면 됩니다.

사용자가 구성에서 업데이트 빈도를 조정하도록 할 수 있습니다. 예를 들어 주식 시세를 15분마다 업데이트하고 싶은 사람도 있고 하루에 네 번만 업데이트하고 싶은 사람도 있습니다. 이 경우 updatePeriodMillis을 0으로 설정하고 대신 WorkManager를 사용합니다.

사용자 상호작용에 대한 응답으로 업데이트

다음은 사용자 상호작용에 따라 위젯을 업데이트하는 권장 방법입니다.

  • 앱의 활동에서: 사용자의 탭과 같은 사용자 상호작용에 대한 응답으로 AppWidgetManager.updateAppWidget을 직접 호출합니다.

  • 알림이나 앱 위젯과 같은 원격 상호작용에서: PendingIntent를 구성한 다음 호출된 Activity, Broadcast 또는 Service에서 위젯을 업데이트합니다. 우선순위를 직접 선택할 수 있습니다. 예를 들어 PendingIntent에 Broadcast를 선택하면 BroadcastReceiver에 우선순위를 부여하는 포그라운드 브로드캐스트를 선택할 수 있습니다.

브로드캐스트 이벤트에 대한 응답으로 업데이트

위젯을 업데이트해야 하는 브로드캐스트 이벤트의 예는 사용자가 사진을 찍는 경우입니다. 이 경우 새 사진이 감지되면 위젯을 업데이트해야 합니다.

JobScheduler로 작업을 예약하고 JobInfo.Builder.addTriggerContentUri 메서드를 사용하여 브로드캐스트를 트리거로 지정할 수 있습니다.

브로드캐스트를 위해 BroadcastReceiver를 등록할 수도 있습니다(예: ACTION_LOCALE_CHANGED 수신 대기). 하지만 이 기능은 기기 리소스를 사용하므로 주의해서 사용하고 특정 브로드캐스트만 수신하세요. Android 7.0 (API 수준 24) 및 Android 8.0 (API 수준 26)에서 브로드캐스트 제한이 도입됨에 따라 앱은 특정 예외를 제외하고 매니페스트에서 암시적 브로드캐스트를 등록할 수 없습니다.

BroadcastReceiver에서 위젯을 업데이트할 때 고려사항

AppWidgetProvider을 비롯한 BroadcastReceiver에서 위젯을 업데이트하는 경우 위젯 업데이트의 기간 및 우선순위에 관한 다음 고려사항을 참고하세요.

업데이트 기간

일반적으로 시스템은 앱의 기본 스레드에서 실행되는 브로드캐스트 리시버가 응답하지 않는 것으로 간주하고 애플리케이션 응답 없음 (ANR) 오류를 트리거하기 전에 최대 10초 동안 실행되도록 허용합니다. 브로드캐스트를 처리하는 동안 기본 스레드가 차단되지 않도록 하려면 goAsync 메서드를 사용하세요. 위젯을 업데이트하는 데 시간이 오래 걸리는 경우 WorkManager를 사용하여 작업을 예약하는 것이 좋습니다.

Caution: Any work you do here blocks further broadcasts until it completes,
so it can slow the receiving of later events.

자세한 내용은 보안 고려사항 및 권장사항을 참고하세요.

업데이트의 우선순위

기본적으로 AppWidgetProvider.onUpdate를 사용하여 만든 브로드캐스트를 비롯한 브로드캐스트는 백그라운드 프로세스로 실행됩니다. 즉, 시스템 리소스가 과부하되면 브로드캐스트 리시버 호출이 지연될 수 있습니다. 브로드캐스트의 우선순위를 지정하려면 포그라운드 프로세스로 만드세요.

예를 들어 사용자가 위젯의 특정 부분을 탭할 때 PendingIntent.getBroadcast에 전달된 Intent에 Intent.FLAG_RECEIVER_FOREGROUND 플래그를 추가합니다.