Dodaj Firebase do projektu Apple

Wymagania wstępne

  • Zainstaluj te elementy:

    • Xcode 15.2 lub nowsza wersja
  • 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.

    W przypadku Cloud Messaging na platformach Apple wymagania wstępne:

    • Skonfiguruj fizyczne urządzenie Apple.
    • Uzyskaj klucz uwierzytelniający Apple Push Notification dla swojego konta Apple Developer.
    • Włącz powiadomienia push w Xcode w sekcji Aplikacja > Możliwości.

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 Apple, musisz utworzyć projekt Firebase, aby połączyć go z aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Informacje o projektach Firebase.

  1. W konsoli Firebase kliknij Dodaj projekt.

    • Aby dodać zasoby Firebase do istniejącego projektu Google Cloud, wpisz jego nazwę lub wybierz ją z menu.

    • Aby utworzyć nowy projekt, wpisz jego nazwę. Opcjonalnie możesz też edytować identyfikator projektu wyświetlany pod nazwą projektu.

  2. Jeśli pojawi się taka prośba, zapoznaj się z warunkami usługi Firebase i je zaakceptuj.

  3. Kliknij Dalej.

  4. (Opcjonalnie) Skonfiguruj w projekcie Google Analytics, aby optymalnie korzystać z tych usług Firebase:

    Wybierz istniejące konto Google Analytics lub utwórz nowe konto.

    Jeśli tworzysz nowe konto, wybierz Analyticslokalizację raportowania, a następnie zaakceptuj ustawienia udostępniania danych i zasady Google Analytics dla projektu.

  5. Kliknij Utwórz projekt (lub Dodaj Firebase, jeśli używasz istniejącego projektu Google Cloud).

Firebase automatycznie udostępnia zasoby dla Twojego projektu Firebase. Po zakończeniu procesu wyświetli się strona podglądu projektu Firebase w konsoli 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.

    • Identyfikator pakietu jednoznacznie identyfikuje aplikację w ekosystemie Apple.

    • Znajdź identyfikator pakietu: otwórz projekt w Xcode, wybierz aplikację najwyższego poziomu w nawigatorze projektu, a następnie wybierz kartę Ogólne.

      Wartością pola Identyfikator grupy jest identyfikator grupy (np. com.yourcompany.yourproject).

    • Pamiętaj, że wielkość liter w wartości identyfikatora pakietu jest rozróżniana, a po zarejestrowaniu aplikacji Firebase w projekcie Firebase nie można jej zmienić.

  4. (Opcjonalnie) Wpisz inne informacje o aplikacji: nazwę skrótową aplikacjiidentyfikator 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).

    • Plik konfiguracji Firebase zawiera unikalne, ale nie tajne identyfikatory projektu. Więcej informacji o tym pliku konfiguracyjnym znajdziesz w artykule Informacje o projektach Firebase.

    • W każdej chwili możesz ponownie pobrać plik konfiguracyjny Firebase.

    • Sprawdź, czy nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, np. „(2)”.

  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
  4. Wybierz wersję pakietu SDK, której chcesz używać.
  5. 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 zostało to już zrobione 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 FirestoreAuthentication:
    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          
    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Skonfiguruj współdzieloną instancję FirebaseApp w metodzie application(_:didFinishLaunchingWithOptions:) w delegacie aplikacji:
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    // 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 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 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 Google Analytics.">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
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ę kompilatora -ObjC w ustawieniach kompilacji docelowej Other Linker Settings.

Dalsze kroki

Więcej informacji o Firebase:

Aby dodać usługi Firebase do aplikacji: