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 e leggere dati utilizzando la libreria client Android, Apple, Web, Unity o C++.

Crea un database Firestore

Se non l'hai già fatto, crea un progetto Firebase: nella Console Firebase, fai clic su Aggiungi progetto, quindi segui le istruzioni sullo schermo per creare un progetto Firebase o aggiungere i 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 utilizzare le librerie client web e per dispositivi mobili, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, assicurati di consultare la sezione Proteggi i tuoi dati.
Seleziona una località per il tuo database.
- Questa impostazione corrisponde alla località delle risorse Google Cloud Platform Cloud del progetto. Tieni presente che questa località verrà utilizzata per i servizi Google Cloud nel progetto che richiedono un'impostazione della località, in particolare il bucket Cloud Storage predefinito e l'app App Engine (obbligatoria se utilizzi Cloud Scheduler).
- Se non riesci a selezionare una località, significa che il tuo progetto ha già una località predefinita per le risorse Google Cloud. È stato impostato durante la creazione del progetto o durante la configurazione di un altro servizio che richiede l'impostazione di una località.
Avviso: dopo aver impostato la località delle risorse Google Cloud predefinita del progetto, non puoi modificarla.
Fai clic su Fine.

Quando abiliti Firestore, abilita l'API anche nel 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 aggiungere 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 aggiungere 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 aggiungere Firebase alla tua app Apple.

Utilizza 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 Firebase Apple:

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

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

Android

Segui le istruzioni per aggiungere Firebase alla tua app Android.
Dichiara la dipendenza per la 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:24.11.1")
```
Se la tua app utilizza più librerie Firebase, valuta la possibilità di utilizzare la distinta base di Firebase Android, che garantisce che le versioni della libreria Firebase della tua app siano sempre compatibili.

Cerchi un modulo relativo alla libreria specifico per Kotlin? A partire dalla release di ottobre 2023, sia gli sviluppatori Kotlin che quelli Java possono dipendere dal modulo della libreria principale. Per maggiori dettagli, consulta le domande frequenti su questa iniziativa.

Fresco

Se non lo hai già fatto, configura e inizializza Firebase nella tua app Flutter.
Dalla directory principale del tuo progetto Flutter, esegui questo comando per installare il plug-in:
```
flutter pub add cloud_firestore
```
Al termine, ricrea la tua applicazione Flutter:
```
flutter run
```

C++

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

Valuta le dipendenze. Aggiungi quanto segue al file Gradle del modulo (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. Allo stesso modo, il modo consigliato per ottenere le dipendenze binarie è aggiungere quanto segue al file 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}")

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

Unity

Segui le istruzioni per aggiungere Firebase al tuo progetto Unity.
Utilizza l'interfaccia Unity per configurare il tuo progetto per 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 > Impostazioni di pubblicazione > Minimizza.
Le opzioni possono variare a seconda della versione di Unity, quindi consulta la documentazione ufficiale di Unity e la guida al debug della build di Firebase Unity.
Se, dopo aver abilitato la minimizzazione, il numero di metodi di riferimento supera ancora il limite, un'altra opzione è abilitare multidex in:
- mainTemplate.gradle se è attivato Modello Gradle personalizzato nelle Impostazioni del player
- 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();

Puoi trovare i valori di "initializeApp" in "firebaseConfig" dell'app web. Per mantenere i dati quando il dispositivo perde la connessione, consulta la documentazione sull'attivazione 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 per i target watchOS e App Clip.

import FirebaseCore
import FirebaseFirestore

FirebaseApp.configure()

let db = Firestore.firestore()AppDelegate.swift

Objective-C

Nota: questo prodotto non è disponibile per i target watchOS e 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

Fresco

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, archiviati in Raccolte. La prima volta che aggiungi dati al documento, Firestore crea raccolte e documenti in modo implicito. Non è necessario creare raccolte o documenti in modo esplicito.

Crea una nuova raccolta e un 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 per i target watchOS e 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 per i target watchOS e 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

Fresco

// 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 include una coppia chiave-valore (secondo nome) che non compare nel primo 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 per i target watchOS e 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 per i target watchOS e 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

Fresco

// 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 di 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 per i target watchOS e 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 per i target watchOS e 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

Fresco

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 le Regole di sicurezza di Firestore per proteggere i tuoi dati in Firestore.

Di seguito sono riportate alcune serie di regole di base che puoi utilizzare per iniziare. Puoi modificare le regole di sicurezza nella scheda Regole della 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 dell'app web, Android o per iOS in produzione, esegui anche le azioni necessarie per assicurarti che solo i client dell'app possano accedere ai dati Firestore. Consulta la documentazione di App Check.

Guarda un tutorial video

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

Web

iOS

Android

Puoi trovare altri video nel canale YouTube di Firebase.

Passaggi successivi

Approfondisci le tue conoscenze sui seguenti argomenti:

Codelab: scopri come utilizzare Firestore in un'app reale seguendo il codelab per Android, iOS o Web.
Modello dati: scopri di più su come sono strutturati i dati in Firestore, inclusi dati gerarchici e sottoraccolte.
Aggiungi dati: scopri di più su come creare e aggiornare i dati in Firestore.
Ottieni dati: scopri di più su come recuperare i dati.
Eseguire query semplici e composte: scopri come eseguire query semplici e composte.
Ordina e limita le query: scopri come ordinare e limitare i dati restituiti dalle tue 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

Fresco

C++

Unity

Inizializza Firestore

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Fresco

C++

Unity

Aggiungi dati

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Fresco

C++

Unity

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Fresco

C++

Unity

Lettura di dati

Versione web 9

Versione web 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Fresco

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