バックグラウンドで動作しているアプリにテストメッセージを送信する

FCM を使用する手始めとして、アプリがバックグラウンドで動作しているときに Notifications Composer から開発デバイスにテスト通知メッセージを送信するという最もシンプルなユースケースを作成します。このページには、このチュートリアルに必要なセットアップから検証までのすべての手順が記載されています。Android クライアントアプリでの FCM の設定がすでに済んでいる場合は、一部の手順を省略できます。

SDK を設定する

このセクションで説明しているタスクは、他の Firebase 機能をアプリですでに有効にしている場合は完了している可能性があります。

準備

Android Studio の最新バージョンをインストールするか、更新してください。
Android アプリを確認してください。
- API レベル 16（Jelly Bean）以降が対象です。
- Gradle 4.1 以降を使用します。
アプリを実行するためのデバイスまたはエミュレータを設定します。
- エミュレータでは Google Play のエミュレータイメージを使用する必要があります。
Google アカウントを使用して Firebase にログインします。

Android アプリプロジェクトをまだ用意していない場合、Firebase プロジェクトを試すだけであれば、クイックスタートサンプルをダウンロードしてご利用いただけます。

Firebase プロジェクトを作成

Android アプリに Firebase を追加する前に、Android アプリに接続するための Firebase プロジェクトを作成します。Firebase プロジェクトの詳細については、Firebase プロジェクトについて理解するをご覧ください。

Firebase プロジェクトを作成する

Firebase コンソールで [プロジェクトを追加] をクリックし、[プロジェクト名] を選択するか、新しいプロジェクト名を入力します。

既存の Google Cloud Platform（GCP）プロジェクトがある場合は、[プロジェクト名] プルダウンメニューからプロジェクトを選択できます。既存のプロジェクトがない場合は、新しいプロジェクト名を入力してください。
（省略可）[プロジェクト ID] を編集します。

Firebase プロジェクトには一意の ID が自動的に割り当てられます。Firebase がプロジェクト ID を使用する仕組みについては、Firebase プロジェクトについて理解するをご覧ください。

Firebase プロジェクトのリソースがプロビジョニングされた後にプロジェクト ID を変更することはできません。
特定の識別子を使用するには、この設定手順でプロジェクト ID を編集する必要があります。
Firebase コンソールで残りの設定手順を実施した後、[プロジェクトを作成]（既存の Google プロジェクトを使用する場合は [Firebase を追加]）をクリックします。

Firebase プロジェクトのリソースが自動的にプロビジョニングされます。処理が完了すると、Firebase コンソールに Firebase プロジェクトの概要ページが表示されます。

Firebase を使用してアプリを登録する

Firebase プロジェクトを作成したら、プロジェクトに Android アプリを追加できます。

Firebase プロジェクトにアプリを追加するベストプラクティス、考慮事項（複数のビルドバリエーションの扱い方など）の詳細については、Firebase プロジェクトについて理解するをご覧ください。

Firebase コンソールの [Project Overview] ページの中央にある Android アイコンをクリックして設定ワークフローを起動します。

すでに Firebase プロジェクトにアプリまたはゲームを追加している場合は、[アプリを追加] をクリックするとプラットフォームのオプションが表示されます。
アプリケーション ID を [Android パッケージ名] に入力します。

アプリが実際に使用している ID を入力してください。アプリを Firebase プロジェクトに登録した後で、この値を追加または変更することはできません。
- アプリケーション ID はパッケージ名と呼ばれることもあります。
- このアプリケーション ID はモジュール（アプリレベル）の Gradle ファイル（通常は app/build.gradle）内に記載されています（アプリケーション ID の例: com.yourcompany.yourproject）。
（省略可）設定ワークフローの指示に従って他のアプリ情報を入力します。

ニックネームは内部用の簡便な ID であり、Firebase コンソールでのみ表示されます。

注: SHA-1 情報は Google ログインまたは電話番号ログインと Firebase Dynamic Links を使用する場合に Firebase Authentication で必要となります。
[アプリを登録] をクリックします。

Firebase 構成ファイルを追加する

Firebase Android 構成ファイルをアプリに追加します。
1. [Download google-services.json] をクリックして、Firebase Android 構成ファイル（google-services.json）を入手します。
  
  Firebase Android 構成ファイルはいつでも再ダウンロードできます。
2. 構成ファイルをアプリのモジュール（アプリレベル）ディレクトリに移動します。
注: Firebase 構成ファイルには、プロジェクト用の機密ではない一意の識別子が含まれています。
構成ファイルの詳細については、Firebase プロジェクトについて理解するをご覧ください。
アプリで Firebase プロダクトを有効にするには、Gradle ファイルに google-services プラグインを追加します。
1. ルートレベル（プロジェクトレベル）の Gradle ファイル（build.gradle）に、Google サービスプラグインを含めるためのルールを追加します。Google の Maven リポジトリがあることも確認してください。
```
buildscript {
  // ...
  dependencies {
    // ...
    // Add the following line:
    classpath 'com.google.gms:google-services:4.2.0'  // Google Services plugin
  }
}

allprojects {
  // ...
  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}
```
2. モジュール（アプリレベル）の Gradle ファイル（通常は app/build.gradle）の末尾に以下の行を追加します。
```
apply plugin: 'com.android.application'

android {
  // ...
}

// Add the following line to the bottom of the file:
apply plugin: 'com.google.gms.google-services'  // Google Play services Gradle plugin
```

アプリに Firebase SDK を追加する

サポートされている Firebase プロダクトを Android アプリに追加できます。Firebase 向け Google アナリティクス機能を提供するコア Firebase SDK（com.google.firebase:firebase-core）から始めることをおすすめします。

モジュール（アプリレベル）の Gradle ファイル（通常は app/build.gradle）に、コア Firebase SDK の依存関係を追加します。

dependencies {
 // ...
 implementation 'com.google.firebase:firebase-core:16.0.8'

 // Getting a "Could not find" error? Make sure that you've added
 // Google's Maven repository to your root-level build.gradle file
}

（省略可）使用するその他の Firebase ライブラリの依存関係を追加します。

一部の Android 向け Firebase SDK では、代わりに Kotlin 拡張ライブラリが提供されている場合があります。
アプリを同期して、すべての依存関係に必要なバージョンがあることを確認します。
アプリを実行して、Firebase の統合に成功したという認証を Firebase に送信します。

デバイスログには、初期化が完了したという Firebase の認証が表示されます。ネットワークにアクセスできるエミュレータでアプリを実行した場合、Firebase コンソールでアプリの接続が完了したことが通知されます。

登録トークンにアクセスする

特定のデバイスにメッセージを送信するには、そのデバイスの登録トークンを知っておく必要があります。このチュートリアルを完了するには、Notifications コンソールのフィールドにトークンを入力する必要があるため、トークンを取得したら、必ずコピーするか安全に保管しておく必要があります。

アプリを初めて起動すると、クライアントアプリのインスタンスの登録トークンが FCM SDK によって生成されます。単一のデバイスをターゲットにする場合、またはデバイスグループを作成する場合は、FirebaseMessagingService を拡張して onNewToken をオーバーライドすることで、このトークンにアクセスする必要があります。

このセクションでは、トークンを取得する方法とトークンに対する変更をモニタリングする方法について説明します。トークンは最初の起動後にローテーションされている可能性があるため、更新された最新の登録トークンを取得することを強くおすすめします。

登録トークンは次のような場合に変更されることがあります。

アプリによってインスタンス ID が削除される場合
アプリが新しいデバイスで復元される場合
ユーザーがアプリをアンインストール / 再インストールする場合
ユーザーがアプリのデータを消去する場合

現在の登録トークンの取得

現在のトークンを取得する必要がある場合は、FirebaseInstanceId.getInstance().getInstanceId() を呼び出します。

Java
Android

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                if (!task.isSuccessful()) {
                    Log.w(TAG, "getInstanceId failed", task.getException());
                    return;
                }

                // Get new Instance ID token
                String token = task.getResult().getToken();

                // Log and toast
                String msg = getString(R.string.msg_token_fmt, token);
                Log.d(TAG, msg);
                Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
            }
        });MainActivity.java

Kotlin
Android

FirebaseInstanceId.getInstance().instanceId
        .addOnCompleteListener(OnCompleteListener { task ->
            if (!task.isSuccessful) {
                Log.w(TAG, "getInstanceId failed", task.exception)
                return@OnCompleteListener
            }

            // Get new Instance ID token
            val token = task.result?.token

            // Log and toast
            val msg = getString(R.string.msg_token_fmt, token)
            Log.d(TAG, msg)
            Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
        })MainActivity.kt

トークンの生成のモニタリング

onNewToken コールバックは、新しいトークンが生成されるたびに呼び出されます。

Java
Android

/**
 * Called if InstanceID token is updated. This may occur if the security of
 * the previous token had been compromised. Note that this is called when the InstanceID token
 * is initially generated so this is where you would retrieve the token.
 */
@Override
public void onNewToken(String token) {
    Log.d(TAG, "Refreshed token: " + token);

    // If you want to send messages to this application instance or
    // manage this apps subscriptions on the server side, send the
    // Instance ID token to your app server.
    sendRegistrationToServer(token);
}MyFirebaseMessagingService.java

Kotlin
Android

/**
 * Called if InstanceID token is updated. This may occur if the security of
 * the previous token had been compromised. Note that this is called when the InstanceID token
 * is initially generated so this is where you would retrieve the token.
 */
override fun onNewToken(token: String?) {
    Log.d(TAG, "Refreshed token: $token")

    // If you want to send messages to this application instance or
    // manage this apps subscriptions on the server side, send the
    // Instance ID token to your app server.
    sendRegistrationToServer(token)
}MyFirebaseMessagingService.kt

トークンを取得したら、それをアプリサーバーに送信して、適切な方法で保管できます。API の詳細については、インスタンス ID API リファレンスをご覧ください。

テスト通知メッセージを送信する

ターゲットデバイスでアプリをインストールして実行します。
アプリがデバイスのバックグラウンドで動作していることを確認します。
Notifications Composer を開き、[新しいメッセージ] を選択します。
メッセージテキストを入力します。
[デバイスでテスト] を選択します。
[FCM 登録トークンを追加] というラベルの付いたフィールドで、このガイドの前のセクションで取得した登録トークンを入力します。
[テスト] をクリックします。

[テスト] をクリックすると、アプリをバックグラウンドで実行しているターゲットクライアントデバイスのシステム通知トレイに通知が届きます。

アプリへのメッセージ配信については、FCM レポートダッシュボードをご覧ください。このダッシュボードには、Android アプリの「インプレッション」（ユーザーが表示した通知）のデータとともに、iOS と Android のデバイスで送信および開封されたメッセージの数が記録されています。

次のステップ

フォアグラウンドで動作しているアプリへのメッセージの送信

バックグラウンドで動作しているアプリに通知メッセージが正常に送信されたら、Android アプリでメッセージを受信するを参照して、フォアグラウンドで動作しているアプリへのメッセージの送信を試します。

通知メッセージ以外の動作

通知メッセージだけでなく、他のより高度な動作をアプリに追加する場合は、以下を確認してください。

バックグラウンドで動作しているアプリにテスト メッセージを送信する

SDK を設定する

準備

Firebase プロジェクトを作成

Firebase を使用してアプリを登録する

Firebase 構成ファイルを追加する

アプリに Firebase SDK を追加する

登録トークンにアクセスする

現在の登録トークンの取得

JavaAndroid

KotlinAndroid

トークンの生成のモニタリング

JavaAndroid

KotlinAndroid

テスト通知メッセージを送信する

次のステップ

フォアグラウンドで動作しているアプリへのメッセージの送信

通知メッセージ以外の動作

バックグラウンドで動作しているアプリにテストメッセージを送信する

Java
Android

Kotlin
Android

Java
Android

Kotlin
Android