Android 개발/트러블슈팅

Android 17 호환성, 6월 Stable 출시 전 반드시 확인할 체크리스트 5가지

stackD 2026. 5. 11. 18:00

 

6월 둘째 주 월요일 오전, 슬랙(Slack) 채널에 빨간 불이 들어옵니다. "사진 선택창 UI가 깨졌어요", "푸시 알림이 안 와요". 안드로이드 17(Android 17) Stable 업데이트 사흘째—이 장면이 싫다면 지금부터 움직이셔야 해요.

 

5월 8일인 오늘을 기준으로, 안드로이드 17의 안정화 버전(Stable) 출시가 대략 한 달 남짓 다가왔습니다. 구글이 작년 안드로이드 16부터 메이저 출시 일정을 2분기로 앞당긴 만큼, 이제 6월 출시는 기정사실이 되었거든요. 메이저 버전 업그레이드 직후 호환성 이슈 발생률이 꽤 높다고 해요. 열 팀 중 두세 팀은 첫 주에 야근을 하게 된다는 얘기가 됩니다. 이번엔 Photo Picker 변경사항, 강화된 Private Space(비공개 공간), targetSdkVersion 36/37 마이그레이션이 한꺼번에 맞물려 있어서 단순 확인보다 체계적인 점검이 필요하더라구요.

 

안드로이드 17 호환성 체크리스트, 놓치면 터지는 5가지

  1. Photo Picker 클라우드 연동 및 UI 변화 — 안드로이드 최신 버전들부터 이미지 선택 UI(Photo Picker)가 시스템 기본으로 강제되면서, 로컬과 클라우드 미디어를 통합해서 보여주는 기능이 더욱 고도화됐어요. 이 과정에서 기존 커스텀 앨범 UI를 쓰던 앱들은 권한이나 레이아웃 면에서 충돌이 잦으니 꼭 다시 점검해볼 필요가 있습니다.
  2. Private Space 및 네이티브 App Lock 강화 — 안드로이드 15에 처음 도입됐던 비공개 공간(Private Space)과 앱 잠금 기능의 시스템 제한이 더 깐깐해졌습니다. 잠긴 앱의 알림은 내용이 가려지는 건 기본이고, 백그라운드 작업이 엄격하게 제한될 수 있어 금융 앱의 거래 알림이나 실시간성이 중요한 기능에 큰 영향을 줄 수 있습니다.
  3. targetSdkVersion 36 필수화 및 37 대비 — 당장 올해 8월이면 구글 플레이 신규 및 업데이트 앱의 필수 요건이 targetSdkVersion 36(Android 16)으로 올라가고, 이어서 17(API 37) 환경에 맞춰야 하잖아요. 특히 시스템 바까지 화면을 꽉 채워야 하는 Edge-to-Edge UI 의무화 정책에 따른 인셋(Inset) 처리를 거부할 수 없게 되어서 UI가 겹치지 않는지 주의해야 합니다.
  4. 고화질 미디어(Ultra HDR 등) 처리 최적화 — 카메라 및 갤러리 앱에서 Ultra HDR 같은 고해상도, 고용량 미디어 포맷 지원이 확대되면서, 데이터 처리 시 메모리(OOM) 사용량이 기존보다 훅 늘어날 수 있습니다.
  5. Credential Manager 바인딩 강화 — 생체 인증·패스키(Passkey) 관련 API 정책이 Credential Manager 중심으로 통합 및 강화되면서, 레거시 인증 로직을 그대로 쓰면 충돌이 생기기도 하더라구요.

5개 모두 "나는 해당 안 될 거야" 싶다가 막상 베타 깔아보면 한두 개씩 걸리는 항목들입니다. 특히 1번과 3번은 거의 모든 앱이 영향을 받는다고 보시면 되겠습니다.

 

 

Photo Picker와 targetSdk 이슈에서 앱이 깨지는 지점

Photo Picker 충돌에서 가장 골치 아픈 건 Custom Picker 충돌이에요. 카메라 촬영과 앨범 선택을 함께 지원하는 앱에서, 레거시 저장소 권한 방식과 새로운 Picker가 동시에 뜨거나 권한 처리가 꼬이는 문제가 나오는 경우가 있더라구요. 커스텀 Picker를 직접 구현했다면 실기기에서 꼭 확인해야 합니다. 프리뷰와 실제 업로드 결과물이 어긋나는 케이스는 카메라 촬영→편집 플로우에서 특히 자주 보입니다.

 

새로운 targetSdkVersion에 맞추다 보면 권한과 스레드 처리에서 ANR(Application Not Responding)이 터지는 원인은 구조적이거든요. 권한 확인 → 파일 로드 → 리스트 렌더링을 메인 스레드에서 순차 처리하면 응답 속도가 눈에 띄게 느려지고, 바로 ANR로 이어집니다. 코루틴으로 권한 확인 단계를 비동기 분리하면 풀리더라구요.

 

Glide나 Coil 같은 이미지 라이브러리는 권한 실패 시 예외 로그 없이 빈 화면만 내뱉는 일이 생겨서 디버깅이 까다롭습니다. 라이브러리 버전을 최신으로 올리고, 권한 실패 콜백을 명시적으로 추가해두는 게 안전해요.

 

 

Private Space와 App Lock 백그라운드 제한, 어디까지 영향받나

이 잠금 기능들의 영향 범위가 생각보다 넓더라구요.

 

포그라운드 알림은 즉시 전달되지만, 백그라운드 알림은 내용이 완전히 마스킹되거나 지연 큐에 쌓일 수 있습니다. 금융 앱의 긴급 거래 알림처럼 실시간성이 중요한 기능에서 직접적인 기능 단절로 이어질 수 있어요. WorkManager나 JobScheduler로 등록한 정기 작업도 앱이 비공개 공간에 있거나 잠금 상태가 오래 유지되면 실행이 밀리고, 앱을 켰을 때 한참 전의 오래된 데이터가 보이는 문제로 나타나거든요.

 

네트워크 변화 등을 감지하는 브로드캐스트 리시버가 아예 동작을 안 하는 경우도 있습니다. Wi-Fi가 끊겼는데 앱이 아무 반응 없이 멈춰 있고, 수동 재시작 전까지 그 상태가 유지되는 경험을 하셨다면 잠금 상태의 백그라운드 제한 영향일 가능성이 높아요.

다만 이 기능은 사용자가 직접 앱을 잠그거나 숨기도록 설정했을 때 동작하며, 엔터프라이즈(MDM) 솔루션보다는 일반 사용자의 사생활 보호 강화에 초점이 맞춰져 있습니다. 따라서 실제 동작 방식은 에뮬레이터가 아닌 일반 사용자 실기기 환경에서 검증하는 것이 훨씬 정확합니다.

 

픽셀 실기기 셋업, 베타 테스트 신뢰도 올리는 법

에뮬레이터로는 최신 OS의 세세한 변화를 잡는 데 한계가 큽니다. Photo Picker UI의 세부 동작, Private Space의 시스템 개입, 생체 인증 연동은 펌웨어 단계의 변화라 에뮬레이터에서 완벽히 재현이 안 되는 일이 꽤 많거든요. 실기기 테스트가 선택이 아닌 필수인 이유죠.

 

시스템 이미지를 픽셀 기기에 직접 플래시(Flash)하면 과정은 약간 복잡해도 언제든 복원이 가능하고, OTA(무선 업데이트) 방식은 간편하지만 롤백이 어렵습니다. 개발자는 직접 플래시, QA는 OTA로 나누는 게 현실적이라고 봅니다.

 

참고로 저는 픽셀(Pixel) 기기를 두 대 운영하고 있어요. 한 대는 안드로이드 17 베타 전용, 나머지는 비교 기준용으로 두는데, 두 대 없이 하나로만 돌리면 롤백이 필요한 순간에 진짜 난감해지더라구요. 최근 공개된 최신 베타 버전을 기점으로 이미 핵심 API들이 확정 단계에 들어섰기 때문에, 지금부터 본격적인 검증을 시작해도 절대 늦지 않습니다.

 

6월 전 1주일, 안드로이드 17 우선순위 점검 순서

순서 항목 소요 시간 핵심 점검 내용
1 targetSdkVersion 36/37 마이그레이션 1일 build.gradle 변경, Edge-to-Edge 대응 및 lint 경고 전수 확인
2 권한별 동작 확인 2일 허용 → 실행 → 거부 3단계 및 부분 권한 허용 테스트
3 Photo Picker 호환성 1일 카메라 → 편집 플로우, 커스텀 Picker 충돌 여부
4 백그라운드 작업 검증 2일 App Lock/Private Space 상태로 8시간 방치 후 WorkManager 테스트
5 배포 프로세스 점검 1일 내부 테스트 → Closed Beta → 공개 출시 과정 및 서명(Keystore) 검증

 

4번 백그라운드 작업 검증이 실무에서 가장 놓치기 쉬운 항목이에요. 기기를 실제로 잠금/비공개 처리해두고 긴 시간 확인해야 하는 테스트라서, 저 같은 경우엔 전날 저녁에 세팅해두고 다음 날 아침에 결과를 봅니다.

 

 

마치며

타사 라이브러리나 유지보수가 끊긴 구형 SDK가 끼어 있으면 내부 코드만으로는 호환성 문제를 막을 방법이 거의 없거든요. 오류가 우려되는 의존성은 지금 바로 대체재를 조사해두시는 게 좋습니다.

 

안드로이드 17 Stable 출시 일정은 거의 코앞으로 다가온 분위기입니다. 최신 베타 버전을 이번 주 안에 픽셀 기기에 설치해서 위 다섯 가지 체크포인트를 하나씩 밟아두시면, 6월 첫 주 슬랙 채널에 빨간 불이 들어오는 당황스러운 상황을 크게 줄이실 수 있을 거라고 꼭 말씀드리고 싶네요.