Opcje instalowania Firebase w aplikacji Apple

Swift Package Manager

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 Xcode w 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 .xcworkspace można potem bezpiecznie usunąć. Jeśli dodajesz Firebase do projektu po raz pierwszy, możesz pominąć ten krok.

2. W Xcode zainstaluj biblioteki Firebase, klikając kolejno File > Add Packages (Plik > Dodaj pakiety).

3. W wyświetlonym oknie dialogowym 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 używanie najnowszej wersji Firebase.

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

Gdy skończysz, Xcode zacznie przetwarzać zależności pakietu i pobierać je w tle.

Za pomocą Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą manifestu Package.swift, możesz dodać Firebase do tablicy dependencies pakietu. Więcej informacji znajdziesz w dokumencie 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, który zależy od produktu Firebase, dodaj 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ć prawidłowo.

Google Analytics

Google Analytics wymaga dodania flagi linkera -ObjC do ustawień kompilacji celu , jeśli jest uwzględniane w sposób przechodni.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania w Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Skrypt uruchamiania znajdziesz tutaj:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Inną opcją przesyłania symboli jest użycie upload-symbols skryptu. Umieść skrypt w podkatalogu pliku projektu (np. 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ć informacje o użyciu i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols bez parametrów.

CocoaPods

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

Dystrybucja CocoaPods Firebase wymaga Xcode w wersji 16.2 i CocoaPods w wersji 1.12.0 lub nowszej. Oto jak zainstalować Firebase za pomocą CocoaPods:

1. Utwórz plik Podfile, jeśli go nie masz. W głównym katalogu projektu uruchom to polecenie:

   pod init

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

   Do aplikacji możesz dodać dowolny z obsługiwanych produktów Firebase.

   Analytics włączona

   # 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, identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji Apple dotyczącej prywatności użytkowników i wykorzystywania danych oraz przejrzystości ś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 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ć prawidłowo.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy kompilacji skryptu uruchamiania w Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Skrypt uruchamiania znajdziesz tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

Obsługa Carthage jest eksperymentalna. Instrukcje dotyczące dodawania Firebase do aplikacji za pomocą Carthage znajdziesz w GitHub.

Integracja ręczna

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

1. Pobierz plik ZIP pakietu SDK frameworka. Ten plik zawiera fragmenty architektury dla wszystkich dostępnych architektur docelowych wszystkich pakietów SDK Firebase, dlatego jego pobieranie może trochę potrwać.

2. Rozpakuj plik, a następnie zapoznaj się z plikiem README dotyczącym frameworków, które chcesz uwzględnić w aplikacji.

3. Dodaj flagę linkera -ObjC w ustawieniach kompilacji celu w sekcji Other Linker Settings (Inne ustawienia linkera).