KotlinでAndroidのスレッドからToastメッセージを表示する方法

はじめに

このチュートリアルでは、Kotlinを使ってAndroidアプリのスレッド（バックグラウンド処理）からToastメッセージを表示する方法を解説します。実際に動作するサンプルコードを紹介するので、そのままプロジェクトに組み込んで挙動を確認できます。

ステップ1：新規プロジェクトの作成

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

ステップ2：レイアウトファイル（activity_main.xml）の編集

res/layout/activity_main.xml に以下のコードを追加します。画面中央に「Tutorials Point」というテキストを配置するシンプルなレイアウトです。

<?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_centerInParent="true"
        android:layout_marginTop="100dp"
        android:text="Tutorials Point"
        android:textAlignment="center"
        android:textColor="@android:color/holo_green_dark"
        android:textSize="32sp"
        android:textStyle="bold" />

</RelativeLayout>

ステップ3：MainActivity.kt の編集

src/MainActivity.kt に以下のコードを追加します。Toastインスタンスを生成し、別スレッドのループ処理の中で show() を呼び出している点がポイントです。

import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    lateinit var toast: Toast
    lateinit var thread: Thread

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"

        toast = Toast.makeText(this, "This is a toast from Thread", Toast.LENGTH_SHORT)

        thread = Thread(Runnable {
            for (i in 0..999) {
                try {
                    Thread.sleep(1000)
                    toast.show()
                    Thread.sleep(1000)
                } catch (e: InterruptedException) {
                    e.printStackTrace()
                }
            }
        })
        thread.start()
    }
}

ステップ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アイコン（緑色の▶ボタン）をクリックします。デバイス選択ダイアログで接続したモバイル端末を選ぶと、端末の画面にアプリが起動し、約2秒間隔でToastメッセージが繰り返し表示されます。

コードのポイントと注意点

このサンプルでは、Toast.makeText() であらかじめToastオブジェクトを作成しておき、Thread 内のループで1秒ごとに sleep() を挟みながら show() を呼び出しています。これにより、UIスレッド以外からでもToastを表示できることを確認できます。

ただし、一般的にUIの更新はメインスレッドで行うのが原則です。特にAndroid 11（API 30）以降では、Looperを持たないスレッドから直接 show() を呼び出すと例外が発生する場合があります。確実に動作させたい場合は、以下のように runOnUiThread を使ってメインスレッド上で表示する方法がおすすめです。

runOnUiThread {
    toast.show()
}