Firebase 集成介绍

概述

本教程将指导您设置 Firebase Authentication 与 Capacitor 社交登录插件的集成。该集成允许您在移动平台上使用本机社交登录提供者（Google、Apple、Facebook、Twitter），同时利用 Firebase Auth 进行后端身份验证和 Firestore 进行数据存储。

您将学到什么

• 如何配置 Firebase Authentication
• 如何将 Capacitor 社交登录插件与 Firebase Auth 集成
• Android、iOS 和 Web 平台的特定设置

您需要什么

在开始之前，请确保您有:

1. 一个 Firebase 项目

   • 在 Firebase 控制台中创建一个项目 启用身份验证（电子邮件/密码和 Google 登录）
   • 获取您的 Firebase 配置凭证
   • Firebase JS __CAPGO_KEEP_0__

2. Firebase JS SDK

   • 终端窗口

     npm install firebase

3. A Capacitor Project

   • 一个现有的Capacitor应用
   • Capacitor 社交登录插件已安装：

     npm install @capgo/capacitor-social-login
     npx cap sync

示例应用

完整的工作示例可在仓库中找到：

Code 仓库: 您可以在这里找到code仓库

示例应用演示：

• 使用 Firebase 的电子邮件/密码身份验证
• Google Sign-In 集成（Android、iOS 和 Web）
• A simple key-value store using Firebase Firestore collections
• User-specific data storage in Firestore subcollections

关于在 SDK 上使用 Firebase Capacitor

当在 SDK 上使用 Firebase JS Capacitor 时，需要注意，当使用身份验证方法时，需要稍微不同地初始化 Firebase Auth 实例。

在 web 平台上，您将使用 getAuth 函数获取 Firebase Auth 实例。

import { initializeApp } from 'firebase/app';
import { getAuth } from 'firebase/auth';

const app = initializeApp(firebaseConfig);
const auth = getAuth(app);

遗憾的是，在 Capacitor 上，这不会起作用，导致 Firebase 认证挂起。如本 博客文章所述，您需要使用 initializeAuth 函数初始化 Firebase Auth 实例。 这看起来像这样：

import { initializeApp } from 'firebase/app';
import { initializeAuth } from 'firebase/auth';

const app = initializeApp(firebaseConfig);

function whichAuth() {
  let auth;
  if (Capacitor.isNativePlatform()) {
    auth = initializeAuth(app, {
      persistence: indexedDBLocalPersistence,
    });
  } else {
    auth = getAuth(app);
  }
  return auth;
}

export const auth = whichAuth();

下一步

继续使用设置指南:

• Firebase设置 - 配置Firebase项目
• Android设置 - Android特定配置
• iOS设置 - iOS特定配置
• Web设置 - Web特定配置

继续从 Firebase Integration 入门

如果您正在使用 Firebase Integration 入门 来规划身份验证和帐户流程，连接它与 使用 @capgo/capacitor-social-login 为使用 @capgo/capacitor-social-login 的原生能力 使用 @capgo/capacitor-social-login 为 @capgo/capacitor-social-login 的实现细节 使用 @capgo/capacitor-passkey 为 @capgo/capacitor-passkey 的实现细节 使用 @capgo/capacitor-native-biometric 在 @capgo/capacitor-native-biometric 中实现详细信息。 双因素认证 在双因素认证中实现详细信息。