使用 Firebase

一份关于开始使用 Firebase JS SDK 和 React Native Firebase 库的指南。

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

Firebase 是一个 Backend-as-a-Service (BaaS) 应用开发平台，提供实时数据库、云存储、身份验证、崩溃报告、分析等托管后端服务。 它构建于 Google 的基础设施之上，并可自动扩展。

在你的项目中使用 Firebase 有两种不同的方式：

• 使用 Firebase JS SDK
• 使用 React Native Firebase

React Native 同时支持 JS SDK 和原生 SDK。以下各节将指导你何时使用哪种 SDK，以及在 Expo 项目中使用 Firebase 所需的全部配置步骤。

先决条件

在继续之前，请确保你已经使用 Firebase 控制台 创建了一个新的 Firebase 项目，或者已经有一个现有项目。

使用 Firebase JS SDK

Firebase JS SDK 是一个 JavaScript 库，可让你在项目中与 Firebase 服务交互。 它支持在 React Native 应用中使用 Authentication、Firestore、Realtime Database 和 Storage 等服务。

何时使用 Firebase JS SDK

在以下情况下，你可以考虑使用 Firebase JS SDK：

• 想在应用中使用 Authentication、Firestore、Realtime Database 和 Storage 等 Firebase 服务，并希望使用 Expo Go 开发应用。
• 想快速开始使用 Firebase 服务。
• 想为 Android、iOS 和 Web 创建一个通用应用。

注意事项

Firebase JS SDK 不支持移动应用的所有服务。其中一些服务包括 Analytics、Dynamic Links 和 Crashlytics。如果你想使用这些服务，请参见 React Native Firebase 部分。

安装并初始化 Firebase JS SDK

Expo SDK 仅支持 firebase@12.0.0 及以上版本。早于此版本会导致 ES 模块解析错误。

import { initializeApp } from 'firebase/app';

// 可选地导入你想使用的服务
// import {...} from 'firebase/auth';
// import {...} from 'firebase/database';
// import {...} from 'firebase/firestore';
// import {...} from 'firebase/functions';
// import {...} from 'firebase/storage';

// 初始化 Firebase
const firebaseConfig = {
  apiKey: 'api-key',
  authDomain: 'project-id.firebaseapp.com',
  databaseURL: 'https://project-id.firebaseio.com',
  projectId: 'project-id',
  storageBucket: 'project-id.appspot.com',
  messagingSenderId: 'sender-id',
  appId: 'app-id',
  measurementId: 'G-measurement-id',
};

const app = initializeApp(firebaseConfig);
// 有关如何在项目中访问 Firebase 的更多信息，
// 请参阅 Firebase 文档：https://firebase.google.com/docs/web/setup#access-firebase

下一步

使用 React Native Firebase

React Native Firebase 通过将 Android 和 iOS 的原生 SDK 封装为 JavaScript API，提供对原生代码的访问。 每个 Firebase 服务都以模块形式提供，可以作为依赖项添加到你的项目中。例如，auth 模块提供对 Firebase Authentication 服务的访问。

何时使用 React Native Firebase

在以下情况下，你可以考虑使用 React Native Firebase：

• 你的应用需要访问 Firebase JS SDK 不支持的 Firebase 服务，例如 Dynamic Links、Crashlytics 等。 有关原生 SDK 提供的额外功能的更多信息，请参阅 React Native Firebase 文档。
• 你想在应用中使用原生 SDK。
• 你有一个已经配置好 React Native Firebase 的裸 React Native 应用，但正在迁移到使用 Expo SDK。
• 你想在应用中使用 Firebase Analytics。

注意事项

React Native Firebase 需要 自定义原生代码，无法与 Expo Go 一起使用。

安装并初始化 React Native Firebase

下一步

配置好 React Native Firebase 库后，你就可以在 Expo 项目中使用它提供的任何模块。