יצירת מסד נתונים של Firestore באמצעות ספריית לקוח לאינטרנט או לנייד

גרסה 9 לאינטרנט

1. פועלים לפי ההוראות להוספת Firebase לאפליקציית האינטרנט.
2. מייבאים גם את Firebase וגם את Firestore:

   import { initializeApp } from "firebase/app";
   import { getFirestore } from "firebase/firestore";

גרסה 8 לאינטרנט

1. פועלים לפי ההוראות להוספת Firebase לאפליקציית האינטרנט.
2. מוסיפים את ספריות Firebase ו-Firestore לאפליקציה:
   ‫

   <script src="https://www.gstatic.com/firebasejs/8.10.1/firebase-app.js"></script>
   <script src="https://www.gstatic.com/firebasejs/8.10.1/firebase-firestore.js"></script>

   חבילת Firestore SDK זמינה גם כחבילת npm.
   ‫

   npm install firebase@8.10.1 --save

   תצטרכו להגדיר ידנית את הדרישות ל-Firebase ול-Firestore.

   const firebase = require("firebase");
   // Required for side-effects
   require("firebase/firestore");

פלטפורמות של אפל

פועלים לפי ההוראות להוספת Firebase לאפליקציית Apple.

משתמשים ב-Swift Package Manager כדי להתקין ולנהל יחסי תלות ב-Firebase.

1. ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Swift Packages > Add Package Dependency (קובץ > חבילות Swift > הוספת תלות בחבילה).
2. כשמוצגת בקשה, מוסיפים את מאגר Firebase Apple platforms SDK:

  https://github.com/firebase/firebase-ios-sdk
  

3. בוחרים את ספריית Firestore.
4. אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם ברקע באופן אוטומטי.

Android

1. פועלים לפי ההוראות להוספת Firebase לאפליקציית Android.
2. מצהירים על התלות של ספריית Firestore ל-Android בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle.kts או app/build.gradle):

   implementation("com.google.firebase:firebase-firestore:26.5.0")

   אם האפליקציה שלכם משתמשת בכמה ספריות Firebase, כדאי להשתמש ב-Firebase Android BoM, כדי לוודא שגרסאות ספריות Firebase באפליקציה תמיד תואמות.

   מחפשים מודול ספרייה ספציפי ל-Kotlin? החל מגרסת אוקטובר 2023, מפתחי Kotlin ומפתחי Java יכולים להסתמך על מודול הספרייה הראשי (פרטים נוספים זמינים במאמר שאלות נפוצות בנושא).

Dart

1. אם עדיין לא עשיתם זאת, מגדירים את Firebase ומפעילים אותו באפליקציית Flutter.
2. מהרמה הבסיסית (root) של פרויקט Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגין:

   flutter pub add cloud_firestore

3. בסיום התהליך, צריך לבנות מחדש את אפליקציית Flutter:

   flutter run

C++‎

1. פועלים לפי ההוראות כדי להוסיף את Firebase לפרויקט C++‎.
2. ממשק C++‎ ל-Android.
• תלויות של Gradle. מוסיפים את השורות הבאות לקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle):

          android.defaultConfig.externalNativeBuild.cmake {
            arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
          }
  
          apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
          firebaseCpp.dependencies {
            // earlier entries
            auth
            firestore
          }
          

• תלויות בינאריות. באופן דומה, הדרך המומלצת לקבל את יחסי התלות הבינאריים היא להוסיף את הקוד הבא לקובץ CMakeLists.txt:

          add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)
          set(firebase_libs firebase_auth firebase_firestore firebase_app)
          # Replace the target name below with the actual name of your target,
          # for example, "native-lib".
          target_link_libraries(${YOUR_TARGET_NAME_HERE} "${firebase_libs}")
          

3. כדי להגדיר שילוב של אפליקציות למחשב, אפשר לעיין במאמר איך מוסיפים את Firebase לפרויקט C++‎.

Unity

1. פועלים לפי ההוראות להוספת Firebase לפרויקט Unity.
2. משתמשים בממשק Unity כדי להגדיר את הפרויקט כך שיבצע מיניפיקציה של גרסאות build ל-Android.

כדי להימנע מההודעה Error while merging dex archives, צריך לכווץ את ה-build.

• האפשרות נמצאת בPlayer Settings > Android > Publishing Settings > Minify.
• יכול להיות שהאפשרויות יהיו שונות בגרסאות שונות של Unity, לכן מומלץ לעיין במסמכי התיעוד הרשמיים של Unity ובמדריך לניפוי באגים ב-Firebase Unity Build.
• אם אחרי הפעלת המיניפיקציה מספר השיטות שמופיעות בהפניה עדיין חורג מהמגבלה, אפשרות נוספת היא להפעיל את multidex ב:
  • ‫mainTemplate.gradle אם האפשרות Custom Gradle Template (תבנית Gradle מותאמת אישית) מופעלת בקטע Player Settings (הגדרות הנגן)
  • או קובץ build.gradle ברמת המודול, אם משתמשים ב-Android Studio כדי לבנות את הפרויקט המיוצא.

גרסה 9 לאינטרנט

// Initialize Firestore through Firebase
import { initializeApp } from "firebase/app"
import { getFirestore } from "firebase/firestore"
const firebaseApp = initializeApp({
  apiKey: '### FIREBASE API KEY ###',
  authDomain: '### FIREBASE AUTH DOMAIN ###',
  projectId: '### CLOUD FIRESTORE PROJECT ID ###'
});

const db = getFirestore();

גרסה 8 לאינטרנט

// Initialize Firestore through Firebase
firebase.initializeApp({
  apiKey: '### FIREBASE API KEY ###',
  authDomain: '### FIREBASE AUTH DOMAIN ###',
  projectId: '### CLOUD FIRESTORE PROJECT ID ###'
});

var db = firebase.firestore();

Swift

import FirebaseCore
import FirebaseFirestore

FirebaseApp.configure()

let db = Firestore.firestore()
AppDelegate.swift

Objective-C

@import FirebaseCore;
@import FirebaseFirestore;

// Use Firebase library to configure APIs
[FIRApp configure];

FIRFirestore *defaultFirestore = [FIRFirestore firestore];
AppDelegate.m
  

‫Kotlin
Android

  // Access a Firestore instance from your Activity
  val db = Firebase.firestore
DocSnippets.kt

‫Java
Android

// Access a Firestore instance from your Activity
  FirebaseFirestore db = FirebaseFirestore.getInstance();
DocSnippets.java

Dart

db = FirebaseFirestore.instance;

C++‎

// Make sure the call to `Create()` happens some time before you call Firestore::GetInstance().
App::Create();
Firestore* db = Firestore::GetInstance();
AppDelegate.mm

Unity

using Firebase.Firestore;
using Firebase.Extensions;

FirebaseFirestore db = FirebaseFirestore.DefaultInstance;

גרסה 9 לאינטרנט

import { collection, addDoc } from "firebase/firestore"; 

try {
  const docRef = await addDoc(collection(db, "users"), {
    first: "Ada",
    last: "Lovelace",
    born: 1815
  });
  console.log("Document written with ID: ", docRef.id);
} catch (e) {
  console.error("Error adding document: ", e);
}
add_ada_lovelace.js

גרסה 8 לאינטרנט

db.collection("users").add({
    first: "Ada",
    last: "Lovelace",
    born: 1815
})
.then((docRef) => {
    console.log("Document written with ID: ", docRef.id);
})
.catch((error) => {
    console.error("Error adding document: ", error);
});
test.firestore.js

Swift

// Add a new document with a generated ID
do {
  let ref = try await db.collection("users").addDocument(data: [
    "first": "Ada",
    "last": "Lovelace",
    "born": 1815
  ])
  print("Document added with ID: \(ref.documentID)")
} catch {
  print("Error adding document: \(error)")
}
ViewController.swift

Objective-C

// Add a new document with a generated ID
__block FIRDocumentReference *ref =
    [[self.db collectionWithPath:@"users"] addDocumentWithData:@{
      @"first":