Computer >> 컴퓨터 >  >> 프로그래밍 >> Android

안드로이드에서 기기의 기본 SDK 버전 확인하는 방법


이 튜토리얼에서는 안드로이드 앱에서 기기의 기본 SDK(소프트웨어) 버전 정보를 가져오는 방법을 단계별로 살펴봅니다. TelephonyManager 클래스의 getDeviceSoftwareVersion() 메서드를 활용하는 방식이며, 위험 권한(dangerous permission) 요청과 처리 과정까지 함께 다룹니다.

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>

위 레이아웃에는 기기의 SDK 버전 정보를 화면에 출력할 TextView 하나가 배치되어 있습니다.

3단계 — MainActivity 코드 작성

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

package com.example.myapplication;

import android.Manifest;
import android.content.Context;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.NonNull;
import android.support.annotation.RequiresApi;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.telephony.TelephonyManager;
import android.widget.TextView;

import static android.Manifest.permission.READ_PHONE_NUMBERS;
import static android.Manifest.permission.READ_PHONE_STATE;
import static android.Manifest.permission.READ_SMS;

public class MainActivity extends AppCompatActivity {
   private static final int PERMISSION_REQUEST_CODE = 100;
   TextView textView;
   TelephonyManager telephonyManager;

   @RequiresApi(api = Build.VERSION_CODES.P)
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      textView = findViewById(R.id.text);
      telephonyManager = (TelephonyManager) this.getSystemService(Context.TELEPHONY_SERVICE);
      if (ActivityCompat.checkSelfPermission(this, READ_SMS) != PackageManager.PERMISSION_GRANTED &&
         ActivityCompat.checkSelfPermission(this, READ_PHONE_NUMBERS) !=
         PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this,
         READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED) {
         ActivityCompat.requestPermissions(this, new String[]{READ_SMS, READ_PHONE_NUMBERS, READ_PHONE_STATE}, PERMISSION_REQUEST_CODE);
      } else {
         textView.setText(""+telephonyManager.getDeviceSoftwareVersion());
      }
   }

   @RequiresApi(api = Build.VERSION_CODES.P)
   @Override
   public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
      super.onRequestPermissionsResult(requestCode, permissions, grantResults);
      switch (requestCode) {
         case PERMISSION_REQUEST_CODE:
            if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_SMS) !=
               PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this,
               Manifest.permission.READ_PHONE_NUMBERS) != PackageManager.PERMISSION_GRANTED &&
               ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_PHONE_STATE) !=
               PackageManager.PERMISSION_GRANTED) {
               return;
            } else {
               textView.setText(""+telephonyManager.getDeviceSoftwareVersion());
            }
      }
   }
}

위 코드의 핵심 흐름은 다음과 같습니다.

  • 권한 확인: READ_SMS, READ_PHONE_NUMBERS, READ_PHONE_STATE 권한이 부여되었는지 먼저 검사합니다.
  • 권한 요청: 권한이 없으면 requestPermissions()를 호출해 사용자에게 권한 승인을 요청합니다.
  • 버전 표시: 권한이 이미 있거나 승인되면 telephonyManager.getDeviceSoftwareVersion()의 반환값을 TextView에 출력합니다.

4단계 — 매니페스트 파일 설정

AndroidManifest.xml 파일에 아래 코드를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
package="com.example.myapplication">

   <uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />
   <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:roundIcon="@mipmap/ic_launcher_round"
      android:supportsRtl="true"
      android:theme="@style/AppTheme">
      <activity android:name=".MainActivity">
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>
</manifest>

매니페스트에 READ_PHONE_NUMBERS와 READ_PHONE_STATE 권한을 반드시 선언해야 합니다. 이 권한 선언이 누락되면 런타임에 SecurityException이 발생할 수 있습니다.

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하고, 옵션 목록에서 자신의 모바일 기기를 선택하세요. 그러면 기기 화면에 아래와 같이 기기의 소프트웨어 버전 정보가 표시됩니다.

안드로이드에서 기기의 기본 SDK 버전 확인하는 방법

참고: 순수한 SDK(API) 버전만 필요하다면

전화 관련 권한 없이 운영체제의 API 레벨(SDK 버전)만 확인하고 싶다면 Build.VERSION.SDK_INT를 사용하는 것이 훨씬 간단합니다.

int sdkVersion = Build.VERSION.SDK_INT; // 예: 33 (Android 13)

이 값은 별도의 권한 없이 어디서든 접근할 수 있으며, 특정 안드로이드 버전 이상에서만 기능을 실행하도록 조건 분기를 걸 때 유용하게 활용됩니다.