Cloud Firestore Android Codelab

1. 概要

目標

この Codelab では、Cloud Firestore をベースとした Android のレストランおすすめアプリを構築します。ここでは以下について学びます。

  • Android アプリから Firestore へのデータの読み取りと書き込みを行う
  • Firestore データの変更をリアルタイムでリッスンする
  • Firebase Authentication とセキュリティ ルールを使用して Firestore データを保護する
  • 複雑な Firestore クエリを作成する

前提条件

この Codelab を始める前に、以下のものが揃っていることを確認してください。

  • Android Studio Flamingo 以降
  • API 19 以降を搭載した Android Emulator
  • Node.js バージョン 16 以降
  • Java バージョン 17 以降

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

  1. Google アカウントで Firebase コンソールにログインします。
  2. Firebase コンソールで [プロジェクトを追加] をクリックします。
  3. 下のスクリーンショットに示すように、Firebase プロジェクトの名前(「Friendly Eats」など)を入力し、[続行] をクリックします。

9d2f625aebcab6af.png

  1. この Codelab では、Google アナリティクスを有効にするよう求められる場合があります。この Codelab では、ここでの選択は問題になりません。
  2. 約 1 分後に Firebase プロジェクトの準備が整います。[続行] をクリックします。

3. サンプル プロジェクトをセットアップする

コードをダウンロードする

次のコマンドを実行して、この Codelab のサンプルコードのクローンを作成します。これにより、マシンに friendlyeats-android というフォルダが作成されます。

$ git clone https://github.com/firebase/friendlyeats-android

マシンに git がない場合は、GitHub からコードを直接ダウンロードすることもできます。

Firebase 構成を追加する

  1. Firebase コンソールの左側のナビゲーションで、[プロジェクトの概要] を選択します。[Android] ボタンをクリックしてプラットフォームを選択します。パッケージ名の入力を求められたら、com.google.firebase.example.fireeats を使用します。

73d151ed16016421.png

  1. [アプリを登録] をクリックし、手順に沿って google-services.json ファイルをダウンロードして、ダウンロードしたコードの app/ フォルダに移動します。[次へ] をクリックします。

プロジェクトをインポートする

Android Studio を開きます。[File] > [New] > [Import Project] をクリックし、friendlyeats-android フォルダを選択します。

4. Firebase エミュレータを設定する

この Codelab では、Firebase Emulator Suite を使用して、Cloud Firestore や他の Firebase サービスをローカルでエミュレートします。これにより、アプリをビルドするための安全で高速かつ無料のローカル開発環境が提供されます。

Firebase CLI をインストールする

まず、Firebase CLI をインストールする必要があります。macOS または Linux を使用している場合は、次の cURL コマンドを実行できます。

curl -sL https://firebase.tools | bash

Windows をご利用の場合は、インストール手順を参照してスタンドアロン バイナリを取得するか、npm からインストールします。

CLI をインストールしたら、firebase --version を実行して 9.0.0 以降のバージョンを報告します。

$ firebase --version
9.0.0

ログイン

firebase login を実行して、CLI を Google アカウントに接続します。新しいブラウザ ウィンドウが開き、ログイン プロセスを完了します。先に Firebase プロジェクトを作成したときに使用したアカウントを選択してください。

friendlyeats-android フォルダ内で firebase use --add を実行して、ローカル プロジェクトを Firebase プロジェクトに接続します。プロンプトに沿って、先ほど作成したプロジェクトを選択します。エイリアスを選択するよう求められたら、default を入力します。

5. アプリを実行する

それでは、Firebase Emulator Suite と friendEats Android アプリを初めて実行します。

エミュレータを実行する

ターミナルで friendlyeats-android ディレクトリ内から firebase emulators:start を実行して、Firebase Emulator を起動します。次のようなログが表示されます。

$ firebase emulators:start
i  emulators: Starting emulators: auth, firestore
i  firestore: Firestore Emulator logging to firestore-debug.log
i  ui: Emulator UI logging to ui-debug.log

┌─────────────────────────────────────────────────────────────┐
│ ✔  All emulators ready! It is now safe to connect your app. │
│ i  View Emulator UI at http://localhost:4000                │
└─────────────────────────────────────────────────────────────┘

┌────────────────┬────────────────┬─────────────────────────────────┐
│ Emulator       │ Host:Port      │ View in Emulator UI             │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Authentication │ localhost:9099 │ http://localhost:4000/auth      │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Firestore      │ localhost:8080 │ http://localhost:4000/firestore │
└────────────────┴────────────────┴─────────────────────────────────┘
  Emulator Hub running at localhost:4400
  Other reserved ports: 4500

Issues? Report them at https://github.com/firebase/firebase-tools/issues and attach the *-debug.log files.

これで、マシンで完全なローカル開発環境が実行されるようになりました。このコマンドは、Codelab の残りの部分で実行したままにしてください。Android アプリはエミュレータに接続する必要があります。

アプリをエミュレータに接続する

Android Studio で util/FirestoreInitializer.kt ファイルと util/AuthInitializer.kt ファイルを開きます。これらのファイルには、アプリケーションの起動時に Firebase SDK をマシンで実行されているローカル エミュレータに接続するロジックが含まれています。

FirestoreInitializer クラスの create() メソッドで、次のコードを確認します。

    // Use emulators only in debug builds
    if (BuildConfig.DEBUG) {
        firestore.useEmulator(FIRESTORE_EMULATOR_HOST, FIRESTORE_EMULATOR_PORT)
    }

BuildConfig を使用して、アプリが debug モードで実行されている場合にのみエミュレータに接続するようにしています。アプリを release モードでコンパイルすると、この条件は false になります。

useEmulator(host, port) メソッドを使用して Firebase SDK をローカル Firestore エミュレータに接続していることがわかります。アプリ全体で FirebaseUtil.getFirestore() を使用してこの FirebaseFirestore のインスタンスにアクセスするため、debug モードで実行しているときは常に Firestore エミュレータに接続します。

アプリを実行する

google-services.json ファイルを適切に追加していれば、プロジェクトがコンパイルされるはずです。Android Studio で [Build] >プロジェクトを再構築し、エラーが残っていないことを確認します。

Android Studio で、Android Emulator でアプリを実行します。最初に [ログイン] 画面が表示されます。表示されます。任意のメールアドレスとパスワードを使用してアプリにログインできます。このログイン プロセスは Firebase Authentication エミュレータに接続しているため、実際の認証情報は送信されません。

ウェブブラウザで http://localhost:4000 に移動してエミュレータ UI を開きます。[Authentication] タブをクリックすると、先ほど作成したアカウントが表示されます。

Firebase Auth エミュレータ

ログイン プロセスが完了すると、アプリのホーム画面が表示されます。

de06424023ffb4b9.png

近日中に、ホーム画面に表示するデータをいくつか追加する予定です。

6. Firestore にデータを書き込む

このセクションでは、現在空のホーム画面にデータを入力できるように、Firestore にデータを書き込みます。

このアプリのメインのモデル オブジェクトはレストランです(model/Restaurant.kt を参照)。Firestore データは、ドキュメント、コレクション、サブコレクションに分割されます。各レストランは、"restaurants" という名前の最上位のコレクションにドキュメントとして保存します。Firestore データモデルの詳細については、こちらのドキュメントでドキュメントとコレクションをご覧ください。

デモのために、[Add Random Items] をクリックすると、10 件のランダムなレストランを作成する機能をアプリに追加します。オーバーフローメニューのボタンを使用します。MainFragment.kt ファイルを開き、onAddItemsClicked() メソッドの内容を次のように置き換えます。

    private fun onAddItemsClicked() {
        val restaurantsRef = firestore.collection("restaurants")
        for (i in 0..9) {
            // Create random restaurant / ratings
            val randomRestaurant = RestaurantUtil.getRandom(requireContext())

            // Add restaurant
            restaurantsRef.add(randomRestaurant)
        }
    }

上記のコードについては、注意すべき重要な点がいくつかあります。

  • まず、"restaurants" コレクションへの参照を取得します。コレクションはドキュメントの追加時に暗黙的に作成されるため、データを書き込む前にコレクションを作成する必要はありません。
  • ドキュメントは Kotlin データクラスを使用して作成できます。このクラスは、各レストランのドキュメントの作成に使用します。
  • add() メソッドは、自動生成された ID でドキュメントをコレクションに追加するため、レストランごとに一意の ID を指定する必要はありません。

アプリをもう一度実行し、右上のオーバーフロー メニューにある [Add Random Items] ボタンをクリックして、先ほど作成したコードを呼び出します。

95691e9b71ba55e3.png

ウェブブラウザで http://localhost:4000 に移動してエミュレータ UI を開きます。次に、[Firestore] タブをクリックすると、追加したデータが表示されます。

Firebase Auth エミュレータ

このデータは、マシンに完全にローカルです。実際のプロジェクトには、まだ Firestore データベースすら含まれていません。つまり、このデータの変更や削除を試しても、結果に影響することはありません。

おつかれさまです。これで、Firestore にデータが書き込まれました。次のステップでは、このデータをアプリで表示する方法を説明します。

7. Firestore のデータを表示する

このステップでは、Firestore からデータを取得してアプリで表示する方法について学習します。Firestore からデータを読み取るための最初のステップは、Query を作成することです。MainFragment.kt ファイルを開き、onViewCreated() メソッドの先頭に次のコードを追加します。

        // Firestore
        firestore = Firebase.firestore

        // Get the 50 highest rated restaurants
        query = firestore.collection("restaurants")
            .orderBy("avgRating", Query.Direction.DESCENDING)
            .limit(LIMIT.toLong())

次に、クエリをリッスンして、一致するすべてのドキュメントを取得し、今後の更新をリアルタイムで通知できるようにします。最終的な目標は、このデータを RecyclerView にバインドすることであるため、データをリッスンする RecyclerView.Adapter クラスを作成する必要があります。

すでに部分的に実装されている FirestoreAdapter クラスを開きます。まず、アダプターに EventListener を実装し、Firestore クエリの更新を受信できるように onEvent 関数を定義します。

abstract class FirestoreAdapter<VH : RecyclerView.ViewHolder>(private var query: Query?) :
        RecyclerView.Adapter<VH>(),
        EventListener<QuerySnapshot> { // Add this implements
    
    // ...

    // Add this method
    override fun onEvent(documentSnapshots: QuerySnapshot?, e: FirebaseFirestoreException?) {
        
        // Handle errors
        if (e != null) {
            Log.w(TAG, "onEvent:error", e)
            return
        }

        // Dispatch the event
        if (documentSnapshots != null) {
            for (change in documentSnapshots.documentChanges) {
                // snapshot of the changed document
                when (change.type) {
                    DocumentChange.Type.ADDED -> {
                        // TODO: handle document added
                    }
                    DocumentChange.Type.MODIFIED -> {
                        // TODO: handle document changed
                    }
                    DocumentChange.Type.REMOVED -> {
                        // TODO: handle document removed
                    }
                }
            }
        }

        onDataChanged()
    }
    
    // ...
}

初期読み込み時に、リスナーは新しいドキュメントごとに 1 つの ADDED イベントを受け取ります。クエリの結果セットが時間とともに変化すると、リスナーはその変化を含むイベントをさらに受け取ります。リスナーの実装を完了しましょう。まず、onDocumentAddedonDocumentModifiedonDocumentRemoved の 3 つの新しいメソッドを追加します。

    private fun onDocumentAdded(change: DocumentChange) {
        snapshots.add(change.newIndex, change.document)
        notifyItemInserted(change.newIndex)
    }

    private fun onDocumentModified(change: DocumentChange) {
        if (change.oldIndex == change.newIndex) {
            // Item changed but remained in same position
            snapshots[change.oldIndex] = change.document
            notifyItemChanged(change.oldIndex)
        } else {
            // Item changed and changed position
            snapshots.removeAt(change.oldIndex)
            snapshots.add(change.newIndex, change.document)
            notifyItemMoved(change.oldIndex, change.newIndex)
        }
    }

    private fun onDocumentRemoved(change: DocumentChange) {
        snapshots.removeAt(change.oldIndex)
        notifyItemRemoved(change.oldIndex)
    }

次に、onEvent から次の新しいメソッドを呼び出します。

    override fun onEvent(documentSnapshots: QuerySnapshot?, e: FirebaseFirestoreException?) {

        // Handle errors
        if (e != null) {
            Log.w(TAG, "onEvent:error", e)
            return
        }

        // Dispatch the event
        if (documentSnapshots != null) {
            for (change in documentSnapshots.documentChanges) {
                // snapshot of the changed document
                when (change.type) {
                    DocumentChange.Type.ADDED -> {
                        onDocumentAdded(change) // Add this line
                    }
                    DocumentChange.Type.MODIFIED -> {
                        onDocumentModified(change) // Add this line
                    }
                    DocumentChange.Type.REMOVED -> {
                        onDocumentRemoved(change) // Add this line
                    }
                }
            }
        }

        onDataChanged()
    }

最後に、startListening() メソッドを実装してリスナーをアタッチします。

    fun startListening() {
        if (registration == null) {
            registration = query.addSnapshotListener(this)
        }
    }

これで、Firestore からデータを読み取るようにアプリが完全に構成されました。アプリをもう一度実行すると、前の手順で追加したレストランが表示されます。

9e45f40faefce5d0.png

ブラウザでエミュレータ UI に戻り、いずれかのレストランの名前を編集します。変更はすぐにアプリに反映されます。

8. データの並べ替えとフィルタ

このアプリは現在、コレクション全体で高評価のレストランを表示しますが、実際のレストラン アプリではデータの並べ替えやフィルタが必要になります。たとえば、アプリは「フィラデルフィアの人気海鮮レストラン」や「最も安いピザ」を表示できる必要があります。

アプリの上部にある白いバーをクリックすると、フィルタ ダイアログが表示されます。このセクションでは、Firestore クエリを使用して、次のダイアログを機能させます。

67898572a35672a5.png

MainFragment.ktonFilter() メソッドを編集しましょう。このメソッドは、フィルタ ダイアログの出力を取得するために作成したヘルパー オブジェクトである Filters オブジェクトを受け取ります。このメソッドを変更して、フィルタからクエリを作成します。

    override fun onFilter(filters: Filters) {
        // Construct query basic query
        var query: Query = firestore.collection("restaurants")

        // Category (equality filter)
        if (filters.hasCategory()) {
            query = query.whereEqualTo(Restaurant.FIELD_CATEGORY, filters.category)
        }

        // City (equality filter)
        if (filters.hasCity()) {
            query = query.whereEqualTo(Restaurant.FIELD_CITY, filters.city)
        }

        // Price (equality filter)
        if (filters.hasPrice()) {
            query = query.whereEqualTo(Restaurant.FIELD_PRICE, filters.price)
        }

        // Sort by (orderBy with direction)
        if (filters.hasSortBy()) {
            query = query.orderBy(filters.sortBy.toString(), filters.sortDirection)
        }

        // Limit items
        query = query.limit(LIMIT.toLong())

        // Update the query
        adapter.setQuery(query)

        // Set header
        binding.textCurrentSearch.text = HtmlCompat.fromHtml(
            filters.getSearchDescription(requireContext()),
            HtmlCompat.FROM_HTML_MODE_LEGACY
        )
        binding.textCurrentSortBy.text = filters.getOrderDescription(requireContext())

        // Save filters
        viewModel.filters = filters
    }

上記のスニペットでは、指定したフィルタに一致する where 句と orderBy 句をアタッチして Query オブジェクトを構築しています。

アプリを再度実行し、次のフィルタを選択して、人気の低価格レストランを表示します。

7a67a8a400c80c50.png

これで、低価格オプションのみを含むレストランの一覧がフィルタされて表示されます。

a670188398c3c59.png

これで、Firestore で完全に機能するレストランのおすすめを表示するアプリが完成しました。レストランの並べ替えやフィルタリングをリアルタイムで行えます。次のセクションでは、レストランにレビューを追加し、アプリにセキュリティ ルールを追加します。

9. サブコレクションでデータを整理する

このセクションでは、ユーザーがお気に入りの(または最もお気に入りでない)レストランをレビューできるように、アプリに評価を追加します。

コレクションとサブコレクション

ここまでは、すべてのレストラン データを「restaurants」という最上位のコレクションに保存しました。ユーザーがレストランに評価を付けると、レストランに新しい Rating オブジェクトが追加されます。このタスクでは、サブコレクションを使用します。サブコレクションは、ドキュメントに関連付けられたコレクションと考えることができます。したがって、各レストラン ドキュメントには、評価ドキュメントがすべて含まれる ratings サブコレクションがあります。サブコレクションを使用すると、ドキュメント肥大化や複雑なクエリを必要とすることなくデータを整理できます。

サブコレクションにアクセスするには、親ドキュメントで .collection() を呼び出します。

val subRef = firestore.collection("restaurants")
        .document("abc123")
        .collection("ratings")

サブコレクションは、トップレベル コレクションと同様にアクセスしてクエリを実行でき、サイズの制限やパフォーマンスの変化はありません。Firestore のデータモデルについて詳しくは、こちらをご覧ください。

トランザクションでデータを書き込む

適切なサブコレクションに Rating を追加するには .add() を呼び出すだけで済みますが、新しいデータを反映するために Restaurant オブジェクトの平均評価と評価数も更新する必要があります。これら 2 つの変更に別々のオペレーションを使用すると、さまざまな競合状態が発生し、データが古くなったり、不正確になったりする可能性があります。

Google では、評価が適切に追加されるようにするため、トランザクションを使用してレストランに評価を追加しています。このトランザクションでは、次の処理が行われます。

  • レストランの現在の評価を読み取り、新しい評価を計算する
  • 評価をサブコレクションに追加する
  • レストランの平均評価と評価数を更新する

RestaurantDetailFragment.kt を開き、addRating 関数を実装します。

    private fun addRating(restaurantRef: DocumentReference, rating: Rating): Task<Void> {
        // Create reference for new rating, for use inside the transaction
        val ratingRef = restaurantRef.collection("ratings").document()

        // In a transaction, add the new rating and update the aggregate totals
        return firestore.runTransaction { transaction ->
            val restaurant = transaction.get(restaurantRef).toObject<Restaurant>()
                ?: throw Exception("Restaurant not found at ${restaurantRef.path}")

            // Compute new number of ratings
            val newNumRatings = restaurant.numRatings + 1

            // Compute new average rating
            val oldRatingTotal = restaurant.avgRating * restaurant.numRatings
            val newAvgRating = (oldRatingTotal + rating.rating) / newNumRatings

            // Set new restaurant info
            restaurant.numRatings = newNumRatings
            restaurant.avgRating = newAvgRating

            // Commit to Firestore
            transaction.set(restaurantRef, restaurant)
            transaction.set(ratingRef, rating)

            null
        }
    }

addRating() 関数は、トランザクション全体を表す Task を返します。onRating() では、トランザクションの結果に応答するために、関数リスナーがタスクに追加されます。

アプリを再度実行し、いずれかのレストランをクリックすると、レストランの詳細画面が表示されます。[+] ボタンをクリックして、レビューの追加を開始します。星の数を選択してテキストを入力し、レビューを追加します。

78fa16cdf8ef435a.png

[送信] をクリックすると、トランザクションが開始されます。取引が完了すると、下にクチコミが表示され、レストランのクチコミ数が更新されます。

f9e670f40bd615b0.png

お疲れさまでした。これで、Cloud Firestore 上に構築された、ソーシャルでローカルなモバイル レストラン レビュー アプリが完成しました。最近ではとても人気があると聞きました。

10. データの保護

これまで、このアプリケーションのセキュリティについては考慮していません。ユーザーが正しいデータのみを読み書きできることを、どのように知ることができますか?Firestore データベースは、セキュリティ ルールと呼ばれる構成ファイルによって保護されています。

firestore.rules ファイルを開くと、次のように表示されます。

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      //
      // WARNING: These rules are insecure! We will replace them with
      // more secure rules later in the codelab
      //
      allow read, write: if request.auth != null;
    }
  }
}

不要なデータアクセスや変更を防ぐために、これらのルールを変更しましょう。firestore.rules ファイルを開き、内容を次のように置き換えます。

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // Determine if the value of the field "key" is the same
    // before and after the request.
    function isUnchanged(key) {
      return (key in resource.data)
        && (key in request.resource.data)
        && (resource.data[key] == request.resource.data[key]);
    }

    // Restaurants
    match /restaurants/{restaurantId} {
      // Any signed-in user can read
      allow read: if request.auth != null;

      // Any signed-in user can create
      // WARNING: this rule is for demo purposes only!
      allow create: if request.auth != null;

      // Updates are allowed if no fields are added and name is unchanged
      allow update: if request.auth != null
                    && (request.resource.data.keys() == resource.data.keys())
                    && isUnchanged("name");

      // Deletes are not allowed.
      // Note: this is the default, there is no need to explicitly state this.
      allow delete: if false;

      // Ratings
      match /ratings/{ratingId} {
        // Any signed-in user can read
        allow read: if request.auth != null;

        // Any signed-in user can create if their uid matches the document
        allow create: if request.auth != null
                      && request.resource.data.userId == request.auth.uid;

        // Deletes and updates are not allowed (default)
        allow update, delete: if false;
      }
    }
  }
}

こうしたルールによってアクセスが制限され、クライアントが安全な変更のみを実施できるようになります。たとえば、レストランのドキュメントの更新では、名前などの不変のデータではなく、評価だけを変更できます。評価は、ユーザー ID がログインしているユーザーと一致する場合にのみ作成できるため、なりすましを防ぎます。

セキュリティ ルールの詳細については、ドキュメントをご覧ください。

11. まとめ

これで、Firestore 上にフル機能のアプリを作成できました。次のような Firestore の最も重要な機能について学びました。

  • ドキュメントとコレクション
  • データの読み取りと書き込み
  • クエリによる並べ替えとフィルタリング
  • サブコレクション
  • トランザクション

詳細

Firestore についてさらに学習するには、次のリソースをご覧ください。

この Codelab のレストラン アプリは「フレンドリーな食事」をベースにしており、見てみましょう。そのアプリのソースコードはこちらで確認できます。

省略可: 本番環境にデプロイする

これまで、このアプリでは Firebase Emulator Suite のみを使用していました。このアプリを実際の Firebase プロジェクトにデプロイする方法を学習する場合は、次のステップに進んでください。

12. (省略可)アプリをデプロイする

これまでのところ、このアプリは完全にローカルであるため、すべてのデータは Firebase Emulator Suite に含まれています。このセクションでは、このアプリが本番環境で動作するように Firebase プロジェクトを構成する方法を学びます。

Firebase Authentication

Firebase コンソールで [Authentication] セクションに移動し、[使ってみる] をクリックします。[ログイン方法] タブに移動し、[ネイティブ プロバイダ] から [メール/パスワード] オプションを選択します。

[メール/パスワード] を有効にして [保存] をクリックします。

sign-in-providers.png

Firestore

データベースの作成

コンソールの [Firestore Database] セクションに移動し、[Create Database] をクリックします。

  1. セキュリティ ルールに関するメッセージが表示されたら、[本番環境モード] で開始してください。これらのルールは近日中に更新されます。
  2. アプリで使用するデータベースのロケーションを選択します。データベースのロケーションの選択は永続的な決定であり、これを変更するには新しいプロジェクトを作成する必要があります。プロジェクトのロケーションの選択の詳細については、ドキュメントをご覧ください。

デプロイルール

先ほど作成したセキュリティ ルールをデプロイするには、Codelab ディレクトリで次のコマンドを実行します。

$ firebase deploy --only firestore:rules

これにより、firestore.rules のコンテンツがプロジェクトにデプロイされます。これは、コンソールの [ルール] タブに移動して確認できます。

インデックスをデプロイする

FriendlyEats アプリには複雑な並べ替えとフィルタリングがあり、そのために複数のカスタム複合インデックスが必要です。これらのルールは Firebase コンソールで手動で作成できますが、firestore.indexes.json ファイルに定義を記述し、Firebase CLI を使用してデプロイする方が簡単です。

firestore.indexes.json ファイルを開くと、必要なインデックスがすでに提供されていることがわかります。

{
  "indexes": [
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "city", "mode": "ASCENDING" },
        { "fieldPath": "avgRating", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "category", "mode": "ASCENDING" },
        { "fieldPath": "avgRating", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "price", "mode": "ASCENDING" },
        { "fieldPath": "avgRating", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "city", "mode": "ASCENDING" },
        { "fieldPath": "numRatings", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "category", "mode": "ASCENDING" },
        { "fieldPath": "numRatings", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "price", "mode": "ASCENDING" },
        { "fieldPath": "numRatings", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "city", "mode": "ASCENDING" },
        { "fieldPath": "price", "mode": "ASCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "fields": [
        { "fieldPath": "category", "mode": "ASCENDING" },
        { "fieldPath": "price", "mode": "ASCENDING" }
      ]
    }
  ],
  "fieldOverrides": []
}

これらのインデックスをデプロイするには、次のコマンドを実行します。

$ firebase deploy --only firestore:indexes

インデックスは即時に作成されるわけではないことに注意してください。進行状況は Firebase コンソールでモニタリングできます。

アプリを構成する

util/FirestoreInitializer.kt ファイルと util/AuthInitializer.kt ファイルで、デバッグモードのときにエミュレータに接続するように Firebase SDK を構成しました。

    override fun create(context: Context): FirebaseFirestore {
        val firestore = Firebase.firestore
        // Use emulators only in debug builds
        if (BuildConfig.DEBUG) {
            firestore.useEmulator(FIRESTORE_EMULATOR_HOST, FIRESTORE_EMULATOR_PORT)
        }
        return firestore
    }

実際の Firebase プロジェクトでアプリをテストするには、次のいずれかを行います。

  1. リリースモードでアプリをビルドし、デバイス上で実行します。
  2. BuildConfig.DEBUG を一時的に false に置き換えて、アプリを再度実行します。

製品版に正しく接続するために、アプリからログアウトして再度ログインすることが必要になる場合があります。