-
안드로이드 앱 출시 사전준비 — 코드보다 계정이 먼저 막힌다장비설정 등등 2026. 7. 31. 23:36반응형
앱을 만들어 출시하겠다고 마음먹으면 보통 개발 환경부터 세팅한다. Android Studio를 깔고, 프로젝트를 만들고, 화면을 그린다. 그런데 정작 출시 단계에서 발목을 잡는 건 코드가 아니라 계정과 정책 요건인 경우가 많다.
특히 개인 개발자라면 "앱은 다 만들었는데 스토어에 올릴 수가 없는" 상황을 만날 수 있다. 최소 2주가 그냥 날아간다. 이 글은 그 함정들을 미리 정리한 것이다.
1. Google 계정과 개발자 계정은 다르다
가장 먼저 헷갈리는 지점이다.
Google 계정 Play Console 개발자 계정 정체 로그인 신원 그 계정에 붙은 앱 배포 자격 비용 무료 USD $25 일회성 (연회비 없음) 주소 myaccount.google.com play.google.com/console 주민등록증과 사업자등록증의 관계와 비슷하다. 사업자등록은 주민등록 위에 얹히는 것이지 별개 신분이 아니다. Play Console도 기존 Google 계정으로 그대로 로그인하며, 새 아이디를 만드는 게 아니라 "이 사람은 앱을 올릴 수 있다"는 자격을 추가 등록하는 것이다.
그래서 Google 계정 설정을 아무리 찾아도 개발자 메뉴는 나오지 않는다. `play.google.com/console`에 접속했을 때 가입·결제 화면이 뜨면 계정이 없는 것이고, 대시보드가 뜨면 있는 것이다.
어떤 Google 계정으로 등록하느냐가 곧 앱의 소유권이다. 개인 Gmail로 등록하면 그 계정이 앱 통제권을 갖는다. 나중에 회사나 다른 계정으로 옮기려면 Google 지원을 통한 계정 이전 절차를 밟아야 하므로, 처음부터 신중하게 고르는 게 좋다.
2. 최대 함정: 12명 × 14일
개인 개발자에게 이게 가장 크다. 2023년 11월 13일 이후에 만든 개인(Personal) 계정은, 프로덕션 출시 전에 비공개 테스트를 거쳐야 한다. 조건은 '테스터 12명이 14일 연속으로 테스트 상태를 유지'하는 것이다. (원래 20명이었다가 2024년 12월 11일에 12명으로 완화됐다. 기간 14일은 그대로다.)
면제 대상:
계정 유형 12명 x 14일 개인 계정, 2023-11-13 이전 생성 면제 개인 계정, 2023-11-13 이후 생성 필수 조직(Organization) 계정 면제(생성 시점 무관) 지금 새로 계정을 만든다면 당연히 요건 대상이다. 그래서 순서가 중요하다. 흔히 하는 실수는 "앱을 완성한 다음 테스트를 시작하는 것"이다. 그러면 완성 시점부터 2주를 통으로 기다린다. 올바른 순서는 반대다.
화면 하나짜리 껍데기라도 좋으니, 최대한 일찍 비공개 테스트로 올린다. 비공개 테스트 앱은 아무리 미완성이어도 상관없고, 그동안 업데이트를 계속 올려도 14일 카운트는 유지된다. 개발 기간에 2주가 묻히는 것과, 개발이 끝난 뒤 2주를 더 기다리는 것의 차이다.
그리고 실무적으로 제일 귀찮은 건 테스터 12명을 실제로 모으는 일이다. Google 계정을 가진 진짜 사람 12명이 테스트 링크를 눌러야 하고, 14일간 이탈하면 안 된다. 이게 출시일을 결정하는 경우가 많으니 미리 섭외해두자.
3. 예전에 만든 계정이 있다면 — 상태부터 확인
"예전에 개발자 등록했던 것 같은데" 싶다면 로그인해보자. 해지 상태인 경우가 생각보다 흔하다. 그리고 해지 사유에 따라 대응이 정반대다.
상태 의미 재등록 정책위반 종료(Terminated) 정책 위반으로 Google이 영구 종료 금지 정지(Suspended) 일시 정지 항소로 복구 가능 본인확인 미완료 신분증 검증 안 해서 비활성 가능 장기 미사용 해지 앱 없이 방치돼 닫힘 가능 미사용 해지라면 좋은 소식이다. 정책 위반이 아니므로 그냥 다시 $25 내고 등록하면 된다. 항소도 필요 없다. 다만 기존 등록비는 복원되지 않고, 새 계정은 당연히 2023-11-13 이후 생성이라 12명×14일 요건이 새로 붙는다. 옛 계정이 살아있었다면 면제였을 이점이 사라지는 셈이다.
정책위반 종료라면 이야기가 완전히 다르다. 가장 흔하고 치명적인 실수가 다른 Google 계정으로 새로 등록하는 것이다. Google은 신원정보·결제수단·기기·IP로 계정을 연결 추적하며, 우회로 판단되면 새 계정도 즉시 종료하고 기존 항소 가능성까지 없앤다. 절대 하지 말자.
항소에는 기한도 있다. 2026년 1월 28일부터 종료일로부터 180일 이내에 제출해야 하며, 그 이전 종료 건은 2026년 7월 27일까지의 일회성 유예가 있었다.
두 경우를 구분하려면 해지 당시 Google이 보낸 메일을 찾는 게 가장 확실하다. Gmail에서 스팸함까지 포함해 검색하고, "정책 위반 / terminated"인지 "본인 확인 / 비활성 / inactive"인지 문구로 판별한다.
4. 2026년 기술 요건 — 이거 안 맞으면 업로드 자체가 거부된다
앱을 아무리 잘 만들어도 여기서 막히면 올릴 수 없다.
요건 내용 타겟 API 36 2026-08-31부터 신규 앱·업데이트는 `targetSdk 36`(Android 16) 필수. 기존 앱 유지는 API 35. 연장 신청은 2026-11-01까지 16KB 페이지 사이즈 네이티브 코드(.so) 포함 시 16KB 정렬 필수. 유예 종료됨 AAB(.aab) 신규 앱은 APK 업로드 불가, App Bundle만 새로 시작하는 프로젝트라면 처음부터 `targetSdk 36`으로 잡으면 신경 쓸 일이 없다. 문제는 기존 앱을 업데이트하는 경우다.
16KB 요건은 특히 주의할 만하다. 순수 Kotlin/Java 앱은 자동 충족이지만, 결제 SDK·지도·푸시·보안 솔루션처럼 네이티브 라이브러리를 포함한 서드파티를 쓰면 그 라이브러리를 버전 업하지 않는 한 업로드가 거부된다. Play Console의 App Bundle Explorer에서 미리 확인할 수 있다.
5. 개발 환경 — Android Studio가 필수는 아니다
의외로 잘 알려지지 않은 사실인데, 필수는 Android SDK(컴파일러·`adb`·빌드툴)이고 Android Studio는 그걸 감싼 IDE일 뿐이다. 분리해서 설치할 수 있다.
방식 용량 특징 SDK 커맨드라인 툴 + 아무 에디터 ~150MB 가볍고 터미널 중심 IntelliJ IDEA + Android 플러그인 ~1GB Android Studio가 사실 이것 기반 VS Code + Kotlin LSP 가벼움 JetBrains 공식 LSP가 2025년 등장 Android Studio ~1.5GB 표준. 진단·에뮬레이터·프로파일러 완비 Jetpack Compose를 쓰면 XML 레이아웃 에디터가 필요 없고, 실기기를 USB로 연결하면 에뮬레이터(Studio에서 가장 무거운 부분)도 필요 없다. 빌드는 어차피 Gradle wrapper라 IDE와 무관하다. 터미널 중심으로 일하는 백엔드 개발자라면 CLI 조합이 오히려 편할 수 있다.
다만 첫 안드로이드 프로젝트라면 Android Studio를 권한다. Gradle/SDK 버전 충돌 같은 게 터졌을 때 진단 메시지와 자동 수정 제안이 있는 것과 없는 것의 차이가 크다. 락인도 없어서, 나중에 답답하면 같은 프로젝트를 다른 에디터로 그냥 열면 된다.
6. 서명키 — 잃어버리면 앱이 죽는다
가장 조용하고 치명적인 함정이다.
안드로이드 앱은 서명키로 신원을 증명한다. 업로드 키를 분실하면 그 앱은 영원히 업데이트할 수 없다. 코드가 멀쩡해도, 계정이 멀쩡해도 소용없다. 새 패키지명으로 다시 올리고 기존 사용자를 포기하는 수밖에 없다.
- 키스토어 파일과 비밀번호는 최소 두 군데 이상 백업 (비밀번호 관리자 + 별도 저장소)
- 절대 Git에 커밋하지 않기. `~/.gradle/gradle.properties`나 CI Secret으로만 주입
- Play App Signing을 활성화하면 최종 배포키는 Google이 관리하므로, 업로드 키를 잃어도 재설정 요청이 가능하다. 신규 앱은 기본 활성화이니 그대로 두자
versionCode도 비슷한 성격이다. 업로드할 때마다 반드시 증가해야 하고, 한 번 쓴 숫자는 되돌릴 수 없다.
반응형'장비설정 등등' 카테고리의 다른 글
맥북(mac) 기본 메모앱 설정 (1) 2025.01.21 [2023/03/14] Mac zsh에서 VSCode 코틀린 개발환경 세팅하기 (3) 2023.03.15 [2023/03/10] 맥 세팅하기 (1) 2023.03.10