Firebase 集成介绍

概述

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

您将学到什么

• 如何配置 Firebase 身份验证
• 如何将 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 平台上，您将使用函数来获取 Firebase Auth 实例。 getAuth 复制到剪贴板

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

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

Unfortunately, on Capacitor, this does not work and causes Firebase auth to hang. As stated in 复制到剪贴板复制到剪贴板 initializeAuth 复制到剪贴板

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 集成介绍

如果您正在使用 Firebase 集成介绍 来规划身份验证和帐户流程，连接它到 使用 @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 的实现细节 双因素认证 为双因素认证的实现细节