안드로이드에서 eSIM 자동 설치 구현하기 — 사용자가 QR코드 안 찍어도 되는 세상

eSIM, 이제 앱에서 자동으로 설치되는 시대

해외여행 갈 때 공항에서 eSIM QR코드를 스캔해본 적 있나요? 최근 몇 년 사이에 eSIM 서비스가 급격히 성장하면서, Airalo나 aloSIM 같은 여행용 eSIM 앱들이 엄청 많아졌는데요. 그런데 지금까지 안드로이드에서 eSIM을 설치하려면 사용자가 직접 QR코드를 카메라로 스캔하거나, 설정 앱에 들어가서 활성화 코드를 수동으로 입력해야 했어요. 사용자 경험(UX) 측면에서 꽤 번거로운 과정이었죠.

그런데 안드로이드에서 이 과정을 앱 안에서 자동으로 처리할 수 있는 방법이 있어요. 바로 EuiccManager API를 활용하는 건데요, 이걸 제대로 구현하면 사용자는 앱에서 버튼 한 번 누르는 것만으로 eSIM이 자동으로 다운로드되고 설치돼요. 최근 한 안드로이드 개발자가 이 구현 과정을 상세하게 공유했는데, 꽤 실용적인 내용이라 정리해볼게요.

EuiccManager API가 뭔가요?

Euicc는 embedded Universal Integrated Circuit Card의 약자인데, 쉽게 말하면 폰에 내장된 SIM 카드 칩이에요. 물리 SIM을 꽂는 대신 소프트웨어적으로 통신사 프로필을 다운로드받아서 활성화하는 방식이 eSIM이거든요.

안드로이드에서는 EuiccManager라는 시스템 API를 통해 이 eSIM 관련 작업을 프로그래밍적으로 할 수 있어요. Android 9(Pie)부터 도입되었는데, 이 API를 쓰면 앱에서 직접 eSIM 프로필을 다운로드하고 활성화할 수 있어요. 사용자가 설정 앱으로 나갈 필요가 없는 거죠.

핵심 흐름은 이래요. 먼저 서버에서 eSIM 활성화 코드(Activation Code)를 받아와요. 이 코드에는 eSIM 프로필을 다운로드할 수 있는 서버 주소와 매칭 ID 같은 정보가 들어있어요. 그다음 EuiccManager의 downloadSubscription() 메서드를 호출하면, 시스템이 알아서 해당 서버에서 프로필을 내려받고 eSIM 칩에 설치해줘요.

구현할 때 어떤 점이 까다로운가요?

개념은 단순한데, 실제 구현에서는 꽤 신경 쓸 게 많아요.

첫째, 권한 문제가 있어요. eSIM 관련 API는 시스템 레벨 작업이라서, 앱이 carrier privileges(통신사 권한)를 가지고 있거나, 특정 조건을 만족해야 해요. 일반 앱이 마음대로 eSIM을 설치할 수 있으면 보안상 큰 문제가 되니까요. 실제로는 LPA(Local Profile Assistant) 역할을 하는 시스템 앱이 중간에서 처리를 하게 되는데, 앱에서는 PendingIntent를 통해 결과를 비동기로 받아요.

둘째, BroadcastReceiver로 결과를 처리해야 해요. downloadSubscription()을 호출하면 바로 결과가 오는 게 아니라, 시스템이 백그라운드에서 작업을 처리하고 나서 BroadcastReceiver를 통해 성공/실패를 알려주거든요. 이 비동기 흐름을 제대로 처리하지 않으면 사용자가 설치가 됐는지 안 됐는지 모르는 상태에 빠질 수 있어요.

셋째, 기기 호환성 문제가 있어요. 모든 안드로이드 폰이 eSIM을 지원하는 건 아니고, 지원하더라도 제조사마다 EuiccManager의 동작이 미묘하게 다를 수 있어요. 삼성, 구글 Pixel, 샤오미 등 기기별로 테스트가 필요한 영역이에요. EuiccManager.isEnabled()로 현재 기기에서 eSIM이 가능한지부터 체크하고 시작해야 해요.

넷째, 사용자에게 확인 다이얼로그가 뜰 수 있어요. 시스템 보안 정책에 따라 "이 eSIM을 설치하시겠습니까?" 같은 확인 화면이 나타나는데, 이 흐름도 UX에 자연스럽게 녹여야 해요. 결과 코드에 RESOLVABLE_ERROR가 올 수 있는데, 이 경우 시스템이 제공하는 resolve 인텐트를 실행해서 사용자 확인을 받아야 하는 식이에요.

업계에서 eSIM 자동 설치가 왜 중요한가요?

전 세계적으로 eSIM 채택률이 빠르게 올라가고 있어요. 특히 여행, IoT, MVNO(알뜰폰) 시장에서 eSIM은 핵심 기술이 되고 있는데요, 사용자 경험의 마찰을 줄이는 게 서비스 성공의 핵심이에요. QR코드를 스캔하는 한 단계만 없어져도 전환율(conversion rate)이 크게 달라지거든요.

iOS에서는 이미 eSIM 자동 설치 흐름이 꽤 잘 정립되어 있어요. 애플이 Carrier 연동을 위한 가이드를 잘 만들어뒀거든요. 안드로이드는 상대적으로 파편화(fragmentation) 이슈가 있어서 구현이 조금 더 까다롭지만, 그만큼 이 영역을 잘 다룰 수 있는 개발자에 대한 수요도 있어요.

한국 개발자에게 주는 시사점

한국은 eSIM 도입이 꽤 빠른 나라예요. SKT, KT, LGU+ 모두 eSIM을 지원하고, 해외여행용 eSIM 서비스도 네이버나 여러 스타트업에서 활발하게 제공하고 있죠. 만약 통신 관련 서비스나 여행 앱을 만들고 있다면, eSIM 자동 설치 기능은 사용자 경험을 확실히 차별화할 수 있는 포인트예요.

국내 삼성 갤럭시 기기가 시장 점유율이 높으니까, 삼성 기기에서의 EuiccManager 동작을 잘 파악해두면 실무에 바로 활용할 수 있을 거예요. 다만 이 API는 통신사나 eSIM 프로필 서버와의 연동이 필요하기 때문에, 백엔드 인프라까지 함께 고려해야 하는 작업이라는 점도 참고하세요.