Zainstaluj Firebase w swojej aplikacji Apple

Menedżer pakietów Swift

Począwszy od wersji 8.0.0 pakietu Firebase Apple SDK, obsługa Swift Package Manager w Firebase jest poza wersją beta i jest ogólnie dostępna do użytku. CocoaPods nie jest wymagane dla użytkowników Swift Package Manager.

W przypadku Firebase w wersji 8 i nowszych zalecaną metodą instalacji jest Swift Package Manager.

Przez Xcode

Obsługa Swift Package Manager wymaga wersji 13.3.1 lub nowszej.

  1. W przypadku migracji z projektu opartego na CocoaPods uruchom pod deintegrate , aby usunąć CocoaPods z projektu Xcode. Plik .xcworkspace wygenerowany przez .xcworkspace można później bezpiecznie usunąć. Jeśli dodajesz Firebase do projektu po raz pierwszy, ten krok można zignorować.

  2. W Xcode zainstaluj biblioteki Firebase, przechodząc do Plik > Dodaj pakiety

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

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

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

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

Po zakończeniu Xcode rozpocznie rozwiązywanie zależności pakietów i pobieranie ich w tle.

Za pośrednictwem Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą manifestu Package.swift , możesz dodać Firebase do tablicy dependencies swojego pakietu. Więcej informacji można znaleźć 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 dowolnym celu zależnym od produktu Firebase dodaj go do tablicy dependencies 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ły poprawnie.

Google Analytics

Google Analytics wymaga dodania flagi -ObjC do ustawień kompilacji celu, jeśli jest ona uwzględniana przechodnie.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przekazać symbole debugowania po kompilacji. Znajdź skrypt uruchamiania 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 (na przykład 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ć uwagi dotyczące użytkowania i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols bez żadnych parametrów.

CocoaPods

Firebase obsługuje instalację z CocoaPods oprócz Swift Package Manager.

Dystrybucja Firebase CocoaPods wymaga Xcode 13.3.1 i CocoaPods 1.10.0 lub nowszego.Oto jak zainstalować Firebase przy użyciu CocoaPods:

  1. Utwórz plik Podfile, jeśli jeszcze go nie masz. Z katalogu głównego katalogu projektu uruchom następujące polecenie:

    pod init

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

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

    Analytics włączone

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

    Dowiedz się więcej o IDFA, identyfikatorze reklamowym na poziomie urządzenia, w dokumentacji Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz przejrzystości śledzenia aplikacji .

    Analytics nie jest włączone

    # 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ły poprawnie.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przekazać symbole debugowania po kompilacji. Znajdź skrypt uruchamiania tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartagina

Wsparcie Kartaginy jest eksperymentalne. Zapoznaj się z instrukcjami na GitHub , aby dodać Firebase do swojej aplikacji za pośrednictwem Carthage.

Zintegruj ręcznie

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

  1. Pobierz framework SDK zip . Ten plik zawiera wycinki architektury dla wszystkich dostępnych architektur docelowych dla wszystkich pakietów SDK Firebase, dlatego jego pobranie może zająć trochę czasu.

  2. Rozpakuj plik, a następnie przejrzyj plik README dla struktur, które chcesz uwzględnić w swojej aplikacji.

  3. Dodaj flagę konsolidatora -ObjC w Other Linker Settings konsolidatora w ustawieniach kompilacji obiektu docelowego.