【Android開発】システムバージョン（OSバージョン・APIレベル）を確認・表示する方法

Androidのシステムバージョンをプログラムで確認する方法

この記事では、Androidアプリ内で端末のシステムバージョン（OSバージョン・コードネーム・APIレベル）を取得し、画面に表示する方法を、実際のコード例とともにステップごとに解説します。バージョンによって処理を分岐させたい場合などに役立つテクニックです。

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

Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な項目（プロジェクト名、パッケージ名、保存先など）を入力して、新しいプロジェクトを作成してください。

手順2：レイアウトファイル（activity_main.xml）にコードを追加する

res/layout/activity_main.xml に以下のコードを記述します。画面中央に配置した TextView が、バージョン情報の表示に使われます。

<?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"
    android:padding="16dp"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:textAlignment="center"
        android:textSize="24sp"
        android:textStyle="bold" />

</RelativeLayout>

手順3：MainActivity.javaにコードを追加する

src/MainActivity.java に以下のコードを記述します。Build.VERSION クラスを使ってOSバージョンとAPIレベルを取得し、正規表現でメジャーバージョンを取り出してコードネームを判定しています。

import androidx.appcompat.app.AppCompatActivity;
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);

        double release = Double.parseDouble(Build.VERSION.RELEASE.replaceAll("(\\d+[.]\\d+)(.*)", "$1"));
        String codeName = "Unsupported";

        if (release >= 4.1 && release < 4.4) codeName = "Jelly Bean";
        else if (release < 5) codeName = "Kit Kat";
        else if (release < 6) codeName = "Lollipop";
        else if (release < 7) codeName = "Marshmallow";
        else if (release < 8) codeName = "Nougat";
        else if (release < 9) codeName = "Oreo";

        textView.setText(codeName + " Version " + release + ", API LEVEL: " + Build.VERSION.SDK_INT);
    }
}

ポイント：

• Build.VERSION.RELEASE … OSのバージョン文字列（例：「8.0.0」「9」）を返します。
• Build.VERSION.SDK_INT … APIレベルを整数値で返します（例：Oreoなら26〜27）。
• 上記のサンプルはOreoまでの判定にとどまっていますが、Pie（9）以降の条件を同じ要領で追加すれば、新しいバージョンにも対応できます。

手順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スマートフォンをUSBケーブルでPCに接続しておいてください。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーのRun（実行）アイコンをクリックします。デバイス選択ダイアログが表示されたら、接続した実機を選択して実行します。

アプリが起動すると、端末の画面中央にコードネーム・バージョン番号・APIレベルが次のように表示されます。

まとめ

Build.VERSION.RELEASE と Build.VERSION.SDK_INT を使えば、数行のコードで端末のOSバージョン情報を簡単に取得できます。バージョンごとの機能制御や互換性対応など、実用的な場面でぜひ活用してみてください。