Opcje instalowania Firebase w aplikacji Apple

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 15.2 lub nowszej.

  1. W przypadku migracji z projektu opartego na CocoaPods uruchom pod deintegrate, aby usunąć CocoaPods z Twojego projektu Xcode. .xcworkspace wygenerowane przez CocoaPods można bezpiecznie usunąć później. Jeśli Firebase jest dodawane do projektu po raz pierwszy, możesz pominąć ten krok.

  2. W Xcode zainstaluj biblioteki Firebase, przechodząc do 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żywać. W nowych projektach zalecamy korzystanie z najnowszej wersji Firebase.

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

Gdy skończysz, Xcode rozpocznie rozpoznawanie zależności pakietów pobierając je w tle.

przez Package.swift

Aby zintegrować Firebase z pakietem Swift za pomocą pliku manifestu Package.swift, możesz: dodaj Firebase do tablicy dependencies swojego pakietu. Więcej informacji: Dokumentacja 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 tablica dependencies w tym zakresie.

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

Uwagi na temat poszczególnych produktów

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

Google Analytics

Google Analytics wymaga dodania flagi łączącej -ObjC do docelowego elementu ustawień kompilacji, jeśli są one uwzględniane pośrednio.

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy uruchamiania skryptu dla Xcode, aby automatycznie przesyłać dane debugowania i symbole po utworzeniu. Skrypt do uruchomienia znajdziesz tutaj:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

Innym sposobem przesyłania symboli jest użycie polecenia upload-symbols skrypt. Umieść skrypt w podkatalogu pliku projektu (np. scripts/upload-symbols), a potem sprawdź, czy można go uruchomić:

chmod +x scripts/upload-symbols

Tego skryptu można używać do ręcznego przesyłania plików dSYM. Uwagi dotyczące użytkowania wraz z dodatkowymi instrukcjami dotyczącymi skryptu, uruchom polecenie upload-symbols bez żadnych .

CocoaPods

Firebase obsługuje instalację za pomocą CocoaPods oprócz Menedżera pakietów Swift.

Dystrybucja CocoaPods w Firebase wymaga pakietów Xcode 15.2 CocoaPods w wersji 1.12.0 lub nowszej. Oto instrukcja instalacji Firebase korzystające z CocoaPods:

  1. Utwórz plik Podfile, jeśli jeszcze go nie masz. Źródło w katalogu projektu, uruchom to polecenie:

    pod init

  2. Dodaj do pliku Podfile pody Firebase, których chcesz używać w swojej aplikacji.

    Możesz dodać dowolną z obsługiwanych usług Firebase do aplikacji.

    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 IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple Prywatność użytkownika i korzystanie z danych oraz Przejrzystość śledzenia aplikacji dokumentacji.

    Funkcja Analytics nie została 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 następnie otwórz plik .xcworkspace, aby wyświetlić projekt Xcode:

    pod install --repo-update
     
    open your-project.xcworkspace

Uwagi na temat poszczególnych produktów

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

Crashlytics

Crashlytics wymaga przesłania symboli debugowania.

Możesz użyć fazy uruchamiania skryptu dla Xcode, aby automatycznie przesyłać dane debugowania i symbole po utworzeniu. Skrypt do uruchomienia znajdziesz tutaj:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Kartagina

Wsparcie Kartaginy ma charakter eksperymentalny. Zobacz instrukcje w GitHubie, dotyczące włączenia Firebase w swojej aplikacji przez Carthage.

Integracja ręczna

Firebase udostępnia gotowy plik binarny XCFramework dla użytkowników, , aby zintegrować Firebase bez użycia menedżera zależności. Aby zainstalować Firebase:

  1. Pobierz plik ZIP pakietu SDK platformy Firebase. Ten plik zawiera wycinki architektury wszystkich dostępnych architektur docelowych dla wszystkich pakietów SDK Firebase, pobieranie może trochę potrwać.

  2. Rozpakuj plik, a następnie w README znajdziesz odpowiednie platformy. dodać do swojej aplikacji.

  3. Dodaj tag łączący -ObjC flagę na Other Linker Settings w ustawieniach kompilacji celu.