Firebase zu Ihrem iOS-Projekt hinzufügen

Voraussetzungen

  • Installieren Sie Folgendes:

    • Xcode 12.2 oder höher
    • CocoaPods 1.10.0 oder höher

  • Stellen Sie sicher, dass Ihr Projekt diese Anforderungen erfüllt:

    • Ihr Projekt muss auf iOS 10 oder höher ausgerichtet sein.

  • Richten Sie ein physisches iOS-Gerät ein oder verwenden Sie den iOS-Simulator, um Ihre App auszuführen.

Wenn Sie nicht bereits über ein Xcode - Projekt haben und wollen nur ein Produkt Firebase auszuprobieren, können Sie einen unserer Download quickstart Proben .

Schritt 1: Firebase Projekt anlegen

Bevor Sie Firebase zu Ihrer iOS-App hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, um eine Verbindung zu Ihrer iOS-App herzustellen. Besuchen Sie verstehen Firebase Projekte mehr über Projekte Firebase zu lernen.

Schritt 2: Registrieren Sie Ihre App mit Firebase

Nachdem Sie ein Firebase-Projekt erstellt haben, können Sie ihm Ihre iOS-App hinzufügen.

Besuchen Sie verstehen Firebase Projekte für das Hinzufügen von Anwendungen zu einem Projekt Firebase mehr über Best Practices und Überlegungen zu lernen, auch , wie mehrere Build - Varianten zu behandeln.

  1. Gehen Sie auf die Firebase Konsole .

  2. Im Zentrum des Projekts Übersichtsseite klicken Sie auf das iOS - Symbol ( ) , um den Setup - Workflow zu starten.

    Wenn Sie bereits eine App zu Ihrem Firebase - Projekt hinzugefügt haben, klicken Sie App Fügen Sie die Plattform - Optionen anzuzeigen.

  3. Geben Sie Ihre App-Bundle - ID in der iOS - Bundle - ID - Feld.

  4. (Optional) Geben Sie weitere Informationen zur App: App Spitznamen und App Store - ID.

  5. Klicken Sie auf Registrieren App.

Schritt 3: Fügen Sie eine Firebase - Konfigurationsdatei

  1. Klicken Sie auf Download GoogleService-Info.plist auf Ihre Firebase iOS - Konfigurationsdatei (erhalten GoogleService-Info.plist ).

  2. Verschieben Sie Ihre Konfigurationsdatei in das Stammverzeichnis Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, wählen Sie aus, ob die Konfigurationsdatei allen Zielen hinzugefügt werden soll.

Wenn Sie mehr Bündel IDs in Ihrem Projekt haben, müssen Sie jedes Bündel ID mit einer registrierten Anwendung in der Konsole verbinden Firebase so dass jede App eine eigene haben kann GoogleService-Info.plist - Datei.

Schritt 4: Firebase SDKs zu Ihrer App

Wir empfehlen die Verwendung von CocoaPods die Firebase Bibliotheken zu installieren. Wenn Sie jedoch eher nicht CocoaPods verwenden, können Sie das SDK - Frameworks direkt integrieren oder verwenden Swift Package Manager statt.

Verwenden Sie eine der Schnellstart - Proben ? Das Xcode - Projekt und Podfile (mit Hülsen) sind bereits vorhanden, aber Sie werden noch brauchen Ihre Firebase - Konfigurationsdatei hinzufügen und die Schoten installieren.

  1. Erstellen Sie eine Poddatei, wenn Sie noch keine haben:

    cd your-project-directory
    pod init

  2. Fügen Sie Ihrer Poddatei die Firebase-Pods hinzu, die Sie in Ihrer App verwenden möchten.

    Sie können eine der Add unterstützt Firebase Produkte auf Ihrem iOS - App.

    Analytics aktiviert

    platform :ios, ‘10.0’
    
# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

    Erfahren Sie mehr über IDFA, die auf Geräteebene Werbe - ID, in Apples Benutzer Datenschutz und Datenverwendung und App - Tracking - Transparency - Dokumentation.

    Analytics nicht aktiviert

    platform :ios, ‘10.0’
    
# Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'

  3. Installieren Sie die Schoten, dann öffnen Sie Ihre .xcworkspace Datei , um das Projekt in Xcode zu sehen:

    pod install
    open your-project.xcworkspace

Schritt 5: Initialisieren Firebase in Ihrer App

Der letzte Schritt besteht darin, Ihrer Anwendung Initialisierungscode hinzuzufügen. Möglicherweise haben Sie dies bereits beim Hinzufügen von Firebase zu Ihrer App getan. Wenn Sie ein verwenden quickstart Beispielprojekt wurde dies für Sie erledigt.

  1. Importieren Sie die Firebase Modul in Ihrem UIApplicationDelegate :

    Schnell

    import Firebase

    Ziel c

    @import Firebase;
  2. Konfigurieren ein FirebaseApp gemeinsame Instanz, in der Regel in Ihrem App - application:didFinishLaunchingWithOptions: Methode:

    Schnell

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Ziel c

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Wenn Sie Firebase Analytics eingebunden haben, können Sie Ihre App ausführen, um eine Bestätigung der erfolgreichen Installation von Firebase an die Firebase-Konsole zu senden.

Das ist es! Sie können vor den überspringen nächsten Schritte .

Wenn Sie Probleme haben, aufgebaut zu werden , besuchen aber die iOS Fehlerbehebung & FAQ .

Verfügbare Pods

In diesem Abschnitt werden die für iOS unterstützten Firebase-Produkte und ihre Pods aufgelistet. Weitere Informationen zu diesen Firebase iOS-Bibliotheken:

Dienstleistung oder Produkt Pods Analytics hinzufügen?
AdMob pod 'Google-Mobile-Ads-SDK'
Analytik pod 'Firebase/Analytics'
App-Check pod 'Firebase/AppCheck'
App-Verteilung pod 'Firebase/AppDistribution'
Authentifizierung pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Cloud Functions for Firebase Client SDK pod 'Firebase/Functions'
Cloud-Messaging pod 'Firebase/Messaging'
Cloud-Speicher pod 'Firebase/Storage'
Crashlytics pod 'Firebase/Crashlytics'
Dynamische Links pod 'Firebase/DynamicLinks'
In-App-Messaging pod 'Firebase/InAppMessaging'
(erforderlich)
Firebase-Installationen pod 'Firebase/Installations'
APIs für benutzerdefinierte Firebase ML-Modelle pod 'Firebase/MLModelDownloader'
Leistungsüberwachung pod 'Firebase/Performance'
Echtzeit-Datenbank pod 'Firebase/Database'
Remote-Konfiguration pod 'Firebase/RemoteConfig'

Integrieren ohne CocoaPods

Wenn Sie Cocoapods nicht verwenden möchten, können Sie dennoch die Firebase SDKs nutzen, indem Sie die Frameworks direkt importieren oder den Swift Package Manager verwenden.

Frameworks

Zusätzlich zur Unterstützung der iOS-Plattform enthält die ZIP-Datei jetzt .xcframework-Dateien, die Community-basierte Catalyst-Unterstützung hinzufügen. Weitere Einzelheiten finden Sie die Firebase iOS SDK README auf GitHub .

  1. Laden Sie das Framework SDK zip . Dies ist eine ca. 200 MB große Datei, deren Download einige Zeit in Anspruch nehmen kann.

  2. Entpacken Sie die Datei überprüfen, dann die README für die Frameworks , dass Sie in Ihrer Anwendung enthalten sein sollen.

  3. Fügen Sie den ObjC Linker - Other Linker Settings Flag in Ihren Other Linker Settings - Other Linker Settings in Ihrem Ziel Build - Einstellungen.

Schneller Paketmanager

Erfahren Sie mehr über Swift Package Manager - Integration in unserem Guide .

Nächste Schritte

Weitere Informationen zu Firebase:

Fügen Sie Ihrer App Firebase-Dienste hinzu: