Menedżer pakietów Swift
Firebase zaleca Swift Package Manager dla nowych projektów.
Przez Xcode
Obsługa Swift Package Manager wymaga wersji 14.1 lub nowszej.
Jeśli przeprowadzasz migrację 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 Plik > Dodaj pakiety
W wyświetlonym monicie wybierz repozytorium GitHub Firebase:
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.
Gdy skończysz, Xcode rozpocznie rozwiązywanie zależności między pakietami i pobieranie ich w tle.
Przez Package.swift
Aby zintegrować Firebase z pakietem Swift za pomocą manifestu Package.swift
, możesz dodać Firebase do tablicy dependencies
swojego pakietu. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją programu Swift Package Manager .
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 produktu
Niektóre produkty Firebase wymagają dodatkowych kroków integracji, aby działały poprawnie.
Google Analytics
Google Analytics wymaga dodania flagi linkera -ObjC
do ustawień kompilacji celu, jeśli jest ona uwzględniona przechodnio.
Crashlytics
Crashlytics wymaga przesłania symboli debugowania.
Możesz użyć fazy kompilacji uruchamiania skryptu dla Xcode, aby automatycznie przesłać 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
Tego skryptu można 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.
KakaoPods
Firebase obsługuje instalację z CocoaPods oprócz Swift Package Manager.
Dystrybucja CocoaPods Firebase wymaga Xcode 14.1 i CocoaPods 1.10.0 lub nowszego. Oto jak zainstalować Firebase za pomocą 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 pody Firebase, których chcesz używać w swojej aplikacji.
Możesz dodać do swojej aplikacji 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'
Dowiedz się więcej o IDFA, identyfikatorze reklamowym na poziomie urządzenia, w dokumentacji firmy Apple dotyczącej prywatności użytkownika 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 pody, a następnie otwórz plik
.xcworkspace
, aby zobaczyć projekt w Xcode:pod install --repo-update
open your-project.xcworkspace
Uwagi dotyczące 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 uruchamiania skryptu dla Xcode, aby automatycznie przesłać symbole debugowania po kompilacji. Znajdź skrypt uruchamiania tutaj:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Kartagina
Wsparcie Kartaginy jest eksperymentalne. Zapoznaj się z instrukcjami w GitHub , aby dołączyć Firebase do swojej aplikacji za pośrednictwem Carthage.
Integruj ręcznie
Firebase zapewnia 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 zip pakietu SDK środowiska . Ten plik zawiera wycinki architektury dla wszystkich dostępnych architektur docelowych dla wszystkich pakietów SDK Firebase, dlatego jego pobranie może trochę potrwać.
Rozpakuj plik, a następnie przejrzyj plik
README
, aby znaleźć struktury, które chcesz uwzględnić w swojej aplikacji.Dodaj flagę linkera
-ObjC
wOther Linker Settings
w ustawieniach kompilacji celu.