Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Dodaj Firebase do swojego projektu na iOS

Warunki wstępne

  • Zainstaluj następujące elementy:

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

    • Twój projekt musi być kierowany na system iOS 10 lub nowszy.
  • Skonfiguruj fizyczne urządzenie iOS lub użyj symulatora iOS, aby uruchomić aplikację.

Jeżeli nie masz jeszcze projektu Xcode i po prostu chcą wypróbować Firebase produkt można pobrać jeden z naszych próbek QuickStart .

Krok 1: Tworzenie projektu Firebase

Zanim dodasz Firebase do swojej aplikacji na iOS, musisz utworzyć projekt Firebase, aby połączyć się z aplikacją na iOS. Wizyta Zrozum Firebase Projekty aby dowiedzieć się więcej o projektach Firebase.

Krok 2: zarejestruj swoją aplikację z Firebase

Gdy masz już projekt Firebase, możesz dodać do niego swoją aplikację na iOS.

Wizyta Zrozum Firebase Projects , aby dowiedzieć się więcej na temat najlepszych praktyk i rozważań na dodawanie aplikacji do projektu Firebase, w tym jak obsługiwać wiele wariantów budowy.

  1. Przejdź do konsoli Firebase .

  2. W środku strony głównej projektu kliknij ikonę iOS ( ), aby uruchomić przepływ pracy instalacji.

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

  3. Wpisz swój identyfikator pakietu aplikacji w iOS wiązek polu ID.

  4. (Opcjonalnie) Wprowadź inne informacje APL: App Store App nick i identyfikator.

  5. Kliknij Register aplikację.

Krok 3: Dodaj plik konfiguracyjny Firebase

  1. Kliknij Pobierz GoogleService-Info.plist aby uzyskać plik konfiguracyjny Firebase 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 wiązki w projekcie, należy powiązać każdy identyfikator pakietu z zarejestrowanej aplikacji w konsoli Firebase tak, że każda aplikacja może mieć własne GoogleService-Info.plist pliku.

Krok 4: Dodaj Firebase SDK do aplikacji

Zalecamy stosowanie CocoaPods instalacji bibliotek Firebase. Jednakże, jeśli nie chcesz używać CocoaPods można zintegrować ram SDK bezpośrednio lub używać Swift Package Manager zamiast.

Używasz jednej z próbek QuickStart ? W ramach projektu Xcode i Podfile (ze strąkami) są już obecne, ale będzie trzeba jeszcze dodać plik konfiguracyjny Firebase i zainstalować strąków.

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

    cd your-project-directory
    pod init
  2. Do pliku podfile dodaj bloki Firebase, których chcesz używać w swojej aplikacji.

    Można dodać dowolny z obsługiwanych produktów Firebase do swojej aplikacji na iOS.

    Analiza włączona

    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, identyfikatora reklamowego na poziomie urządzenia, w Apple użytkownika prywatności i danych użytkowania i App Tracking przejrzystości dokumentacji.

    Analytics nie jest włączone

    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. Zainstalować strąków, następnie otwórz .xcworkspace plik, aby zobaczyć projekt w Xcode:

    pod install
    open your-project.xcworkspace

Krok 5: Inicjalizacja 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 używasz przykładowy projekt quickstart , zostało to wykonane.

  1. Zaimportować moduł Firebase w 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 korzystasz z Firebase Analytics, możesz uruchomić swoją aplikację, aby przesłać do konsoli Firebase weryfikację pomyślnego zainstalowania Firebase.

Otóż ​​to! Można przejść od razu do kolejnych etapów .

Jeśli masz problemy z uzyskaniem konfiguracji, choć można znaleźć w rozwiązywaniu problemów z systemem iOS i nas .

Dostępne strąki

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

Usługa lub produkt Pody Dodać Analytics?
AdMob pod 'Google-Mobile-Ads-SDK'
Analityka pod 'Firebase/Analytics'
Sprawdzanie aplikacji pod 'Firebase/AppCheck'
Dystrybucja aplikacji pod 'Firebase/AppDistribution'
Uwierzytelnianie pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
Pakiet SDK Cloud Functions dla klienta Firebase pod 'Firebase/Functions'
Wiadomości 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'

Zintegruj bez CocoaPods

Jeśli nie chcesz używać Cocoapods, nadal możesz korzystać z pakietów SDK Firebase, 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 można znaleźć na Firebase iOS SDK Readme na GitHub .

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

  2. Rozpakuj plik, a następnie przejrzeć README dla Konstrukcje, które chcesz umieścić w swojej aplikacji.

  3. Dodaj ObjC linker flagi w swoich Other Linker Settings w ustawieniach budować swój docelowego.

Menedżer pakietów Swift

Dowiedz się więcej o integracji Swift Package Manager w naszym przewodniku .

Następne kroki

Dowiedz się więcej o Firebase:

Dodaj usługi Firebase do swojej aplikacji: