Dodaj Firebase do swojego projektu Apple

Warunki wstępne

  • Zainstaluj następujące elementy:

    • Xcode 14.1 lub nowszy
  • Upewnij się, że Twój projekt spełnia następujące wymagania:

    • Twój projekt musi być przeznaczony dla tych wersji platform lub nowszych:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • zegarekOS 6
  • 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ć produkt Firebase, możesz pobrać jeden z naszych przykładów szybkiego startu .

Krok 1 : Utwórz projekt Firebase

Zanim będziesz mógł dodać Firebase do swojej aplikacji Apple, musisz utworzyć projekt Firebase, aby połączyć się z Twoją aplikacją. Odwiedź stronę Poznaj 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ć 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 dodałeś już aplikację do projektu Firebase, kliknij Dodaj aplikację , aby wyświetlić opcje platformy.

  3. Wpisz identyfikator pakietu aplikacji w polu identyfikatora pakietu .

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

  5. Kliknij opcję Zarejestruj aplikację .

Krok 3 : Dodaj plik konfiguracyjny Firebase

  1. Kliknij opcję Pobierz GoogleService-Info.plist , aby uzyskać plik konfiguracyjny platform Firebase 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 obiektów docelowych.

Jeśli w swoim 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 pakiety SDK Firebase do swojej aplikacji

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

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

    Jeśli w Twoim projekcie Firebase jest włączona usługa Google Analytics, pamiętaj o dodaniu FirebaseAnalytics . W przypadku Analytics bez możliwości zbierania identyfikatorów IDFA dodaj zamiast tego 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 , zostało to zrobione za Ciebie.

  1. Zaimportuj moduł FirebaseCore do swojego UIApplicationDelegate , a także wszelkie inne moduły Firebase, których używa 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 aplikacji delegata application(_:didFinishLaunchingWithOptions:) metoda:

    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, zapoznaj się z instrukcjami 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 weryfikację, czy pomyślnie zainstalowałeś Firebase.

Otóż ​​to! Możesz przejść do kolejnych kroków .

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

Dostępne biblioteki

W tej sekcji wymieniono produkty Firebase obsługiwane na platformach Apple. Dowiedz się więcej o bibliotekach platformy Firebase Apple:

Usługa lub Produkt Strąki Biblioteki SwiftPM Dodać analitykę?
AdMob pod 'Google-Mobile-Ads-SDK' Nie dotyczy
Analityka pod 'FirebaseAnalytics' FirebaseAnalytics
Kontrola aplikacji pod 'FirebaseAppCheck' FirebaseAppCheck
Dystrybucja aplikacji pod 'FirebaseAppDistribution' FirebaseAppDistribution
Uwierzytelnianie pod 'FirebaseAuth' FirebaseAuth
Chmura Firestore pod 'FirebaseFirestore' FirebaseFirestore
Funkcje chmury 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 Menedżera pakietów Swift

Jeśli nie chcesz korzystać z Menedżera pakietów Swift, nadal możesz skorzystać z zestawów SDK Firebase, używając CocoaPods lub bezpośrednio importując struktury.

CocoaPods

Więcej o integracji CocoaPods dowiesz się z naszego poradnika .

Ramy

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

  1. Pobierz framework SDK zip . Jest to plik o wielkości około 200 MB, więc pobranie może zająć trochę czasu.

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

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

    Informacje dotyczące wersji frameworka lub zależności można znaleźć w pliku METADATA.md w pobranej dystrybucji zip.

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

Następne kroki

Dowiedz się więcej o Firebase:

Dodaj usługi Firebase do swojej aplikacji: