このページは Cloud Translation API によって翻訳されました。

Firebase を Next.js アプリと統合する

1. 始める前に

この Codelab では、Firebase をレストランのレビューウェブサイトである Friendly Eats という Next.js ウェブアプリと統合する方法を学びます。

フレンドリーイーツウェブアプリ

完成したウェブアプリには、Firebase を使用して Next.js アプリを構築する方法を示した便利な機能が備わっています。主な機能は次のとおりです。

自動ビルドとデプロイ: この Codelab では、Firebase App Hosting を使用して、構成したブランチに push するたびに Next.js コードを自動的にビルドしてデプロイします。
ログインとログアウト: 完成したウェブアプリでは、Google でログインしたりログアウトしたりできます。ユーザーのログインと永続性は、すべて Firebase Authentication で管理されます。
画像: 完成したウェブアプリでは、ログインしたユーザーがレストランの画像をアップロードできます。画像アセットは Cloud Storage for Firebase に保存されます。Firebase JavaScript SDK は、アップロードされた画像への公開 URL を提供します。この公開 URL は、Cloud Firestore の関連するレストランドキュメントに保存されます。
レビュー: 完成したウェブアプリでは、ログインしたユーザーがレストランのレビューを投稿できます。レビューは、星評価とテキストベースのメッセージで構成されます。レビュー情報は Cloud Firestore に保存されます。
フィルタ: 完成したウェブアプリでは、ログインしたユーザーがカテゴリ、場所、価格に基づいてレストランのリストをフィルタできます。使用する並べ替え方法をカスタマイズすることもできます。データは Cloud Firestore からアクセスされ、使用されるフィルタに基づいて Firestore クエリが適用されます。

前提条件

GitHub アカウント
Next.js と JavaScript に関する知識

学習内容

Next.js App ルーターとサーバーサイドレンダリングで Firebase を使用する方法。
Cloud Storage for Firebase に画像を保持する方法。
Cloud Firestore データベースでデータの読み取りと書き込みを行う方法。
Firebase JavaScript SDK で「Google でログイン」を使用する方法。

必要なもの

Git
Node.js の最新の安定版
任意のブラウザ（Google Chrome など）
コードエディタとターミナルを備えた開発環境
Firebase プロジェクトの作成と管理を行う Google アカウント
Firebase プロジェクトを Blaze お支払いプランにアップグレードする機能

2. 開発環境と GitHub リポジトリを設定する

この Codelab では、アプリのスターターコードベースを提供し、Firebase CLI を使用します。

GitHub リポジトリを作成する

Codelab のソースは https://github.com/firebase/friendlyeats-web にあります。このリポジトリには、複数のプラットフォーム用のサンプルプロジェクトが含まれています。ただし、この Codelab では nextjs-start ディレクトリのみを使用します。次のディレクトリをメモします。

* `nextjs-start`: contains the starter code upon which you build.
* `nextjs-end`: contains the solution code for the finished web app.

nextjs-start フォルダを独自のリポジトリにコピーします。

ターミナルを使用してパソコンに新しいフォルダを作成し、新しいディレクトリに移動します。
```
mkdir codelab-friendlyeats-web

cd codelab-friendlyeats-web
```
giget npm パッケージを使用して、nextjs-start フォルダのみを取得します。
```
npx giget@latest gh:firebase/friendlyeats-web/nextjs-start#master . --install
```

git を使用してローカルで変更を追跡します。

git init

git commit -a -m "codelab starting point"

git branch -M main

新しい GitHub リポジトリ（https://github.com/new）を作成します。任意の名前を付けます。
GitHub によって作成された新しい URL をコピーします。次のように表示されます。
- https://github.com/<USER_NAME>/<REPOSITORY_NAME>.git または
- git@github.com:<USER_NAME>/<REPOSITORY_NAME>.git
次のコマンドを実行して、ローカルの変更を新しい GitHub リポジトリに push します。<REPOSITORY_URL> プレースホルダは、実際のリポジトリ URL に置き換えます。
```
git remote add origin <REPOSITORY_URL>

git push -u origin main
```
GitHub リポジトリにスターターコードが表示されます。

Firebase CLI をインストールまたは更新する

次のコマンドを実行して、Firebase CLI がインストールされ、v13.9.0 以降であることを確認します。

firebase --version

バージョンが低い場合や Firebase CLI がインストールされていない場合は、インストールコマンドを実行します。

npm install -g firebase-tools@latest

権限エラーが原因で Firebase CLI をインストールできない場合は、npm のドキュメントをご覧ください。または、別のインストールオプションを使用してください。

Firebase にログインする

次のコマンドを実行して Firebase CLI にログインします。
```
firebase login
```
Firebase でデータを収集するかどうかに応じて、Y または N を入力します。
ブラウザで Google アカウントを選択し、[許可] をクリックします。

3. Firebase プロジェクトを設定する

このセクションでは、Firebase プロジェクトを設定し、Firebase ウェブアプリを関連付けます。また、サンプルウェブアプリで使用される Firebase サービスを設定します。

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

Firebase コンソールで [プロジェクトを追加] をクリックします。
[Enter your project name] テキストボックスに「FriendlyEats Codelab」（または任意のプロジェクト名）と入力し、[続行] をクリックします。
[Firebase の料金プランの確認] モーダルで、プランが Blaze であることを確認して、[プランを確認] をクリックします。
この Codelab では Google アナリティクスは必要ないため、[このプロジェクトで Google アナリティクスを有効にする] オプションをオフにします。
[プロジェクトの作成] をクリックします。
プロジェクトがプロビジョニングされるのを待ってから、[続行] をクリックします。
Firebase プロジェクトで、プロジェクトの設定に移動します。後で必要になるため、プロジェクト ID をメモしておきます。この一意の識別子によって、プロジェクトが識別されます（Firebase CLI など）。

Firebase の料金プランをアップグレードする

Firebase App Hosting と Cloud Storage for Firebase を使用するには、Firebase プロジェクトが従量課金制（Blaze）のお支払いプラン（Cloud 請求先アカウントにリンクされている）である必要があります。

Cloud 請求先アカウントには、クレジットカードなどのお支払い方法が必要です。
Firebase と Google Cloud を初めて使用する場合は、$300 のクレジットと無料トライアル用 Cloud 請求先アカウントを利用できるかどうかご確認ください。
この Codelab をイベントの一環として実施する場合は、利用可能な Cloud クレジットがあるかどうかを主催者に確認してください。

プロジェクトを Blaze プランにアップグレードする手順は次のとおりです。

Firebase コンソールで、プランをアップグレードを選択します。
Blaze プランを選択します。画面上の手順に沿って、Cloud 請求先アカウントをプロジェクトにリンクします。
このアップグレードの一環として Cloud 請求先アカウントを作成する必要があった場合は、Firebase コンソールでアップグレードフローに移動してアップグレードを完了する必要があります。

Firebase プロジェクトにウェブアプリを追加する

Firebase プロジェクトの [プロジェクトの概要] に移動し、 [ウェブ] をクリックします。

プロジェクトにすでにアプリが登録されている場合は、[アプリを追加] をクリックしてウェブアイコンを表示します。
[アプリのニックネーム] テキストボックスに、覚えやすいアプリのニックネーム（My Next.js app など）を入力します。
[このアプリの Firebase Hosting も設定します] チェックボックスはオフのままにします。
[アプリの登録] > [次へ] > [次へ] > [コンソールに進む] をクリックします。

Firebase コンソールで Firebase サービスを設定する

Authentication を設定する

Firebase コンソールで [認証] に移動します。
[Get started] をクリックします。
[その他のプロバイダ] 列で、[Google] > [有効にする] をクリックします。
[プロジェクトの公開名] テキストボックスに、覚えやすい名前（My Next.js app など）を入力します。
[プロジェクトのサポートメール] プルダウンからメールアドレスを選択します。
[保存] をクリックします。

Cloud Firestore を設定する

Firebase コンソールの左側のパネルで [ビルド] を展開し、[Firestore データベース] を選択します。
[データベースを作成] をクリックします。
[データベース ID] は (default) のままにします。
データベースのロケーションを選択し、[次へ] をクリックします。
実際のアプリの場合は、ユーザーに近いロケーションを選択します。
[テストモードで開始] をクリックします。セキュリティルールに関する免責条項を確認します。
この Codelab の後半で、セキュリティルールを追加してデータを保護します。データベースのセキュリティルールを追加せずに、アプリを配布または公開しないでください。
[作成] をクリックします。

Cloud Storage for Firebase を設定する

Firebase コンソールの左側のパネルで [ビルド] を開き、[Storage] を選択します。
[開始] をクリックします。
デフォルトの Storage バケットのロケーションを選択します。
US-WEST1、US-CENTRAL1、US-EAST1 のバケットは、Google Cloud Storage の「無料枠」を利用できます。他のすべてのロケーションのバケットは、Google Cloud Storage の料金と使用量に従います。
[テストモードで開始] をクリックします。セキュリティルールに関する免責条項を確認します。
この Codelab の後半で、セキュリティルールを追加してデータを保護します。Storage バケットのセキュリティルールを追加せずに、アプリを配布または公開しないでください。
[作成] をクリックします。

4. スターターコードベースを確認する

このセクションでは、この Codelab で機能を追加するアプリのスターターコードベースのいくつかの領域を確認します。

フォルダとファイルの構造

次の表に、アプリのフォルダとファイル構造の概要を示します。

フォルダとファイル	説明
`src/components`	フィルタ、ヘッダー、レストランの詳細、レビュー用の React コンポーネント
`src/lib`	React や Next.js にバインドされていないユーティリティ関数
`src/lib/firebase`	Firebase 固有のコードと Firebase 構成
`public`	ウェブアプリの静的アセット（アイコンなど）
`src/app`	Next.js App Router を使用したルーティング
`src/app/restaurant`	API ルートハンドラ
`package.json` と `package-lock.json`。	npm を使用したプロジェクトの依存関係
`next.config.js`	Next.js 固有の構成（サーバーアクションが有効）
`jsconfig.json`	JavaScript 言語サービスの構成

サーバーコンポーネントとクライアントコンポーネント

このアプリは、App ルーターを使用する Next.js ウェブアプリです。サーバーレンダリングはアプリ全体で使用されます。たとえば、src/app/page.js ファイルはメインページを担当するサーバーコンポーネントです。src/components/RestaurantListings.jsx ファイルは、ファイルの先頭にある "use client" ディレクティブで表されるクライアントコンポーネントです。

インポートステートメント

次のような import ステートメントが見つかります。

import RatingPicker from "@/src/components/RatingPicker.jsx";

このアプリでは、@ 記号を使用して、煩雑な相対インポートパスを回避しています。これは、パスエイリアスによって可能になっています。

Firebase 固有の API

すべての Firebase API コードは src/lib/firebase ディレクトリにラップされています。個々の React コンポーネントは、Firebase 関数を直接インポートするのではなく、src/lib/firebase ディレクトリからラップされた関数をインポートします。

モックデータ

レストランとレビューのモックデータは src/lib/randomData.js ファイルに含まれています。このファイルのデータは、src/lib/fakeRestaurants.js ファイルのコードに組み込まれます。

5. App Hosting バックエンドを作成する

このセクションでは、Git リポジトリのブランチを監視する App Hosting バックエンドを設定します。

このセクションの終わりまでに、GitHub のリポジトリに接続された App Hosting バックエンドが作成されます。このバックエンドは、main ブランチに新しい commit を push するたびに、アプリの新しいバージョンを自動的に再ビルドしてロールアウトします。

セキュリティルールをデプロイする

このコードには、Firestore と Cloud Storage for Firebase のセキュリティルールのセットがすでに含まれています。セキュリティルールをデプロイすると、データベースとバケット内のデータを不正使用から保護できます。

ターミナルで、前に作成した Firebase プロジェクトを使用するように CLI を構成します。
```
firebase use --add
```
エイリアスの入力を求められたら、friendlyeats-codelab と入力します。
これらのセキュリティルールをデプロイするには、ターミナルで次のコマンドを実行します。
```
firebase deploy --only firestore:rules,storage
```
「"Cloud Storage for Firebase needs an IAM Role to use cross-service rules. Grant the new role?"」というメッセージが表示されたら、Enter を押して [はい] を選択します。

Firebase 構成をウェブアプリのコードに追加する

Firebase コンソールで プロジェクトの設定に移動します。
[アプリ] セクションまで下にスクロールし、この Codelab で作成した Firebase ウェブアプリを選択します。
firebaseConfig 変数とそのプロパティと値をコピーします。
コードエディタで apphosting.yaml ファイルを開き、環境変数の値に Firebase コンソールの構成値を入力します。
ファイルで、既存のプロパティをコピーしたプロパティに置き換えます。
ファイルを保存します。

バックエンドの作成

Firebase コンソールの [App Hosting] ページに移動します。

App Hosting コンソールのゼロ状態（[使ってみる] ボタンあり）

[使ってみる] をクリックして、バックエンドの作成フローを開始します。バックエンドを次のように構成します。
最初の手順のメッセージに沿って、先ほど作成した GitHub リポジトリを接続します。
デプロイの設定を設定します。
1. ルートディレクトリを / のままにする
2. ライブブランチを main に設定します。
3. 自動ロールアウトを有効にする
バックエンドに friendlyeats-codelab という名前を付けます。
[Firebase ウェブアプリを作成または関連付ける] で、[既存の Firebase ウェブアプリを選択する] プルダウンから、前に構成したウェブアプリを選択します。
[完了してデプロイ] をクリックします。しばらくすると、新しいページが表示され、新しい App Hosting バックエンドのステータスを確認できます。
注: コンソールからリンクをたどることで、App Hosting バックエンドの基盤となる Google Cloud サービスをモニタリングできます。詳細については、ログと指標を表示するをご覧ください。
ロールアウトが完了したら、[ドメイン] で無料ドメインをクリックします。DNS の伝播により、動作を開始するまでに数分かかることがあります。

これで、最初のウェブアプリがデプロイされました。GitHub リポジトリの main ブランチに新しい commit を push するたびに、Firebase コンソールで新しいビルドとロールアウトが開始されます。ロールアウトが完了すると、サイトが自動的に更新されます。

6. ウェブアプリに認証を追加する

このセクションでは、ウェブアプリに認証を追加して、ウェブアプリにログインできるようにします。

src/lib/firebase/auth.js ファイルで、onAuthStateChanged、signInWithGoogle、signOut 関数を次のコードに置き換えます。

export function onAuthStateChanged(cb) {
	return _onAuthStateChanged(auth, cb);
}

export async function signInWithGoogle() {
  const provider = new GoogleAuthProvider();

  try {
    await signInWithPopup(auth, provider);
  } catch (error) {
    console.error("Error signing in with Google", error);
  }
}

export async function signOut() {
  try {
    return auth.signOut();
  } catch (error) {
    console.error("Error signing out with Google", error);
  }
}

このコードでは、次の Firebase API を使用します。

Firebase API	説明
`GoogleAuthProvider`	Google 認証プロバイダインスタンスを作成します。
`signInWithPopup`	ダイアログベースの認証フローを開始します。
`auth.signOut`	ユーザーをログアウトします。

src/components/Header.jsx ファイルでは、コードですでに signInWithGoogle 関数と signOut 関数が呼び出されています。

commit メッセージ「Adding Google Authentication」で commit を作成し、GitHub リポジトリに push します。1. Firebase コンソールで [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
ウェブアプリでページを更新し、[Google でログイン] をクリックします。ウェブアプリが更新されないため、ログインが成功したかどうか不明です。

認証状態をサーバーに送信する

認証状態をサーバーに渡すには、サービスワーカーを使用します。fetchWithFirebaseHeaders 関数と getAuthIdToken 関数を次のコードに置き換えます。

async function fetchWithFirebaseHeaders(request) {
  const app = initializeApp(firebaseConfig);
  const auth = getAuth(app);
  const installations = getInstallations(app);
  const headers = new Headers(request.headers);
  const [authIdToken, installationToken] = await Promise.all([
    getAuthIdToken(auth),
    getToken(installations),
  ]);
  headers.append("Firebase-Instance-ID-Token", installationToken);
  if (authIdToken) headers.append("Authorization", `Bearer ${authIdToken}`);
  const newRequest = new Request(request, { headers });
  return await fetch(newRequest);
}

async function getAuthIdToken(auth) {
  await auth.authStateReady();
  if (!auth.currentUser) return;
  return await getIdToken(auth.currentUser);
}

サーバーの認証状態を読み取る

FirebaseServerApp を使用して、クライアントの認証状態をサーバーにミラーリングします。

src/lib/firebase/serverApp.js を開き、getAuthenticatedAppForUser 関数を置き換えます。

export async function getAuthenticatedAppForUser() {
  const idToken = headers().get("Authorization")?.split("Bearer ")[1];
  console.log('firebaseConfig', JSON.stringify(firebaseConfig));
  const firebaseServerApp = initializeServerApp(
    firebaseConfig,
    idToken
      ? {
          authIdToken: idToken,
        }
      : {}
  );

  const auth = getAuth(firebaseServerApp);
  await auth.authStateReady();

  return { firebaseServerApp, currentUser: auth.currentUser };
}

認証の変更をサブスクライブする手順は次のとおりです。

src/components/Header.jsx ファイルに移動する
関数全体を次の　useUserSession　に置き換えます。

function useUserSession(initialUser) {
	// The initialUser comes from the server via a server component
	const [user, setUser] = useState(initialUser);
	const router = useRouter();

	// Register the service worker that sends auth state back to server
	// The service worker is built with npm run build-service-worker
	useEffect(() => {
		if ("serviceWorker" in navigator) {
			const serializedFirebaseConfig = encodeURIComponent(JSON.stringify(firebaseConfig));
			const serviceWorkerUrl = `/auth-service-worker.js?firebaseConfig=${serializedFirebaseConfig}`
		
		  navigator.serviceWorker
			.register(serviceWorkerUrl)
			.then((registration) => console.log("scope is: ", registration.scope));
		}
	  }, []);

	useEffect(() => {
		const unsubscribe = onAuthStateChanged((authUser) => {
			setUser(authUser)
		})

		return () => unsubscribe()
		// eslint-disable-next-line react-hooks/exhaustive-deps
	}, []);

	useEffect(() => {
		onAuthStateChanged((authUser) => {
			if (user === undefined) return

			// refresh when user changed to ease testing
			if (user?.email !== authUser?.email) {
				router.refresh()
			}
		})
		// eslint-disable-next-line react-hooks/exhaustive-deps
	}, [user])

	return user;
}

このコードでは、React の状態フックを使用して、onAuthStateChanged 関数で認証状態の変更が指定されたときにユーザーを更新します。

変更を確認する

src/app/layout.js ファイルのルートレイアウトはヘッダーをレンダリングし、ユーザーが利用可能な場合はプロップとして渡します。

<Header initialUser={currentUser?.toJSON()} />

つまり、<Header> コンポーネントは、サーバーの実行時にユーザーデータ（利用可能な場合）をレンダリングします。最初のページ読み込み後のページライフサイクル中に認証が更新された場合、onAuthStateChanged ハンドラがその更新を処理します。

新しいビルドをロールアウトして、ビルド内容を確認しましょう。

commit メッセージ「Show signin state」で commit を作成し、GitHub リポジトリに push します。
Firebase コンソールで [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
新しい認証動作を確認します。
1. ブラウザでウェブアプリを更新します。表示名がヘッダーに表示されます。
2. ログアウトしてもう一度ログインしてください。ページを更新しなくても、ページがリアルタイムで更新されます。この手順は、別のユーザーに対しても繰り返すことができます。
3. 省略可: ウェブアプリを右クリックし、[ページのソースを表示] を選択して、表示名を検索します。サーバーから返された未加工の HTML ソースに表示されます。

7. レストラン情報を表示する

このウェブアプリには、レストランとレビューのモックデータが含まれています。

レストランを 1 つ以上追加する

ローカルの Cloud Firestore データベースにレストランのモックデータを挿入する手順は次のとおりです。

ウェブアプリで、 > サンプルのレストランを追加を選択します。
Firebase コンソールの [Firestore データベース] ページで、[レストラン] を選択します。レストランコレクションには、レストランを表す最上位のドキュメントが表示されます。
いくつかのドキュメントをクリックして、レストランのドキュメントのプロパティを確認します。

レストランのリストを表示する

Cloud Firestore データベースに、Next.js ウェブアプリで表示できるレストランが追加されました。

データ取得コードを定義する手順は次のとおりです。

src/app/page.js ファイルで <Home /> サーバーコンポーネントを見つけ、getRestaurants 関数の呼び出しを確認します。この関数は、サーバー実行時にレストランのリストを取得します。getRestaurants 関数を実装する手順は次のとおりです。
src/lib/firebase/firestore.js ファイルで、applyQueryFilters 関数と getRestaurants 関数を次のコードに置き換えます。

function applyQueryFilters(q, { category, city, price, sort }) {
	if (category) {
		q = query(q, where("category", "==", category));
	}
	if (city) {
		q = query(q, where("city", "==", city));
	}
	if (price) {
		q = query(q, where("price", "==", price.length));
	}
	if (sort === "Rating" || !sort) {
		q = query(q, orderBy("avgRating", "desc"));
	} else if (sort === "Review") {
		q = query(q, orderBy("numRatings", "desc"));
	}
	return q;
}

export async function getRestaurants(db = db, filters = {}) {
	let q = query(collection(db, "restaurants"));

	q = applyQueryFilters(q, filters);
	const results = await getDocs(q);
	return results.docs.map(doc => {
		return {
			id: doc.id,
			...doc.data(),
			// Only plain objects can be passed to Client Components from Server Components
			timestamp: doc.data().timestamp.toDate(),
		};
	});
}

「Firestore からレストランのリストを読み取る」という commit メッセージで commit を作成し、GitHub リポジトリに push します。
Firebase コンソールで [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
ウェブアプリでページを更新します。レストランの画像がタイルとしてページに表示されます。

レストランのリスティングがサーバー実行時に読み込まれることを確認する

Next.js フレームワークを使用すると、データがサーバー実行時とクライアントサイド実行時のどちらで読み込まれるかが明確でない場合があります。

レストランのリスティングがサーバー実行時に読み込まれることを確認する手順は次のとおりです。

ウェブアプリで DevTools を開き、JavaScript を無効にします。

DevTools で JavaScipt を無効にする

ウェブアプリを更新しても、レストランのリスティングは引き続き読み込まれます。レストラン情報はサーバーレスポンスで返されます。JavaScript が有効になっている場合、レストラン情報はクライアントサイドの JavaScript コードを介してハイドレートされます。
DevTools で、JavaScript を再度有効にする。

Cloud Firestore スナップショットリスナーでレストランの更新をリッスンする

前のセクションでは、src/app/page.js ファイルからレストランの初期セットが読み込まれる方法を確認しました。src/app/page.js ファイルはサーバーコンポーネントであり、Firebase データ取得コードを含むサーバー上でレンダリングされます。

src/components/RestaurantListings.jsx ファイルはクライアントコンポーネントであり、サーバーレンダリングされたマークアップをハイドレートするように構成できます。

サーバー側でレンダリングされたマークアップをハイドレートするように src/components/RestaurantListings.jsx ファイルを構成する手順は次のとおりです。

src/components/RestaurantListings.jsx ファイルで、すでに記述されている次のコードを確認します。

useEffect(() => {
        const unsubscribe = getRestaurantsSnapshot(data => {
                setRestaurants(data);
        }, filters);

        return () => {
                unsubscribe();
        };
}, [filters]);

このコードは、前のステップで実装した getRestaurants() 関数に似ている getRestaurantsSnapshot() 関数を呼び出します。ただし、このスナップショット関数にはコールバックメカニズムが用意されているため、レストランのコレクションに変更が加えられるたびにコールバックが呼び出されます。

src/lib/firebase/firestore.js ファイルで、getRestaurantsSnapshot() 関数を次のコードに置き換えます。

export function getRestaurantsSnapshot(cb, filters = {}) {
	if (typeof cb !== "function") {
		console.log("Error: The callback parameter is not a function");
		return;
	}

	let q = query(collection(db, "restaurants"));
	q = applyQueryFilters(q, filters);

	const unsubscribe = onSnapshot(q, querySnapshot => {
		const results = querySnapshot.docs.map(doc => {
			return {
				id: doc.id,
				...doc.data(),
				// Only plain objects can be passed to Client Components from Server Components
				timestamp: doc.data().timestamp.toDate(),
			};
		});

		cb(results);
	});

	return unsubscribe;
}

[Firestore データベース] ページで行った変更がウェブアプリにリアルタイムで反映されるようになりました。

commit メッセージ「レストランのリアルタイム更新をリッスン」で commit を作成し、GitHub リポジトリに push します。
Firebase コンソールで [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
ウェブアプリで、 > サンプルのレストランを追加を選択します。スナップショット関数が正しく実装されていると、ページを更新しなくてもレストランがリアルタイムで表示されます。

8. ウェブアプリからユーザーが送信したレビューを保存する

src/lib/firebase/firestore.js ファイルで、updateWithRating() 関数を次のコードに置き換えます。

const updateWithRating = async (
	transaction,
	docRef,
	newRatingDocument,
	review
) => {
	const restaurant = await transaction.get(docRef);
	const data = restaurant.data();
	const newNumRatings = data?.numRatings ? data.numRatings + 1 : 1;
	const newSumRating = (data?.sumRating || 0) + Number(review.rating);
	const newAverage = newSumRating / newNumRatings;

	transaction.update(docRef, {
		numRatings: newNumRatings,
		sumRating: newSumRating,
		avgRating: newAverage,
	});

	transaction.set(newRatingDocument, {
		...review,
		timestamp: Timestamp.fromDate(new Date()),
	});
};

このコードは、新しいレビューを表す新しい Firestore ドキュメントを挿入します。また、レストランを表す既存の Firestore ドキュメントも更新され、評価の数と計算された平均評価の最新の値が反映されます。

関数全体を次の　addReviewToRestaurant()　に置き換えます。

export async function addReviewToRestaurant(db, restaurantId, review) {
	if (!restaurantId) {
		throw new Error("No restaurant ID has been provided.");
	}

	if (!review) {
		throw new Error("A valid review has not been provided.");
	}

	try {
		const docRef = doc(collection(db, "restaurants"), restaurantId);
		const newRatingDocument = doc(
			collection(db, `restaurants/${restaurantId}/ratings`)
		);

		// corrected line
		await runTransaction(db, transaction =>
			updateWithRating(transaction, docRef, newRatingDocument, review)
		);
	} catch (error) {
		console.error(
			"There was an error adding the rating to the restaurant",
			error
		);
		throw error;
	}
}

Next.js サーバーアクションを実装する

Next.js サーバーアクションには、フォームデータにアクセスするための便利な API が用意されています。たとえば、data.get("text") はフォーム送信ペイロードからテキスト値を取得します。

Next.js サーバーアクションを使用してレビューフォームの送信を処理する手順は次のとおりです。

src/components/ReviewDialog.jsx ファイルで、<form> 要素の action 属性を見つけます。

<form action={handleReviewFormSubmission}>

action 属性値は、次の手順で実装する関数を参照します。

src/app/actions.js ファイルで、handleReviewFormSubmission() 関数を次のコードに置き換えます。

// This is a next.js server action, which is an alpha feature, so
// use with caution.
// https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions
export async function handleReviewFormSubmission(data) {
        const { app } = await getAuthenticatedAppForUser();
        const db = getFirestore(app);

        await addReviewToRestaurant(db, data.get("restaurantId"), {
                text: data.get("text"),
                rating: data.get("rating"),

                // This came from a hidden form field.
                userId: data.get("userId"),
        });
}

レストランのレビューを追加する

レビューの送信のサポートを実装したので、レビューが Cloud Firestore に正しく挿入されていることを確認できます。

レビューを追加して Cloud Firestore に挿入されたことを確認する手順は次のとおりです。

commit メッセージ「ユーザーがレストランのレビューを送信できるようにする」で commit を作成し、GitHub リポジトリに push します。
Firebase コンソールで [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
ウェブアプリを更新し、ホームページからレストランを選択します。
レストランのページで [] をクリックします。
評価を選択してください。
クチコミを書く。
[送信] をクリックします。レビューはレビューのリストの上部に表示されます。
Cloud Firestore の [ドキュメントを追加] ペインで、レビューしたレストランのドキュメントを検索して選択します。
[コレクションを開始] ペインで [評価] を選択します。
[ドキュメントを追加] ペインで、確認するドキュメントを見つけて、想定どおりに挿入されていることを確認します。

Firestore エミュレータのドキュメント

9. ウェブアプリからユーザーがアップロードしたファイルを保存する

このセクションでは、ログイン時にレストランに関連付けられた画像を置き換えられるようにする機能を追加します。画像を Firebase Storage にアップロードし、レストランを表す Cloud Firestore ドキュメントで画像の URL を更新します。

ユーザーがアップロードしたファイルをウェブアプリから保存する手順は次のとおりです。

src/components/Restaurant.jsx ファイルで、ユーザーがファイルをアップロードしたときに実行されるコードを確認します。

async function handleRestaurantImage(target) {
        const image = target.files ? target.files[0] : null;
        if (!image) {
                return;
        }

        const imageURL = await updateRestaurantImage(id, image);
        setRestaurant({ ...restaurant, photo: imageURL });
}

変更は必要ありませんが、次の手順で updateRestaurantImage() 関数の動作を実装します。

src/lib/firebase/storage.js ファイルで、updateRestaurantImage() 関数と uploadImage() 関数を次のコードに置き換えます。

export async function updateRestaurantImage(restaurantId, image) {
	try {
		if (!restaurantId)
			throw new Error("No restaurant ID has been provided.");

		if (!image || !image.name)
			throw new Error("A valid image has not been provided.");

		const publicImageUrl = await uploadImage(restaurantId, image);
		await updateRestaurantImageReference(restaurantId, publicImageUrl);

		return publicImageUrl;
	} catch (error) {
		console.error("Error processing request:", error);
	}
}

async function uploadImage(restaurantId, image) {
	const filePath = `images/${restaurantId}/${image.name}`;
	const newImageRef = ref(storage, filePath);
	await uploadBytesResumable(newImageRef, image);

	return await getDownloadURL(newImageRef);
}

updateRestaurantImageReference() 関数はすでに実装されています。この関数は、更新された画像 URL を使用して、Cloud Firestore 内の既存のレストランドキュメントを更新します。

画像アップロード機能を確認する

画像が想定どおりにアップロードされたことを確認する手順は次のとおりです。

「ユーザーが各レストランの写真を変更できるようにする」という commit メッセージを付けて commit を作成し、GitHub リポジトリに push します。
Firebase コンソールで [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
ウェブアプリでログインしていることを確認し、レストランを選択します。
をクリックして、ファイルシステムから画像をアップロードします。イメージはローカル環境から Cloud Storage にアップロードされます。アップロードした画像はすぐに表示されます。
Firebase の Cloud Storage に移動します。
レストランを表すフォルダに移動します。アップロードした画像がフォルダに存在する。

10. 生成 AI でレストランのレビューを要約する

このセクションでは、レビューの要約機能を追加します。これにより、ユーザーはすべてのレビューを読まなくても、レストランに対する他のユーザーの意見を簡単に把握できます。

Gemini API キーを Cloud Secret Manager に保存する

Gemini API を使用するには、API キーが必要です。Google AI Studio でキーを作成します。
App Hosting は Cloud Secret Manager と統合されているため、API キーなどの機密情報を安全に保存できます。
1. ターミナルで次のコマンドを実行して、新しいシークレットを作成します。
```
firebase apphosting:secrets:set gemini-api-key
```
1. シークレット値の入力を求められた場合は、Google AI Studio から Gemini API キーをコピーして貼り付けます。
2. 新しいシークレットを apphosting.yaml に追加するかどうかを確認するメッセージが表示されたら、Y と入力して承認します。

Gemini API キーが Cloud Secret Manager に安全に保存され、App Hosting バックエンドからアクセスできるようになりました。

クチコミの概要コンポーネントを実装する

src/components/Reviews/ReviewSummary.jsx で、GeminiSummary 関数を次のコードに置き換えます。

export async function GeminiSummary({ restaurantId }) {
    const { firebaseServerApp } = await getAuthenticatedAppForUser();
    const reviews = await getReviewsByRestaurantId(
        getFirestore(firebaseServerApp),
        restaurantId
    );

    const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY);
    const model = genAI.getGenerativeModel({ model: "gemini-pro"});

    const reviewSeparator = "@";
    const prompt = `
        Based on the following restaurant reviews, 
        where each review is separated by a '${reviewSeparator}' character, 
        create a one-sentence summary of what people think of the restaurant. 

        Here are the reviews: ${reviews.map(review => review.text).join(reviewSeparator)}
    `;

    try {
        const result = await model.generateContent(prompt);
        const response = await result.response;
        const text = response.text();

        return (
            <div className="restaurant__review_summary">
                <p>{text}</p>
                <p>✨ Summarized with Gemini</p>
            </div>
        );
    } catch (e) {
        console.error(e);
        return <p>Error contacting Gemini</p>;
    }
}

「AI を使用してレビューを要約する」という commit メッセージを含む commit を作成し、GitHub リポジトリに push します。
Firebase コンソールで [App Hosting] ページを開き、新しいロールアウトが完了するまで待ちます。
レストランのページを開きます。ページの上部には、ページ上のすべてのレビューの概要が 1 文で表示されます。
新しいクチコミを追加してページを更新します。概要が変更されたことを確認できます。

11. まとめ

これで完了です。Firebase を使用して Next.js アプリに機能と機能を追加する方法について学びました。具体的には、以下を使用しました。

Firebase App Hosting: 構成したブランチに push するたびに、Next.js コードが自動的にビルドされ、デプロイされます。
Firebase Authentication: ログインとログアウト機能を有効にします。
Cloud Firestore: レストランデータとレストランのレビューデータ。
レストランの画像には Cloud Storage for Firebase を使用します。