KotlinでAndroidのAPIバージョンをプログラム的に取得する方法

この記事では、Kotlinを使ってAndroidのAPIバージョンをプログラム的に取得する方法を、サンプルコードとともにわかりやすく解説します。

Androidでは、Build.VERSION.SDK_INTを参照するだけで、実行中のデバイスのAPIレベルを整数値として取得できます。ここでは、ボタンをタップするとAPIレベルを判定し、対応するAndroidバージョン名（KitKat、Lollipopなど）を画面に表示するシンプルなアプリを作成します。

手順1：新規プロジェクトを作成する

Android Studioを起動し、「File」⇒「New Project」を選択します。必要な項目をすべて入力して、新しいプロジェクトを作成しましょう。

手順2：レイアウトファイル（activity_main.xml）を編集する

res/layout/activity_main.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="50dp"
        android:text="Tutorials Point"
        android:textAlignment="center"
        android:textColor="@android:color/holo_green_dark"
        android:textSize="32sp"
        android:textStyle="bold" />

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_above="@id/button"
        android:layout_centerInParent="true"
        android:layout_marginBottom="12sp"
        android:textSize="24sp"
        android:textStyle="bold|italic" />

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="Get Android API Version"
        android:textSize="16sp"
        android:textStyle="bold" />
</RelativeLayout>

手順3：MainActivity.ktを編集する

src/MainActivity.kt に以下のコードを追加します。

import android.os.Build
import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    lateinit var button: Button
    lateinit var textView: TextView
    var androidVersion = 0

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        textView = findViewById(R.id.textView)
        button = findViewById(R.id.button)
        button.setOnClickListener {
            androidVersion = Build.VERSION.SDK_INT
            when (androidVersion) {
                14 -> textView.text = "14, Ice Cream Sandwich"
                15 -> textView.text = "15, Ice Cream Sandwich"
                16 -> textView.text = "16, Jelly Bean"
                17 -> textView.text = "17, Jelly Bean"
                18 -> textView.text = "18, Jelly Bean"
                19 -> textView.text = "19, KitKat"
                21 -> textView.text = "21, Lollipop"
                22 -> textView.text = "22, Lollipop"
                23 -> textView.text = "23, Marshmallow"
                24 -> textView.text = "24, Nougat"
                25 -> textView.text = "25, Nougat"
                26 -> textView.text = "26, Oreo"
                27 -> textView.text = "27, Oreo"
                28 -> textView.text = "28, Pie"
                29 -> textView.text = "29, Android Q"
                else -> Toast.makeText(this@MainActivity, "Not Found", Toast.LENGTH_LONG).show()
            }
        }
    }
}

重要なのは Build.VERSION.SDK_INT の部分です。このプロパティでAPIレベルを取得し、Kotlinのwhen式を使って各バージョンに対応する名称をTextViewに表示しています。該当する値がない場合は、Toastで「Not Found」と通知されます。

なお、上記のコードはAPI 29（Android 10）までの対応表です。API 30以降（Android 11以降）のデバイスではelse節が実行されるため、必要に応じて分岐を追加してください。

手順4：AndroidManifest.xmlを編集する

androidManifest.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11">
    <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>

アプリを実行して動作を確認する

それでは、アプリケーションを実行してみましょう。実機のAndroidスマートフォンがパソコンに接続されていることを前提としています。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。表示された選択肢から自分のモバイルデバイスを選択すると、端末側にアプリの初期画面が表示されます。

ボタンをタップすると、実行中のデバイスのAPIレベルに応じたAndroidバージョン名が画面中央に表示されます。