React Native Firebase 多平台支持指南

蒋一南

于 2025-06-03 09:09:53 发布

阅读量314

点赞数 4

本文链接：https://blog.youkuaiyun.com/gitblog_00547/article/details/148393503

版权

React Native Firebase 多平台支持指南

react-native-firebase invertase/react-native-firebase: 是一个用于 React Native 的 Firebase 集成库，可以方便地在 React Native 应用中集成 Firebase 服务。适合对 React Native、Firebase 和想要实现 React Native 与 Firebase 集成的开发者。项目地址: https://gitcode.com/gh_mirrors/re/react-native-firebase

前言

React Native Firebase 是一个强大的工具集，它让开发者能够在 React Native 应用中轻松集成 Firebase 的各种服务。本文将全面解析 React Native Firebase 在不同平台上的支持情况，帮助开发者更好地规划跨平台应用开发。

平台支持概述

React Native Firebase 默认支持两大移动平台：

Android：
- 最低支持版本：5.0 (Lollipop)
- 使用 Firebase Auth 时需要最低 6.0 (Marshmallow)
- 编译要求：JDK 17 或更高版本
iOS：
- 最低支持版本：13.0

对于其他平台（如 Web、macOS、Windows 等），React Native Firebase 提供了基于 Firebase JavaScript SDK 的回退实现方案。

服务支持矩阵

下表详细列出了各 Firebase 服务在不同平台上的支持情况：

| 服务名称 | Android | iOS | 其他平台 | |-------------------|:-------:|:---:|:--------:| | 分析 (Analytics) | ✅ | ✅ | ✅ | | 应用检查 (App Check) | ⚠️ | ⚠️ | ⚠️ | | 应用分发 (App Distribution) | ✅ | ✅ | ❌ | | 核心 (App) | ✅ | ✅ | ✅ | | 认证 (Auth) | ✅ | ✅ | ⚠️ | | 崩溃报告 (Crashlytics) | ✅ | ✅ | ❌ | | 实时数据库 (Database) | ✅ | ✅ | ✅ | | 动态链接 (Dynamic Links) | ✅ | ✅ | ❌ | | Firestore | ✅ | ✅ | ⚠️ | | 云函数 (Functions) | ✅ | ✅ | ✅ | | 应用内消息 (In-App Messaging) | ✅ | ✅ | ❌ | | 安装 (Installations) | ✅ | ✅ | ❌ | | 消息 (Messaging) | ✅ | ✅ | ❌ | | 机器学习 (ML) | ✅ | ✅ | ❌ | | 性能监控 (Perf) | ✅ | ✅ | ❌ | | 远程配置 (Remote Config) | ✅ | ✅ | ✅ | | 存储 (Storage) | ✅ | ✅ | ⚠️ |

图例说明：

✅ 完全支持
⚠️ 部分支持（详见下文说明）
❌ 不支持

其他平台实现原理

对于非 Android/iOS 平台，React Native Firebase 采用了一种智能的回退机制：

自动切换：当检测到当前平台不是 Android 或 iOS 时，SDK 会自动使用基于 Firebase JavaScript SDK 的实现
统一 API：开发者无需修改代码，可以保持相同的 API 调用方式
错误处理：对于不支持的方法，会抛出 unsupported 错误代码

关键注意事项

异步存储配置

某些服务（如认证和分析）需要持久化存储支持。开发者需要提供 Async Storage 实现：

import firebase from '@react-native-firebase/app';
import AsyncStorage from '@react-native-async-storage/async-storage';

// 在初始化 Firebase 前配置
firebase.setReactNativeAsyncStorage(AsyncStorage);

// 然后正常初始化
await firebase.initializeApp({ ... });

如果不配置，SDK 将使用内存存储，这会导致应用重启后数据丢失。