使用 Web 或移动客户端库创建 Firestore 数据库

本快速入门介绍如何使用 Android、Apple 平台、Web、Unity 或 C++ 客户端库设置 Firestore、添加数据和读取数据。

  1. 如果您还没有 Firebase 项目，请创建一个，具体步骤是：在 Firebase 控制台中，点击添加项目，然后按照屏幕上的说明创建 Firebase 项目或将 Firebase 服务添加到现有 Google Cloud 项目。

  2. 在左侧面板中，依次前往数据库和存储空间 > Firestore。

  3. 点击创建数据库。

  4. 选择数据库的位置。

    如果您无法选择位置，则表明项目的“默认 Google Cloud 资源位置”已经设置。您的项目的部分资源（例如默认 Firestore 实例）共享一个通用位置依赖项，并且可以在项目创建期间或设置共享此位置依赖项的其他服务时设置其位置。

  5. 为您的 Firestore 安全规则选择一个初始模式：

    测试模式

    此模式适合刚开始使用移动和 Web 客户端库的用户，但会允许任何人读取和覆盖您的数据。测试完成后，请务必查看保护您的数据部分。

    如需开始使用 Web、Apple 平台或 Android SDK，请选择测试模式。

    锁定模式

    此模式会拒绝来自移动和 Web 客户端的所有读写操作。经过身份验证的应用服务器（C#、Go、Java、Node.js、PHP、Python 或 Ruby）仍然可以访问您的数据库。

    如需开始使用 C#、Go、Java、Node.js、PHP、Python 或 Ruby 服务器客户端库，请选择锁定模式。

    最初的一组 Firestore 安全规则将应用于您的默认 Firestore 数据库。如果您为项目创建多个数据库，则可以为每个数据库部署 Firestore 安全规则。

  6. 点击创建。

启用 Firestore 时，也会在 Cloud API 管理器中启用相应 API。

设置开发环境

将所需的依赖项和客户端库添加到您的应用。

Web 版本 9

  1. 按照相关说明将 Firebase 添加到您的 Web 应用。
  2. 导入 Firebase 和 Firestore：
    import { initializeApp } from "firebase/app";
import { getFirestore } from "firebase/firestore";

Web 版本 8

  1. 按照相关说明将 Firebase 添加到您的 Web 应用。
  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
     您需要手动通过 require() 函数同时引入 Firebase 和 Firestore。
    const firebase = require("firebase");
// Required for side-effects
require("firebase/firestore");
Apple 平台

按照相关说明将 Firebase 添加到您的 Apple 应用。

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

  1. 在 Xcode 中打开您的应用项目，依次点击 File（文件）> Swift Packages（Swift 软件包）> Add Package Dependency（添加软件包依赖项）。
  2. 出现提示时，添加 Firebase Apple 平台 SDK 仓库：
    3.   https://github.com/firebase/firebase-ios-sdk
  3. 选择 Firestore 库。
  4. 完成之后，Xcode 将会自动开始在后台解析和下载您的依赖项。
Android
  1. 按照相关说明将 Firebase 添加到您的 Android 应用。
  2. 在您的模块（应用级）Gradle 文件（通常为 app/build.gradle.kts 或 app/build.gradle）中声明 Firestore Android 库的依赖项：
    implementation("com.google.firebase:firebase-firestore:26.6.0")

    如果您的应用使用多个 Firebase 库，请考虑使用 Firebase Android BoM，这样可以确保您应用的 Firebase 库版本始终兼容。

    是否想要查找 Kotlin 专用的库模块？从 2023 年 10 月发布的版本开始，Kotlin 和 Java 开发者可以依赖于主库模块（如需了解详情，请参阅关于此计划的常见问题解答）。

Dart

  1. 如果您尚未在 Flutter 应用中配置并初始化 Firebase，请先配置并进行初始化。
  2. 从 Flutter 项目的根目录运行以下命令，安装该插件： 
    flutter pub add cloud_firestore
  3. 完成后，重新构建您的 Flutter 应用：
    flutter run
C++
  1. 按照相关说明将 Firebase 添加到您的 C++ 项目。
  2. Android 版 C++ 接口。
    • Gradle 依赖项。将以下内容添加到您的模块（应用级）Gradle 文件（通常为 app/build.gradle）：
              android.defaultConfig.externalNativeBuild.cmake {