Opcje instalowania Firebase w aplikacji Apple

Swift Package Manager

Firebase zaleca używanie Swift Package Managera w nowych projektach.

Przez Xcode

Obsługa menedżera pakietów Swift wymaga wersji 26.2 lub nowszej.

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

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

3. W oknie dialogowym, które się pojawi, wybierz repozytorium Firebase na GitHubie:

   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 aplikacji.

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

przez Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą pliku manifestu Package.swift, możesz dodać Firebase do tablicy dependencies pakietu. Więcej informacji znajdziesz w dokumentacji Swift Package Managera.

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Następnie w każdym celu, który zależy od usługi Firebase, dodaj ją do tablicy dependencies tego celu.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Uwagi dotyczące konkretnych usług

Niektóre usługi Firebase wymagają dodatkowych czynności integracyjnych, aby działać prawidłowo.

Google Analytics

Google Analytics wymaga dodania flagi łączącej -ObjC do ustawień kompilacji celu, jeśli jest uwzględniona przejściowo.

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 uruchamiający znajdziesz 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 (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 żadnych parametrów.

CocoaPods

Firebase obsługuje instalację za pomocą CocoaPods i Swift Package Managera.

Dystrybucja CocoaPods Firebase wymaga Xcode 26.2 i CocoaPods 1.12.0 lub nowszej wersji. Aby zainstalować Firebase za pomocą CocoaPods:

1. Utwórz plik Podfile, jeśli jeszcze go nie masz. W katalogu głównym 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ć dowolne obsługiwane usługi Firebase.

   Model Analytics został włączony

   # 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 IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz zasad App Tracking Transparency.

   Analytics nie jest włączony

   # 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 wyświetlić projekt w Xcode:

   pod install --repo-update

   open your-project.xcworkspace

Uwagi dotyczące konkretnych usług

Niektóre usługi Firebase wymagają dodatkowych czynności integracyjnych, 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 uruchamiający znajdziesz tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartagina

Obsługa Carthage jest eksperymentalna. Aby dowiedzieć się, jak dodać Firebase do aplikacji za pomocą Carthage, zapoznaj się z instrukcjami na GitHubie.

Integracja ręczna

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

1. Pobierz plik ZIP z pakietem SDK platformy. Ten plik zawiera fragmenty architektury dla wszystkich dostępnych architektur docelowych wszystkich pakietów SDK Firebase, więc jego pobranie może trochę potrwać.

2. Rozpakuj plik, a następnie sprawdź README pod kątem platform, które chcesz uwzględnić w aplikacji.

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