Google Play 배포 시 자꾸 막힐 때

로컬에서 괜찮았던 설정도 배포 환경에서는 다르게 보일 수 있다. 특히 Google Play 배포는 여러 검증 단계를 거치기 때문에 문제가 명확하지 않을 수 있다.

문제를 체계적으로 추적하려면 먼저 사용자가 보는 모습과 개발자가 보는 신호를 따로 생각해야 한다. 사용자는 화면만 보지만, 개발자는 로그와 설정까지 모두 확인할 수 있다.

사용자가 보는 모습 먼저 정리하기

배포 후 실제 사용자가 뭘 볼까. 앱이 설치되지 않는가, 설치는 되지만 실행이 안 되는가, 실행은 되지만 기능이 작동하지 않는가.

• 설치 불가: 권한 문제, 호환성 문제
• 실행 불가: 권한 구성 오류
• 기능 미작동: 설정 값 오류, API 연결 실패

각 단계별로 뭐가 안 되는지 구분하면 다음 수정이 명확해진다.

개발자가 보는 신호 확인하기

빌드 결과, 배포 검증 단계에서 나오는 경고나 에러를 놓치면 안 된다.

npm run build

빌드 로그를 끝까지 읽고, 경고가 있는지 확인한다. 배포 과정에서 Play Console이 알려주는 메시지도 모두 기록해둔다.

로컬과 배포 환경의 차이 정확하게 파악하기

로컬에서는 모든 권한이 있지만, 배포 후에는 구글이 정한 규칙에 따라야 한다.

• 앱 서명
• 권한 선언
• API 호출 설정
• 보안 정책

이런 차이들이 배포에서 문제를 일으킨다. 먼저 이 차이를 정리해야 한다.

배포 전에 고정할 값들

배포 후에는 수정하기 어려운 값들이 있다. 배포 전에 정상 상태를 꼭 확인한다.

1. 빌드가 정상인가
2. 모든 필수 설정이 완료됐는가
3. 권한 선언이 정확한가

수정 후 확인하는 작은 루틴

한 가지 설정을 수정했다면, 바로 다음 배포를 시도하지 말고 몇 가지를 먼저 확인한다.

1. 수정 전 상태를 기록했는가
2. 뭘 바꿨는가
3. 로그에 새로운 경고가 생겼는가
4. 배포 검증 단계에서 new issue가 있는가

작은 확인이 쌓이면 배포가 성공할 가능성이 훨씬 높아진다. 남겨진 기록이 있으면 나중에 비슷한 문제가 생겼을 때 훨씬 빠르게 처리할 수 있다.