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 wersji 16.2 lub nowszej.

  1. Jeśli migrujesz 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, możesz pominąć ten krok.

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

  3. W wyświetlonym oknie wybierz repozytorium GitHub Firebase:

    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.

przez Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą Package.swiftmanifestu, możesz dodać Firebase do dependencies tablicy pakietu. Więcej informacji 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 każdym celu, który zależy od usługi Firebase, dodaj go do dependenciestablicy tego celu.

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

Uwagi dotyczące konkretnych produktów

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

Google Analytics

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

Crashlytics

Crashlytics wymaga przesłania symboli na potrzeby 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 można go wykonać:

chmod +x scripts/upload-symbols

Ten skrypt może służyć do ręcznego przesyłania plików dSYM. Aby wyświetlić uwagi dotyczące użycia i dodatkowe instrukcje dotyczące skryptu, uruchom polecenie upload-symbols bez parametrów.

CocoaPods

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

Dystrybucja CocoaPods Firebase wymaga Xcode 16.2 i CocoaPods 1.12.0 lub nowszej. 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.

    Włączono: Analytics 

    # 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, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentach firmy Apple Prywatność użytkowników i wykorzystywanie danych oraz App Tracking Transparency.

    Nie włączono Analytics 

    # 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 produktów

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

Crashlytics

Crashlytics wymaga przesłania symboli na potrzeby 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. Zapoznaj się z instrukcjami na GitHubie dotyczącymi dodawania Firebase do aplikacji za pomocą narzędzia Carthage.

Integracja ręczna

Firebase udostępnia gotową dystrybucję binarną 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 platformy. Ten plik zawiera wycinki architektury dla wszystkich dostępnych architektur docelowych wszystkich pakietów SDK Firebase, więc jego pobieranie może zająć trochę czasu.

  2. Rozpakuj plik, a potem przejrzyj README w przypadku platform, które chcesz uwzględnić w aplikacji.

  3. Dodaj -ObjCflagę linkera w Other Linker Settingsustawieniach kompilacji elementu docelowego.