Szybki menedżer pakietów
Firebase rekomenduje Swift Package Manager do nowych projektów.
Przez Xcode
Obsługa Menedżera pakietów Swift wymaga wersji 14.1 lub nowszej.
W przypadku migracji 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, ten krok można zignorować.W Xcode zainstaluj biblioteki Firebase, przechodząc do opcji 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żywać. W przypadku nowych projektów zalecamy korzystanie z najnowszej wersji Firebase.
Wybierz biblioteki Firebase, które chcesz uwzględnić w swojej aplikacji.
Gdy skończysz, Xcode zacznie rozwiązywać zależności pakietów i pobierać je w tle.
Przez Package.swift
Aby zintegrować Firebase z pakietem Swift za pośrednictwem manifestu Package.swift
, możesz dodać Firebase do tablicy dependencies
swojego pakietu. Więcej szczegółów 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 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 etapów integracji, aby działać poprawnie.
Google Analytics
Google Analytics wymaga dodania flagi linkera -ObjC
do ustawień kompilacji obiektu docelowego, jeśli jest ona uwzględniona przechodnio.
Crashlytics
Crashlytics wymaga przesłania symboli debugowania.
Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Znajdź skrypt uruchamiający 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
Tego skryptu można użyć do ręcznego przesyłania plików dSYM. Aby uzyskać uwagi dotyczące użycia i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols
bez żadnych parametrów.
CocoaPods
Firebase obsługuje instalację z CocoaPods oprócz Menedżera pakietów Swift.
Dystrybucja CocoaPods Firebase wymaga Xcode 14.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. W katalogu głównym katalogu projektu uruchom następującą komendę:
pod init
Do swojego Podfile dodaj pody Firebase, których chcesz używać w swojej aplikacji.
Do swojej aplikacji możesz dodać dowolny z obsługiwanych produktów 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 na temat identyfikatora IDFA, identyfikatora reklamowego na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz przejrzystości śledzenia aplikacji .
Analityka 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 kapsuły, 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 etapów integracji, aby działać poprawnie.
Crashlytics
Crashlytics wymaga przesłania symboli debugowania.
Możesz użyć fazy kompilacji skryptu uruchamiania dla Xcode, aby automatycznie przesyłać symbole debugowania po kompilacji. Znajdź skrypt uruchamiający tutaj:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Kartagina
Wsparcie Kartaginy ma charakter eksperymentalny. Zobacz instrukcje w GitHub dotyczące włączania Firebase do swojej aplikacji za pośrednictwem Kartaginy.
Zintegruj ręcznie
Firebase zapewnia wstępnie zbudowaną 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 zestawów SDK Firebase, dlatego pobranie może zająć trochę czasu.
Rozpakuj plik, a następnie przejrzyj plik
README
pod kątem struktur, które chcesz uwzględnić w swojej aplikacji.Dodaj flagę linkera
-ObjC
wOther Linker Settings
w ustawieniach kompilacji obiektu docelowego.