ادغام کردن کیت‌های توسعه نرم‌افزار Firebase با برنامه وب

Firebase App Hosting برای برنامه‌های وب پویایی که با Firebase JavaScript SDK و Firebase Admin SDK برای Node.js ساخته شده‌اند، مناسب است. در یک برنامه وب با ویژگی‌های کامل، کیت‌های توسعه نرم‌افزار Firebase مانند Authentication، Cloud Firestore، و App Check نقش‌های مهمی ایفا می‌کنند. این راهنما برخی‌از استراتژی‌های کلیدی را برای کمک به بهینه‌سازی کیت‌های توسعه نرم‌افزار Firebase و شروع ساختن Firebase در برنامه وب شما در Firebase App Hosting شرح می‌دهد.

مقداردهی اولیه خودکار Firebase Admin SDK و کیت‌های توسعه نرم‌افزار وب

محیط‌های Google مانند Firebase App Hosting مقداردهی اولیه برنامه را ازطریق فراخوانی سازنده بدون آرگومان در زمان ساخت و زمان اجرا ساده می‌کنند. این ویژگی هم در Firebase Admin SDK برای Node.js (کیت توسعه نرم‌افزار سمت سرور که بخش بزرگی از عملکرد Firebase را باز می‌کند و می‌تواند در برنامه وب شما بسیار مفید باشد) و هم در کیت توسعه نرم‌افزار Firebase JavaScript وجود دارد.

با initializeApp()، می‌توانید به Firebase App Hosting اجازه دهید به‌طور خودکار پیکربندی برنامه وب را برای شما پر کند، درحالی‌که همچنان گزینه کنترل دقیق بر مقادیر خاص را درصورت تمایل به لغو مقادیر پیش‌فرض حفظ می‌کنید.

مقداردهی اولیه بدون متغیرهای مستقل

برای مقداردهی اولیه کیت توسعه نرم‌افزار (SDK) Firebase Admin SDK یا Firebase JavaScript با مقادیر پیکربندی پیش‌فرض، از initializeApp() بدون ارائه هیچ آرگومانی استفاده کنید.

Admin SDK

import { initializeApp } from 'firebase-admin/app';
const app = initializeApp();

برای Admin SDK، این راهبرد مقداردهی اولیه در App Hosting و همچنین دیگر محیط‌های سرور Google ازجمله Cloud Run، App Engine، و توابع Cloud Run کار می‌کند.

کیت توسعه نرم‌افزار جاوا اسکریپت

import { initializeApp } from 'firebase/app';
const app = initializeApp();

برای کیت توسعه نرم‌افزار جاوا اسکریپت، این راهبرد مقداردهی اولیه در App Hosting کار می‌کند.

لغو مقادیر تکمیل‌شده خودکار

می‌توانید پیکربندی پیش‌فرضی را که به‌طور خودکار تزریق می‌شود لغو کنید. توجه داشته باشید که این گزینه‌ها بین Admin SDK و کیت توسعه نرم‌افزار جاوا اسکریپت متفاوت است.

لغو کردن Admin SDK

برای مشخص کردن اختیاری گزینه‌های مقداردهی اولیه سفارشی برای سرویس‌هایی مانند Realtime Database،‏ Cloud Storage، یا Cloud Functions، از متغیر محیطی FIREBASE_CONFIG استفاده کنید. اگر محتوای متغیر FIREBASE_CONFIG با نویسه { شروع شود، به‌عنوان شیء JSON تجزیه خواهد شد. درغیراین‌صورت، کیت توسعه نرم‌افزار فرض می‌کند که رشته مسیر فایل JSON حاوی گزینه‌ها است.

# apphosting.yaml

env:
  - variable: FIREBASE_CONFIG
    value: '{"databaseURL":"https://project-id-default-rtdb.firebaseio.com","projectId":"my-project-id"}'

لغو کیت توسعه نرم‌افزار جاوا اسکریپت

برای لغو مقادیر پیش‌فرض FIREBASE_WEBAPP_CONFIG که App Hosting برای مقداردهی اولیه کیت توسعه نرم‌افزار جاوا اسکریپت تزریق می‌کند، می‌توانید مقادیر را در apphosting.yaml مشخص کنید:

# apphosting.yaml

env:
  - variable: FIREBASE_WEBAPP_CONFIG
    value: '{"apiKey":"myApiKey","appId":"app:123","authDomain":"project-id.firebaseapp.com","databaseURL":"https://project-id-default-rtdb.firebaseio.com","messagingSenderId":"0123456789","projectId":"project-id","storageBucket":"project-id.firebasestorage.app"}'

استفاده از مقداردهی اولیه خودکار در محیط‌های دیگر

مقداردهی اولیه خودکار با یک اسکریپت npmpostinstall هنگام نصب کیت توسعه نرم‌افزار جاوا اسکریپت در Firebase راه‌اندازی می‌شود. متن postinstall به‌دنبال متغیر محیطی FIREBASE_WEBAPP_CONFIG می‌گردد که به‌طور خودکار در محیط Cloud Build App Hosting تنظیم شده است.

اگر کیت توسعه نرم‌افزار JS را خارج از Cloud Build نصب می‌کنید، باید این متغیر محیطی را خودتان هنگام نصب کیت توسعه نرم‌افزار جاوا اسکریپت Firebase تنظیم کنید.

برای راه‌اندازی دستی محیط در زمان نصب:

  1. شیء پیکربندی برنامه وب Firebase خود را از کنسول Firebase کپی کنید.

  2. از پایانه، متغیر محیطی FIREBASE_WEBAPP_CONFIG را قبل‌از اجرای فرمان npm install تنظیم کنید.

FIREBASE_WEBAPP_CONFIG="{...}" npm install firebase

هرزمان پروژه Firebase یا برنامه وب خود را تغییر دادید، این فرمان را دوباره اجرا کنید. حافظه‌های نهان واسطه (مثل .next/cache) نیز ممکن است نیاز به پاک شدن داشته باشند.

استفاده از FirebaseServerApp برای SSR

اگر در توسعه برنامه وب خود با کیت توسعه نرم‌افزار Firebase JS یا سایر کیت‌های توسعه نرم‌افزار مشتری Firebase کار کرده‌اید، احتمالاً با رابط FirebaseApp و نحوه استفاده از آن برای پیکربندی نمونه‌های برنامه آشنا هستید. برای تسهیل عملیات مشابه در سمت سرور، Firebase‏ FirebaseServerApp را ارائه می‌دهد.

‫FirebaseServerApp گونه‌ای از FirebaseApp برای استفاده در محیط‌های پرداخت سمت سرور (SSR) است. این چارچوب شامل ابزارهایی برای ادامه دادن جلسه‌های Firebase است که تقسیم‌بندی پردازش سمت کارخواه (CSR) / پردازش سمت سرور را دربرمی‌گیرد.

از FirebaseServerApp برای این کارها استفاده کنید:

  • کد سمت سرور را در بافت کاربر اجرا می‌کند، برخلاف Firebase Admin SDK که حقوق کامل مدیریت دارد.
  • استفاده از App Check را در محیط‌های SSR فعال کنید.
  • ادامه دادن جلسه Firebase Auth که در کارخواه ایجاد شده است.

برای جزئیات کامل درباره استفاده از FirebaseServerApp برای این اهداف، به استفاده از Firebase در برنامه‌های وب پویا با SSR مراجعه کنید.

فعال کردن App Check در برنامه وب

می‌توانید از App Check برای تقویت امنیت برنامه وب پویایتان در App Hosting استفاده کنید. با پیاده‌سازی برخی‌از استراتژی‌های خاص سمت سرور که در استفاده از Firebase در برنامه‌های وب پویا با SSR شرح داده شده است، می‌توانید از App Hosting زیرینه‌هایتان دربرابر سوءاستفاده محافظت کنید.