Zainstaluj Firebase w swojej aplikacji Apple

Szybki menedżer pakietów

Firebase rekomenduje Swift Package Manager do nowych projektów.

Przez Xcode

Obsługa Menedżera pakietów Swift wymaga wersji 14.1 lub nowszej.

  1. W przypadku migracji z projektu opartego na CocoaPods uruchom pod deintegrate aby usunąć CocoaPods z projektu Xcode. Wygenerowany przez CocoaPods 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 opcji 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żywać. 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 zacznie rozwiązywać zależności pakietów i pobierać je w tle.

Przez Package.swift

Aby zintegrować Firebase z pakietem Swift za pośrednictwem manifestu Package.swift , możesz dodać Firebase do tablicy dependencies swojego pakietu. Więcej szczegółów 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 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 etapów integracji, aby działać poprawnie.

Google Analytics

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

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Znajdź skrypt uruchamiający 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życia i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols bez żadnych parametrów.

CocoaPods

Firebase obsługuje instalację z CocoaPods oprócz Menedżera pakietów Swift.

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

  1. Utwórz plik Podfile, jeśli jeszcze go nie masz. W katalogu głównym katalogu projektu uruchom następującą komendę:

    pod init
  2. Do swojego Podfile dodaj pody Firebase, których chcesz używać w swojej aplikacji.

    Do swojej aplikacji możesz dodać 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'

    Więcej informacji na temat identyfikatora IDFA, identyfikatora reklamowego na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników 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'
  3. Zainstaluj kapsuły, 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 etapów integracji, aby działać poprawnie.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Znajdź skrypt uruchamiający tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartagina

Wsparcie Kartaginy ma charakter eksperymentalny. Zobacz instrukcje w GitHub dotyczące włączania Firebase do swojej aplikacji za pośrednictwem Kartaginy.

Zintegruj ręcznie

Firebase zapewnia wstępnie zbudowaną 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 zestawów SDK Firebase, dlatego pobranie może zająć trochę czasu.

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

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