Dodaj Firebase do projektu Apple

Wymagania wstępne

  • Zainstaluj te elementy:

    • Xcode 26.2 lub nowszy,

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

    • Projekt musi być przeznaczony na te wersje platformy lub nowsze:
      • iOS 15
      • macOS 11
      • tvOS 15
      • watchOS 8

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

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

Krok 1. Utwórz projekt w Firebase

Zanim dodasz Firebase do aplikacji na urządzenia Apple, musisz utworzyć projekt w Firebase, który połączysz z aplikacją. Aby dowiedzieć się więcej o projektach w Firebase, przeczytaj artykuł Informacje o projektach Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby używać Firebase w aplikacji na urządzenia Apple, musisz zarejestrować aplikację w projekcie w Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.

  1. Otwórz konsolę Firebase.

  2. Na środku strony Przegląd projektu kliknij ikonę iOS+, aby uruchomić proces konfiguracji.

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

  3. Wpisz identyfikator pakietu aplikacji w polu Identyfikator pakietu.

  4. (Opcjonalnie) Wpisz inne informacje o aplikacji: Nazwa aplikacji i Identyfikator sklepu z aplikacjami.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

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

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

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

Krok 4. Dodaj do aplikacji pakiety SDK Firebase

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

  1. W Xcode, gdy projekt aplikacji jest otwarty, kliknij 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 usługa Google Analytics, dodaj FirebaseAnalytics. Zapewnia ona wszystkie funkcje analityczne. Możesz też wybrać poszczególne funkcje. Więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania dotyczące najnowszej organizacji modułów w pakiecie SDK Google Analytics dla Firebase.

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

Krok 5. Zainicjuj Firebase w aplikacji

Ostatnim krokiem jest dodanie kodu inicjującego do aplikacji. Być może zostało to już zrobione podczas dodawania Firebase do aplikacji. Jeśli używasz przykładowego projektu z szybkiego startu, zostało to już zrobione.

  1. Zaimportuj moduł FirebaseCore do pliku UIApplicationDelegate oraz wszystkie 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ć obiekt delegowany aplikacji i dołączyć go do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć swizzling 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 platformy Google Analytics, możesz uruchomić aplikację, aby wysłać do konsoli Firebase potwierdzenie, że Firebase został zainstalowany.

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

Jeśli masz problemy z konfiguracją, zapoznaj się z artykułem Rozwiązywanie problemów i najczęstsze pytania dotyczące 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 platformy Apple:

Usługa lub produkt Nazwa biblioteki / platformy Dodawanie 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
WYCOFANE LUB NIEOBSŁUGIWANE BIBLIOTEKI
Dynamic Links FirebaseDynamicLinks
Interfejsy API modelu niestandardowego Firebase ML FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) wcześniej nosił nazwę „Vertex AI w Firebase” i był rozpowszechniany w module FirebaseVertexAI. Firebase AI Logic był też wcześniej rozpowszechniany w module FirebaseAI.

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

Integracja bez użycia Swift Package Managera

Jeśli nie chcesz używać menedżera pakietów Swift, 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 na platformy Apple na GitHubie.

  1. Pobierz plik ZIP z pakietem SDK platformy. Plik ma rozmiar ok. 200 MB, więc pobieranie może trochę potrwać.

  2. Rozpakuj plik, a następnie zintegruj platformy, które chcesz uwzględnić w aplikacji.

    Instrukcje integracji znajdziesz w tych miejscach:

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

  3. Dodaj flagę łącznika -ObjC w ustawieniach kompilacji Other Linker Flags w przypadku celu.

Dalsze kroki

Więcej informacji o Firebase:

Dodaj usługi Firebase do aplikacji:

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

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

  • skonfigurować uwierzytelnianie użytkowników za pomocą Authentication,

  • przechowywać dane, takie jak informacje o użytkownikach, za pomocą Cloud Firestore lub Realtime Database;

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

  • Uruchamiaj kod backendu 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.