Dodaj Firebase do swojego projektu Apple

Wymagania wstępne

  • Zainstaluj następujące elementy:

    • Xcode 14.1 lub nowsza wersja

  • Sprawdź, czy projekt spełnia te wymagania:

    • Twój projekt musi być kierowany na te lub nowsze wersje platformy:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6

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

Jeśli nie masz jeszcze projektu Xcode i chcesz wypróbować usługę Firebase, możesz pobrać krótkie wprowadzenie.

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do aplikacji Apple, musisz utworzyć projekt Firebase, który będzie połączony z Twoją aplikacją. Odwiedź stronę Omówienie projektów Firebase, aby dowiedzieć się więcej o projektach Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby używać Firebase w aplikacji Apple, musisz ją zarejestrować w projekcie Firebase. Rejestracja aplikacji to często tzw. „dodanie” jej do projektu.

  1. Otwórz konsolę Firebase.

  2. Na środku strony przeglądu 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: Pseudonim aplikacji i Identyfikator w sklepie z aplikacjami.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

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

  2. Przenieś plik konfiguracyjny do katalogu głównego projektu Xcode. Jeśli pojawi się prośba, wybierz dodanie pliku konfiguracyjnego do wszystkich celów.

Jeśli w projekcie masz wiele identyfikatorów pakietu, 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. Po otwarciu projektu aplikacji w Xcode przejdź do File > Add Packages (Plik > Dodaj pakiety).
  2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK platformy Apple dla platform Firebase:
    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żyć.

    Jeśli w Twoim projekcie Firebase włączona jest usługa Google Analytics, pamiętaj o dodaniu komponentu FirebaseAnalytics. W przypadku Analytics bez funkcji zbierania danych IDFA dodaj zamiast tego FirebaseAnalyticsWithoutAdId.

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

Krok 5. Zainicjuj Firebase w swojej aplikacji

Ostatnim krokiem jest dodanie kodu inicjowania do aplikacji. Być może udało Ci się już to zrobić podczas dodawania Firebase do aplikacji. Jeśli korzystasz z przykładowego projektu szybkiego startu, zostało to zrobione za Ciebie.

  1. Zaimportuj moduł FirebaseCore do interfejsu UIApplicationDelegate, a także wszystkie inne moduły Firebase, których używa osoba, której przekazano dostęp do aplikacji. Aby na przykład korzystać z Cloud Firestore i uwierzytelniania:

    Interfejs 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:

    Interfejs 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ć przesuwanie delegata aplikacji. Więcej informacji znajdziesz w instrukcjach interfejsu SwiftUI.

    Interfejs 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 używasz pakietu SDK Firebase dla Google Analytics, możesz uruchomić aplikację, aby wysłać do konsoli Firebase potwierdzenie instalacji Firebase.

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

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

Dostępne biblioteki

W tej sekcji wymienione są usługi Firebase obsługiwane na platformach Apple. Dowiedz się więcej o tych bibliotekach platformy Firebase Apple:

Usługa lub produkt Blok reklamowy Biblioteki SwiftPM Dodać statystyki?
AdMob pod 'Google-Mobile-Ads-SDK' Nie dotyczy
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
Sprawdzanie aplikacji pod 'FirebaseAppCheck' FirebaseAppCheck
Rozpowszechnianie aplikacji pod 'FirebaseAppDistribution' FirebaseAppDistribution
Uwierzytelnianie pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore. pod 'FirebaseFirestore' FirebaseFirestore
Pakiet SDK klienta Cloud Functions dla Firebase pod 'FirebaseFunctions' FirebaseFunctions
Komunikacja w chmurze pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage, pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Linki dynamiczne pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Wysyłanie wiadomości w aplikacji pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(wymagane)
Instalacje Firebase pod 'FirebaseInstallations' FirebaseInstallations
Interfejsy API modeli niestandardowych Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Monitorowanie wydajności pod 'FirebasePerformance' FirebasePerformance
Baza danych czasu rzeczywistego pod 'FirebaseDatabase' FirebaseDatabase
Zdalna konfiguracja pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI dla Firebase Nie dotyczy FirebaseVertexAI-Preview

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 bezpośrednio importując platformy.

CocoaPods

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

Platformy

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

  1. Pobierz plik ZIP SDK platformy. Rozmiar tego pliku wynosi ok. 200 MB, a jego pobieranie może trochę potrwać.

  2. Rozpakuj plik, a następnie zintegruj platformy, które chcesz umieścić w aplikacji.

    Instrukcje integracji znajdziesz w tych miejscach:

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

  3. Dodaj flagę łączącą -ObjC w elemencie Other Linker Settings w ustawieniach kompilacji celu.

Dalsze kroki

Więcej informacji o Firebase:

Dodaj usługi Firebase do aplikacji: