Dodaj Firebase do projektu Apple

Wymagania wstępne

  • Zainstaluj następujące elementy:

    • Xcode 14.1 lub nowsza wersja

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

    • Twój projekt musi być kierowany na te wersje platformy lub nowsze:
      • 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 tylko wypróbować Firebase możesz pobrać nasze krótkie wprowadzenia.

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do swojej aplikacji Apple, musisz utworzyć taką aplikację projekt, aby połączyć się z aplikacją. Odwiedź Więcej informacji o projektach Firebase Projekty Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby używać Firebase w swojej aplikacji Apple, musisz ją zarejestrować w projekt Firebase. Rejestracja aplikacji często nazywa się „dodawaniem” aplikacji na w projektach AI.

  1. Otwórz konsolę Firebase.

  2. Na środku strony przeglądu projektu kliknij ikonę iOS+. aby rozpocząć proces konfiguracji.

    Jeśli masz już aplikację w projekcie 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: Nazwa aplikacji i identyfikator App Store.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

  1. Kliknij Download GoogleService-Info.plist, aby otrzymać Firebase Apple plik konfiguracji platform (GoogleService-Info.plist).

  2. Przenieś plik konfiguracji do katalogu głównego projektu Xcode. Jeśli pojawi się taka prośba, wybierz, aby dodać plik konfiguracyjny do wszystkich środowisk docelowych.

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

Krok 4. Dodaj pakiety SDK Firebase do aplikacji

Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.

  1. W Xcode po otwarciu projektu aplikacji przejdź do File > Dodaj pakiety.
  2. Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK 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żywać.

    Jeśli w projekcie Firebase masz włączoną usługę Google Analytics, upewnij się, aby dodać FirebaseAnalytics. W przypadku Analytics bez zbierania danych IDFA , dodaj w zamian FirebaseAnalyticsWithoutAdId.

Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub zależności w tle.

Krok 5. Zainicjuj Firebase w swojej aplikacji

Ostatnim krokiem jest dodanie kodu inicjującego do aplikacji. Być może masz Ten proces został już przez Ciebie wykonany w ramach dodawania Firebase do Twojej aplikacji. Jeśli używasz tagu quickstart sample project, to już za Ciebie.

  1. Zaimportuj moduł FirebaseCore do UIApplicationDelegate, jak i wszelkie inne Moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć Cloud Firestore i Uwierzytelniania:

    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 FirebaseApp współdzielonej instancji w uprawnieniach przedstawiciela aplikacji Metoda application(_:didFinishLaunchingWithOptions:):

    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ć i dołączyć przedstawiciela aplikacji. do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Dla: 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 masz pakiet SDK Firebase dla Google Analytics, możesz aplikacji, aby wysłać weryfikację do konsoli Firebase Firebase został zainstalowany.

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

Jeśli jednak masz problemy z konfiguracją, odwiedź Rozwiązywanie problemów z platformami Apple Najczęstsze pytania.

Dostępne biblioteki

W tej sekcji znajdziesz usługi Firebase obsługiwane na platformach Apple. Ucz się o tych bibliotekach platformy Firebase Apple:

Usługa lub produkt Pody Biblioteki SwiftPM Dodać Analytics?
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 modelu niestandardowego 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

Przeprowadź integrację bez korzystania z menedżera pakietów Swift

Jeśli nie chcesz korzystać z menedżera pakietów Swift, możesz skorzystać z pakiety SDK Firebase przy użyciu CocoaPods lub bezpośrednio importując platformy.

CocoaPods

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

Platformy

Oprócz obsługi platformy iOS plik ZIP zawiera teraz .xcframework . Więcej informacji znajdziesz w artykule Firebase Platformy Apple z pakietem SDK README w obszarze README GitHub ,

  1. Pobierz plik ZIP pakietu SDK platformy Firebase. Rozmiar pliku to ok. 200 MB. Może to potrwać trochę czasu do pobrania.

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

    Instrukcje integracji można znaleźć w jednym z następujących miejsc:

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

  3. Dodaj parametr -ObjC flaga łącząca w Other Linker Settings w ustawieniach kompilacji celu.

Dalsze kroki

Więcej informacji o Firebase:

Dodaj usługi Firebase do aplikacji: