דרכים חלופיות להוספת Firebase לפרויקט JavaScript

ברוב אפליקציות האינטרנט של Firebase מומלץ מאוד להשתמש ב-SDK דרך npm. עם זאת, למשתמשים עם דרישות מיוחדות, Firebase מספק דרכים חלופיות להוספת ה-SDK. בדף הזה מפורטות הוראות להגדרה של השיטות החלופיות הבאות:

CDN (רשת להעברת תוכן)
npm לאפליקציות Node.js

בעזרת השיטות האלה אפשר להוסיף לאפליקציה כל אחת מהספריות הזמינות.

מה-CDN

אפשר להגדיר ייבוא חלקי של ה-SDK של Firebase JavaScript ולטעון רק את מוצרי Firebase הנחוצים לכם. Firebase שומרת כל ספרייה של Firebase JavaScript SDK ברשת ה-CDN (Content Delivery Network) הגלובלית שלנו.

כדי לכלול רק מוצרי Firebase ספציפיים (לדוגמה, Authentication ו-Cloud Firestore), מוסיפים את הסקריפט הבא לתחתית התג <body>, אבל לפני שמשתמשים בשירותי Firebase:

<body>
  <!-- Insert this script at the bottom of the HTML, but before you use any Firebase services -->
  <script type="module">
    import { initializeApp } from 'https://www.gstatic.com/firebasejs/11.3.1/firebase-app.js'

    // If you enabled Analytics in your project, add the Firebase SDK for Google Analytics
    import { getAnalytics } from 'https://www.gstatic.com/firebasejs/11.3.1/firebase-analytics.js'

    // Add Firebase products that you want to use
    import { getAuth } from 'https://www.gstatic.com/firebasejs/11.3.1/firebase-auth.js'
    import { getFirestore } from 'https://www.gstatic.com/firebasejs/11.3.1/firebase-firestore.js'
  </script>
</body>

מוסיפים את אובייקט התצורה של Firebase ומפעילים את Firebase באפליקציה:

<body>
  <script type="module">
    // ...

    // TODO: Replace the following with your app's Firebase project configuration
    const firebaseConfig = {
      // ...
    };

    // Initialize Firebase
    const app = initializeApp(firebaseConfig);
  </script>
</body>

אפליקציות Node.js

מתקינים את ה-SDK של Firebase JavaScript:
1. אם עדיין אין לכם קובץ package.json, תוכלו ליצור אותו על ידי הפעלת הפקודה הבאה מהשורש של פרויקט JavaScript:
```
npm init
```
2. כדי להתקין את חבילת ה-npm firebase ולשמור אותה בקובץ package.json, מריצים את הפקודה:
```
npm install --save firebase@11.3.1
```
אפשר להשתמש באחת מהאפשרויות הבאות כדי להשתמש במודול Firebase באפליקציה:
- אפשר require מודולים מכל קובץ JavaScript
  
  כדי לכלול רק מוצרי Firebase ספציפיים (כמו Authentication ו-Cloud Firestore):
```
// Firebase App (the core Firebase SDK) is always required and
// must be listed before other Firebase SDKs
var firebase = require("firebase/app");

// Add the Firebase products that you want to use
require("firebase/auth");
require("firebase/firestore");
```
  כדאי לכלול את כל Firebase JavaScript SDK, במקום ערכות SDK נפרדות (לא מומלץ לאפליקציות בסביבת ייצור)
  
  טעינה של כל ה-SDK לא יעילה לאפליקציות אינטרנט בסביבת ייצור.
  אפשר להשתמש באפשרות הזו למטרות פיתוח בלבד.
```
var firebase = require("firebase");
```
- אפשר להשתמש ב-ES2015 במודולים של import
  
  כדי לכלול רק מוצרי Firebase ספציפיים (כמו Authentication ו-Cloud Firestore):
```
// Firebase App (the core Firebase SDK) is always required and
// must be listed before other Firebase SDKs
import firebase from "firebase/app";

// Add the Firebase services that you want to use
import "firebase/auth";
import "firebase/firestore";
```
  כדאי לכלול את כל Firebase JavaScript SDK, במקום ערכות SDK נפרדות (לא מומלץ לאפליקציות בסביבת ייצור)
  
  טעינה של כל ה-SDK לא יעילה לאפליקציות אינטרנט בסביבת ייצור.
  אפשר להשתמש באפשרות הזו למטרות פיתוח בלבד.
```
import firebase from "firebase";
```
  הערה: השימוש בתחביר import ישירות עם Node.js הוא ניסיוני, אבל אפשר להמיר לפורמט CommonJS (תחביר require) באמצעות מהדרים כמו Babel.

מוסיפים את אובייקט התצורה של Firebase ומפעילים את Firebase באפליקציה:

import { initializeApp } from 'firebase/app';

// TODO: Replace the following with your app's Firebase project configuration
const firebaseConfig = {
  //...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);