Android Dev Summit, October 23-24: two days of technical content, directly from the Android team. Sign-up for livestream updates.

앱 버전 지정

버전 관리는 앱 업그레이드와 유지보수 전략에서 중요한 구성요소입니다. 버전 관리가 중요한 이유는 다음과 같습니다.

  • 사용자는 기기에 설치된 앱 버전과 설치할 수 있는 업그레이드 버전에 관한 구체적인 정보를 알아야 합니다.
  • 모음 형태로 게시하는 앱을 포함한 다른 앱은 시스템에 앱의 버전을 쿼리하여 호환성을 확인하고 종속성을 파악해야 합니다.
  • 앱을 게시하는 서비스도 사용자에게 버전을 표시할 수 있도록 앱에 버전을 쿼리해야 할 수 있습니다. 또한, 게시 서비스는 앱 버전을 검사하여 호환성을 확인하고 업그레이드/다운그레이드 관계를 설정해야 할 수도 있습니다.

Android 시스템에서는 다운그레이드를 방지하기 위해 앱 버전 정보를 사용합니다. Android 시스템에서는 다운그레이드를 방지하기 위해 앱 버전 정보를 사용합니다. 앱은 버전 제한을 적용해야 하며 버전 제한에 관해 사용자에게 알립니다.

Android 시스템은 빌드 파일의 minSdkVersion 설정에 명시된 시스템 버전 호환성을 적용합니다. 이 설정을 통해 앱은 호환되는 최소 시스템 API를 지정할 수 있습니다. 자세한 정보는 최소 시스템 API 버전 지정하기를 참고하세요.

애플리케이션 버전 정보 설정하기

앱의 버전 정보를 정의하려면 Gradle 빌드 파일에 버전 설정을 위한 값을 설정해야 합니다. 그러면 이러한 값이 빌드 프로세스 도중에 앱의 manifest 파일로 병합됩니다.

참고: 앱이 <manifest> 요소에서 직접 앱 버전을 정의하는 경우 Gradle 빌드 파일의 버전 값이 manifest의 설정을 재정의합니다. 또한, Gradle 빌드 파일에서 이러한 설정을 정의하면 앱의 여러 버전에 서로 다른 값을 지정할 수 있습니다. 유연성을 강화하고 manifest가 병합될 때 이러한 설정을 덮어쓸 수 있는 문제를 방지하려면 <manifest> 요소에서 이러한 속성을 삭제하고 Gradle 빌드 파일에서 버전 설정을 대신 정의해야 합니다.

두 가지 설정을 사용할 수 있으며, 항상 두 설정의 값을 모두 정의해야 합니다.

  • versionCode - 양의 정수이며, 내부 버전 번호로 사용됩니다. 이 번호는 한 버전이 다른 버전보다 최신인지 여부를 판단하는 데만 사용되며, 번호가 높을수록 더욱 최신 버전입니다. 사용자에게 표시되는 버전 번호가 아닙니다. 사용자에게 표시되는 번호는 아래에 나와 있는 versionName 설정으로 지정됩니다. Android 시스템은 versionCode 값을 사용하여 versionCode가 현재 기기에 설치되어 있는 버전보다 낮은 APK를 사용자가 설치하지 못하게 함으로써 다운그레이드를 방지합니다.

    이 값은 양의 정수이므로 다른 앱이 예를 들어, 업그레이드나 다운그레이드 관계를 확인할 때 프로그래밍 방식으로 이 값을 평가할 수 있습니다. 이 값은 원하는 대로 임의의 양의 정수를 설정할 수 있지만 나중의 앱 출시가 더 큰 값을 가져야 합니다. 이미 이전 버전에 사용한 versionCode를 사용하여 Play 스토어에 APK를 업로드할 수 없습니다.

    참고: 일부 특정 상황에서는 versionCode가 최신 버전보다 낮은 앱 버전을 업로드하고 싶을 수도 있습니다. 예를 들어 여러 APK를 게시하는 경우 특정 APK에 versionCode 범위를 사전 설정할 수 있습니다. 여러 APK의 versionCode 값을 할당하는 방법을 자세히 알아보려면 다중 APK 지원을 참고하세요.

    일반적으로 앱의 첫 번째 버전은 versionCode를 1로 설정하여 출시하고, 릴리스가 주 릴리스이든 부 릴리스이든 관계없이 각 릴리스마다 일정하게 값을 증가시킵니다. 즉, versionCode 값은 사용자에게 표시되는 앱 릴리스 버전과 매우 유사할 필요는 없습니다(아래 versionName 참조). 앱과 게시 서비스는 사용자에게 이 버전 값을 표시해서는 안 됩니다.

    경고: Google Play에서 versionCode로 허용하는 가장 큰 값은 2100000000입니다.

  • versionName - 문자열이며, 사용자에게 표시되는 버전 번호로 사용됩니다. 이 설정은 원시 문자열이나 문자열 리소스의 참조로 지정할 수 있습니다.

    값은 문자열로서, <major>.<minor>.<point> 문자열이나 다른 유형의 절대 또는 상대 버전 식별자로 앱 버전을 설명할 수 있습니다. versionName은 사용자에게 표시하는 것 이외에 다른 용도는 없습니다.

모듈의 build.gradle 파일에서 android {} 블록 내에 중첩되어 있는 defaultConfig {} 블록에 이 설정을 포함하여 이 설정의 기본값을 정의할 수 있습니다. 그런 다음, 개별 빌드 유형 또는 제품 버전별로 별도의 값을 정의하여 여러 앱 버전의 이러한 기본값을 재정의할 수 있습니다. 다음 build.gradle 파일에서는 defaultConfig {} 블록과 productFlavors {} 블록 내에 있는 versionCodeversionName 설정을 보여줍니다.

    android {
      ...
      defaultConfig {
        ...
        versionCode 2
        versionName "1.1"
      }
      productFlavors {
        demo {
          ...
          versionName "1.1-demo"
        }
        full {
          ...
        }
      }
    }
    

이 예의 defaultConfig {} 블록에서 versionCode 값은 현재 APK에 앱의 두 번째 릴리스가 포함되어 있다는 것을 나타내고, versionName 문자열은 사용자에게 버전이 1.1로 표시되도록 지정합니다. 이 build.gradle 파일에서는 두 제품 버전 'demo' 및 'full'도 정의합니다. 'demo' 제품 버전에서 versionName이 '1.1-demo'로 정의되어 있으므로 'demo' 빌드는 기본값 대신 이 versionName을 사용합니다. 'full' 제품 버전 블록에서는 versionName이 정의되어 있지 않으므로 기본값 '1.1'을 사용합니다.

Android 프레임워크에서는 시스템에 앱 관련 버전 정보를 쿼리하는 데 사용할 수 있는 API를 제공합니다. 버전 정보를 가져오려면 getPackageInfo(java.lang.String, int) 메서드를 사용합니다(PackageManager).

API 레벨 요구사항 지정하기

앱이 Android 플랫폼의 특정 최소 버전을 요구하는 경우 앱의 build.gradle 파일에서 이러한 버전 요구사항을 API 레벨 설정으로 지정할 수 있습니다. 이러한 설정은 빌드 프로세스 동안 앱의 manifest 파일에 병합됩니다. API 레벨 요구사항을 지정하면 호환되는 Android 플랫폼 버전을 실행하는 기기에만 앱이 설치될 수 있도록 합니다.

참고: 앱의 manifest 파일에서 직접 API 레벨 요구사항을 지정하면 빌드 파일에서 이에 대응되는 설정이 manifest 파일의 설정을 재정의합니다. 또한, Gradle 빌드 파일에서 이러한 설정을 정의하면 앱의 여러 버전별로 서로 다른 값을 지정할 수 있습니다. 유연성을 강화하고 manifest가 병합될 때 발생할 수 있는 덮어쓰기를 방지하려면 <uses-sdk> 요소에서 이러한 속성을 삭제하고 Gradle 빌드 파일에서 API 레벨 설정을 대신 정의해야 합니다.

두 가지 API 레벨 설정을 사용할 수 있습니다.

  • minSdkVersion - 앱이 실행되는 Android 플랫폼의 최소 버전이며, 플랫폼의 API 레벨 식별자에 의해 지정됩니다.
  • targetSdkVersion - 앱이 실행되는 API 레벨을 지정합니다. 경우에 따라 최소 API 레벨에 정의된 것만 사용하도록 제한하기보다는 앱이 대상 API 레벨에서 정의된 manifest 요소나 동작을 사용하도록 허용해야 할 수도 있습니다.

build.gradle 파일에서 기본 API 레벨 요구사항을 지정하려면 android {} 블록 내에 중첩되어 있는 defaultConfig {} 블록에 위에 나온 설정을 하나 이상 추가합니다. 또한 이 설정을 빌드 유형이나 제품 버전에 추가하여 여러 앱 버전의 이러한 기본값을 재정의할 수도 있습니다. 다음 build.gradle 파일에서는 defaultConfig {} 블록에서 기본 minSdkVersiontargetSdkVersion 설정을 지정하고 한 제품 버전의 minSdkVersion을 재정의합니다.

    android {
      ...
      defaultConfig {
        ...
        minSdkVersion 14
        targetSdkVersion 24
      }
      productFlavors {
        main {
          ...
        }
        afterLollipop {
          ...
          minSdkVersion 21
        }
      }
    }
    

앱 설치를 준비할 때 시스템은 이러한 설정 값을 확인하고 시스템 버전과 비교합니다. minSdkVersion 값이 시스템 버전보다 크면 시스템에서 앱 설치가 차단됩니다.

이러한 설정을 지정하지 않으면 시스템에서는 앱이 모든 플랫폼 버전과 호환되는 것으로 간주합니다.

자세한 내용은 <uses-sdk> manifest 요소 문서와 API 레벨 문서를 참조하세요. Gradle 빌드 설정의 경우 빌드 변형 구성을 참고하세요.