버전 코드

Android 앱 버전 코드를 지속 가능한 방식으로 관리하기

Android에서는 의도치 않은 다운그레이드를 방지하기 위해 출시할 때마다 앱 버전 코드의 값을 높여야 하며, Google Play에서는 버전 코드에 엄격한 최대 한도를 설정하고 있습니다. 버전 코드 숫자가 급격히 늘어나는 방식을 사용하면 나중에 업데이트를 게시하는 데 제한이 생길 수 있습니다. 앱을 향후 몇 년 동안 계속해서 업데이트할 수 있으려면 앱 버전 관리의 작동 방식을 이해하고 확장 가능한 버전 코드 생성 전략을 도입하는 것이 중요합니다.

앱 버전에 관한 정보

Android 앱은 두 가지 주요 버전 관리 속성을 사용합니다.

• versionCode: 새 버전이 출시될 때마다 값이 커지는 32비트 정수입니다. 이 값은 Android 시스템과 Google Play에서 특정 버전이 다른 버전보다 나중에 출시된 버전인지 판단하는 용도로 내부에서 사용됩니다.
• versionName: 사용자에게 표시되는 버전 번호를 나타내는 문자열입니다(예: '1.0.0', '1.1 베타', '2.0'). 이 정보는 Google Play 및 기기에서 사용자에게 표시됩니다.

버전 코드를 선택하는 방법에 관한 자세한 안내는 여러 APK 및 버전 코드에 관한 Android 개발자 문서를 참고하세요.

최대 버전 코드 한도에 도달한 경우

Google Play에서는 버전 코드에 상한을 두고 있습니다. Google Play에서 허용하는 versionCode의 최댓값은 2,100,000,000입니다. 이 숫자가 상당히 커 보일 수 있지만, 버전 관리가 제대로 이루어지지 않거나 비효율적이면 앱에 다음과 같은 문제가 발생할 수 있습니다.

• 업데이트 게시 불가: 앱의 versionCode가 최대 한도에 도달하거나 이를 초과하면, 해당 애플리케이션의 새로운 APK 또는 App Bundle을 Google Play에 더 이상 업로드할 수 없게 됩니다. 즉, 사용자에게 더 이상 버그 수정, 새로운 기능 또는 호환성 업데이트가 제공되지 않습니다.

최대 버전 코드 한도에 도달하지 않으려면 다음 안내를 따르세요.

• 지속 가능한 versionCode 전략 도입: 버전 코드가 점진적이고 일관되게 높아지도록 하여 사용 가능한 범위를 너무 빨리 넘어서지 않는 versionCode 생성 전략을 수립하세요.
• versionCode 사용량 모니터링: 앱의 versionCode 증가 추이를 정기적으로 확인하여 한도에 도달할 시점을 미리 파악하세요.
• 자동 검사 기능 도입: 빌드 및 출시 프로세스에 검사 단계를 통합하여 versionCode 값이 지나치게 높게 설정된 경우 경고를 보내거나 사용을 방지하도록 설정하세요.

버전 코드의 최대 한도에 도달하면 Google Play에서 지원을 제공해 드릴 수 있습니다. 도움이 필요한 경우 Google Play 지원팀에 문의하세요.