Opcje instalowania Firebase w aplikacji Apple

Menedżer pakietów Swift

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 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 .xcworkspacemożesz później usunąć. 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 celu, jeśli jest ona uwzględniona pośrednio.

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 wyświetlić notatki dotyczące skryptu i dodatkowe instrukcje, uruchom upload-symbols bez żadnych parametrów.

CocoaPods

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

Rozpowszechnianie pakietu CocoaPods przez Firebase wymaga Xcode 16.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 Analytics 

    # 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, czyli identyfikatorze reklam na poziomie urządzenia, znajdziesz w dokumentacji 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 potem 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żywania menedżera zależności. Aby zainstalować Firebase:

  1. Pobierz pakiet SDK platformy w formacie ZIP. Plik ten zawiera fragmenty 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 tych frameworków, które chcesz uwzględnić w aplikacji.

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