طرق بديلة لإضافة 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.13.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.13.0/firebase-analytics.js'
    
        // Add Firebase products that you want to use
        import { getAuth } from 'https://www.gstatic.com/firebasejs/12.13.0/firebase-auth.js'
        import { getFirestore } from 'https://www.gstatic.com/firebasejs/12.13.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.13.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);