Opcje instalowania Firebase w aplikacji Apple

Menedżer pakietów Swift

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

Za pomocą Xcode

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

  1. Jeśli migrujesz z projektu opartego na CocoaPods, uruchom polecenie pod deintegrate, aby usunąć CocoaPods z projektu Xcode. Następnie możesz usunąć wygenerowany przez CocoaPods plik .xcworkspace. Jeśli Firebase jest dodawane do projektu po raz pierwszy, możesz pominąć ten krok.

  2. Aby zainstalować biblioteki Firebase w Xcode, wybierz Plik > Dodaj pakiety.

  3. W wyświetlonym promptzie wybierz repozytorium GitHub Firebase:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Wybierz wersję Firebase, której chcesz użyć. 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 rozwiązywać zależności pakietu i pobierać je w tle.

przez Package.swift

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

dependencies: [

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

],

Następnie w każdym docelowym miejscu docelowym, które zależy od produktu Firebase, dodaj ten produkt do tablicy dependencies tego miejsca docelowego.

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

Uwagi dotyczące poszczególnych usług

Niektóre usługi Firebase wymagają dodatkowych czynności integracyjnych, aby działać prawidłowo.

Google Analytics

Google Analytics wymaga dodania flagi linkera -ObjC do ustawień kompilacji docelowego, jeśli jest ona uwzględniona w ramach pośrednich.

Crashlytics

Domena Crashlytics wymaga przesłania symboli debugowania.

Aby automatycznie przesyłać symbole debugowania po kompilacji, możesz użyć fazy kompilacji skryptu do uruchomienia w Xcode. Skrypt do uruchomienia znajdziesz tutaj:

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

Inną opcją przesyłania symboli jest użycie skryptu upload-symbols. Umieść skrypt w podkatalogu pliku projektu (np. scripts/upload-symbols), a potem sprawdź, czy można go uruchomić:

chmod +x scripts/upload-symbols

Za pomocą tego skryptu możesz ręcznie przesyłać pliki dSYM. Aby uzyskać informacje o użytkowaniu i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols bez żadnych parametrów.

CocoaPods

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

Rozpowszechnianie pakietu Firebase za pomocą CocoaPods wymaga Xcode 15.2 i CocoaPods 1.12.0 lub nowszej. Aby zainstalować Firebase za pomocą CocoaPods:

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

    pod init
  2. Dodaj do pliku Podfile moduły Firebase, których chcesz używać w aplikacji.

    Do aplikacji możesz dodać dowolne obsługiwane produkty Firebase.

    Włączono kryterium „Analytics

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

    Więcej informacji o identyfikatorze IDFA, czyli identyfikatorze reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników i używania danych oraz przezroczystości w przypadku ś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 wyświetlić projekt w Xcode:

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

Uwagi dotyczące poszczególnych usług

Niektóre usługi Firebase wymagają dodatkowych czynności integracyjnych, aby działać prawidłowo.

Crashlytics

Domena Crashlytics wymaga przesłania symboli debugowania.

Aby automatycznie przesyłać symbole debugowania po kompilacji, możesz użyć fazy kompilacji skryptu do uruchomienia w Xcode. Skrypt do uruchomienia znajdziesz tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Obsługa Carthage jest eksperymentalna. Aby dodać Firebase do aplikacji za pomocą Carthage, zapoznaj się z instrukcjami na GitHubie.

Integracja ręczna

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

  1. Pobierz pakiet SDK platformy w formacie ZIP. Plik ten zawiera wycinki architektury dla wszystkich dostępnych architektur docelowych we wszystkich pakietach SDK Firebase, więc jego pobranie może trochę potrwać.

  2. Rozpakuj plik, a potem przejrzyj README dla frameworków, które chcesz uwzględnić w aplikacji.

  3. Dodaj flagę linkera -ObjC w ustawieniach kompilacji docelowej Other Linker Settings.