Firebase SDK for Swift：完整指南及示例

什么是 Firebase SDK for Swift？

Firebase SDK（软件开发工具包）用于 Swift 语言，是 Google 提供的一套强大工具，为 iOS 应用开发者提供现成的后端基础设施（后端即服务，BaaS）。您无需从头编写服务器端代码，即可获得现成的云服务：数据库、身份验证、分析、云存储、推送通知等等。

Firebase SDK for Swift 允许您：

• 实时存储数据（Firestore 和 Realtime Database）
• 对用户进行身份验证（邮箱/密码、Google、Apple、Facebook 等）
• 上传文件到云存储（Cloud Storage）
• 发送推送通知（Cloud Messaging）
• 收集分析数据（Google Analytics for Firebase）
• 配置 A/B 测试（Remote Config）
• 捕获错误（Crashlytics）

该库通过 Swift Package Manager (SPM) 或 CocoaPods 分发。这是 Google 的官方 SDK，得到持续支持和更新。

安装 Firebase SDK for Swift

选项 1：Swift Package Manager (SPM) — 推荐方式

1. 在 Xcode 中打开您的项目
2. 转到 File → Add Packages...
3. 粘贴仓库 URL：https://github.com/firebase/firebase-ios-sdk.git
4. 选择所需版本（建议使用最新的稳定版本）
5. 选择所需的模块（例如 FirebaseFirestore、FirebaseAuth）
6. 点击 Add Package

选项 2：CocoaPods

如果您使用 CocoaPods，请在您的 Podfile 中添加：

platform :ios, '13.0'use_frameworks!

target 'YourAppName' do  pod 'FirebaseFirestore'  pod 'FirebaseAuth'  pod 'FirebaseStorage'  pod 'FirebaseAnalytics'  pod 'FirebaseMessaging'end

然后在终端中执行：

pod install

在 Firebase 控制台中配置项目

1. 前往 console.firebase.google.com
2. 创建新项目或选择现有项目
3. 添加 iOS 应用
4. 下载 GoogleService-Info.plist 文件
5. 将其拖放到您的 Xcode 项目根目录中

快速入门及代码示例

安装和配置完成后，在 AppDelegate.swift 中初始化 Firebase：

import UIKitimport FirebaseCore

@mainclass AppDelegate: UIResponder, UIApplicationDelegate {    func application(_ application: UIApplication,                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {        FirebaseApp.configure()        return true    }}

现在您可以使用 Firebase 了。以下是从 Firestore 写入和读取数据的简单示例：

import FirebaseFirestore

class ViewController: UIViewController {    let db = Firestore.firestore()

    override func viewDidLoad() {        super.viewDidLoad()        addUser()        readUsers()    }

    func addUser() {        db.collection("users").addDocument(data: [            "name": "伊万·彼得罗夫",            "age": 25,            "email": "ivan@example.com"        ]) { error in            if let error = error {                print("添加错误：\\(error.localizedDescription)")            } else {                print("用户成功添加！")            }        }    }

    func readUsers() {        db.