KotlinでAndroid端末のIMEI/ESN番号をプログラム的に取得する方法をわかりやすく解説

この記事では、Kotlinを使用してAndroid端末のIMEI/ESN番号をプログラム的に取得する方法を解説します。IMEI（International Mobile Equipment Identity）は各モバイル機器に割り当てられた世界共通の識別番号で、端末の認証や管理などに利用されます。

開発の全体像

今回作成するのは、ボタンをタップすると端末のIMEI番号を取得して画面に表示するシンプルなアプリです。IMEIの取得にはTelephonyManagerを使用し、実行時にREAD_PHONE_STATE権限をリクエストする処理も実装します。

ステップ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" />

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_above="@id/textView"
        android:layout_centerInParent="true"
        android:layout_marginBottom="20sp"
        android:text="IMEI番号を確認" />

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:hint="ここにIMEI番号が表示されます"
        android:textColor="@android:color/background_dark"
        android:textSize="16sp" />
</RelativeLayout>

ステップ3：MainActivity.ktの実装

src/MainActivity.ktに以下のコードを追加します。ボタンがタップされるとTELEPHONY_SERVICEからTelephonyManagerを取得し、権限が許可されている場合にIMEI番号をTextViewへ表示します。権限が未許可の場合は、実行時に権限リクエストのダイアログを表示します。

import android.Manifest
import android.content.Context
import android.content.pm.PackageManager
import android.os.Bundle
import android.telephony.TelephonyManager
import android.widget.Button
import android.widget.TextView
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import androidx.core.app.ActivityCompat

class MainActivity : AppCompatActivity() {
    lateinit var button: Button
    lateinit var textView: TextView
    private lateinit var IMEINumber: String
    private val REQUEST_CODE = 101

    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 {
            val telephonyManager = getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
            if (ActivityCompat.checkSelfPermission(this@MainActivity,
                    Manifest.permission.READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions(this@MainActivity,
                    arrayOf(Manifest.permission.READ_PHONE_STATE), REQUEST_CODE)
                return@setOnClickListener
            }
            IMEINumber = telephonyManager.deviceId
            textView.text = IMEINumber
        }
    }

    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String?>,
                                            grantResults: IntArray) {
        when (requestCode) {
            REQUEST_CODE -> {
                if (grantResults.isNotEmpty() && grantResults[0] ==
                    PackageManager.PERMISSION_GRANTED) {
                    Toast.makeText(this, "Permission granted.", Toast.LENGTH_SHORT).show()
                } else {
                    Toast.makeText(this, "Permission denied.", Toast.LENGTH_SHORT).show()
                }
            }
        }
    }
}

ステップ4：AndroidManifest.xmlへの権限追加

androidManifest.xmlに以下のコードを追加します。IMEI番号を取得するためには、READ_PHONE_STATEパーミッションの宣言が必須です。

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

アプリの実行と動作確認

それではアプリを実行してみましょう。実際のAndroidスマートフォンをパソコンに接続していることを前提とします。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。接続したモバイルデバイスを選択すると、実機の画面にアプリが起動します。

ボタンをタップして権限を許可すると、画面中央に端末のIMEI番号が表示されます。

実装時の注意点

非推奨APIの扱い： サンプルで使用しているTelephonyManager.getDeviceId()は、APIレベル26（Android 8.0）以降で非推奨となっています。Android 8.0以降をターゲットにする場合は、代わりにgetImei()を使用することを推奨します。

Android 10以降の制限： Android 10（APIレベル29）以降では、プライバシー保護のためサードパーティアプリによるIMEIなどの一意な端末識別子へのアクセスが大幅に制限されています。READ_PRIVILEGED_PHONE_STATE権限はシステムアプリにしか付与されないため、一般アプリでこれらの情報を扱う際は、代替となる識別子（例：SSAIDや独自発行のID）の利用を検討してください。