获取数据

您可以通过三种方式来检索存储在 Cloud Firestore 中的数据。每种方法都可以用于检索文档、文档集合或查询结果。这三种方式分别是：

• 调用一个方法来获取一次数据。
• 设置监听器来接收数据更改事件。
• 通过使用数据捆绑包从外部来源批量加载 Firestore 快照数据。如需了解详情，请参阅捆绑包文档。

设置监听器后，Cloud Firestore 会首先向监听器发送数据的初始快照，然后会在每次文档发生更改时，再发送一次快照。

须知事项

如需创建 Cloud Firestore 数据库，请参阅Cloud Firestore 使用入门。

初始化 Cloud Firestore

初始化 Cloud Firestore 的实例：

移动 SDK 和 Web SDK

Web

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

// TODO: Replace the following with your app's Firebase project configuration
// See: https://support.google.com/firebase/answer/7015592
const firebaseConfig = {
    FIREBASE_CONFIGURATION
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);

// Initialize Cloud Firestore and get a reference to the service
const db = getFirestore(app);

将 FIREBASE_CONFIGURATION 替换为 Web 应用的 firebaseConfig。

如需在设备的网络连接中断时保留数据，请参阅启用离线数据文档。

Web

import firebase from "firebase/app";
import "firebase/firestore";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://support.google.com/firebase/answer/7015592
const firebaseConfig = {
    FIREBASE_CONFIGURATION
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);

// Initialize Cloud Firestore and get a reference to the service
const db = firebase.firestore();

将 FIREBASE_CONFIGURATION 替换为 Web 应用的 firebaseConfig。

如需在设备的网络连接中断时保留数据，请参阅启用离线数据文档。

Swift

注意：此产品不适用于 watchOS 和 App Clip 目标。

import FirebaseCore
import FirebaseFirestore

FirebaseApp.configure()

let db = Firestore.firestore()

AppDelegate.swift

Objective-C

注意：此产品不适用于 watchOS 和 App Clip 目标。

@import FirebaseCore;
@import FirebaseFirestore;

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

FIRFirestore *defaultFirestore = [FIRFirestore firestore];

AppDelegate.m

Kotlin

// Access a Cloud Firestore instance from your Activity

val db = Firebase.firestore

DocSnippets

.kt