Dodaj Firebase do swojego projektu Apple

Warunki wstępne

  • Zainstaluj następujące elementy:

    • Xcode 13.3.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 10
      • macOS 10.12
      • telewizor z systemem operacyjnym 12
      • zegarekOS 6
  • Skonfiguruj fizyczne urządzenie Apple lub użyj symulatora do uruchomienia aplikacji.

Jeśli nie masz jeszcze projektu Xcode i chcesz tylko 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 swojej aplikacji Apple, musisz utworzyć projekt Firebase, aby połączyć się z Twoją aplikacją. Odwiedź Zrozumienie projektów Firebase , aby dowiedzieć się więcej o projektach Firebase.

Krok 2 : Zarejestruj swoją aplikację w Firebase

Aby korzystać z Firebase w swojej 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ć przepływ pracy instalacji.

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

  3. Wpisz identyfikator pakietu swojej aplikacji w polu identyfikatora pakietu .

  4. (Opcjonalnie) Wpisz 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 uzyskać plik konfiguracyjny platform Apple Firebase ( GoogleService-Info.plist ).

  2. Przenieś plik konfiguracyjny do katalogu głównego projektu Xcode. Jeśli pojawi się monit, wybierz, aby dodać plik konfiguracyjny do wszystkich celów.

Jeśli masz w projekcie 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 pozycji Plik > Dodaj pakiety .
  2. Po wyświetleniu monitu dodaj repozytorium SDK platformy 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 włączono Google Analytics, 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 twoich zależności w tle.

Krok 5 : zainicjuj Firebase w swojej aplikacji

Ostatnim krokiem jest dodanie kodu inicjującego do aplikacji. Być może zrobiłeś to już 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 używane przez delegata aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:

    Szybki

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Cel C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Skonfiguruj współużytkowane wystąpienie FirebaseApp , zwykle w inicjatorze App lub w metodzie application(_:didFinishLaunchingWithOptions:) :

    Szybki

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

    Cel C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Jeśli masz pakiet Firebase SDK dla Google Analytics, możesz uruchomić swoją aplikację, aby przesłać do konsoli Firebase weryfikację pomyślnego zainstalowania Firebase.

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

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

Dostępne biblioteki

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

Usługa lub produkt Pody Biblioteki SwiftPM Dodać Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' Nie dotyczy
Analityka pod 'FirebaseAnalytics' FirebaseAnalytics
Sprawdzanie aplikacji pod 'FirebaseAppCheck' FirebaseAppCheck
Dystrybucja aplikacji pod 'FirebaseAppDistribution' FirebaseAppDistribution
Uwierzytelnianie pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Pakiet SDK Cloud Functions dla klienta Firebase pod 'FirebaseFunctions' FirebaseFunctions
Wiadomości w chmurze pod 'FirebaseMessaging' FirebaseMessaging
Magazyn w chmurze pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamiczne linki 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

Integracja bez użycia Swift Package Manager

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

CocoaPods

Dowiedz się więcej o integracji CocoaPods w naszym przewodniku .

Ramy

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

  1. Pobierz framework SDK zip . Jest to plik o rozmiarze ~200 MB, którego pobranie może zająć trochę czasu.

  2. Rozpakuj plik, a następnie przejrzyj plik README dla struktur, które chcesz uwzględnić w swojej aplikacji.

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

Następne kroki

Dowiedz się więcej o Firebase:

Dodaj usługi Firebase do swojej aplikacji: