Catch up on highlights from Firebase at Google I/O 2023. Learn more

Dodaj Firebase do swojego projektu Apple

Wymagania wstępne

  • Zainstaluj następujące elementy:

    • Xcode 14.1 lub nowszy
  • Upewnij się, że 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ć swoją aplikację.

Jeśli nie masz jeszcze projektu Xcode i chcesz tylko wypróbować produkt Firebase, możesz pobrać jedną z naszych próbek szybkiego startu .

Krok 1 : Utwórz projekt Firebase

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

Krok 2 : Zarejestruj swoją aplikację w Firebase

Aby używać Firebase w aplikacji Apple, musisz zarejestrować swoją aplikację w projekcie Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.

  1. Przejdź do konsoli Firebase .

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

    Jeśli już dodałeś aplikację do swojego projektu Firebase, kliknij Dodaj aplikację , aby wyświetlić opcje platformy.

  3. Wprowadź identyfikator pakietu swojej aplikacji w polu Identyfikator pakietu .

  4. (Opcjonalnie) Wprowadź inne informacje o aplikacji: pseudonim aplikacji i identyfikator App Store .

  5. Kliknij Zarejestruj aplikację .

Krok 3 : Dodaj plik konfiguracyjny Firebase

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

  2. Przenieś plik konfiguracyjny do katalogu głównego projektu Xcode. Jeśli zostanie wyświetlony monit, wybierz opcję dodania pliku konfiguracyjnego do wszystkich celów.

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

Krok 4 : dodaj zestawy SDK Firebase do swojej aplikacji

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

  1. W Xcode przy otwartym projekcie aplikacji przejdź do File > Add Packages .
  2. Po wyświetleniu monitu dodaj repozytorium Firebase Apple platforms SDK:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Wybierz wersję zestawu SDK, której chcesz użyć.
  5. Wybierz biblioteki Firebase, których chcesz użyć.

    Jeśli Google Analytics jest włączone w Twoim projekcie Firebase, pamiętaj o dodaniu FirebaseAnalytics . W przypadku Analytics bez możliwości zbierania identyfikatorów IDFA zamiast tego dodaj FirebaseAnalyticsWithoutAdId .

Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie zależności w tle.

Krok 5 : Zainicjuj Firebase w swojej aplikacji

Ostatnim krokiem jest dodanie kodu inicjującego do aplikacji. Być może już to zrobiłeś w ramach dodawania Firebase do swojej aplikacji. Jeśli korzystasz z przykładowego projektu szybkiego startu , zrobiliśmy to za Ciebie.

  1. Zaimportuj moduł FirebaseCore do swojego UIApplicationDelegate , a także wszelkie inne moduły Firebase, z których korzysta delegat aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Szybki

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Cel C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Skonfiguruj udostępnioną instancję FirebaseApp w metodzie application application(_:didFinishLaunchingWithOptions:) delegata aplikacji:

    SwiftUI

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Szybki

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Cel 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 pośrednictwem UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor . Musisz także wyłączyć przełączanie delegatów aplikacji. Aby uzyskać więcej informacji, zobacz instrukcje 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 Firebase SDK dla Google Analytics, możesz uruchomić swoją aplikację, aby wysłać do konsoli Firebase potwierdzenie, że pomyślnie zainstalowałeś Firebase.

Otóż ​​to! Możesz przejść od razu do następnych kroków .

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę Rozwiązywanie problemów z platformami Apple i często zadawane pytania .

Dostępne biblioteki

Ta sekcja zawiera listę produktów Firebase obsługiwanych na platformach Apple. Dowiedz się więcej o tych bibliotekach platformy Apple Firebase:

Usługa lub Produkt Strąki Biblioteki SwiftPM Dodać Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' Nie dotyczy
Analityka pod 'FirebaseAnalytics' FirebaseAnalytics
Sprawdź aplikację pod 'FirebaseAppCheck' FirebaseAppCheck
Dystrybucja aplikacji pod 'FirebaseAppDistribution' FirebaseAppDistribution
Uwierzytelnianie pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions dla pakietu SDK klienta Firebase pod 'FirebaseFunctions' FirebaseFunctions
Wiadomości w chmurze pod 'FirebaseMessaging' FirebaseMessaging
Magazyn w chmurze pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Linki dynamiczne pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Wiadomości w aplikacji pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(wymagany)
Instalacje Firebase pod 'FirebaseInstallations' FirebaseInstallations
Interfejsy API modelu niestandardowego Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Monitoring wydajności pod 'FirebasePerformance' FirebasePerformance
Baza danych czasu rzeczywistego pod 'FirebaseDatabase' FirebaseDatabase
Zdalna konfiguracja pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Integruj bez użycia Swift Package Manager

Jeśli nie chcesz używać Swift Package Manager, nadal możesz skorzystać z zestawów SDK Firebase, używając CocoaPods lub bezpośrednio importując frameworki.

KakaoPods

Dowiedz się więcej o integracji CocoaPods z naszego przewodnika .

Ramy

Oprócz obsługi platformy iOS, zip zawiera teraz pliki .xcframework . Aby uzyskać szczegółowe informacje, zobacz plik README platformy Firebase firmy Apple w witrynie GitHub .

  1. Pobierz zip pakietu SDK środowiska . Jest to plik o wielkości ~200 MB i jego pobranie może trochę potrwać.

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

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

    Aby uzyskać informacje dotyczące wersji frameworka lub zależności, zapoznaj się z plikiem METADATA.md w pobranej dystrybucji ZIP.

  3. Dodaj flagę linkera -ObjC w Other Linker Settings w ustawieniach kompilacji celu.

Następne kroki

Dowiedz się więcej o Firebase:

Dodaj usługi Firebase do swojej aplikacji: