앱 MVP Android 위젯 갱신: 전체·부분·목록 새로고침을 나누는 5가지 기준

홈 화면 위젯은 앱을 열지 않아도 핵심 정보를 확인하거나 한 가지 동작을 시작하게 해 주지만, 화면에 값이 보인다는 사실과 그 값이 최신이라는 사실은 다릅니다. MVP에서 위젯을 넣을 때는 ‘갱신한다’는 말 하나로 설계·배터리·사용자 기대를 묶지 않는 편이 좋습니다. 어떤 정보를 보여 줄지, 언제 다시 그릴지, 화면 일부만 바꿀지, 목록 데이터만 새로 읽을지, 늦은 갱신을 어떻게 표시할지를 별도 결정으로 남겨야 합니다.

Android Developers는 위젯을 앱의 중요한 데이터와 기능을 홈 화면에서 한눈에 보여 주는 표면으로 설명하고, 정보형·목록형·제어형 위젯을 구분합니다(C001, C002). 또 위젯 갱신에는 전체 갱신, 부분 갱신, 목록 데이터 새로고침이 있으며 계산 비용과 동작이 서로 다르다고 안내합니다(C003). 이 글은 특정 앱의 배터리 사용량·전환율·알림 성과를 주장하지 않습니다.

먼저 분리할 것: 위젯 화면과 앱의 최신 상태는 같은 완료 신호가 아닙니다

위젯은 앱 전체를 축소한 화면이 아니라, 사용자가 빠르게 확인하거나 시작할 한 가지 정보·동작을 남기는 표면입니다(C001). 따라서 MVP에서는 먼저 ‘위젯에 꼭 남겨야 하는 한 가지 질문’을 정하는 편이 좋습니다. 예를 들어 오늘의 할 일 수, 최근 기록 한 건, 사용자가 누르는 재생·완료 같은 흐름은 위젯의 후보가 될 수 있지만, 앱의 모든 설정과 탐색을 위젯 안에 넣을 이유가 되지는 않습니다.

기록도 둘로 나누세요. 첫째는 앱의 원본 데이터가 바뀐 시점입니다. 둘째는 그 변화가 특정 위젯 인스턴스에 반영된 시점입니다. 두 시간이 다르면 ‘데이터가 틀렸다’고 즉시 단정하기보다 갱신 요청이 있었는지, 시스템이 나중에 실행했는지, 마지막으로 성공한 표시값은 무엇인지부터 확인할 수 있습니다. 관찰하지 않은 즉시성은 요구사항이나 성과로 쓰지 않는 것이 안전합니다.

기준 1: 정보·목록·제어 중 하나를 중심 역할로 정합니다

Android Developers는 정보형 위젯을 중요한 정보의 변화를 보여 주는 용도, 목록형 위젯을 같은 유형의 여러 항목을 훑고 상세 화면을 여는 용도, 제어형 위젯을 자주 쓰는 기능을 홈 화면에서 실행하는 용도로 나눕니다(C002). 한 위젯이 섞인 형태일 수는 있지만, 기본 유형 하나를 먼저 잡으면 갱신 기준도 선명해집니다.

정보형이라면 마지막 갱신 시각과 값의 우선순위를, 목록형이라면 항목 정렬·비어 있음·상세 화면 이동을, 제어형이라면 탭 뒤 실제 동작의 성공·실패 상태를 각각 확인하세요. ‘버튼을 눌렀다’와 ‘서버 또는 기기 작업이 끝났다’를 같은 상태로 표기하지 않는 것이 중요합니다. 화면 공간이 작을수록 앱에서 볼 상세 정보와 위젯에서 볼 핵심 신호를 분리해야 합니다.

우리 앱 MVP의 홈 화면 기능·갱신 기준·검증 기록 점검하기

기준 2: 전체 갱신, 부분 갱신, 목록 새로고침을 같은 말로 부르지 않습니다

Android Developers는 `updateAppWidget`으로 이전 `RemoteViews`를 새 화면으로 바꾸는 전체 갱신, `partiallyUpdateAppWidget`으로 일부를 병합하는 부분 갱신, 컬렉션 위젯의 데이터 무효화 뒤 데이터셋을 다시 읽는 새로고침을 구분합니다(C003). 부분 갱신은 그 전에 전체 갱신을 최소 한 번 받지 못한 위젯에서는 무시될 수 있다는 조건도 함께 안내합니다(C004).

실무 체크리스트에는 ‘갱신됨’ 한 줄 대신 `바뀐 값`, `바꾼 화면 범위`, `대상 위젯 ID`, `요청 원인`, `성공 또는 실패 관찰`을 남겨 두세요. 예를 들어 숫자 한 개만 바뀐다고 판단했다면 부분 갱신이 가능한지, 목록 항목 자체가 바뀌었다면 데이터 새로고침이 필요한지, 크기나 구조가 바뀌었다면 전체 화면을 다시 구성해야 하는지를 분리해 검토합니다. 구현 방식은 앱의 실제 UI와 데이터 모델에 맞춰 선택해야 하며, 이 글이 특정 API 사용을 지시하지는 않습니다.

기준 3: 주기 갱신은 ‘원하는 시간’이 아니라 시스템 제약과 함께 정합니다

`updatePeriodMillis`로 주기 갱신을 지정할 수 있지만, Android Developers는 30분보다 짧은 값을 지원하지 않는다고 설명합니다(C005). 비동기 데이터 로드나 오래 걸리는 작업이 필요한 경우에는 BroadcastReceiver 갱신의 대안과 `WorkManager`를 검토하라고 안내합니다(C006). 따라서 ‘매 분 최신’처럼 제품 문구부터 확정하면 구현과 실제 표시 사이에 약속 차이가 생길 수 있습니다.

MVP 요구사항에는 갱신의 목적을 먼저 적어 보세요. 사용자가 직접 새로고침을 눌렀을 때, 앱에서 어떤 작업을 끝냈을 때, 특정 데이터가 바뀌었을 때, 정해진 간격으로 확인할 때는 각각 허용할 지연과 실패 시 표시가 달라질 수 있습니다. 사용자가 횟수를 조정하게 할지, 배터리·네트워크 제약에서 이전 값을 유지할지, 앱을 열었을 때만 최신 값을 보장할지 또한 별도의 결정입니다.

기준 4: 브로드캐스트 안에서 끝나는 일과 뒤로 넘길 일을 구분합니다

Android Developers는 위젯을 갱신하는 BroadcastReceiver가 보통 최대 10초 뒤 응답하지 않는 것으로 간주될 수 있다고 설명하며, 오래 걸리는 작업은 `goAsync` 또는 `WorkManager`를 고려하라고 안내합니다(C007). 특정 브로드캐스트만 신중하게 수신하고, Android 버전별 암시적 브로드캐스트 제한도 함께 검토해야 합니다(C008).

따라서 브로드캐스트 수신 시에는 작은 표시 변경을 적용하고, 네트워크 호출·대량 계산·파일 처리처럼 완료 시간이 불확실한 일은 별도 작업으로 넘기는 기준을 문서화하세요. 작업이 늦어질 때 기존 값을 유지할지, ‘동기화 중’ 같은 상태를 보여 줄지, 오류를 앱 상세 화면으로 안내할지도 사용자 경험의 일부입니다. 지연 자체를 오류로 단정하지 말고 수신 시각, 작업 시작·종료, 마지막 성공 표시를 나눠 관찰하는 편이 낫습니다.

기준 5: 크기 변화와 탭 뒤 이동을 실제 런처에서 확인합니다

위젯은 사용자가 크기를 바꿀 수 있고, Android Developers는 작은 크기에는 핵심 정보에 집중하고 크기가 커질수록 맥락을 더하라고 권장합니다(C009). 기기마다 홈 화면 격자의 수·간격이 달라 유연한 레이아웃이 필요하다는 안내도 있습니다(C010). 즉 개발 기기 한 대에서 보기 좋았다는 사실만으로 모든 크기에서 정보가 잘린다고 판단할 수는 없습니다.

출시 후보에서는 최소한 작은·중간·큰 크기에서 무엇이 보이는지, 비어 있는 데이터일 때 어떤 문구가 나오는지, 항목을 눌렀을 때 어느 앱 화면으로 이어지는지, 제어 버튼을 누른 뒤 표시와 실제 상태가 일치하는지를 확인해 보세요. 관련 글 앱 MVP Android BroadcastReceiver: 수신·작업·사용자 상태를 나누는 기준은 이벤트 수신 뒤 작업 경계를 기록하는 방법을 다룹니다. 이번 글은 그보다 좁게 홈 화면 위젯의 표시·갱신·크기·동작 확인에 초점을 둡니다.

출시 전 위젯의 표시값·갱신 조건·QA 기준을 함께 정리하기

자주 묻는 질문

위젯은 30분보다 짧게 자동 갱신할 수 없나요?

Android Developers는 `updatePeriodMillis`가 30분보다 짧은 값을 지원하지 않는다고 안내합니다. 다만 사용자 상호작용·앱의 작업 완료·특정 데이터 변경처럼 갱신 원인이 다른 경우가 있으므로, 요구하는 최신성·작업 시간·전력 제약을 함께 검토하세요.

부분 갱신만 쓰면 되나요?

그렇게 단정할 수 없습니다. 부분 갱신은 먼저 전체 갱신을 받은 위젯을 전제로 하며, 화면 구조·크기·목록 데이터가 달라지는 경우에는 다른 방식이 필요할 수 있습니다. 실제로 바뀐 값과 화면 범위를 먼저 분리하세요.

목록 위젯에서 새 데이터가 오면 이전 항목은 바로 사라지나요?

Android Developers는 컬렉션 데이터 새로고침이 진행되는 동안 기존 데이터가 위젯에 표시된다고 설명합니다. 따라서 로딩·빈 상태·마지막 성공 값의 표현을 제품 요구사항으로 미리 정하는 편이 좋습니다.

위젯 갱신이 늦으면 모두 ANR인가요?

아닙니다. BroadcastReceiver에서 오래 걸리는 처리는 응답성 문제를 만들 수 있으므로 경계를 관리해야 하지만, 위젯에 표시되는 시점이 늦다는 관찰만으로 원인을 단정할 수는 없습니다. 수신·작업·표시의 시각과 실패 기록을 나눠 확인하세요.

공식 출처

Android Developers: App widgets overview — 2026-09-21 확인 Android Developers: Create an advanced widget — 2026-09-21 확인 Android Developers: Jetpack Glance — 2026-09-21 확인

발행일: 2026-09-21 · 작성: 유인어스 정책자금·정부지원사업 인사이트