Opcje instalowania Firebase w aplikacji Apple

Menedżer pakietów Swift

Firebase zaleca Menedżera pakietów Swift w przypadku nowych projektów.

Przez Xcode

Obsługa menedżera pakietów Swift wymaga wersji 14.1 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 zignorować ten krok.

  2. Zainstaluj w Xcode biblioteki Firebase, wybierając Plik > Dodaj pakiety.

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

  5. Wybierz biblioteki Firebase, które chcesz dodać do swojej aplikacji.

Gdy skończysz, Xcode zacznie rozpoznawać zależności pakietów 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 swojego 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 dowolny cel zależny od usługi Firebase dodaj do tablicy dependencies tego celu.

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

Kwestie związane z konkretnymi usługami

Niektóre usługi Firebase wymagają dodatkowych kroków integracji, aby działać prawidłowo.

Google Analytics

Google Analytics wymaga dodania flagi łączącej -ObjC do ustawień kompilacji celu, jeśli są dołączane przechodnie.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

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

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

Innym sposobem przesyłania symboli jest użycie skryptu upload-symbols. Umieść skrypt w podkatalogu pliku projektu (np. scripts/upload-symbols) i sprawdź, czy jest on wykonywalny:

chmod +x scripts/upload-symbols

Tego skryptu można używać do ręcznego przesyłania plików dSYM. Aby uzyskać uwagi dotyczące użytkowania i dodatkowe instrukcje dotyczące skryptu, uruchom polecenie upload-symbols bez parametrów.

CocoaPods

Firebase obsługuje instalację z użyciem CocoaPods a także z menedżera pakietów Swift.

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

  1. Utwórz plik Podfile, jeśli jeszcze 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.

    Możesz dodać do aplikacji dowolną obsługiwaną usługę 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 o IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników i wykorzystywania danych oraz narzędzia App Tracking Transparency.

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

    pod install --repo-update
    open your-project.xcworkspace

Kwestie związane z konkretnymi usługami

Niektóre usługi 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 dla Xcode, aby po zakończeniu kompilacji automatycznie przesyłać symbole debugowania. Skrypt uruchamiany znajdziesz tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartagina

Obsługa Carthage ma charakter eksperymentalny. Informacje o tym, jak dodać Firebase do aplikacji za pomocą Carthage, znajdziesz w instrukcjach na GitHubie.

Integracja ręczna

Firebase udostępnia gotowy binarny rozkład 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 SDK platformy. Ten plik zawiera wycinki architektury wszystkich dostępnych architektur docelowych dla wszystkich pakietów SDK Firebase, dlatego jego pobieranie może trochę potrwać.

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

  3. Dodaj flagę łączącą -ObjC w elemencie Other Linker Settings w ustawieniach kompilacji celu.