Menedżer pakietów Swift
Firebase zaleca korzystanie z usługi Swift Package Manager w przypadku 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, możesz pominąć ten krok.Zainstaluj biblioteki Firebase w Xcode, klikając Plik > Dodaj pakiety.
W wyświetlonym komunikacie 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 używanie najnowszej wersji Firebase.
Wybierz biblioteki Firebase, które chcesz uwzględnić w aplikacji.
Po zakończeniu 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 w dowolnym miejscu docelowym zależnym od usługi Firebase dodaj go do tablicy dependencies
tego celu.
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
Uwagi na temat poszczególnych produktów
Niektóre usługi Firebase do prawidłowego działania wymagają dodatkowych kroków integracji.
Google Analytics
Google Analytics wymaga dodania flagi łączącej -ObjC
do ustawień kompilacji celu, jeśli jest ona występująca pośrednio.
Crashlytics
Crashlytics wymaga przesłania symboli debugowania.
Możesz użyć fazy uruchamiania skryptu w Xcode, aby po zakończeniu kompilacji automatycznie przesyłać symbole debugowania. Uruchom skrypt 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 upewnij się, że jest 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 upload-symbols
bez żadnych parametrów.
CocoaPods
Firebase obsługuje instalację za pomocą CocoaPods oraz menedżera pakietów Swift.
Dystrybucja CocoaPods w Firebase wymaga Xcode 14.1 i CocoaPods w wersji 1.12.0 lub nowszej. Aby zainstalować Firebase za pomocą CocoaPods:
Utwórz plik Podfile, jeśli jeszcze go nie masz. W katalogu głównym projektu uruchom to polecenie:
pod init
Dodaj do pliku Podfile pody Firebase, których chcesz używać w swojej aplikacji.
Możesz dodać do aplikacji dowolne obsługiwane usługi 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żytkownika i korzystania z danych oraz usługi App Tracking Transparency.
Statystyki nie są 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 wyświetlić projekt w Xcode:pod install --repo-update
open your-project.xcworkspace
Uwagi na temat poszczególnych produktów
Niektóre usługi Firebase do prawidłowego działania wymagają dodatkowych kroków integracji.
Crashlytics
Crashlytics wymaga przesłania symboli debugowania.
Możesz użyć fazy uruchamiania skryptu w Xcode, aby po zakończeniu kompilacji automatycznie przesyłać symbole debugowania. Uruchom skrypt tutaj:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Kartagina
Podparcie Kartaginy ma charakter eksperymentalny. Zapoznaj się z instrukcjami w serwisie GitHub, jak dołączyć Firebase do swojej aplikacji przez Carthage.
Integracja ręczna
Firebase udostępnia gotowy plik binarny XCFramework dla użytkowników, którzy chcą zintegrować Firebase bez korzystania z menedżera zależności. Aby zainstalować Firebase:
Pobierz plik ZIP pakietu SDK platformy Firebase. Ten plik zawiera wycinki architektury dla wszystkich dostępnych architektur docelowych dla wszystkich pakietów SDK Firebase, dlatego jego pobieranie może trochę potrwać.
Rozpakuj plik, a następnie w
README
znajdź platformy, które chcesz uwzględnić w aplikacji.Dodaj flagę tagu łączącego
-ObjC
do elementuOther Linker Settings
w ustawieniach kompilacji celu.