Opcje instalowania Firebase w aplikacji Apple

Swift Package Manager

W przypadku nowych projektów Firebase zaleca używanie menedżera pakietów Swift.

Za pomocą Xcode

Obsługa menedżera pakietów Swift wymaga Xcode w wersji 16.2 lub nowszej.

  1. Jeśli migrujesz z projektu opartego na CocoaPods, uruchom polecenie pod deintegrate, aby usunąć CocoaPods z projektu Xcode. Wygenerowany przez CocoaPods plik .xcworkspace można potem bezpiecznie usunąć. Jeśli dodajesz Firebase do projektu po raz pierwszy, możesz pominąć ten krok.

  2. W Xcode zainstaluj biblioteki Firebase, klikając kolejno File > Add Packages (Plik > Dodaj pakiety).

  3. W wyświetlonym oknie dialogowym wybierz repozytorium Firebase GitHub:

    https://github.com/firebase/firebase-ios-sdk.git

  4. Wybierz wersję Firebase, której chcesz używać. W przypadku nowych projektów zalecamy używanie najnowszej wersji Firebase.

  5. Wybierz biblioteki Firebase, które chcesz uwzględnić w aplikacji.

Gdy skończysz, Xcode zacznie przetwarzać zależności pakietu i pobierać je w tle.

Za pomocą Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą manifestu Package.swift, możesz dodać Firebase do tablicy dependencies pakietu. Więcej informacji znajdziesz w dokumencie menedżera pakietów Swift.

dependencies: [

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

],

Następnie w dowolnym celu, który zależy od produktu Firebase, dodaj go do dependencies tablicy tego celu.

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

Uwagi dotyczące konkretnego produktu

Niektóre produkty Firebase wymagają dodatkowych kroków integracji, aby działać prawidłowo.

Google Analytics

Google Analytics wymaga dodania flagi linkera -ObjC do ustawień kompilacji celu , jeśli jest uwzględniane w sposób przechodni.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania w Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Skrypt uruchamiania znajdziesz tutaj:

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

Inną opcją przesyłania symboli jest użycie upload-symbols skryptu. Umieść skrypt w podkatalogu pliku projektu (np. scripts/upload-symbols), a następnie upewnij się, że skrypt jest wykonywalny:

chmod +x scripts/upload-symbols

Ten skrypt może służyć do ręcznego przesyłania plików dSYM. Aby uzyskać informacje o użyciu i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols bez parametrów.

CocoaPods

Firebase obsługuje instalację za pomocą CocoaPods oprócz menedżera pakietów Swift.

Dystrybucja CocoaPods Firebase wymaga Xcode w wersji 16.2 i CocoaPods w wersji 1.12.0 lub nowszej. Oto jak zainstalować Firebase za pomocą CocoaPods:

  1. Utwórz plik Podfile, jeśli go nie masz. W głównym katalogu projektu uruchom to polecenie:

    pod init

  2. Do pliku Podfile dodaj pody Firebase, których chcesz używać w aplikacji.

    Do aplikacji możesz dodać dowolny z obsługiwanych produktów Firebase.

    Analytics włączona 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod FirebaseAnalytics/Core

# 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'

    Więcej informacji o identyfikatorze IDFA, identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji Apple dotyczącej prywatności użytkowników i wykorzystywania danych oraz przejrzystości śledzenia aplikacji.

    Analytics nie jest włączona 

    # 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. Zainstaluj pody, a następnie otwórz plik .xcworkspace, aby zobaczyć projekt w Xcode:

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

Uwagi dotyczące konkretnego produktu

Niektóre produkty Firebase wymagają dodatkowych kroków integracji, aby działać prawidłowo.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania w Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Skrypt uruchamiania znajdziesz tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Obsługa Carthage jest eksperymentalna. Instrukcje dotyczące dodawania Firebase do aplikacji za pomocą Carthage znajdziesz w GitHub.

Integracja ręczna

Firebase udostępnia wstępnie skompilowaną binarną dystrybucję XCFramework dla użytkowników, którzy chcą zintegrować Firebase bez używania menedżera zależności. Aby zainstalować Firebase:

  1. Pobierz plik ZIP pakietu SDK frameworka. Ten plik zawiera fragmenty architektury dla wszystkich dostępnych architektur docelowych wszystkich pakietów SDK Firebase, dlatego jego pobieranie może trochę potrwać.

  2. Rozpakuj plik, a następnie zapoznaj się z plikiem README dotyczącym frameworków, które chcesz uwzględnić w aplikacji.

  3. Dodaj flagę linkera -ObjC w ustawieniach kompilacji celu w sekcji Other Linker Settings (Inne ustawienia linkera).