앱 버전 지정

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

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

Android 시스템은 앱 버전 정보를 사용하여 타사 앱의 업그레이드/다운그레이드 또는 호환성에 제한을 가하지 않습니다. 대신, 개발자가 앱 내부에 버전 제한을 적용하거나 사용자에게 버전 제한과 한계를 알려야 합니다. 그러나 Android 시스템은 빌드 파일의 minSdkVersion 설정에 명시된 시스템 버전 호환성을 적용합니다. 이 설정을 통해 앱은 호환되는 최소 시스템 API를 지정할 수 있습니다. 자세한 정보는 최소 시스템 API 버전 지정을 참조하세요.

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

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

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

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

  • versionCode - 정수이며, 내부 버전 번호로 사용됩니다. 이 번호는 하나의 버전이 다른 버전보다 최신인지 여부를 판단하는 데만 사용되며, 번호가 높을수록 더욱 최신 버전입니다. 이는 사용자에게 표시되는 버전 번호가 아니고, 사용자에게 표시되는 번호는 아래에 나와 있는 versionName으로 설정됩니다.

    이 값은 정수이므로 다른 앱이 예를 들어, 업그레이드나 다운그레이드 관계를 확인할 때 프로그래밍 방식으로 이 값을 평가할 수 있습니다. 이 값은 원하는 정수로 설정할 수 있지만 각 후속 앱 릴리스가 더 큰 값을 사용해야 합니다. 시스템은 이 동작을 강제하지 않지만, 후속 릴리스에서 값을 증가시키는 것이 규칙입니다.

    일반적으로 앱의 첫 번째 버전은 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를 제공합니다. 버전 정보를 가져오려면 PackageManagergetPackageInfo(java.lang.String, int) 메서드를 사용합니다.

참고: Instant Run을 사용하면 Android Studio가 versionCodeMAXINT로, versionName"INSTANTRUN"으로 자동으로 설정합니다.

API 레벨 요구사항 지정

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

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

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

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

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

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

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

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

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