Dodaj Firebase do projektu Apple

Wymagania wstępne

  • Zainstaluj te elementy:

    • Xcode 16.2 lub nowsza

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

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

  • Skonfiguruj fizyczne urządzenie Apple lub uruchom aplikację za pomocą symulatora.

Jeśli nie masz jeszcze projektu Xcode i chcesz wypróbować produkt Firebase, możesz pobrać jeden z naszych przykładów szybkiego startu.

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do aplikacji na 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 ją zarejestrować w projekcie Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.

  1. Otwórz konsolę Firebase.

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

    Jeśli aplikacja została już dodana do projektu Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy.

  3. W polu Identyfikator pakietu wpisz identyfikator pakietu aplikacji.

  4. (Opcjonalnie) Wpisz inne informacje o aplikacji: nazwę skrótową aplikacji i identyfikator App Store.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

  1. Kliknij Pobierz plik GoogleService-Info.plist, aby pobrać plik konfiguracji Firebase dla platform Apple (GoogleService-Info.plist).

  2. Przenieś plik konfiguracji do katalogu głównego projektu Xcode. Jeśli pojawi się taka prośba, wybierz opcję dodania pliku konfiguracyjnego do wszystkich miejsc docelowych.

Jeśli w projekcie masz wiele identyfikatorów pakietów, 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 zarządzania nimi możesz używać menedżera pakietów Swift.

  1. Po otwarciu projektu aplikacji w Xcode wybierz 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 usługa Google Analytics, pamiętaj, aby dodać FirebaseAnalytics. W przypadku Analytics bez funkcji zbierania danych IDFA dodaj zamiast tego FirebaseAnalyticsWithoutAdId.

Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.

Krok 5. Inicjuj Firebase w aplikacji

Ostatnim krokiem jest dodanie kodu inicjalizacji do aplikacji. Być może zrobiono to już w ramach dodawania Firebase do aplikacji. Jeśli używasz próbnego projektu Szybki start, ta czynność została już wykonana.

  1. Zaimportuj moduł FirebaseCore w pliku UIApplicationDelegate, a także wszystkie inne moduły Firebase, których używa delegowany obiekt 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 współdzieloną instancję FirebaseApp w metodzie application(_:didFinishLaunchingWithOptions:) w delegacie 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ć obiekt delegujący aplikacji i dołączyć go do struktury App za pomocą funkcji UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć swizlowanie zastępników aplikacji. Więcej informacji znajdziesz w instrukcjach 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 dołączysz 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 sekcji Następne kroki.

Jeśli jednak masz problem z konfiguracją, zapoznaj się z artykułem Rozwiązywanie problemów z platformami Apple i najczęstsze pytania.

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:

Usługa lub produkt Podstacje SwiftPM Libraries Dodaj Analytics
AdMob pod 'Google-Mobile-Ads-SDK' Nie dotyczy
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 instalacji 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
Vertex AI in Firebase pod 'FirebaseVertexAI' FirebaseVertexAI

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

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

CocoaPods

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

Platformy

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

  1. Pobierz pakiet SDK platformy w formacie ZIP. Plik ma rozmiar około 200 MB i jego pobranie może trochę potrwać.

  2. Rozpakuj plik, a potem zintegruj frameworki, które chcesz uwzględnić w aplikacji.

    Instrukcje integracji znajdziesz w jednym z tych miejsc:

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

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

Dalsze kroki

Więcej informacji o Firebase:

Aby dodać usługi Firebase do aplikacji:

  • Uzyskaj statystyki na temat zachowań użytkowników za pomocą 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 Cloud Storage.

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

  • Wysyłanie powiadomień za pomocą Cloud Messaging.

  • Dowiedz się, kiedy i dlaczego aplikacja się zawiesza, korzystając z funkcji Crashlytics.