Wymagania wstępne
Zainstaluj te elementy:
- Xcode 15.2 lub nowsza wersja
Upewnij się, że Twój projekt spełnia te wymagania:
- Twój projekt musi być kierowany na te wersje platform lub nowsze:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- Twój projekt musi być kierowany na te wersje platform lub nowsze:
Skonfiguruj fizyczne urządzenie Apple lub uruchom aplikację za pomocą symulatora.
- Zaloguj się w Firebase za pomocą konta Google.
Jeśli nie masz jeszcze projektu Xcode i chcesz wypróbować produkt Firebase, możesz pobrać jeden z naszych przykładowych projektów.
Krok 1. Utwórz projekt Firebase
Zanim dodasz Firebase do aplikacji Apple, musisz utworzyć projekt Firebase, aby połączyć go z aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Informacje o projektach Firebase.
Krok 2. Zarejestruj aplikację w Firebase
Aby korzystać z Firebase w aplikacji na urządzenia Apple, musisz ją zarejestrować w projekcie Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.
Otwórz konsolę Firebase.
W centrum strony „Opis” projektu kliknij ikonę iOS+, aby uruchomić proces konfiguracji.
Jeśli aplikacja została już dodana do projektu Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy.
W polu Identyfikator pakietu wpisz identyfikator pakietu aplikacji.
(Opcjonalnie) Wpisz inne informacje o aplikacji: nazwę skrótową aplikacji i identyfikator App Store.
Kliknij Zarejestruj aplikację.
Krok 3. Dodaj plik konfiguracji Firebase
Kliknij Pobierz plik GoogleService-Info.plist, aby pobrać plik konfiguracji Firebase dla platform Apple (
GoogleService-Info.plist
).Przenieś plik konfiguracji do katalogu głównego projektu Xcode. Jeśli pojawi się taka prośba, wybierz opcję dodania pliku konfiguracyjnego do wszystkich miejsc docelowych.
Jeśli w projekcie masz wiele identyfikatorów pakietów, musisz powiązać każdy z nich z zarejestrowaną aplikacją w konsoli Firebase, aby każda aplikacja miała własny plik GoogleService-Info.plist
.
Krok 4. Dodaj do aplikacji pakiety SDK Firebase
Do instalacji zależności Firebase i zarządzania nimi możesz używać menedżera pakietów Swift.
- Po otwarciu projektu aplikacji w Xcode wybierz Plik > Dodaj pakiety.
- Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
- Wybierz wersję pakietu SDK, której chcesz używać.
Wybierz biblioteki Firebase, których chcesz używać.
Jeśli w projekcie Firebase włączona jest usługa Google Analytics, pamiętaj, aby dodać
FirebaseAnalytics
. W przypadku Analytics bez funkcji zbierania danych IDFA dodaj zamiast tegoFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.
Krok 5. Inicjuj Firebase w aplikacji
Ostatnim krokiem jest dodanie kodu inicjalizacji do aplikacji. Być może zrobiono to już w ramach dodawania Firebase do aplikacji. Jeśli używasz próbnego projektu Szybki start, ta czynność została już wykonana.
- Zaimportuj moduł
FirebaseCore
w plikuUIApplicationDelegate
oraz wszystkie inne moduły Firebase, których używa delegowany obiekt aplikacji. Aby na przykład użyć właściwości Cloud Firestore i Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj współdzieloną instancję
FirebaseApp
w metodzieapplication(_:didFinishLaunchingWithOptions:)
w delegacie aplikacji:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Jeśli używasz SwiftUI, musisz utworzyć obiekt delegujący aplikacji i dołączyć go do struktury
App
za pomocą funkcjiUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
. Musisz też wyłączyć swizlowanie zastępników aplikacji. Więcej informacji znajdziesz w instrukcjach SwiftUI.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Jeśli dołączysz pakiet SDK Firebase dla Google Analytics, możesz uruchomić aplikację, aby wysłać do konsoli Firebase potwierdzenie, że Firebase został zainstalowany.
To wszystko. Możesz przejść do sekcji Następne kroki.
Jeśli jednak masz problemy z konfiguracją, zapoznaj się z informacjami o rozwiązywaniu problemów z urządzeniami Apple i najczęściej zadawanymi pytaniami.
Dostępne biblioteki
W tej sekcji znajdziesz listę usług Firebase obsługiwanych na platformach Apple. Dowiedz się więcej o tych bibliotekach Firebase na platformę Apple:
Dokumentacja (Swift | Objective-C)
Pakiet SDK Firebase na platformy Apple w repozytorium GitHub
Usługa lub produkt | Podstacje | SwiftPM Libraries | Google Analytics.">Dodaj Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
Nie dotyczy | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(wymagane) |
Firebase instalacji | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML Interfejsy API modeli niestandardowych | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
Integracja bez użycia menedżera pakietów Swift
Jeśli nie chcesz używać menedżera pakietów Swift, nadal możesz korzystać z pakietów SDK Firebase, używając CocoaPods lub importując frameworky bezpośrednio.
CocoaPods
Więcej informacji o integracji z CocoaPods znajdziesz w tym przewodniku.
Platformy
Oprócz obsługi platformy iOS plik ZIP zawiera teraz pliki .xcframework
. Szczegółowe informacje znajdziesz w README pakietu SDK Firebase na platformy Apple na GitHub.
Pobierz pakiet SDK platformy w formacie ZIP. Plik ma rozmiar około 200 MB i jego pobranie może trochę potrwać.
Rozpakuj plik, a potem zintegruj frameworki, które chcesz uwzględnić w aplikacji.
Instrukcje integracji znajdziesz w jednym z tych miejsc:
- W repozytorium GitHub pakietu SDK Firebase na iOS.
- W pliku
README.md
w pobranej dystrybucji ZIP.
Informacje o wersjach lub zależnościach frameworka znajdziesz w pliku
METADATA.md
w pobieranym pliku ZIP.Dodaj flagę linkera
-ObjC
w ustawieniach kompilacji docelowego w plikuOther Linker Settings
.
Dalsze kroki
Więcej informacji o Firebase:
Więcej informacji o projektach Firebase i sprawdzonych metodach ich tworzenia znajdziesz w artykule [EN] Understanding Firebase Projects.
Zapoznaj się z przykładowymi aplikacjami Firebase.
Zdobądź praktyczne doświadczenie w korzystaniu z Firebase iOS Codelab.
Zapoznaj się z kodem open source na GitHubie.
Przygotuj się do uruchomienia aplikacji:
- W konsoli Google Cloud skonfiguruj alerty dotyczące budżetu dla projektu.
- Aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase, monitoruj panel Dane i rozliczenia w konsoli Firebase.
- Przejrzyj listę kontrolną przed wdrożeniem Firebase.
Masz problemy z Firebase i projektem Apple? Zapoznaj się z najczęstszymi pytaniami dotyczącymi platform Apple i sposobów rozwiązywania problemów z nimi związanych.
Aby dodać usługi Firebase do aplikacji:
Uzyskaj statystyki na temat zachowań użytkowników za pomocą Analytics.
Skonfiguruj uwierzytelnianie użytkowników za pomocą Authentication.
Przechowuj dane, takie jak informacje o użytkownikach, za pomocą funkcji Cloud Firestore lub Realtime Database.
Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage.
Aktywuj kod backendu, który działa w bezpiecznym środowisku za pomocą Cloud Functions.
Wysyłanie powiadomień za pomocą Cloud Messaging.
Dowiedz się, kiedy i dlaczego aplikacja się zawiesza, korzystając z Crashlytics.