Dodaj Firebase do projektu Apple

Wymagania wstępne

  • Zainstaluj te elementy:

    • Xcode 16.2 lub nowsze

  • Upewnij się, że Twój projekt spełnia te wymagania:

    • Twój projekt musi być przeznaczony na te wersje platformy lub nowsze:
      • iOS 13
      • macOS 10.15
      • tvOS 13
      • watchOS 7

  • Skonfiguruj fizyczne urządzenie Apple lub użyj symulatora, aby uruchomić aplikację.

Jeśli nie masz jeszcze projektu Xcode i chcesz tylko wypróbować usługę Firebase, możesz pobrać jeden z naszych przykładowych projektów.

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do aplikacji na urządzenia Apple, musisz utworzyć projekt Firebase, aby połączyć go z aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Informacje o projektach Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby korzystać z Firebase w aplikacji na urządzenia Apple, musisz zarejestrować ją w projekcie Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.

  1. Otwórz Firebasekonsolę.

  2. W centrum strony „Opis” projektu kliknij ikonę iOS+, aby uruchomić proces konfiguracji.

    Jeśli masz już aplikację w projekcie Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy.

  3. W polu bundle ID wpisz identyfikator pakietu aplikacji.

  4. (Opcjonalnie) wpisz inne informacje o aplikacji: pseudonim aplikacji i identyfikator App Store.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracyjny Firebase

  1. Kliknij Pobierz GoogleService-Info.plist, aby uzyskać plik konfiguracyjny Firebase aplikacji (GoogleService-Info.plist).

  2. Przenieś plik konfiguracyjny do katalogu głównego projektu Xcode. Jeśli pojawi się odpowiedni komunikat, wybierz opcję dodania pliku konfiguracyjnego do wszystkich miejsc docelowych.

Jeśli w projekcie masz kilka identyfikatorów pakietu, musisz powiązać każdy z nich z zarejestrowaną aplikacją w konsoli Firebase, aby każda aplikacja miała własny plik GoogleService-Info.plist.

Krok 4. Dodaj do aplikacji pakiety SDK Firebase

Do instalacji zależności Firebase i do zarządzania nimi możesz używać menedżera pakietów Swift.

  1. Po otwarciu projektu aplikacji wybierz w Xcode opcję File > Add Packages (Plik > Dodaj pakiety).
  2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Wybierz wersję pakietu SDK, której chcesz używać.

  4. Wybierz biblioteki Firebase, których chcesz używać.

    Jeśli w projekcie Firebase włączona jest funkcja Google Analytics, dodaj FirebaseAnalytics. Zapewnia to dostęp do wszystkich funkcji analitycznych. Możesz też wybrać poszczególne funkcje. Więcej informacji znajdziesz w naszych odpowiedziach na najczęstsze pytania dotyczące najnowszej organizacji modułów w Google Analytics pakietu SDK Firebase.

Gdy skończysz, Xcode zacznie automatycznie wyszukiwać i pobierać zależności w tle.

Krok 5. Zainicjuj Firebase w aplikacji

Ostatnim krokiem jest dodanie kodu inicjującego do aplikacji. Mogłeś(-aś) już to zrobić w ramach dodawania Firebase do aplikacji. Jeśli używasz projektu przykładowego szybkiego startu, zostało to już zrobione.

  1. Zaimportuj moduł FirebaseCore w pliku UIApplicationDelegate, a także inne moduły Firebase, których używa delegat aplikacji. Aby na przykład użyć właściwości Cloud Firestore i Authentication:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Skonfiguruj udostępnioną instancję FirebaseApp w metodzie application(_:didFinishLaunchingWithOptions:) delegata aplikacji:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć zamianę delegata aplikacji. Więcej informacji znajdziesz w instrukcjach dotyczących SwiftUI.

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. Jeśli masz pakiet SDK Firebase dla Google Analytics, możesz uruchomić aplikację, aby wysłać do konsoli Firebase potwierdzenie, że Firebase został zainstalowany.

To wszystko. Możesz przejść do dalszych kroków.

Jeśli masz problemy z konfiguracją, zapoznaj się z rozwiązywaniem problemów i najczęstszymi pytaniami dotyczącymi platform Apple.

Dostępne biblioteki

W tej sekcji znajdziesz listę usług Firebase obsługiwanych na platformach Apple. Dowiedz się więcej o tych bibliotekach Firebase na platformę Apple:

  • Dokumentacja źródłowa (Swift | Obj-C)

  • Repozytorium GitHub pakietu Firebase SDK na platformy Apple

Usługa lub produkt Pods Biblioteki SwiftPM Chcesz dodać Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' Nie dotyczy
Firebase AI Logic 1
 pod 'FirebaseAI' FirebaseAI
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Data Connect Nie dotyczy FirebaseDataConnect
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(wymagane)
Firebase instalacje pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML Interfejsy API modeli niestandardowych pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

1 Firebase AI Logic nosiło wcześniej nazwę „Vertex AI in Firebase” z podem pod 'FirebaseVertexAI' i biblioteką SwiftPM FirebaseVertexAI.

Integracja bez użycia menedżera pakietów Swift

Jeśli nie chcesz używać Swift Package Manager, możesz nadal korzystać z pakietów SDK Firebase, używając CocoaPods lub importując bezpośrednio struktury.

CocoaPods

Więcej informacji o integracji z CocoaPods znajdziesz w naszym przewodniku.

Platformy

Oprócz obsługi platformy iOS plik ZIP zawiera teraz pliki .xcframework. Szczegółowe informacje znajdziesz w pliku README pakietu SDK Firebase na platformy Apple w witrynie GitHub.

  1. Pobierz plik ZIP pakietu SDK platformy. To plik o rozmiarze około 200 MB, więc pobieranie może zająć trochę czasu.

  2. Rozpakuj plik, a następnie zintegruj z aplikacją wybrane przez siebie platformy.

    Instrukcje integracji znajdziesz w jednym z tych miejsc:

    Informacje o wersjach platformy lub zależnościach znajdziesz w pliku METADATA.md w pobranym pliku ZIP.

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

Dalsze kroki

Więcej informacji o Firebase:

Dodaj do aplikacji usługi Firebase:

  • Twórz funkcje generatywnej AI z modelami Gemini i Imagen za pomocą Firebase AI Logic.

  • Uzyskuj statystyki dotyczące zachowań użytkowników dzięki Analytics.

  • Skonfiguruj uwierzytelnianie użytkowników za pomocą Authentication.

  • Przechowuj dane, np. informacje o użytkownikach, za pomocą Cloud Firestore lub Realtime Database.

  • Przechowuj pliki, takie jak zdjęcia i filmy, w usłudze Cloud Storage.

  • Uruchamiaj kod backendu, który działa w bezpiecznym środowisku, za pomocą Cloud Functions.

  • Wysyłaj powiadomienia za pomocą Cloud Messaging.

  • Dowiedz się, kiedy i dlaczego Twoja aplikacja ulega awarii, korzystając z Crashlytics.