Zainstaluj Firebase w swojej aplikacji Apple

Menedżer pakietów Swift

Począwszy od wersji 8.0.0 pakietu Firebase Apple SDK, obsługa Firebase Swift Package Manager 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. Jeśli przeprowadzasz migrację z projektu opartego na CocoaPods, uruchom pod deintegrate , aby usunąć CocoaPods z projektu Xcode. Wygenerowany przez .xcworkspace plik .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 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 korzystanie z najnowszej wersji Firebase.

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

Gdy skończysz, Xcode rozpocznie rozwiązywanie zależności między pakietami i pobieranie ich w tle.

Przez Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą manifestu Package.swift , możesz dodać Firebase do tablicy dependencies swojego pakietu. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją programu Swift Package Manager .

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 produktu

Niektóre produkty Firebase wymagają dodatkowych kroków integracji, aby działały poprawnie.

Google Analytics

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

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji uruchamiania skryptu dla Xcode, aby automatycznie przesłać 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

Tego skryptu można 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.

KakaoPods

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

Dystrybucja CocoaPods Firebase wymaga Xcode 13.3.1 i CocoaPods 1.10.0 lub nowszej. 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 pody Firebase, których chcesz używać w swojej aplikacji.

   Możesz dodać do swojej aplikacji dowolny z obsługiwanych produktów Firebase .

   Analityka włączona

   # 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 firmy Apple dotyczącej prywatności użytkownika i wykorzystania danych oraz przejrzystości śledzenia aplikacji .

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

   Binarne zależności Firebase są domyślnie integrowane jako struktury statyczne. Jeśli używasz Firebase jako zależności od dynamicznego frameworka, przeczytaj dokumentację dotyczącą korzystania z Firebase z frameworka lub biblioteki .

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 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 uruchamiania skryptu dla Xcode, aby automatycznie przesłać symbole debugowania po kompilacji. Znajdź skrypt uruchamiania tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartagina

Wsparcie Kartaginy jest eksperymentalne. Zapoznaj się z instrukcjami w GitHub , aby dołączyć Firebase do swojej aplikacji za pośrednictwem Carthage.

Integruj ręcznie

Firebase zapewnia 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 zip pakietu SDK środowiska . Ten plik zawiera wycinki architektury dla wszystkich dostępnych architektur docelowych dla wszystkich pakietów SDK Firebase, dlatego jego pobranie może trochę potrwać.

2. Rozpakuj plik, a następnie przejrzyj plik README , aby znaleźć struktury, które chcesz uwzględnić w swojej aplikacji.

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