Menedżer pakietów Swift
Począwszy od wersji 8.0.0 pakietu Firebase Apple SDK, obsługa Swift Package Manager w Firebase jest poza wersją beta i jest ogólnie dostępna do użytku. CocoaPods nie jest wymagane dla użytkowników Swift Package Manager.
W przypadku Firebase w wersji 8 i nowszych zalecaną metodą instalacji jest Swift Package Manager.
Przez Xcode
Obsługa Swift Package Manager wymaga wersji 13.3.1 lub nowszej.
W przypadku migracji z projektu opartego na CocoaPods uruchom
pod deintegrate
, aby usunąć CocoaPods z projektu Xcode. Plik .xcworkspace wygenerowany przez.xcworkspace
można później bezpiecznie usunąć. Jeśli dodajesz Firebase do projektu po raz pierwszy, ten krok można zignorować.W Xcode zainstaluj biblioteki Firebase, przechodząc do Plik > Dodaj pakiety
W wyświetlonym monicie wybierz repozytorium Firebase GitHub:
https://github.com/firebase/firebase-ios-sdk.git
Wybierz wersję Firebase, której chcesz użyć. W przypadku nowych projektów zalecamy korzystanie z najnowszej wersji Firebase.
Wybierz biblioteki Firebase, które chcesz uwzględnić w swojej aplikacji.
Po zakończeniu Xcode rozpocznie rozwiązywanie zależności pakietów i pobieranie ich w tle.
Za pośrednictwem Package.swift
Aby zintegrować Firebase z pakietem Swift za pomocą manifestu Package.swift
, możesz dodać Firebase do tablicy dependencies
swojego pakietu. Więcej informacji można znaleźć 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 dowolnym celu zależnym od produktu Firebase dodaj go do tablicy dependencies
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ły poprawnie.
Google Analytics
Google Analytics wymaga dodania flagi -ObjC
do ustawień kompilacji celu, jeśli jest ona uwzględniana przechodnie.
Crashlytics
Crashlytics wymaga przesłania symboli debugowania.
Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przekazać symbole debugowania po kompilacji. Znajdź skrypt uruchamiania 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 (na przykład 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ć uwagi dotyczące użytkowania i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols
bez żadnych parametrów.
CocoaPods
Firebase obsługuje instalację z CocoaPods oprócz Swift Package Manager.
Dystrybucja Firebase CocoaPods wymaga Xcode 13.3.1 i CocoaPods 1.10.0 lub nowszego.Oto jak zainstalować Firebase przy użyciu CocoaPods:
Utwórz plik Podfile, jeśli jeszcze go nie masz. Z katalogu głównego katalogu projektu uruchom następujące polecenie:
pod init
Do pliku Podfile dodaj bloki Firebase, których chcesz używać w swojej aplikacji.
Do swojej aplikacji możesz dodać dowolne obsługiwane produkty Firebase .
Analytics włączone
# 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'
Dowiedz się więcej o IDFA, identyfikatorze reklamowym na poziomie urządzenia, w dokumentacji Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz przejrzystości śledzenia aplikacji .
Analytics nie jest włączone
# 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 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ły poprawnie.
Crashlytics
Crashlytics wymaga przesłania symboli debugowania.
Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przekazać symbole debugowania po kompilacji. Znajdź skrypt uruchamiania tutaj:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Kartagina
Wsparcie Kartaginy jest eksperymentalne. Zapoznaj się z instrukcjami na GitHub , aby dodać Firebase do swojej aplikacji za pośrednictwem Carthage.
Zintegruj ręcznie
Firebase udostępnia gotową binarną dystrybucję XCFramework dla użytkowników, którzy chcą zintegrować Firebase bez korzystania z menedżera zależności. Aby zainstalować Firebase:
Pobierz framework SDK zip . Ten plik zawiera wycinki architektury dla wszystkich dostępnych architektur docelowych dla wszystkich pakietów SDK Firebase, dlatego jego pobranie może zająć trochę czasu.
Rozpakuj plik, a następnie przejrzyj plik
README
dla struktur, które chcesz uwzględnić w swojej aplikacji.Dodaj flagę konsolidatora
-ObjC
wOther Linker Settings
konsolidatora w ustawieniach kompilacji obiektu docelowego.