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.
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.Zainstaluj w Xcode biblioteki Firebase, wybierając Plik > Dodaj pakiety.
W wyświetlonym komunikacie wybierz repozytorium Firebase na GitHubie:
https://github.com/firebase/firebase-ios-sdk.git
Wybierz wersję Firebase, której chcesz użyć. W przypadku nowych projektów zalecamy używanie najnowszej wersji Firebase.
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:
Utwórz plik Podfile, jeśli jeszcze go nie masz. W głównym katalogu projektu uruchom to polecenie:
pod init
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'
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:
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ć.
Rozpakuj plik, a następnie sprawdź
README
pod kątem platform, które chcesz uwzględnić w swojej aplikacji.Dodaj flagę łączącą
-ObjC
w elemencieOther Linker Settings
w ustawieniach kompilacji celu.