Questa pagina è stata tradotta dall'API Cloud Translation.

Crea un database Firestore utilizzando una libreria client web o mobile

Questa guida rapida mostra come configurare Firestore, aggiungere dati e leggere utilizzando la libreria client di Android, Apple, Web, Unity o C++.

Crea un database Firestore

Se non lo hai già fatto, crea un progetto Firebase: Console Firebase, fai clic su Aggiungi progetto. e poi segui le istruzioni sullo schermo per creare un progetto Firebase o aggiungere servizi Firebase a un progetto Google Cloud esistente.
Nel riquadro di navigazione della console Firebase, seleziona Firestore, quindi fai clic su Crea database per Firestore.
Seleziona Modalità di test per le regole di sicurezza di Firestore:

Modalità di test

È ideale per iniziare a usare le librerie client web e per dispositivi mobili, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, effettua assicurati di rivedere la sezione Proteggere i tuoi dati.
Seleziona una località per il tuo database.
- Questa impostazione di geolocalizzazione corrisponde a quella del progetto località Google Cloud Platform Cloud. Tieni presente che questa località verrà utilizzata per i servizi Google Cloud nel tuo progetto che richiedono l'impostazione della località, in particolare, del bucket Cloud Storage e App Engine (che richiesta se utilizzi Cloud Scheduler).
- Se non riesci a selezionare una località, significa che il progetto è già ha una località delle risorse Google Cloud predefinita. È stato impostato durante il progetto creazione o configurazione di un altro servizio che richiede una posizione dell'ambientazione.
Avviso: dopo aver impostato la località delle risorse Google Cloud predefinita per il progetto, non lo possono modificare.
Fai clic su Fine.

Quando abiliti Firestore, l'API verrà abilitata anche nella Gestore API Cloud.

Configurazione dell'ambiente di sviluppo

Aggiungi le dipendenze e le librerie client necessarie alla tua app.

Versione web 9

Segui le istruzioni per aggiungi Firebase alla tua app web.

Importa sia Firebase che Firestore:

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

Versione web 8

Segui le istruzioni per aggiungi Firebase alla tua app web.

Aggiungi le librerie Firebase e Firestore alla tua app:

<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>

L'SDK Firestore è disponibile anche come pacchetto npm.

npm install firebase@8.10.1 --save

Dovrai richiedere manualmente sia Firebase che Firestore.

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

Piattaforme Apple

Segui le istruzioni per aggiungi Firebase alla tua app Apple.

Usa Swift Package Manager per installare e gestire le dipendenze di Firebase.

In Xcode, con il progetto dell'app aperto, vai a File > Pacchetti Swift > Aggiungi dipendenza pacchetto.
Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple Firebase:

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

Scegli la libreria Firestore.
Al termine, Xcode inizierà automaticamente a risolvere e scaricare il le dipendenze in background.

Android

Segui le istruzioni per aggiungi Firebase alla tua app Android.
Dichiara la dipendenza della libreria Firestore per Android nel file Gradle del modulo (a livello di app) (di solito app/build.gradle.kts o app/build.gradle):
```
implementation("com.google.firebase:firebase-firestore:25.0.0")
```
Se la tua app utilizza più librerie Firebase, valuta la possibilità di utilizzare lo Firebase distinta base di Android, che garantisce che le versioni della libreria Firebase della tua app sono sempre compatibili.

Cerchi un modulo della libreria specifico per Kotlin? A partire dal Release di ottobre 2023, gli sviluppatori Kotlin e Java possono dipendere dal modulo della libreria principale (per i dettagli, consulta Domande frequenti su questa iniziativa).

Darte

Se non lo hai già fatto, configura e inizializza Firebase nell'app Flutter.
Dalla radice del progetto Flutter, esegui questo comando: Installa il plug-in:
```
flutter pub add cloud_firestore
```
Al termine, ricrea l'applicazione Flutter:
```
flutter run
```

C++

Segui le istruzioni per aggiungi Firebase al tuo progetto C++.
Interfaccia C++ per Android.

Dipendenze di Gradle. Aggiungi quanto segue al modulo file Gradle (a livello di app) (di solito 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
        }

Dipendenze binarie. Analogamente, il modo consigliato per le dipendenze binarie consiste nell'aggiungere quanto segue al tuo CMakeLists.txt file:

        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}")

Per configurare l'integrazione desktop, consulta Aggiungere Firebase al progetto C++.

Unity

Segui le istruzioni per aggiungi Firebase al tuo account Unity progetto.
Usa l'interfaccia Unity per configurare il tuo progetto al fine di minimizzare le build Android.

Devi minimizzare la build per evitare il messaggio Error while merging dex archives.

L'opzione è disponibile in Impostazioni del player > Android > Pubblicazione in corso... Impostazioni > Minimizza.
Le opzioni possono variare a seconda della versione di Unity, quindi fai riferimento alle la documentazione ufficiale Unity e il Guida al debug della build di Firebase Unity.
Se, dopo aver abilitato la minimizzazione, il numero di metodi a cui viene fatto riferimento supera il limite, un'altra opzione è attivare multidex in:
- mainTemplate.gradle se l'opzione Modello Gradle personalizzato in Impostazioni del player è abilitata
- o il file build.gradle a livello di modulo, se usi Android Studio per creare il progetto esportato.

Inizializza Firestore

Inizializza un'istanza di Firestore:

Versione web 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();

I valori di "initializeApp" sono disponibili in `firebaseConfig` della tua app web. Per rendere persistenti i dati quando il dispositivo perde la connessione, consulta la documentazione relativa all'abilitazione dei dati offline.

Versione web 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

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

import FirebaseCore
import FirebaseFirestore

FirebaseApp.configure()

let db = Firestore.firestore()AppDelegate.swift

Objective-C

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

@import FirebaseCore;
@import FirebaseFirestore;

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

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

Kotlin+KTX
Android

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

Java
Android

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

Darte

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;

Aggiungi dati

Firestore archivia i dati in Documenti, che sono archiviati in Raccolte. Firestore crea raccolte e documenti in modo implicito la prima volta che aggiungi dati al documento. Non è necessario specificare creare raccolte o documenti.

Crea una nuova raccolta e un nuovo documento utilizzando il seguente codice di esempio.

Versione web 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

Versione web 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

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

// 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

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

// Add a new document with a generated ID
__block FIRDocumentReference *ref =
    [[self.db collectionWithPath:@"users"] addDocumentWithData:@{
      @"first": @"Ada",
      @"last": @"Lovelace",
      @"born": @1815
    } completion:^(NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error adding document: %@", error);
      } else {
        NSLog(@"Document added with ID: %@", ref.documentID);
      }
    }];ViewController.m

Kotlin+KTX
Android

// Create a new user with a first and last name
val user = hashMapOf(
    "first" to "Ada",
    "last" to "Lovelace",
    "born" to 1815,
)

// Add a new document with a generated ID
db.collection("users")
    .add(user)
    .addOnSuccessListener { documentReference ->
        Log.d(TAG, "DocumentSnapshot added with ID: ${documentReference.id}")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "Error adding document", e)
    }DocSnippets.kt

Java
Android

// Create a new user with a first and last name
Map<String, Object> user = new HashMap<>();
user.put("first", "Ada");
user.put("last", "Lovelace");
user.put("born", 1815);

// Add a new document with a generated ID
db.collection("users")
        .add(user)
        .addOnSuccessListener(new OnSuccessListener<DocumentReference>() {
            @Override
            public void onSuccess(DocumentReference documentReference) {
                Log.d(TAG, "DocumentSnapshot added with ID: " + documentReference.getId());
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                Log.w(TAG, "Error adding document", e);
            }
        });DocSnippets.java

Darte

// Create a new user with a first and last name
final user = <String, dynamic>{
  "first": "Ada",
  "last": "Lovelace",
  "born": 1815
};

// Add a new document with a generated ID
db.collection("users").add(user).then((DocumentReference doc) =>
    print('DocumentSnapshot added with ID: ${doc.id}'));firestore.dart

C++

// Add a new document with a generated ID
Future<DocumentReference> user_ref =
    db->Collection("users").Add({{"first", FieldValue::String("Ada")},
                                 {"last", FieldValue::String("Lovelace")},
                                 {"born", FieldValue::Integer(1815)}});

user_ref.OnCompletion([](const Future<DocumentReference>& future) {
  if (future.error() == Error::kErrorOk) {
    std::cout << "DocumentSnapshot added with ID: " << future.result()->id()
              << std::endl;
  } else {
    std::cout << "Error adding document: " << future.error_message() << std::endl;
  }
});snippets.cpp

Unity

DocumentReference docRef = db.Collection("users").Document("alovelace");
Dictionary<string, object> user = new Dictionary<string, object>
{
	{ "First", "Ada" },
	{ "Last", "Lovelace" },
	{ "Born", 1815 },
};
docRef.SetAsync(user).ContinueWithOnMainThread(task => {
	Debug.Log("Added data to the alovelace document in the users collection.");
});

Ora aggiungi un altro documento alla raccolta users. Tieni presente che questo documento Includa una coppia chiave-valore (secondo nome) che non compare nella prima documento. I documenti di una raccolta possono contenere diversi insiemi di informazioni.

Versione web 9

// Add a second document with a generated ID.
import { addDoc, collection } from "firebase/firestore"; 

try {
  const docRef = await addDoc(collection(db, "users"), {
    first: "Alan",
    middle: "Mathison",
    last: "Turing",
    born: 1912
  });

  console.log("Document written with ID: ", docRef.id);
} catch (e) {
  console.error("Error adding document: ", e);
}add_alan_turing.js

Versione web 8

// Add a second document with a generated ID.
db.collection("users").add({
    first: "Alan",
    middle: "Mathison",
    last: "Turing",
    born: 1912
})
.then((docRef) => {
    console.log("Document written with ID: ", docRef.id);
})
.catch((error) => {
    console.error("Error adding document: ", error);
});test.firestore.js

Swift

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

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

Objective-C

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

// Add a second document with a generated ID.
__block FIRDocumentReference *ref =
    [[self.db collectionWithPath:@"users"] addDocumentWithData:@{
      @"first": @"Alan",
      @"middle": @"Mathison",
      @"last": @"Turing",
      @"born": @1912
    } completion:^(NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error adding document: %@", error);
      } else {
        NSLog(@"Document added with ID: %@", ref.documentID);
      }
    }];ViewController.m

Kotlin+KTX
Android

// Create a new user with a first, middle, and last name
val user = hashMapOf(
    "first" to "Alan",
    "middle" to "Mathison",
    "last" to "Turing",
    "born" to 1912,
)

// Add a new document with a generated ID
db.collection("users")
    .add(user)
    .addOnSuccessListener { documentReference ->
        Log.d(TAG, "DocumentSnapshot added with ID: ${documentReference.id}")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "Error adding document", e)
    }DocSnippets.kt

Java
Android

// Create a new user with a first, middle, and last name
Map<String, Object> user = new HashMap<>();
user.put("first", "Alan");
user.put("middle", "Mathison");
user.put("last", "Turing");
user.put("born", 1912);

// Add a new document with a generated ID
db.collection("users")
        .add(user)
        .addOnSuccessListener(new OnSuccessListener<DocumentReference>() {
            @Override
            public void onSuccess(DocumentReference documentReference) {
                Log.d(TAG, "DocumentSnapshot added with ID: " + documentReference.getId());
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                Log.w(TAG, "Error adding document", e);
            }
        });DocSnippets.java

Darte

// Create a new user with a first and last name
final user = <String, dynamic>{
  "first": "Alan",
  "middle": "Mathison",
  "last": "Turing",
  "born": 1912
};

// Add a new document with a generated ID
db.collection("users").add(user).then((DocumentReference doc) =>
    print('DocumentSnapshot added with ID: ${doc.id}'));firestore.dart

C++

db->Collection("users")
    .Add({{"first", FieldValue::String("Alan")},
          {"middle", FieldValue::String("Mathison")},
          {"last", FieldValue::String("Turing")},
          {"born", FieldValue::Integer(1912)}})
    .OnCompletion([](const Future<DocumentReference>& future) {
      if (future.error() == Error::kErrorOk) {
        std::cout << "DocumentSnapshot added with ID: "
                  << future.result()->id() << std::endl;
      } else {
        std::cout << "Error adding document: " << future.error_message()
                  << std::endl;
      }
    });snippets.cpp

Unity

DocumentReference docRef = db.Collection("users").Document("aturing");
Dictionary<string, object> user = new Dictionary<string, object>
{
	{ "First", "Alan" },
	{ "Middle", "Mathison" },
	{ "Last", "Turing" },
	{ "Born", 1912 }
};
docRef.SetAsync(user).ContinueWithOnMainThread(task => {
	Debug.Log("Added data to the aturing document in the users collection.");
});

Lettura di dati

Utilizza il visualizzatore dati nella Console Firebase per verificare rapidamente di aver aggiunto dati a Firestore.

Puoi anche utilizzare il metodo get per recuperare l'intera collezione.

Versione web 9

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

const querySnapshot = await getDocs(collection(db, "users"));
querySnapshot.forEach((doc) => {
  console.log(`${doc.id} => ${doc.data()}`);
});get_all_users.js

Versione web 8

db.collection("users").get().then((querySnapshot) => {
    querySnapshot.forEach((doc) => {
        console.log(`${doc.id} => ${doc.data()}`);
    });
});test.firestore.js

Swift

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

do {
  let snapshot = try await db.collection("users").getDocuments()
  for document in snapshot.documents {
    print("\(document.documentID) => \(document.data())")
  }
} catch {
  print("Error getting documents: \(error)")
}ViewController.swift

Objective-C

Nota: questo prodotto non è disponibile su watchOS e sui target di App Clip.

[[self.db collectionWithPath:@"users"]
    getDocumentsWithCompletion:^(FIRQuerySnapshot * _Nullable snapshot,
                                 NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error getting documents: %@", error);
      } else {
        for (FIRDocumentSnapshot *document in snapshot.documents) {
          NSLog(@"%@ => %@", document.documentID, document.data);
        }
      }
    }];ViewController.m

Kotlin+KTX
Android

db.collection("users")
    .get()
    .addOnSuccessListener { result ->
        for (document in result) {
            Log.d(TAG, "${document.id} => ${document.data}")
        }
    }
    .addOnFailureListener { exception ->
        Log.w(TAG, "Error getting documents.", exception)
    }DocSnippets.kt

Java
Android

db.collection("users")
        .get()
        .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() {
            @Override
            public void onComplete(@NonNull Task<QuerySnapshot> task) {
                if (task.isSuccessful()) {
                    for (QueryDocumentSnapshot document : task.getResult()) {
                        Log.d(TAG, document.getId() + " => " + document.getData());
                    }
                } else {
                    Log.w(TAG, "Error getting documents.", task.getException());
                }
            }
        });DocSnippets.java

Darte

await db.collection("users").get().then((event) {
  for (var doc in event.docs) {
    print("${doc.id} => ${doc.data()}");
  }
});firestore.dart

C++

Future<QuerySnapshot> users = db->Collection("users").Get();
users.OnCompletion([](const Future<QuerySnapshot>& future) {
  if (future.error() == Error::kErrorOk) {
    for (const DocumentSnapshot& document : future.result()->documents()) {
      std::cout << document << std::endl;
    }
  } else {
    std::cout << "Error getting documents: " << future.error_message()
              << std::endl;
  }
});snippets.cpp

Unity

CollectionReference usersRef = db.Collection("users");
usersRef.GetSnapshotAsync().ContinueWithOnMainThread(task =>
{
  QuerySnapshot snapshot = task.Result;
  foreach (DocumentSnapshot document in snapshot.Documents)
  {
    Debug.Log(String.Format("User: {0}", document.Id));
    Dictionary<string, object> documentDictionary = document.ToDictionary();
    Debug.Log(String.Format("First: {0}", documentDictionary["First"]));
    if (documentDictionary.ContainsKey("Middle"))
    {
      Debug.Log(String.Format("Middle: {0}", documentDictionary["Middle"]));
    }

    Debug.Log(String.Format("Last: {0}", documentDictionary["Last"]));
    Debug.Log(String.Format("Born: {0}", documentDictionary["Born"]));
  }

  Debug.Log("Read all data from the users collection.");
});

Proteggi i tuoi dati

Utilizza Firebase Authentication e Regole di sicurezza di Firestore per la protezione dei dati in Firestore

Di seguito sono riportate alcune serie di regole di base che è possibile utilizzare per iniziare. Puoi modificare sulle regole di sicurezza nella sezione Regole di la console Firebase.

Autorizzazione obbligatoria

// Allow read/write access on all documents to any user signed in to the application
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

Modalità di blocco

// Deny read/write access to all users under any conditions
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if false;
    }
  }
}

Modalità di test

// Allow read/write access to all users under any conditions
// Warning: **NEVER** use this rule set in production; it allows
// anyone to overwrite your entire database.
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

Prima di eseguire il deployment della tua app web, Android o per iOS in produzione, segui alcuni passaggi per assicurarti che solo i client delle tue app possano accedere ai dati Firestore. Consulta la documentazione di App Check.

Guarda un tutorial video

Per indicazioni dettagliate su come iniziare a utilizzare Firestore librerie client web e per dispositivi mobili, guarda uno dei seguenti tutorial video:

Web

iOS

Android

Puoi trovare altri video in Firebase Canale YouTube.

Passaggi successivi

Approfondisci le tue conoscenze sui seguenti argomenti:

Codelabs. Scopri come utilizzare Firestore in un'app reale seguire il codelab per Android, iOS Web.
Modello dei dati: scopri di più su come vengono strutturati in Firestore, che includono dati gerarchici e sottoraccolte.
Aggiungi dati: scopri di più su come creare e aggiornare i dati in Firestore.
Recupera i dati: scopri di più su come recuperarli e i dati di Google Cloud.
Esecuzione di query semplici e composte: scopri come eseguire query semplici e composte.
Query relative a un ordine e a una limitazione: scopri come effettuare un ordine e limitare i dati restituiti dalle query.

Crea un database Firestore utilizzando una libreria client web o mobile

Crea un database Firestore

Configurazione dell'ambiente di sviluppo

Versione web 9

Versione web 8

Piattaforme Apple

Android

Darte

C++

Unity

Inizializza Firestore

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Darte

C++

Unity

Aggiungi dati

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Darte

C++

Unity

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Darte

C++

Unity

Lettura di dati

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Darte

C++

Unity

Proteggi i tuoi dati

Autorizzazione obbligatoria

Modalità di blocco

Modalità di test

Guarda un tutorial video

Web

iOS

Android

Passaggi successivi

Kotlin+KTX
Android

Java
Android

Kotlin+KTX
Android

Java
Android

Kotlin+KTX
Android

Java
Android

Kotlin+KTX
Android

Java
Android