Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Dodaj Firebase do swojego projektu na iOS

Wymagania wstępne

  • Zainstaluj następujące elementy:

    • Xcode 12.2 lub nowszy
    • CocoaPods 1.10.0 lub nowsza
  • Upewnij się, że Twój projekt spełnia te wymagania:

    • Twój projekt musi być przeznaczony dla systemu iOS 10 lub nowszego.
  • Skonfiguruj fizyczne urządzenie iOS lub użyj symulatora iOS, 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 dodasz Firebase do swojej aplikacji na iOS, musisz utworzyć projekt Firebase, aby połączyć się z aplikacją na iOS. Odwiedź artykuł Omówienie projektów Firebase, aby dowiedzieć się więcej o projektach Firebase.

Krok 2 : zarejestruj swoją aplikację w Firebase

Po utworzeniu projektu Firebase możesz dodać do niego swoją aplikację na iOS.

Odwiedź artykuł Omówienie projektów Firebase, aby dowiedzieć się więcej o sprawdzonych metodach i kwestiach związanych z dodawaniem aplikacji do projektu Firebase, w tym o tym, jak obsługiwać wiele wariantów kompilacji.

  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 ID pakietu na iOS .

  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 GoogleService-Info.plist iOS ( 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 wiele identyfikatorów pakietów w swoim projekcie, musisz powiązać każdy identyfikator pakietu z zarejestrowaną aplikacją w konsoli GoogleService-Info.plist aby każda aplikacja mogła mieć własny plik GoogleService-Info.plist .

Krok 4. Dodaj pakiety SDK Firebase do swojej aplikacji

Zalecamy użycie CocoaPods do zainstalowania bibliotek Firebase . Jeśli jednak wolisz nie używać CocoaPods, możesz bezpośrednio zintegrować struktury SDK lub zamiast tego użyć Swift Package Manager .

Czy używasz jednego z przykładów szybkiego startu ? Projekt Xcode i Podfile (z podami) są już obecne, ale nadal musisz dodać plik konfiguracyjny Firebase i zainstalować pody.

  1. Utwórz plik Podfile, jeśli jeszcze go nie masz:

    cd your-project-directory
    pod init
  2. Do swojego pliku Podfile dodaj pody Firebase, których chcesz użyć w swojej aplikacji.

    Do aplikacji na iOS możesz dodać dowolne obsługiwane produkty Firebase .

    Analytics włączone

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

    Dowiedz się więcej o IDFA, identyfikatorze reklamowym na poziomie urządzenia, w dokumentacji firmy Apple dotyczącej prywatności i wykorzystywania danych oraz przejrzystości śledzenia aplikacji .

    Analytics nie jest włączony

    platform :ios, ‘10.0’
    # Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
  3. Zainstaluj pody, a następnie otwórz plik .xcworkspace , aby wyświetlić projekt w Xcode:

    pod install
    open your-project.xcworkspace

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 używasz przykładowego projektu Szybki start , zostało to zrobione za Ciebie.

  1. Zaimportuj moduł UIApplicationDelegate :

    Szybki

    import Firebase

    Cel C

    @import Firebase;
  2. Skonfiguruj FirebaseApp wspólne wystąpienie, zazwyczaj w swojej aplikacji application:didFinishLaunchingWithOptions: metodę:

    Szybki

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

    Cel C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Jeśli uwzględnisz Firebase Analytics, możesz uruchomić aplikację, aby wysłać weryfikację do konsoli Firebase, ż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 systemem iOS i często zadawane pytania .

Dostępne strąki

W tej sekcji wymieniono produkty Firebase obsługiwane na iOS i ich pody. Dowiedz się więcej o tych bibliotekach Firebase na iOS:

  • Dokumentacja referencyjna ( Swift | Obj-C )

  • Repozytorium GitHub Firebase iOS SDK

Usługa lub produkt Strąki Dodać Analytics?
AdMob pod 'Google-Mobile-Ads-SDK'
Analityka pod 'Firebase/Analytics'
Dystrybucja aplikacji pod 'Firebase/AppDistribution'
Poświadczenie pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Cloud Functions for Firebase Client SDK pod 'Firebase/Functions'
Komunikacja w chmurze pod 'Firebase/Messaging'
Magazyn w chmurze pod 'Firebase/Storage'
Crashlytics pod 'Firebase/Crashlytics'
Dynamiczne linki pod 'Firebase/DynamicLinks'
Wiadomości w aplikacji pod 'Firebase/InAppMessaging'
(wymagany)
Instalacje Firebase pod 'Firebase/Installations'
Interfejsy API modelu niestandardowego Firebase ML pod 'Firebase/MLModelDownloader'
Monitoring wydajności pod 'Firebase/Performance'
Baza danych czasu rzeczywistego pod 'Firebase/Database'
Zdalna konfiguracja pod 'Firebase/RemoteConfig'

Integracja bez CocoaPods

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

Ramy

Oprócz obsługi platformy iOS, zip zawiera teraz pliki .xcframework, które dodają obsługę Catalyst opartą na społeczności. Szczegółowe informacje znajdziesz w pliku README Firebase iOS SDK w GitHub .

  1. Pobierz plik ZIP z zestawem SDK platformy . To jest 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 dołączyć do aplikacji.

  3. Dodaj ObjC konsolidatora ObjC w Other Linker Settings konsolidatora w ustawieniach kompilacji celu.

Swift Package Manager

Dowiedz się więcej o integracji Swift Package Manager z naszego przewodnika .

Następne kroki

Dowiedz się więcej o Firebase:

Dodaj usługi Firebase do swojej aplikacji: