Mengintegrasikan Firebase dengan aplikasi Next.js

1. Sebelum memulai

Dalam codelab ini, Anda akan mempelajari cara mengintegrasikan Firebase dengan aplikasi web Next.js yang disebut Friendly Eats, yaitu situs yang menyediakan ulasan restoran.

Aplikasi web yang sudah selesai menawarkan fitur berguna yang menunjukkan bagaimana Firebase dapat membantu Anda membangun aplikasi Next.js. Fitur tersebut mencakup:

• Pembuatan dan deployment otomatis: Codelab ini menggunakan Firebase App Hosting untuk mem-build dan men-deploy kode Next.js secara otomatis setiap kali Anda melakukan push ke cabang yang dikonfigurasi.
• Login dan logout: Dengan aplikasi web yang sudah selesai, Anda dapat login dengan Google dan logout. Login dan persistensi pengguna dikelola sepenuhnya melalui Firebase Authentication.
• Gambar: Aplikasi web yang sudah selesai memungkinkan pengguna yang login mengupload gambar restoran. Aset gambar disimpan di Cloud Storage for Firebase. Firebase JavaScript SDK menyediakan URL publik untuk gambar yang diupload. URL publik ini kemudian disimpan di dokumen restoran yang relevan di Cloud Firestore.
• Ulasan: Dengan aplikasi web yang sudah selesai, pengguna yang login dapat memposting ulasan tentang restoran yang terdiri dari rating bintang dan pesan berbasis teks. Informasi ulasan disimpan di Cloud Firestore.
• Filter: Dengan aplikasi web yang sudah selesai, pengguna yang login dapat memfilter daftar restoran berdasarkan kategori, lokasi, dan harga. Anda juga dapat menyesuaikan metode pengurutan yang digunakan. Data diakses dari Cloud Firestore, dan kueri Firestore diterapkan berdasarkan filter yang digunakan.

Prasyarat

• Akun GitHub
• Pengetahuan tentang Next.js dan JavaScript

Yang akan Anda pelajari

• Cara menggunakan Firebase dengan Router Aplikasi Next.js dan rendering sisi server.
• Cara mempertahankan gambar di Cloud Storage for Firebase.
• Cara membaca dan menulis data di database Cloud Firestore.
• Cara menggunakan login dengan Google menggunakan Firebase JavaScript SDK.

Yang Anda butuhkan

• Git
• Node.js versi stabil terbaru
• Browser pilihan Anda, seperti Google Chrome
• Lingkungan pengembangan dengan editor kode dan terminal
• Akun Google untuk pembuatan dan pengelolaan project Firebase Anda
• Kemampuan untuk mengupgrade project Firebase ke paket harga Blaze

2. Menyiapkan lingkungan pengembangan dan repositori GitHub

Codelab ini menyediakan codebase awal aplikasi dan mengandalkan Firebase CLI.

Membuat repositori GitHub

Sumber codelab dapat ditemukan di https://github.com/firebase/friendlyeats-web. Repositori ini berisi project contoh untuk beberapa platform. Namun, codelab ini hanya menggunakan direktori nextjs-start. Perhatikan direktori berikut:

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

Salin folder nextjs-start ke repositori Anda sendiri:

1. Dengan menggunakan terminal, buat folder baru di komputer dan beralih ke direktori baru:

   mkdir codelab-friendlyeats-web
   
   cd codelab-friendlyeats-web
   

2. Gunakan paket npm giget untuk mengambil folder nextjs-start saja:

   npx giget@latest gh:firebase/friendlyeats-web/nextjs-start#master . --install
   

3. Melacak perubahan secara lokal dengan git:

   git init
   
   git commit -a -m "codelab starting point"
   
   git branch -M main
   

4. Buat repositori GitHub baru: https://github.com/new. Beri nama apa pun yang Anda inginkan.
5. Salin URL baru yang dibuat GitHub untuk Anda. Tampilannya akan seperti salah satu dari berikut ini:
   • https://github.com/<USER_NAME>/<REPOSITORY_NAME>.git atau
   • [e-mail]:<USER_NAME>/<REPOSITORY_NAME>.git
6. Kirim perubahan lokal ke repositori GitHub baru Anda dengan menjalankan perintah berikut. Ganti URL repositori sebenarnya dengan placeholder <REPOSITORY_URL>.

   git remote add origin <REPOSITORY_URL>
   
   git push -u origin main
   

7. Sekarang Anda akan melihat kode awal di repositori GitHub.

Menginstal atau mengupdate Firebase CLI

Jalankan perintah berikut untuk memverifikasi bahwa Anda telah menginstal Firebase CLI dan menggunakan v13.9.0 atau yang lebih tinggi:

firebase --version

Jika Anda melihat versi yang lebih rendah atau belum menginstal Firebase CLI, jalankan perintah penginstalan:

npm install -g firebase-tools@latest

Jika Anda tidak dapat menginstal Firebase CLI karena error izin, lihat dokumentasi npm atau gunakan opsi penginstalan lainnya.

Login ke Firebase

1. Jalankan perintah berikut untuk login ke Firebase CLI:

   firebase login
   

2. Bergantung pada apakah Anda ingin Firebase mengumpulkan data, masukkan Y atau N.
3. Di browser, pilih akun Google Anda, lalu klik Allow.

3. Menyiapkan project Firebase

Di bagian ini, Anda akan menyiapkan project Firebase dan mengaitkan aplikasi web Firebase dengan project tersebut. Anda juga akan menyiapkan layanan Firebase yang digunakan oleh aplikasi web contoh.

Membuat project Firebase

1. Di Firebase console, klik Tambahkan project.
2. Di kotak teks Enter your project name, masukkan FriendlyEats Codelab (atau nama project pilihan Anda), lalu klik Continue.
3. Di modal Konfirmasi paket penagihan Firebase, konfirmasi bahwa paketnya adalah Blaze, lalu klik Konfirmasi paket
4. Untuk codelab ini, Anda tidak memerlukan Google Analytics. Oleh karena itu, nonaktifkan opsi Enable Google Analytics for this project.
5. Klik Create project.
6. Tunggu hingga project Anda disediakan, lalu klik Continue.
7. Di project Firebase Anda, buka Project Settings. Catat project ID Anda karena Anda akan memerlukannya nanti. ID unik ini adalah cara project Anda diidentifikasi (misalnya, di Firebase CLI).

Mengupgrade paket harga Firebase Anda

Untuk menggunakan Firebase App Hosting dan Cloud Storage for Firebase, project Firebase Anda harus menggunakan paket harga bayar sesuai pemakaian (Blaze), yang berarti project tersebut ditautkan ke akun Penagihan Cloud.

• Akun Penagihan Cloud memerlukan metode pembayaran, seperti kartu kredit.
• Jika Anda baru menggunakan Firebase dan Google Cloud, periksa apakah Anda memenuhi syarat untuk mendapatkan kredit sebesar$300 dan akun Penagihan Cloud Uji Coba Gratis.
• Jika Anda melakukan codelab ini sebagai bagian dari acara, tanyakan kepada penyelenggara apakah ada kredit Cloud yang tersedia.

Untuk mengupgrade project Anda ke paket Blaze, ikuti langkah-langkah berikut:

1. Di Firebase console, pilih upgrade your plan.
2. Pilih paket Blaze. Ikuti petunjuk di layar untuk menautkan akun Penagihan Cloud ke project Anda.
   Jika perlu membuat akun Penagihan Cloud sebagai bagian dari upgrade ini, Anda mungkin perlu kembali ke alur upgrade di Firebase console untuk menyelesaikan upgrade.

Catatan: Anda dapat mendowngrade project ke paket harga tanpa biaya (Spark) setelah menyelesaikan codelab ini.

Menambahkan aplikasi web ke project Firebase

1. Buka Project overview di project Firebase Anda, lalu klik Web.
   
   Jika Anda sudah memiliki aplikasi yang terdaftar di project, klik Add app untuk melihat ikon Web.
2. Di kotak teks App nickname, masukkan nama panggilan aplikasi yang mudah diingat, seperti My Next.js app.
3. Jangan centang kotak Also set up Firebase Hosting for this app.
4. Klik Register app > Next > Next > Continue to konsol.
   

Menyiapkan layanan Firebase di Firebase console

Menyiapkan Authentication

1. Di Firebase console, buka Authentication.
2. Klik Get started.
3. Di kolom Additional providers, klik Google > Enable.
4. Di kotak teks Public-facing name for project, masukkan nama yang mudah diingat, seperti My Next.js app.
5. Dari drop-down Support email for project, pilih alamat email Anda.
6. Klik Save.

Menyiapkan Cloud Firestore

1. Di panel kiri Firebase console, luaskan Build, lalu pilih Firestore database.
2. Klik Create database.
3. Biarkan Database ID ditetapkan ke (default).
4. Pilih lokasi untuk database Anda, lalu klik Berikutnya.
   Untuk aplikasi yang sebenarnya, Anda harus memilih lokasi yang dekat dengan pengguna.
5. Klik Mulai dalam mode pengujian. Baca pernyataan penyangkalan tentang aturan keamanan.
   Di codelab ini, Anda akan menambahkan Aturan Keamanan untuk mengamankan data. Jangan mendistribusikan atau mengekspos aplikasi ke publik tanpa menambahkan Aturan Keamanan untuk database Anda.
6. Klik Buat.

Menyiapkan Cloud Storage for Firebase

1. Di panel kiri Firebase console, luaskan Build, lalu pilih Storage.
2. Klik Mulai.
3. Pilih lokasi untuk bucket Storage default Anda.
   Bucket di US-WEST1, US-CENTRAL1, dan US-EAST1 dapat memanfaatkan paket"Selalu Gratis" untuk Google Cloud Storage. Bucket di semua lokasi lainnya mengikuti harga dan penggunaan Google Cloud Storage.
4. Klik Mulai dalam mode pengujian. Baca pernyataan penyangkalan tentang aturan keamanan.
   Di codelab ini, Anda akan menambahkan aturan keamanan untuk mengamankan data. Jangan mendistribusikan atau mengekspos aplikasi ke publik tanpa menambahkan Aturan Keamanan untuk bucket Storage Anda.
5. Klik Buat.

4. Meninjau codebase awal

Di bagian ini, Anda akan meninjau beberapa area codebase awal aplikasi yang akan ditambahi fungsi dalam codelab ini.

Struktur folder dan file

Tabel berikut berisi ringkasan struktur folder dan file aplikasi:

Folder dan file	Deskripsi
src/components	Komponen React untuk filter, header, detail restoran, dan ulasan
src/lib	Fungsi utilitas yang tidak harus terikat dengan React atau Next.js
src/lib/firebase	Kode khusus Firebase dan konfigurasi Firebase
public	Aset statis di aplikasi web, seperti ikon
src/app	Memilih rute dengan Router Aplikasi Next.js
src/app/restaurant	Pengendali rute API
package.json dan package-lock.json	Dependensi project dengan npm
next.config.js	Konfigurasi khusus Next.js (tindakan server diaktifkan)
jsconfig.json	Konfigurasi layanan bahasa JavaScript

Komponen server dan klien

Aplikasi ini adalah aplikasi web Next.js yang menggunakan Router Aplikasi. Rendering server digunakan di seluruh aplikasi. Misalnya, file src/app/page.js adalah komponen server yang bertanggung jawab atas halaman utama. File src/components/RestaurantListings.jsx adalah komponen klien yang ditunjukkan oleh perintah "use client" di awal file.

Pernyataan impor

Anda mungkin melihat pernyataan impor seperti berikut:

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

Aplikasi menggunakan simbol @ untuk menghindari jalur impor relatif yang kaku dan dimungkinkan oleh alias jalur.

API khusus Firebase

Semua kode Firebase API digabungkan dalam direktori src/lib/firebase. Setiap komponen React kemudian mengimpor fungsi yang digabungkan dari direktori src/lib/firebase, bukan mengimpor fungsi Firebase secara langsung.

Data tiruan

Data restoran dan ulasan tiruan terdapat dalam file src/lib/randomData.js. Data dari file tersebut disusun dalam kode di file src/lib/fakeRestaurants.js.

5. Membuat backend Hosting Aplikasi

Di bagian ini, Anda akan menyiapkan backend Hosting Aplikasi untuk memantau cabang di repositori git.

Catatan: Firebase App Hosting masih dalam pratinjau publik.

Di akhir bagian ini, Anda akan memiliki backend App Hosting yang terhubung ke repositori di GitHub yang akan otomatis mem-build ulang dan meluncurkan versi baru aplikasi setiap kali Anda mendorong commit baru ke cabang main.

Men-deploy Aturan Keamanan

Kode ini sudah memiliki kumpulan aturan keamanan untuk Firestore dan Cloud Storage for Firebase. Setelah Anda men-deploy Aturan Keamanan, data dalam database dan bucket akan lebih terlindungi dari penyalahgunaan.

1. Di terminal, konfigurasikan CLI untuk menggunakan project Firebase yang Anda buat sebelumnya:

   firebase use --add
   

   Saat diminta memasukkan alias, masukkan friendlyeats-codelab.
2. Untuk men-deploy Aturan Keamanan ini, jalankan perintah ini di terminal Anda:

   firebase deploy --only firestore:rules,storage
   

3. Jika ditanya: "Cloud Storage for Firebase needs an IAM Role to use cross-service rules. Grant the new role?", tekan Enter untuk memilih Yes.

Menambahkan konfigurasi Firebase ke kode aplikasi web

1. Di Firebase console, buka Project settings.
2. Scroll ke bawah ke bagian Aplikasi Anda, lalu pilih Aplikasi Web Firebase yang Anda buat sebelumnya di codelab ini.
3. Salin variabel firebaseConfig, lalu salin properti dan nilainya.
4. Buka file apphosting.yaml di editor kode Anda, dan isi nilai variabel lingkungan dengan nilai konfigurasi dari Firebase console.
5. Dalam file, ganti properti yang ada dengan properti yang Anda salin.
6. Simpan file.

Membuat backend

1. Buka halaman App Hosting di Firebase console:

2. Klik "Mulai" untuk memulai alur pembuatan backend. Konfigurasikan backend Anda sebagai berikut:
3. Ikuti petunjuk di langkah pertama untuk menghubungkan repositori GitHub yang Anda buat sebelumnya.
4. Tetapkan setelan deployment:
   1. Pertahankan direktori utama sebagai /
   2. Menetapkan cabang aktif ke main
   3. Mengaktifkan peluncuran otomatis
5. Beri nama backend Anda friendlyeats-codelab.
6. Di "Create or associate a Firebase web app", pilih aplikasi web yang Anda konfigurasi sebelumnya dari drop-down "Select an existing Firebase web app".
7. Klik "Selesaikan dan deploy". Setelah beberapa saat, Anda akan diarahkan ke halaman baru tempat Anda dapat melihat status backend Hosting Aplikasi baru.

   Catatan: Anda dapat memantau layanan Google Cloud yang mendasari backend Hosting Aplikasi dengan mengikuti link dari konsol. Pelajari lebih lanjut di Melihat log dan metrik.

8. Setelah peluncuran selesai, klik domain gratis Anda di bagian "domain". Mungkin perlu waktu beberapa menit untuk mulai berfungsi karena penyebaran DNS.

Anda telah men-deploy aplikasi web awal. Setiap kali Anda mendorong commit baru ke cabang main di repositori GitHub, Anda akan melihat build dan peluncuran baru dimulai di Firebase console, dan situs Anda akan otomatis diperbarui setelah peluncuran selesai.

6. Menambahkan autentikasi ke aplikasi web

Di bagian ini, Anda akan menambahkan autentikasi ke aplikasi web sehingga Anda dapat login ke aplikasi tersebut.

Catatan: Di sepanjang bagian ini, perhatikan jumlah kode minimal yang diperlukan untuk mulai menggunakan Firebase Authentication, yang secara langsung mendukung banyak penyedia autentikasi. Namun, codelab ini menggunakan satu penyedia, yaitu Login dengan Google.

Mengimplementasikan fungsi login dan logout

1. Di file src/lib/firebase/auth.js, ganti fungsi onAuthStateChanged, signInWithGoogle, dan signOut dengan kode berikut:

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);
  }
}

Kode ini menggunakan Firebase API berikut:

Firebase API	Deskripsi
GoogleAuthProvider	Membuat instance penyedia autentikasi Google.
signInWithPopup	Memulai alur autentikasi berbasis dialog.
auth.signOut	Memproses logout pengguna.

Dalam file src/components/Header.jsx, kode sudah memanggil fungsi signInWithGoogle dan signOut.

1. Buat commit dengan pesan commit "Menambahkan Google Authentication" dan kirim ke repositori GitHub Anda. 1. Buka halaman App Hosting di Firebase console dan tunggu peluncuran baru Anda selesai.
2. Di aplikasi web, muat ulang halaman dan klik Sign in with Google. Aplikasi web tidak diupdate, sehingga tidak jelas apakah login berhasil atau tidak.

Catatan: Terlepas dari apakah aplikasi web diupdate, Anda telah menggunakan Firebase Authentication. Anda dapat memverifikasi bahwa ada pengguna autentikasi baru di Firebase console di halaman Authentication.

Mengirim status autentikasi ke server

Untuk meneruskan status autentikasi ke server, kita akan menggunakan pekerja layanan. Ganti fungsi fetchWithFirebaseHeaders dan getAuthIdToken dengan kode berikut:

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);
}

Membaca status autentikasi di server

Kita akan menggunakan FirebaseServerApp untuk mencerminkan status autentikasi klien di server.

Buka src/lib/firebase/serverApp.js, dan ganti fungsi 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 };
}

Berlangganan perubahan autentikasi

Untuk berlangganan perubahan autentikasi, ikuti langkah-langkah berikut:

1. Buka file src/components/Header.jsx.
2. Ganti fungsi useUserSession dengan kode berikut:

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;
}

Catatan: Khusus untuk aplikasi web ini, penggunaan Firebase API digabungkan dalam folder src//lib/firebase. Ini juga merupakan pendekatan yang valid untuk menggunakan Firebase API langsung di komponen yang membutuhkannya, atau bahkan menggunakan hook lain seperti ReactFire atau React Firebase Hooks. Jika Anda menggunakan hook tersebut, pastikan penggunaan Anda sesuai dengan paradigma baru yang diperkenalkan pada Router Aplikasi Next.js dan komponen server.

Kode ini menggunakan hook state React untuk mengupdate pengguna saat fungsi onAuthStateChanged menentukan bahwa ada perubahan pada status autentikasi.

Memverifikasi perubahan

Tata letak root di file src/app/layout.js merender header dan meneruskan pengguna, jika tersedia, sebagai properti.

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

Ini berarti komponen <Header> akan merender data pengguna, jika tersedia, selama waktu proses server. Jika ada update autentikasi selama siklus proses halaman setelah pemuatan halaman awal, pengendali onAuthStateChanged akan menanganinya.

Sekarang saatnya meluncurkan build baru dan memverifikasi apa yang telah Anda buat.

1. Buat commit dengan pesan commit "Show signin state" dan kirim ke repositori GitHub Anda.
2. Buka halaman App Hosting di Firebase console dan tunggu peluncuran baru Anda selesai.
3. Verifikasi perilaku autentikasi baru:
   1. Di browser, muat ulang aplikasi web. Nama tampilan Anda akan muncul di header.
   2. Logout dan login lagi. Halaman diupdate secara real time tanpa memuat ulang halaman. Anda dapat mengulangi langkah ini dengan pengguna lain.
   3. Opsional: Klik kanan aplikasi web, pilih View page source, lalu telusuri nama tampilan. Nama tampilan akan muncul di sumber HTML mentah yang ditampilkan dari server.

7. Melihat informasi restoran

Aplikasi web menyertakan data tiruan untuk restoran dan ulasan.

Menambahkan satu atau beberapa restoran

Catatan: Pada langkah ini, Anda mengklik tombol Add sample restaurants. Perhatikan bahwa tidak ada masukan untuk tindakan ini karena fungsinya belum ada. Baca langkah-langkah berikut dengan cermat untuk memahami cara memverifikasi restoran yang ditambahkan.

Untuk memasukkan data restoran tiruan ke database Cloud Firestore lokal Anda, ikuti langkah-langkah berikut:

1. Di aplikasi web, pilih > Add sample restaurants.
2. Di Firebase console di halaman Firestore Database, pilih restaurants. Anda akan melihat dokumen tingkat teratas dalam koleksi restoran, yang masing-masing mewakili restoran.
3. Klik beberapa dokumen untuk menjelajahi properti dokumen restoran.

Menampilkan daftar restoran

Database Cloud Firestore Anda sekarang memiliki restoran yang dapat ditampilkan oleh aplikasi web Next.js.

Untuk menentukan kode pengambilan data, ikuti langkah-langkah berikut:

1. Dalam file src/app/page.js, temukan komponen server <Home />, dan tinjau panggilan ke fungsi getRestaurants, yang mengambil daftar restoran pada waktu proses server. Anda akan menerapkan fungsi getRestaurants dalam langkah-langkah berikut.
2. Di file src/lib/firebase/firestore.js, ganti fungsi applyQueryFilters dan getRestaurants dengan kode berikut:

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(),
		};
	});
}

1. Buat commit dengan pesan commit "Baca daftar restoran dari Firestore" dan kirimkan ke repositori GitHub Anda.
2. Buka halaman App Hosting di Firebase console dan tunggu peluncuran baru Anda selesai.
3. Di aplikasi web, muat ulang halaman. Gambar restoran muncul sebagai kartu di halaman.

Catatan: Meskipun Cloud Firestore menawarkan fitur snapshot berguna yang dapat membantu aplikasi web reaktif, untuk saat ini Anda hanya perlu mendapatkan daftar awal restoran di sisi server. Oleh karena itu, fungsi getRestaurants menggunakan fungsi getDocs dari Cloud Firestore, bukan fungsi onSnapshot.

Memastikan listingan restoran dimuat pada waktu proses server

Dengan menggunakan framework Next.js, mungkin akan sulit untuk mengetahui kapan data dimuat pada waktu proses server atau waktu proses sisi klien.

Untuk memverifikasi bahwa listingan restoran dimuat pada waktu proses server, ikuti langkah-langkah berikut:

1. Di aplikasi web, buka DevTools dan nonaktifkan JavaScript.

2. Muat ulang aplikasi web. Listingan restoran masih dimuat. Informasi restoran ditampilkan di respons server. Jika JavaScript diaktifkan, informasi restoran dihidrasi melalui kode JavaScript sisi klien.
3. Di DevTools, aktifkan kembali JavaScript.

Memproses update restoran dengan pemroses snapshot Cloud Firestore

Di bagian sebelumnya, Anda telah melihat cara kumpulan restoran awal dimuat dari file src/app/page.js. File src/app/page.js adalah komponen server dan dirender di server, termasuk kode pengambilan data Firebase.

File src/components/RestaurantListings.jsx adalah komponen klien dan dapat dikonfigurasi untuk menghidrasi markup yang dirender server.

Untuk mengonfigurasi file src/components/RestaurantListings.jsx guna menghidrasi markup yang dirender server, ikuti langkah-langkah berikut:

1. Dalam file src/components/RestaurantListings.jsx, amati kode berikut, yang sudah ditulis untuk Anda:

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

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

Kode ini memanggil fungsi getRestaurantsSnapshot(), yang mirip dengan fungsi getRestaurants() yang Anda implementasikan di langkah sebelumnya. Namun, fungsi snapshot ini menyediakan mekanisme callback sehingga callback dipanggil setiap kali perubahan dilakukan pada koleksi restoran.

2. Di file src/lib/firebase/firestore.js, ganti fungsi getRestaurantsSnapshot() dengan kode berikut:

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;
}

Perubahan yang dilakukan melalui halaman Database Firestore kini tercermin di aplikasi web secara real time.

1. Buat commit dengan pesan commit "Listen for realtime restaurant updates" dan kirim ke repositori GitHub Anda.
2. Buka halaman App Hosting di Firebase console dan tunggu peluncuran baru Anda selesai.
3. Di aplikasi web, pilih > Add sample restaurants. Jika fungsi snapshot Anda diterapkan dengan benar, restoran akan muncul secara real time tanpa memuat ulang halaman.

8. Menyimpan ulasan yang dikirimkan pengguna dari aplikasi web

1. Di file src/lib/firebase/firestore.js, ganti fungsi updateWithRating() dengan kode berikut:

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()),
	});
};

Kode ini menyisipkan dokumen Firestore baru yang mewakili ulasan baru. Kode ini juga mengupdate dokumen Firestore yang ada yang mewakili restoran dengan angka yang diperbarui untuk jumlah rating dan rata-rata rating yang dihitung.

2. Ganti fungsi addReviewToRestaurant() dengan kode berikut:

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;
	}
}

Mengimplementasikan Tindakan Server Next.js

Tindakan Server Next.js menyediakan API yang mudah digunakan untuk mengakses data formulir, seperti data.get("text") untuk mendapatkan nilai teks dari payload pengiriman formulir.

Untuk menggunakan Tindakan Server Next.js guna memproses pengiriman formulir peninjauan, ikuti langkah-langkah berikut:

1. Dalam file src/components/ReviewDialog.jsx, temukan atribut action di elemen <form>.

<form action={handleReviewFormSubmission}>

Nilai atribut action mengacu pada fungsi yang Anda implementasikan di langkah berikutnya.

2. Di file src/app/actions.js, ganti fungsi handleReviewFormSubmission() dengan kode berikut:

// 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"),
        });
}

Catatan: Kolom formulir tersembunyi digunakan di file components/ReviewDialog.jsx. Kolom formulir tersembunyi akan menyematkan ID restoran dan pengguna, sehingga tindakan server Next.js dapat mengakses nilai tersebut setelah pengiriman formulir.

Menambahkan ulasan restoran

Anda telah menerapkan dukungan untuk pengiriman ulasan, jadi sekarang Anda dapat memverifikasi bahwa ulasan Anda disisipkan ke Cloud Firestore dengan benar.

Untuk menambahkan ulasan dan memverifikasi bahwa ulasan tersebut disisipkan ke Cloud Firestore, ikuti langkah-langkah berikut:

1. Buat commit dengan pesan commit "Izinkan pengguna mengirimkan ulasan restoran" dan kirimkan ke repositori GitHub Anda.
2. Buka halaman App Hosting di Firebase console dan tunggu peluncuran baru Anda selesai.
3. Muat ulang aplikasi web, lalu pilih restoran dari halaman beranda.
4. Di halaman restoran, klik .
5. Pilih rating bintang.
6. Tulis ulasan.
7. Klik Submit. Ulasan Anda akan muncul di bagian atas daftar ulasan.
8. Di Cloud Firestore, telusuri panel Add document untuk dokumen restoran yang telah Anda ulas dan pilih dokumen tersebut.
9. Di panel Start collection, pilih ratings.
10. Di panel Add document, temukan dokumen untuk peninjauan Anda guna memverifikasi bahwa dokumen tersebut disisipkan seperti yang diharapkan.

Catatan: Saat Anda menyisipkan ulasan, ulasan tersebut akan langsung muncul di halaman tanpa memuat ulang halaman. Hal ini berfungsi karena snapshot Firestore dan Hook React. Jika Anda ingin mengingatkan diri Anda tentang kode, buka file src/components/Restaurant.jsx, dan periksa referensi ke fungsi getReviewsSnapshotByRestaurantId().

9. Menyimpan file yang diupload pengguna dari aplikasi web

Di bagian ini, Anda menambahkan fungsi sehingga Anda dapat mengganti gambar yang terkait dengan restoran saat Anda login. Anda mengupload gambar ke Firebase Storage, dan mengupdate URL gambar di dokumen Cloud Firestore yang mewakili restoran.

Untuk menyimpan file yang diupload pengguna dari aplikasi web, ikuti langkah-langkah berikut:

1. Di file src/components/Restaurant.jsx, amati kode yang berjalan saat pengguna mengupload file:

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 });
}

Perubahan tidak diperlukan, tetapi Anda menerapkan perilaku fungsi updateRestaurantImage() dalam langkah-langkah berikut.

2. Di file src/lib/firebase/storage.js, ganti fungsi updateRestaurantImage() dan uploadImage() dengan kode berikut:

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);
}

Fungsi updateRestaurantImageReference() sudah diimplementasikan untuk Anda. Fungsi ini mengupdate dokumen restoran yang ada di Cloud Firestore dengan URL gambar yang diupdate.

Memverifikasi fungsi upload gambar

Untuk memastikan bahwa gambar diupload seperti yang diharapkan, ikuti langkah-langkah berikut:

1. Buat commit dengan pesan commit "Izinkan pengguna mengubah setiap foto restoran" dan kirimkan ke repositori GitHub Anda.
2. Buka halaman App Hosting di Firebase console dan tunggu peluncuran baru Anda selesai.
3. Di aplikasi web, pastikan Anda login dan pilih restoran.
4. Klik lalu upload gambar dari sistem file Anda. Gambar Anda meninggalkan lingkungan lokal dan diupload ke Cloud Storage. Gambar akan langsung muncul setelah Anda menguploadnya.
5. Buka Cloud Storage for Firebase.
6. Buka folder yang mewakili restoran. Gambar yang Anda upload ada di folder.

Catatan: Cloud Storage for Firebase adalah layanan yang tepat untuk digunakan untuk resource biner seperti file gambar.

10. Meringkas ulasan restoran dengan AI generatif

Di bagian ini, Anda akan menambahkan fitur ringkasan ulasan sehingga pengguna dapat dengan cepat memahami pendapat semua orang tentang restoran tanpa harus membaca setiap ulasan.

Menyimpan kunci Gemini API di Cloud Secret Manager

1. Untuk menggunakan Gemini API, Anda memerlukan kunci API. Buat kunci di Google AI Studio.
2. App Hosting terintegrasi dengan Cloud Secret Manager untuk memungkinkan Anda menyimpan nilai sensitif seperti kunci API dengan aman:
   1. Di terminal, jalankan perintah untuk membuat secret baru:

   firebase apphosting:secrets:set gemini-api-key
   

   1. Saat diminta memasukkan nilai rahasia, salin dan tempel kunci Gemini API Anda dari Google AI Studio.
   2. Saat ditanya apakah secret baru harus ditambahkan ke apphosting.yaml, masukkan Y untuk menyetujui.

Kunci Gemini API Anda kini disimpan dengan aman di Cloud Secret Manager, dan dapat diakses oleh backend Hosting Aplikasi Anda.

Mengimplementasikan komponen ringkasan ulasan

1. Di src/components/Reviews/ReviewSummary.jsx, ganti fungsi GeminiSummary dengan kode berikut:

   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>;
       }
   }
   

2. Buat commit dengan pesan commit "Gunakan AI untuk meringkas ulasan" dan kirimkan ke repositori GitHub Anda.
3. Buka halaman App Hosting di Firebase console dan tunggu peluncuran baru Anda selesai.
4. Buka halaman untuk restoran. Di bagian atas, Anda akan melihat ringkasan satu kalimat dari semua ulasan di halaman.
5. Tambahkan ulasan baru dan muat ulang halaman. Anda akan melihat perubahan ringkasan.

11. Kesimpulan

Selamat! Anda telah mempelajari cara menggunakan Firebase untuk menambahkan fitur dan fungsi ke aplikasi Next.js. Secara khusus, Anda telah menggunakan hal berikut:

• Firebase App Hosting untuk mem-build dan men-deploy kode Next.js secara otomatis setiap kali Anda melakukan push ke cabang yang dikonfigurasi.
• Firebase Authentication untuk mengaktifkan fungsi login dan logout.
• Cloud Firestore untuk data restoran dan data ulasan restoran.
• Cloud Storage for Firebase untuk gambar restoran.

Pelajari lebih lanjut

• Codelab Web Cloud Firestore
• Codelab Framework Web Angular Firebase
• Melindungi data Firestore dengan Aturan Keamanan Firebase