앱 개발

안드로이드 포그라운드 서비스 유형 선언과 구글 플레이 신고 기준

안드로이드 포그라운드 서비스 유형 선언과 구글 플레이 신고 기준

안드로이드 포그라운드 서비스 유형 선언과 구글 플레이 신고 기준

안드로이드 14 이상을 타깃으로 하는 앱은 포그라운드 서비스마다 유형과 전용 권한을 선언하고 Play Console에 사용 목적과 시연 동영상을 신고해야 합니다. 기능별 유형 고르기와 안드로이드 15의 6시간 제한까지 다룹니다.

안드로이드 14 이상을 타깃으로 하는 앱은 포그라운드 서비스마다 유형과 전용 권한을 선언하고 Play Console에 사용 목적과 시연 동영상을 신고해야 합니다. 기능별 유형 고르기와 안드로이드 15의 6시간 제한까지 다룹니다.

6분 소요

6분 소요

포그라운드 서비스는 앱이 화면 뒤로 가도 알림을 띄운 채 계속 일하게 하는 기능입니다. 안드로이드 14 이상을 타깃으로 하는 앱은 이 서비스마다 유형을 매니페스트에 선언하고, 유형별 전용 권한을 따로 적어야 합니다. 구글 플레이에는 Play Console 앱 콘텐츠 화면에서 유형별 사용 목적과 시연 동영상을 신고해야 합니다. 올해 8월 31일부터 구글 플레이 업데이트는 타깃 API 36 이상이어야 하므로, 지금 업데이트를 내는 앱은 모두 이 기준에 들어갑니다.

안드로이드 포그라운드 서비스 유형 선언과 구글 플레이 신고 기준 대표 이미지

블루투스 기기 연결, 걸음 수 측정처럼 뒤에서 오래 도는 기능이 있는 앱이라면 거의 확실히 해당됩니다. BLE 앱의 권한 구성은 BLE 앱 개발 구조 글에서 따로 다뤘습니다.

빠뜨리면 앱이 바로 멈춥니다

안드로이드 14 변경 사항 문서는 선언이 빠졌을 때 일어나는 일을 예외 이름까지 적어 두었습니다. 대부분 서비스를 시작하는 startForeground() 호출 순간에 터지기 때문에, 개발 중에는 멀쩡하다가 특정 기기나 특정 순서에서만 앱이 꺼지는 식으로 나타납니다.

  • 매니페스트의 foregroundServiceType: MissingForegroundServiceTypeException
  • 유형별 권한(FOREGROUND_SERVICE_LOCATION 등): SecurityException
  • 실행 권한을 받기 전에 서비스 시작: SecurityException, 앱 종료 가능
  • 자격 없이 systemExempted 선언: ForegroundServiceTypeNotAllowedException

유형별 권한은 설치할 때 자동으로 허용되는 일반 권한이라 사용자에게 묻는 창이 뜨지 않습니다. 대신 위치나 카메라처럼 사용자가 허용해야 하는 실행 권한은 서비스를 시작하기 전에 먼저 받아 둬야 합니다. 서비스를 띄운 다음에 권한을 묻는 순서로 짜여 있던 코드는 이 순서를 뒤집어야 합니다.

기능별로 맞는 유형

포그라운드 서비스 유형 문서에 나온 유형 가운데 일반 앱에서 자주 쓰는 것들입니다.

  • 블루투스 기기 연결 유지: connectedDevice, BLUETOOTH_CONNECT 같은 근처 기기 권한 중 하나
  • 운동 기록, 걸음 수 측정: health, ACTIVITY_RECOGNITION 같은 건강 관련 권한 중 하나
  • 길 안내, 위치 공유: location, 위치 서비스 켜짐과 위치 권한
  • 음악, 강의 백그라운드 재생: mediaPlayback, 추가 권한 없음
  • 영상 통화 중 다른 앱 사용: camera와 microphone, CAMERA와 RECORD_AUDIO 권한
  • 파일 업로드, 백업: dataSync, 추가 권한 없음
  • 화면 공유: mediaProjection, 화면 캡처 동의
  • 끊기면 안 되는 짧은 작업: shortService, 약 3분까지만 실행

어디에도 맞지 않으면 specialUse를 쓰고 매니페스트의 <property>에 이유를 직접 적습니다. 이 설명은 Play Console 제출 때 심사자가 읽습니다.

문서는 유형마다 대신 쓸 수 있는 API도 함께 안내합니다. 특정 장소에 도착했을 때만 동작하면 되는 기능은 지오펜스, 기기 근처에 있을 때만 깨어나면 되는 기능은 Companion Device Manager, 주기적인 동기화는 WorkManager가 맞습니다. 포그라운드 서비스를 줄이면 신고할 항목도 줄어듭니다.

안드로이드 15에서 더 좁아진 조건

안드로이드 15 동작 변경 문서에는 타깃 API 35 이상 앱에 적용되는 제한이 추가됐습니다.

  • dataSync와 새로 생긴 mediaProcessing은 24시간 동안 합쳐서 6시간까지만 돕니다. 시간이 다 되면 onTimeout()이 불리고, 몇 초 안에 stopSelf()로 멈추지 않으면 RemoteServiceException으로 앱이 종료됩니다. 사용자가 앱을 다시 앞으로 가져오면 6시간이 다시 채워집니다.
  • 부팅 완료 신호(BOOT_COMPLETED)를 받아 dataSync, camera, mediaPlayback, phoneCall, mediaProjection, microphone 유형을 시작할 수 없습니다. 시도하면 ForegroundServiceStartNotAllowedException이 납니다.
  • 다른 앱 위에 그리기 권한(SYSTEM_ALERT_WINDOW)이 있다는 이유만으로 백그라운드에서 서비스를 시작하던 예외가 좁아졌습니다. 이제는 오버레이 창이 실제로 화면에 떠 있어야 합니다.

부팅하자마자 자동으로 동기화를 시작하던 앱은 두 번째 항목에 그대로 걸립니다. 문서는 타깃을 올리기 전에도 안드로이드 15 기기에서 adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS 패키지명, adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS 패키지명으로 같은 제한을 켜서 시험할 수 있다고 안내합니다.

Play Console에 신고할 내용

Play Console 도움말에 따르면 유형마다 아래 항목을 채웁니다.

  • 그 유형을 쓰는 앱 기능 설명
  • 시스템이 작업 시작을 미루거나 중간에 멈추면 사용자에게 어떤 영향이 있는지
  • 해당 기능을 보여 주는 동영상 링크
  • 미리 정해진 사용 사례 목록에서 고르거나 직접 입력

동영상에서 막히는 경우가 많습니다. 도움말은 사용자가 서비스가 돌고 있다는 것을 알아챌 수 있어야 한다는 기준을 두고, 데이터 동기화라면 완전 자동 백업 장면은 인정하지 않는다고 적고 있습니다. 음악 재생도 앱을 열 때 저절로 나오는 배경음은 해당되지 않습니다. 사용자가 버튼을 눌러 기능을 시작하고, 상단에 알림이 떠 있는 장면이 들어가야 합니다.

같은 도움말에는 전체 화면 알림 권한(USE_FULL_SCREEN_INTENT)도 함께 나옵니다. 2025년 1월 22일부터 안드로이드 14 이상을 타깃으로 하는 앱은 통화나 알람 기능이 있을 때만 이 권한이 기본으로 켜지고, 그 외 앱은 사용자에게 따로 허락을 받아야 합니다.

업데이트 전 점검 순서

저희는 안드로이드 업데이트 전에 아래 순서로 봅니다. 걸음 수 앱처럼 권한이 많은 앱의 심사 준비는 걸음 수 앱 출시 전 권한과 심사 절차 글에도 있습니다.

  1. 라이브러리까지 합쳐진 최종 매니페스트에서 <service>와 foregroundServiceType, FOREGROUND_SERVICE_ 권한 목록을 뽑습니다.
  2. 서비스를 시작하는 코드마다 실행 권한을 먼저 받는지 봅니다.
  3. WorkManager나 지오펜스로 옮길 수 있는 서비스는 옮깁니다.
  4. 남은 유형마다 시연 동영상을 찍고 Play Console 앱 콘텐츠에 신고합니다.

타깃 API 요건 전체는 타겟 API 36 대응 글에 있습니다.

자주 묻는 질문

포그라운드 서비스를 만든 적이 없는데 Play Console에서 신고하라고 합니다.

외부 SDK가 매니페스트에 서비스를 넣었을 가능성이 큽니다. Android Studio의 병합된 매니페스트 화면에서 어떤 라이브러리가 넣은 서비스인지 찾고, 실제로 쓰는 기능이면 신고하고 쓰지 않는 기능이면 해당 SDK 설정이나 버전을 바꿉니다.

신고 동영상에는 무엇이 나와야 하나요?

사용자가 직접 기능을 시작하는 장면과 서비스가 도는 동안 떠 있는 알림이 보여야 합니다. Play Console 도움말은 완전 자동으로 도는 백업이나 앱을 열 때 저절로 나오는 배경음은 인정하지 않는다고 안내합니다.

dataSync 6시간 제한은 어떤 앱에 적용되나요?

안드로이드 15(API 35) 이상을 타깃으로 하는 앱에 적용됩니다. 지금 구글 플레이 업데이트는 API 36 이상이어야 하므로 업데이트를 내는 앱은 모두 대상입니다. 앱의 모든 dataSync 서비스가 6시간을 함께 나눠 씁니다.

shortService가 3분을 넘기면 어떻게 되나요?

시스템이 onTimeout()을 부르고, 그래도 멈추지 않으면 앱이 응답 없음(ANR) 상태가 됩니다. 안드로이드 13 이하 기기에는 이 콜백이 없으니 작업이 끝나는 대로 직접 서비스를 멈추게 만들어야 합니다.

블루투스, 위치, 건강 기능이 들어간 앱의 업데이트 준비가 필요하시면 상담 페이지로 앱 이름과 백그라운드에서 도는 기능을 알려 주세요.

앱 개발이 고민되시나요?
앱 개발이 고민되시나요?

기획부터 출시까지, 모바일파트너스가 함께합니다

다른 아티클 살펴보기

다른 아티클 살펴보기

다른 아티클 살펴보기

안드로이드 16KB 페이지 크기 대응, 구글 플레이 기준과 점검 순서 대표 이미지

안드로이드 16KB 페이지 크기 대응, 구글 플레이 기준과 점검 순서

안드로이드 16KB 페이지 크기 대응, 구글 플레이 기준과 점검 순서

안드로이드 15 이상을 타깃으로 하는 앱은 64비트 기기에서 16KB 메모리 페이지를 지원해야 하고, 2027년 2월 1일부터 지원하지 않는 업데이트는 구글 플레이에 낼 수 없습니다. 영향받는 앱과 점검, 수정 방법을 다룹니다.

글 읽어보기

글 읽어보기

BLE 앱 개발 구조, GATT부터 안드로이드 12 권한과 iOS 백그라운드 재연결까지 대표 이미지

BLE 앱 개발 구조, GATT부터 안드로이드 12 권한과 iOS 백그라운드 재연결까지

BLE 앱 개발 구조, GATT부터 안드로이드 12 권한과 iOS 백그라운드 재연결까지

BLE 기기의 데이터는 서비스, 특성, 서술자로 이뤄진 GATT 구조로 오가고, 알림을 받으려면 CCCD(0x2902)에 값을 써야 합니다. 안드로이드 12 이후 권한, API 33과 37에서 바뀐 GATT 함수, iOS 백그라운드 제약과 재연결 순서를 다룹니다.

글 읽어보기

글 읽어보기

걸음 수 앱 출시 전 권한, 백그라운드, 스토어 심사 절차 대표 이미지

걸음 수 앱 출시 전 권한, 백그라운드, 스토어 심사 절차

걸음 수 앱 출시 전 권한, 백그라운드, 스토어 심사 절차

iOS는 걸음 수 변경을 백그라운드로 받을 때 최대 1시간에 한 번만 앱을 깨우고, 구글 플레이는 헬스 커넥트 권한마다 사용 목적 설명을 받아 심사합니다. 걸음 수 앱을 출시하기까지 거치는 권한, 백그라운드, 스토어 정책 절차를 다룹니다.

글 읽어보기

글 읽어보기