Dodaj Firebase do swojego projektu Apple

Warunki wstępne

  • Zainstaluj następujące elementy:

    • Xcode 12.5 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ż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 Apple, musisz utworzyć projekt Firebase, aby połączyć się z Twoją aplikacją. Wizyta Zrozum Firebase Projekty aby dowiedzieć się więcej o projektach Firebase.

Krok 2: zarejestruj swoją aplikację z Firebase

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

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 polu wiązki 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 uzyskanie złożyć platform Firebase jabłko config ( 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

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

  1. W Xcode, z projektem otwartej aplikacji, należy przejść do menu Plik> Swift Pakiety> Dodaj Package zależność.
  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 Google Analytics jest włączona w projekcie Firebase, upewnij się, aby dodać FirebaseAnalytics . Dla Analytics bez możliwości zbierania IDFA, dodać FirebaseAnalyticsWithoutAdId zamiast.

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

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 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żna przejść od razu do kolejnych etapów .

Jeśli masz problemy z uzyskaniem konfiguracji, choć odwiedzić platformy firmy Apple Rozwiązywanie problemów i FAQ .

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 'Firebase/Analytics' FirebaseAnalytics
Sprawdzanie aplikacji pod 'Firebase/AppCheck' FirebaseAppCheck
Dystrybucja aplikacji pod 'Firebase/AppDistribution' FirebaseAppDistribution
Uwierzytelnianie pod 'Firebase/Auth' FirebaseAuth
Cloud Firestore pod 'Firebase/Firestore' FirebaseFirestore
Pakiet SDK Cloud Functions dla klienta Firebase pod 'Firebase/Functions' FirebaseFunctions
Wiadomości w chmurze pod 'Firebase/Messaging' FirebaseMessaging
Magazyn w chmurze pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
Dynamiczne linki pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
Wiadomości w aplikacji pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(wymagany)
Instalacje Firebase pod 'Firebase/Installations' FirebaseInstallations
Interfejsy API modelu niestandardowego Firebase ML pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
Monitoring wydajności pod 'Firebase/Performance' FirebasePerformance
Baza danych czasu rzeczywistego pod 'Firebase/Database' FirebaseDatabase
Zdalna konfiguracja pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

Integruj bez menedżera zależności

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

Ramy

Oprócz obsługi platformy iOS, zip zawiera teraz .xcframework plików. Szczegółowe informacje znajdują się platformy Firebase firmy Apple 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 ram, które chcesz umieścić w swojej aplikacji.

  3. Dodaj -ObjC flagę łącznikowej w swoich Other Linker Settings w ustawieniach budować swój docelowego.

CocoaPods

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

Następne kroki

Dowiedz się więcej o Firebase:

Dodaj usługi Firebase do swojej aplikacji: