[Android] AlertDialogを使ってユーザーに警告を表示する-Androidアプリ個人開発者の実践的アドバイス集

AlertDialogを使って、ユーザーに対して簡単にメッセージや選択肢を提示するポップアップウィンドウ（アラートダイアログ）を表示することができます。
  
まずは、ダイアログを表示するために以下のAndroidXライブラリをインポートします。

```kotlin  
import androidx.appcompat.app.AlertDialog
```

<br>
  
## AlertDialogでタイトルとメッセージを設定する

タイトルとメッセージの指定はとても簡単にできます。
  
kotlinでの簡単なコード例は以下の通りです。Builderにはコンテキストを与えますので、フラグメントの場合は<code>requireContext()</code>を使用して渡します。

```kotlin
AlertDialog.Builder(requireContext())
	.setTitle("警告文")
	.setMessage("警告文です。")
	.setPositiveButton("OK") { dialog, _ ->
		dialog.dismiss()
}.show()
```
  
上記の例では、タイトルが「警告文」でメッセージが「警告文です。」のアラートダイアログを作成します。そして、OKボタンがクリックされたときにダイアログを閉じる動作をします。

これで簡単にアラートダイアログを表示できました。
  
  
<br>
  
## アプリケーション起動後の初回のみダイアログを表示する

何かの動作に対して、アプリケーションを起動後の初回のみ警告を表示したい時、<code>SharedPreferences</code>を活用すればそれが容易に実現できます。
  
ここでは、<code>SharedPreferences</code>と<code>onTextChanged</code>を組み合わせて、EditTextにテキストが始めて16文字以上入力されたときにアラートダイアログを表示する例を紹介します。この例では、フラグメントを使うと仮定します。

まず、MainActivityのonCreate内で以下の記述をします。

```kotlin
private lateinit var sharedPreferences: SharedPreferences

override fun onCreate(savedInstanceState: Bundle?) {
  ...
	sharedPreferences = this.getSharedPreferences(SharedPreferencesKey.MyPrefs.name, Context.MODE_PRIVATE)
	val editor = sharedPreferences.edit()
	editor.putBoolean(SharedPreferencesKey.IsFirstRunAfterLaunching.name, true)
}
```

SharedPreferencesの使い方、そして参照しているキー（この例だと<code>IsFirstRunAfterLaunching</code>）の値の取得や格納については以下の記事をご参照ください。
  
  
<iframe class="hatenablogcard" style="width:100%;height:175px;margin:15px 0;max-width:680px;" title="%title%" src="https://hatenablog-parts.com/embed?url=https://androidappsadvices.blogspot.com/2023/05/sharedpreferences.html" frameborder="0" scrolling="no"></iframe>
  
<br>
  
次に、任意のフラグメントでアラートダイアログを表示するための記述をします。
  
onViewCreated内で以下のkotlinコードを記述します。
  
```kotlin
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
  ...
	EditText.addTextChangedListener(object : TextWatcher {
        override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) {}
        override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) {
            // display #of entered digits
            val length = s?.length ?: 0

if (length > 15 && sharedPreferences.getBoolean(SharedPreferencesKey.IsFirstRunAfterLaunching.name, true)) {
                AlertDialog.Builder(requireContext())
                .setTitle("警告文")
                .setMessage("16文字以上が入力されました。")
                .setPositiveButton("OK") { dialog, _ ->

val editor = sharedPreferences.edit()
                    editor.putBoolean(SharedPreferencesKey.IsFirstRunAfterLaunching.name, false)
                    editor.apply()

dialog.dismiss()
                }.show()
            }
        }

override fun afterTextChanged(s: Editable?) {}
	})
  
 ... 
}
```
  
<code>addTextChangedListener</code>、<code>onTextChanged</code>の使い方については、以下の記事をご参照ください。

<br>
  
特に目新しいことはないのですが、IsFirstRunAfterLaunchingの値の変化と、コードの動作の概要について説明します。
  
1. まず、onCreate内でtrueに設定されています。
2. 次に、EditTextに入力された文字数が16文字以上になった際にIsFirstRunAfterLaunchingはtrueのままであるため、onTextChanged内のif文が真になります。
3. それにより、アラートダイアログが表示されます。
4. その後、OKボタンがクリックされると、IsFirstRunAfterLaunchingはfalseに設定されます。その結果、二回目以降はonTextChanged内のif文は偽になり、アラートダイアログは表示されません。
  
<br>
  
## アプリケーション再起動後の初回にもダイアログを表示する
  
アプリケーションの起動後の初回だけでなく、再起動したときにも同様のアラートダイアログを表示したい場合には、<code>onDestroy()</code>内でonCreate()で記述した内容と同じようにSharedPreferencesの値を更新してあげれば良いだけです。
  
```kotlin
private lateinit var sharedPreferences: SharedPreferences

override fun onDestroy() {
  ...
	sharedPreferences = this.getSharedPreferences(SharedPreferencesKey.MyPrefs.name, Context.MODE_PRIVATE)
	val editor = sharedPreferences.edit()
	editor.putBoolean(SharedPreferencesKey.IsFirstRunAfterLaunching.name, true)
}
```
  
<br>

## 最後に
  
AlertDialogの使い方と、それをSharedPreferences等と組み合わせて使う方法を紹介しました。

[Android] AlertDialogを使ってユーザーに警告を表示する

0 件のコメント:

コメントを投稿

このブログを検索

ラベル

自己紹介

人気の投稿

不正行為を報告

リリースしたAndroidアプリ