Android 앱 버전 이름(versionName) 가져오는 방법 완벽 가이드

이 튜토리얼에서는 PackageManager를 활용해 Android 애플리케이션의 버전 이름(versionName)을 가져와 화면에 표시하는 방법을 단계별로 알아봅니다.

1단계: 새 프로젝트 생성하기

Android Studio에서 새 프로젝트를 생성합니다. 상단 메뉴에서 File ⇒ New Project를 선택한 후, 프로젝트 생성에 필요한 모든 세부 정보(프로젝트 이름, 패키지명, 언어 등)를 입력합니다.

2단계: 레이아웃 파일 작성하기

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android"
   xmlns:app = "https://schemas.android.com/apk/res-auto"
   xmlns:tools = "https://schemas.android.com/tools"
   android:layout_width = "match_parent"
   android:gravity = "center"
   android:layout_height = "match_parent"
   tools:context = ".MainActivity"
   android:orientation = "vertical">
   <TextView
      android:id = "@+id/text"
      android:textSize = "30sp"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content" />
</LinearLayout>

위 코드에서는 앱의 버전 이름을 화면에 표시하기 위해 TextView 하나를 배치했습니다. 레이아웃은 수직 방향 LinearLayout으로 구성되며, gravity 속성을 center로 지정해 텍스트가 화면 중앙에 나타나도록 설정했습니다.

3단계: MainActivity 코드 작성하기

src/MainActivity.java 파일에 아래 코드를 추가합니다.

package com.example.myapplication;
import android.app.ActivityManager;
import android.content.Context;
import android.content.pm.PackageInfo;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.telephony.TelephonyManager;
import android.view.WindowManager;
import android.widget.TextView;
import java.util.List;
public class MainActivity extends AppCompatActivity {
    TextView textView;
    @RequiresApi(api = Build.VERSION_CODES.P)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getWindow().setFlags(WindowManager.LayoutParams.FLAG_BLUR_BEHIND,
        WindowManager.LayoutParams.FLAG_BLUR_BEHIND);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.text);
        PackageManager pm = getApplicationContext().getPackageManager();
        String pkgName = getApplicationContext().getPackageName();
        PackageInfo pkgInfo = null;
        try {
            pkgInfo = pm.getPackageInfo(pkgName, 0);
        } catch (PackageManager.NameNotFoundException e) {
            e.printStackTrace();
        }
      String ver = pkgInfo.versionName;
      textView.setText("" +ver);
   }
}

핵심 코드 설명

버전 정보를 가져오는 핵심 로직은 다음과 같습니다.

① PackageManager 인스턴스 생성 — getApplicationContext().getPackageManager()를 호출해 현재 애플리케이션의 PackageManager 객체를 얻습니다.

② 패키지 이름 조회 — getApplicationContext().getPackageName()으로 현재 앱의 패키지명을 가져옵니다.

③ PackageInfo 획득 — pm.getPackageInfo(pkgName, 0) 메서드를 호출하면 해당 패키지의 전체 정보가 담긴 PackageInfo 객체가 반환됩니다. 이때 존재하지 않는 패키지를 요청할 경우 NameNotFoundException이 발생할 수 있으므로 try-catch 문으로 예외 처리를 해주는 것이 좋습니다.

④ versionName 추출 및 출력 — pkgInfo.versionName 필드에 앱의 버전 이름이 문자열로 저장되어 있으며, 이를 TextView에 설정해 화면에 표시합니다.

참고: build.gradle의 defaultConfig 블록에 선언된 versionCode는 정수형 내부 버전 번호이고, versionName은 사용자에게 보여지는 버전 문자열입니다. 필요하다면 pkgInfo.versionCode를 통해 버전 코드도 함께 가져올 수 있습니다.

4단계: 애플리케이션 실행하기

이제 애플리케이션을 실행해 보겠습니다. 실제 Android 스마트폰이 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 후, 툴바에서 Run(실행) 아이콘을 클릭하세요. 옵션 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 다음과 같이 앱의 기본 화면과 함께 버전 이름이 표시됩니다.

마무리

이처럼 PackageManager와 PackageInfo만 활용하면 몇 줄의 코드로 간단히 앱의 버전 이름을 가져올 수 있습니다. 이 기법은 설정 화면에 앱 버전을 표시하거나, 업데이트 여부를 확인하는 로직을 구현할 때 매우 유용하게 사용됩니다. 추가로 API 28(Pie) 이상에서는 getLongVersionCode() 메서드를 사용해 더 정밀한 버전 코드를 확인할 수도 있습니다.