【Android開発】プログラムから現在のSDKバージョン（APIレベル）を取得する方法

この記事では、Androidアプリ内から現在のSDKバージョン（APIレベル）をプログラムで取得する方法を、実際のサンプルコードとともにわかりやすく解説します。

使用するクラス：android.os.Build

Androidでは、android.os.Build.VERSION クラスを使うことで、端末のOS情報を簡単に取得できます。主に以下の2つのフィールドを使用します。

• Build.VERSION.SDK_INT … APIレベルを整数値で返します（例：33）
• Build.VERSION.RELEASE … OSバージョンを文字列で返します（例：「13」）

手順1：新規プロジェクトの作成

まず、Android Studioで新しいプロジェクトを作成します。メニューから「File」→「New Project」を選択し、必要な項目を入力してプロジェクトを作成してください。

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

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

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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"
    android:orientation="vertical"
    android:padding="4dp"
    tools:context=".MainActivity">
    <TextView
        android:text=""
        android:id="@+id/textView"
        android:layout_marginTop="30dp"
        android:textStyle="bold"
        android:textSize="24sp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
</LinearLayout>

ここでは、取得したバージョン情報を表示するための TextView を1つ配置しています。

手順3：MainActivity.java の編集

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

import android.os.Build;
import android.os.Bundle;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity {
    TextView textView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.textView);
        int versionAPI = Build.VERSION.SDK_INT;
        String versionRelease = Build.VERSION.RELEASE;
        textView.setText("API Version :" + versionAPI + "\n" + "Version Release : " + versionRelease);
    }
}

ポイント： Build.VERSION.SDK_INT を使うことで、条件分岐によるバージョン別の処理も簡単に実装できます。例えば if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) のように記述すれば、特定のOSバージョン以降でのみ動作する処理を安全に書くことができます。

手順4：AndroidManifest.xml の確認

androidManifest.xml は以下のようになります。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <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レベルとOSバージョンが表示されます。

まとめ

現在のSDKバージョンを取得するには、Build.VERSION.SDK_INT（APIレベル）と Build.VERSION.RELEASE（OSバージョン文字列）を使用します。これらの値を活用することで、OSバージョンに応じた互換性のあるアプリ開発が可能になります。