Versioning Your Applications

Versioning is a critical component of your application upgrade/maintenance strategy.

• Users need to have specific information about the application version that is installed on their devices and the upgrade versions available for installation.
• Other applications including other applications that you publish as a suite need to query the system for your application's version, to determine compatibility and identify dependencies.
• Services through which you will publish your application(s) may also need to query your application for its version, so that they can display the version to users. A publishing service may also need to check the application version to determine compatibility and establish upgrade/downgrade relationships.

사용자는 자신들의 디바이스에 설치되는 애플리케이션 버전와 설치가 가능한 업그레이드 버전에 대한 분명한 정보를 가지는 것이 필요하다.
다른 애플리케이션들은 - 여러분이 하나의 묶음으로써 배포하는 다른 애플리케이션들을 포함함 - 호환성을 결정하고 의존도를 확인하기 위해, 시스템에 애플리케이션 버전을 질의하는 것이 필요하다.
여러분의 애플리케이션을 배포할 때 사용하는 서비스는 여러분의 애플리케이션에게 그것의 버전을 질의할 필요가 있을 수 있다. 이로써 서비스는 사용자들에게 그 버전을 보여줄 수 있다. 또한 배포 서비스는 호환성을 결정하고 업그레이드/다운그레이드 관계를 확립하기 위해서 애플리케이션 버전을 확인할 필요가 있을 수도 있다.

The Android system itself does not ever check the application version information for an application, such as to enforce restrictions on upgrades, compatibility, and so on. Instead, only users or applications themselves are responsible for enforcing any version restrictions for applications themselves.

The Android system does check any system version compatibility expressed by an application in its manifest, in the minSdkVersion attribute. This allows an application to specify the minimum system API with which is compatible. For more information see Specifying Minimum System API Version.

Setting Application Version

To define the version information for your application, you set attributes in the application's manifest file. Two attributes are available, and you should always define values for both of them:

• android:versionCode An integer value that represents the version of the application code, relative to other versions.

  The value is an integer so that other applications can programatically evaluate it, for example to check an upgrade or downgrade relationship. You can set the value to any integer you want, however you should make sure that each successive release of your application uses a greater value. The system does not enforce this behavior, but increasing the value with successive releases is normative.

  Typically, you would release the first version of your application with versionCode set to 1, then monotonically increase the value with each release, regardless whether the release constitutes a major or minor release. This means that the android:versionCode value does not necessarily have a strong resemblence to the application release version that is visible to the user (see android:versionName, below). Applications and publishing services should not display this version value to users.

• android:versionName A string value that represents the release version of the application code, as it should be shown to users.

  The value is a string so that you can describe the application version as a <major>.<minor>.<point> string, or as any other type of absolute or relative version identifier.

  As with android:versionCode, the system does not use this value for any internal purpose, other than to enable applications to display it to users. Publishing services may also extract the android:versionName value for display to users.

android:versionCode ? 다른 버전에 상대적인 애플리케이션 코드 버전을 나타내는 정수integer 값.

이 값은 예를 들어 업그레이드나 다운그레이드 관계를 확인하기 위해서 다른 애플리케이션이 프로그램적으로 그것을 평가할 수 있는 정수integer 값이다. 여러분이 원하는 임의의 정수integer로 그 값을 설정할 수 있다. 하지만 여러분은 애플리케이션 각각의 다음 릴리즈가 더 큰 값을 사용하도록 보장해야 한다. 시스템이 이것을 강제하는 것은 아니지만, 다음 릴리즈 값을 증가시키는 것이 표준이다.

일반적으로, 여러분은 첫 번째 애플리케이션 버전에 versionCode 1을 설정해서 릴리즈한다. 그런 다음에는 그 릴리즈가 메이저 또는 마이너 릴리즈든 상관없이 단순하게 각각의 릴리즈 값을 증가시킨다. 이것은 android:versionCode 값이 사용자에게 보여지는 애플리케이션 릴리즈 버전을 꼭 닮지 않아도 되는 것을 의미한다(아래의 android:versionName를 보라). 애플리케이션과 배포 서비스는 사용자에게 버전 값을 보여주지 않는다.

android:versionName ? 사용자에게 보여져야 하는 애플리케이션 코드의 릴리즈 버전을 나타내는 문자열 값.

이 값은 여러분이 애플리케이션 버전을 설명할 수 있도록 하는 하나의 문자열이다. 그것은 <major>.<minor>.<point> 문자열로써 표현되거나, 또는 절대적 또는 상대적인 어떤 다른 버전 식별자 타입으로 표현된다.

Android:versionCode와는 다르게, 시스템은 이 값을 어떤 내부 목적으로도 사용하지 않는다. 그 보다는 애플리케이션은 이 값을 사용자에게 보여주기 위해 사용한다. 배포 서비스는 또한 사용자에게 보여주기 위해, android:versionName 값을 추출해 낼 수도 있다.

You define both of these version attributes in the <manifest> element of the manifest file.

Here's an example manifest that shows the android:versionCode and android:versionName attributes in the <manifest> element.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.example.package.name"
      android:versionCode="2"
      android:versionName="1.1">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        ...
    </application>
</manifest>

In this example, note that android:versionCode value indicates that the current .apk contains the second release of the application code, which corresponds to a minor follow-on release, as shown by the android:codeName string.

The Android framework provides an API to let applications query the system for version information about your application. To obtain version information, applications use the getPackageInfo(java.lang.String, int) method of PackageManager.

Specifying Your Application's System API Requirements

If your application requires a specific minimum version of the Android platform, or is designed only to support a certain range of Android platform versions, you can specify those version requirements as API Level identifiers in the application's manifest file. Doing so ensures that your application can only be installed on devices that are running a compatible version of the Android system.

To specify API Level requirements, add a <uses-sdk> element in the application's manifest, with one or more of these attributes:

• android:minSdkVersion The minimum version of the Android platform on which the application will run, specified by the platform's API Level identifier.
• android:targetSdkVersion Specifies the API Level on which the application is designed to run. In some cases, this allows the application to use manifest elements or behaviors defined in the target API Level, rather than being restricted to using only those defined for the minimum API Level.
• android:maxSdkVersion The maximum version of the Android platform on which the application is designed to run, specified by the platform's API Level identifier. Important: Please read the <uses-sdk> documentation before using this attribute.

android:minSdkVersion ? 애플리케이션이 실행될 안드로이드 플랫폼의 최소 버전으로 API 레벨 식별자에 의해 지정된다.
android:targetSdkVersion - 애플리케이션이 실행되도록 계획된 API를 지정한다. 몇몇 경우에, 이것은 최초 API 레벨을 위해 정의된 것들만을 사용하는 것으로 제약되기보다는, 애플리케이션이 타켓 API 레벨에 정의된 매니페스트의 엘리먼트 또는 작동형태를 사용하는 것을 가능하게 한다.
android:maxSdkVersion - 애플리케이션이 실행될 안드로이드 플랫폼의 최대 버전으로 API 레벨 식별자에 의해 지정된다. Important: 이 애트리뷰트를 사용하기 전에 <uses-sdk> 문서를 읽어라.

When preparing to install your application, the system checks the value of this attribute and compares it to the system version. If the android:minSdkVersion value is greater than the system version, the system aborts the installation of the application. Similarly, the system installs your application only if its android:maxSdkVersion is compatible with the platform version.

If you do not specify these attributes in your manifest, the system assumes that your application is compatible with all platform versions, with no maximum API Level.

To specify a minimum platform version for your application, add a <uses-sdk> element as a child of <manifest>, then define the android:minSdkVersion as an attribute.

For more information, see the <uses-sdk> manifest element documentation and the API Levels document.