Opcje instalowania Firebase w aplikacji Apple

Menedżer pakietów Swift

W przypadku nowych projektów Firebase zaleca menedżera pakietów Swift.

Za pomocą Xcode

Obsługa menedżera pakietów Swift wymaga wersji 15.2 lub nowszej.

1. Jeśli migrujesz z projektu opartego na CocoaPods, uruchom polecenie pod deintegrate, aby usunąć CocoaPods z projektu Xcode. Następnie możesz usunąć wygenerowany przez CocoaPods plik .xcworkspace. Jeśli Firebase jest dodawane do projektu po raz pierwszy, możesz pominąć ten krok.

2. Aby zainstalować biblioteki Firebase w Xcode, wybierz Plik > Dodaj pakiety.

3. W wyświetlonym promptzie wybierz repozytorium GitHub Firebase:

   https://github.com/firebase/firebase-ios-sdk.git
   

4. Wybierz wersję Firebase, której chcesz użyć. W przypadku nowych projektów zalecamy używanie najnowszej wersji Firebase.

5. Wybierz biblioteki Firebase, które chcesz uwzględnić w aplikacji.

Gdy skończysz, Xcode zacznie rozwiązywać zależności pakietu i pobierać je w tle.

przez Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą pliku Package.swift manifest, możesz dodać Firebase do tablicy dependencies w pakiecie. 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 każdym docelowym miejscu docelowym, które zależy od produktu Firebase, dodaj ten produkt do tablicy dependencies tego miejsca docelowego.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Uwagi dotyczące poszczególnych usług

Niektóre usługi Firebase do prawidłowego działania wymagają dodatkowych kroków integracji.

Google Analytics

Google Analytics wymaga dodania flagi linkera -ObjC do ustawień kompilacji docelowego, jeśli jest ona uwzględniona w ramach pośrednich.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Aby automatycznie przesyłać symbole debugowania po kompilacji, możesz użyć fazy kompilacji skryptu do uruchomienia w Xcode. Skrypt do uruchomienia znajdziesz 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 (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ć informacje o użytkowaniu i dodatkowe instrukcje dotyczące skryptu, uruchom upload-symbols bez żadnych parametrów.

CocoaPods

Firebase obsługuje instalację za pomocą CocoaPods, a nie tylko menedżera pakietów Swift.

Rozpowszechnianie pakietu CocoaPods Firebase wymaga Xcode 15.2 i CocoaPods 1.12.0 lub nowszej wersji. Aby zainstalować Firebase za pomocą CocoaPods:

1. Utwórz plik Podfile, jeśli go nie masz. W katalogu głównym katalogu projektu uruchom to polecenie:

   pod init

2. Dodaj do pliku Podfile moduły Firebase, których chcesz używać w aplikacji.

   Do aplikacji możesz dodać dowolne obsługiwane produkty Firebase.

   Włączono: Analytics

   # 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 identyfikatorze IDFA, czyli identyfikatorze reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników i używania danych oraz przezroczystości w przypadku śledzenia aplikacji.

   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'

3. Zainstaluj pody, a potem otwórz plik .xcworkspace, aby wyświetlić projekt w Xcode:

   pod install --repo-update

   open your-project.xcworkspace

Uwagi dotyczące poszczególnych usług

Niektóre usługi Firebase do prawidłowego działania wymagają dodatkowych kroków integracji.

Crashlytics

Domena Crashlytics wymaga przesłania symboli debugowania.

Aby automatycznie przesyłać symbole debugowania po kompilacji, możesz użyć fazy kompilacji skryptu do uruchomienia w Xcode. Skrypt do uruchomienia znajdziesz tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartagina

Obsługa Carthage jest eksperymentalna. Aby dodać Firebase do aplikacji za pomocą Carthage, zapoznaj się z instrukcjami na GitHubie.

Integracja ręczna

Firebase udostępnia gotową dystrybucję binarną XCFramework dla użytkowników, którzy chcą zintegrować Firebase bez użycia menedżera zależności. Aby zainstalować Firebase:

1. Pobierz pakiet SDK platformy w formacie ZIP. Plik zawiera fragmenty architektury dla wszystkich dostępnych architektur docelowych we wszystkich pakietach SDK Firebase, więc jego pobranie może trochę potrwać.

2. Rozpakuj plik, a potem przejrzyj README dla frameworków, które chcesz uwzględnić w aplikacji.

3. Dodaj flagę linkera -ObjC w ustawieniach kompilacji docelowej Other Linker Settings.