Installieren Sie Firebase in Ihrer Apple-App

Swift-Paketmanager

Firebase empfiehlt Swift Package Manager für neue Projekte.

Über Xcode

Die Unterstützung von Swift Package Manager erfordert 14.1 oder höher.

  1. Wenn Sie von einem CocoaPods-basierten Projekt migrieren, führen Sie pod deintegrate aus, um CocoaPods aus Ihrem Xcode-Projekt zu entfernen. Die von CocoaPods generierte .xcworkspace Datei kann anschließend sicher gelöscht werden. Wenn Sie Firebase zum ersten Mal zu einem Projekt hinzufügen, kann dieser Schritt ignoriert werden.

  2. Installieren Sie in Xcode die Firebase-Bibliotheken, indem Sie zu Datei > Pakete hinzufügen navigieren

  3. Wählen Sie in der angezeigten Eingabeaufforderung das Firebase-GitHub-Repository aus:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Wählen Sie die Version von Firebase aus, die Sie verwenden möchten. Für neue Projekte empfehlen wir die Verwendung der neuesten Version von Firebase.

  5. Wählen Sie die Firebase-Bibliotheken aus, die Sie in Ihre App einbinden möchten.

Sobald Sie fertig sind, beginnt Xcode damit, Ihre Paketabhängigkeiten aufzulösen und sie im Hintergrund herunterzuladen.

Über Package.swift

Um Firebase über ein Package.swift Manifest in ein Swift-Paket zu integrieren, können Sie Firebase zum dependencies Ihres Pakets hinzufügen. Weitere Informationen finden Sie in der Dokumentation zum Swift Package Manager .

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Fügen Sie es dann in jedem Ziel, das von einem Firebase-Produkt abhängt, zum dependencies dieses Ziels hinzu.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Produktspezifische Überlegungen

Einige Firebase-Produkte erfordern zusätzliche Integrationsschritte, damit sie ordnungsgemäß funktionieren.

Google Analytics

Google Analytics erfordert das Hinzufügen des Linker-Flags -ObjC zu den Build-Einstellungen Ihres Ziels, wenn es transitiv einbezogen wird.

Crashlytics

Crashlytics erfordert das Hochladen von Debug-Symbolen.

Sie können eine Ausführungsskript-Build-Phase für Xcode verwenden, um Debug-Symbole nach dem Build automatisch hochzuladen. Das Ausführungsskript finden Sie hier:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Eine weitere Möglichkeit zum Hochladen von Symbolen ist die Verwendung des Skripts upload-symbols . Platzieren Sie das Skript in einem Unterverzeichnis Ihrer Projektdatei (zum Beispiel scripts/upload-symbols ) und stellen Sie dann sicher, dass das Skript ausführbar ist:

chmod +x scripts/upload-symbols

Mit diesem Skript können dSYM-Dateien manuell hochgeladen werden. Für Hinweise zur Verwendung und zusätzliche Anweisungen für das Skript führen Sie upload-symbols ohne Parameter aus.

Kakaoschoten

Firebase unterstützt zusätzlich zum Swift Package Manager die Installation mit CocoaPods .

Für die CocoaPods-Distribution von Firebase sind Xcode 14.1 und CocoaPods 1.12.0 oder höher erforderlich. So installieren Sie Firebase mit CocoaPods:

  1. Erstellen Sie eine Poddatei, falls Sie noch keine haben. Führen Sie im Stammverzeichnis Ihres Projektverzeichnisses den folgenden Befehl aus:

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

    Sie können Ihrer App jedes der unterstützten Firebase-Produkte hinzufügen.

    Analytics aktiviert

    # Add the Firebase pod for Google Analytics
    pod 'FirebaseAnalytics'
    
    # 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 'FirebaseAuth'
    pod 'FirebaseFirestore'

    Weitere Informationen zu IDFA, der Werbekennung auf Geräteebene, finden Sie in der Dokumentation zu Benutzerdatenschutz, Datennutzung und App-Tracking-Transparenz von Apple.

    Analytics nicht aktiviert

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'FirebaseAuth'
    pod 'FirebaseFirestore'
  3. Installieren Sie die Pods und öffnen Sie dann Ihre .xcworkspace Datei, um das Projekt in Xcode anzuzeigen:

    pod install --repo-update
    open your-project.xcworkspace

Produktspezifische Überlegungen

Einige Firebase-Produkte erfordern zusätzliche Integrationsschritte, damit sie ordnungsgemäß funktionieren.

Crashlytics

Crashlytics erfordert das Hochladen von Debug-Symbolen.

Sie können eine Ausführungsskript-Build-Phase für Xcode verwenden, um Debug-Symbole nach dem Build automatisch hochzuladen. Das Ausführungsskript finden Sie hier:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Karthago

Die Unterstützung durch Karthago ist experimentell. Sehen Sie sich die Anweisungen auf GitHub an, um Firebase über Carthage in Ihre App einzubinden.

Manuell integrieren

Firebase bietet eine vorgefertigte binäre XCFramework-Distribution für Benutzer, die Firebase integrieren möchten, ohne einen Abhängigkeitsmanager zu verwenden. So installieren Sie Firebase:

  1. Laden Sie die Framework-SDK-Zip-Datei herunter. Diese Datei enthält Architektur-Slices für alle verfügbaren Zielarchitekturen für alle Firebase SDKs und daher kann das Herunterladen einige Zeit in Anspruch nehmen.

  2. Entpacken Sie die Datei und lesen Sie dann die README für die Frameworks, die Sie in Ihre App einbinden möchten.

  3. Fügen Sie das Linker-Flag -ObjC in Ihren Other Linker Settings in den Build-Einstellungen Ihres Ziels hinzu.