Dodaj Firebase do projektu Apple

Wymagania wstępne

  • Zainstaluj te elementy:

    • Xcode 26.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 15
      • macOS 10.15
      • tvOS 15
      • 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 szybkiego startu.

Krok 1. Utwórz projekt w Firebase

Zanim dodasz Firebase do aplikacji na Apple, musisz utworzyć projekt Firebase, aby połączyć go z tą 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ć aplikację w projekcie w 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 aplikacja została już dodana do projektu w 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 konfiguracji Firebase

  1. Kliknij Download GoogleService-Info.plist (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, kliknij, aby dodać plik konfiguracyjny 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

Używaj menedżera pakietów Swift do instalowania zależności Firebase i zarządzania nimi.

  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 w Firebase włączona jest funkcja Google Analytics, dodaj FirebaseAnalytics. Zapewnia to wszystkie funkcje analityczne. Możesz też wybrać poszczególne funkcje. Więcej informacji znajdziesz w sekcji Najczęstsze pytania dotyczącej najnowszej organizacji modułów w Google Analytics pakietu SDK Firebase.

Po zakończeniu Xcode automatycznie zacznie przetwarzać i pobierać zależności w tle.

Krok 5. Zainicjuj Firebase w aplikacji

Ostatnim krokiem jest dodanie do aplikacji kodu inicjującego. Być może masz już to za sobą, jeśli dodawałeś Firebase do aplikacji. Jeśli korzystasz z projektu przykładowego szybkiego startu, to zadanie zostało już wykonane.

  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ć znaczników 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ępnione wystąpienie 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 problem z konfiguracją, zapoznaj się z rozwiązywaniem problemów i najczęstszymi pytaniami dotyczącymi platform Apple.

Dostępne biblioteki

Ta sekcja zawiera listę usług Firebase obsługiwanych na platformach Apple. Dowiedz się więcej o tych bibliotekach Firebase na platformę Apple:

Usługa lub produkt Nazwa biblioteki lub platformy Chcesz dodać Analytics?
AdMob GoogleMobileAds
Firebase AI Logic 1
 FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (wymagane)
Firebase instalacje FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
PRZESTARZAŁE LUB NIEWSPIERANE BIBLIOTEKI
Dynamic Links FirebaseDynamicLinks
Firebase ML Interfejsy API modeli niestandardowych FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) was formerly called "Vertex AI in Firebase" and distributed under the FirebaseVertexAI module. Firebase AI Logic były wcześniej rozpowszechniane w ramach modułu FirebaseAI.

2 Firebase SQL Connect nosiło wcześniej nazwę „Firebase Data Connect”.

Integracja bez użycia Swift Package Manager

Jeśli nie chcesz używać Swift Package Manager, możesz zintegrować Firebase, importując bezpośrednio wstępnie skompilowane platformy.

Platformy

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

  1. Pobierz plik ZIP z pakietem SDK platformy. Jest 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 tych miejscach:

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

  3. Dodaj -ObjC flagę linkera w Other Linker Flags w ustawieniach kompilacji elementu docelowego.

Dalsze kroki

Więcej informacji o Firebase:

Dodaj do aplikacji usługi Firebase:

  • Twórz funkcje generatywnej AI za pomocą modeli Gemini, korzystając z Firebase AI Logic.

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

  • Skonfiguruj uwierzytelnianie użytkowników za pomocą metody 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.

  • Wywołuj 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 aplikacja ulega awarii, korzystając z Crashlytics.