Zainstaluj Firebase w swojej aplikacji Apple

Menedżer pakietów Swift

Począwszy od v8.0.0 z Firebase firmy Apple SDK, Firebase za Swift Package Manager wsparcie jest z wersji beta i jest ogólnie dostępna do użytku. CocoaPods nie jest wymagane dla użytkowników Swift Package Manager.

W przypadku Xcode w wersji 12.5 i nowszych zalecaną metodą instalacji jest Swift Package Manager.

Przez Xcode

Obsługa Swift Package Manager wymaga Xcode 12.5 lub nowszego.

  1. W przypadku migracji z projektem opartym na CocoaPods uruchom pod deintegrate usunąć CocoaPods z projektu Xcode. CocoaPods generowane .xcworkspace plik może być bezpiecznie usunięte później. Jeśli dodajesz Firebase do projektu po raz pierwszy, ten krok można zignorować.

  2. W Xcode, zainstalować Firebase bibliotek przechodząc Plik> Swift pakiecie> Dodaj Package zależności ...

  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.

Via Package.swift

Aby zintegrować Firebase do pakietu Swift za pośrednictwem Package.swift oczywisty, można dodać Firebase do dependencies tablicy pakietu. Aby uzyskać więcej informacji, zobacz dokumentację Swift Package Manager .

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, dodać 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ły poprawnie.

Google Analytics

Google Analytics wymaga dodania -ObjC flagę łącznika do ustawień kompilacji swój cel, jeśli zawarte przechodni.

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 upload-symbols skrypt. Umieścić 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. Notatek użytkowania i dodatkowych instrukcji 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 12.5 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.

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

    Analytics włączone

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

    Dowiedz się więcej o IDFA, identyfikatora reklamowego na poziomie urządzenia, w Apple użytkownika prywatności i danych użytkowania i App Tracking przejrzystości dokumentacji.

    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 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. Zainstalować strąków, następnie otwórz .xcworkspace plik, 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. Patrz instrukcje na GitHub na tym Firebase w swojej aplikacji poprzez Kartaginy.

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 zip Framework SDK . 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 przejrzeć README dla ram, które chcesz umieścić w swojej aplikacji.

  3. Dodaj -ObjC flagę łącznikowej w swoich Other Linker Settings w ustawieniach budować swój docelowego.