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

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

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

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

מ-CDN

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

  1. כדי לכלול רק מוצרי 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/12.0.0/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/12.0.0/firebase-analytics.js'
    
        // Add Firebase products that you want to use
        import { getAuth } from 'https://www.gstatic.com/firebasejs/12.0.0/firebase-auth.js'
        import { getFirestore } from 'https://www.gstatic.com/firebasejs/12.0.0/firebase-firestore.js'
      </script>
    </body>
  2. מוסיפים את אובייקט ההגדרה של Firebase, ואז מאתחלים את Firebase באפליקציה:

    <body>
      <script type="module">
        // ...
    
        // TODO: Replace the following with your app's Firebase configuration
        const firebaseConfig = {
          // ...
        };
    
        // Initialize Firebase
        const app = initializeApp(firebaseConfig);
      </script>
    </body>

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

  1. מתקינים את Firebase JavaScript SDK:

    1. אם עדיין אין לכם קובץ package.json, אתם יכולים ליצור אותו על ידי הרצת הפקודה הבאה מהספרייה הראשית של פרויקט JavaScript:

      npm init
    2. מריצים את הפקודה הבאה כדי להתקין את חבילת ה-npm‏ firebase ולשמור אותה בקובץ package.json:

      npm install --save firebase@12.0.0
  2. כדי להשתמש במודול 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");
      


    • אפשר להשתמש בתחביר ESM כדי 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";
      
  3. מוסיפים את אובייקט ההגדרה של Firebase, ואז מאתחלים את Firebase באפליקציה:

    import { initializeApp } from 'firebase/app';
    
    // TODO: Replace the following with your app's Firebase configuration
    const firebaseConfig = {
      //...
    };
    
    // Initialize Firebase
    const app = initializeApp(firebaseConfig);