Wymagania wstępne
Zainstaluj następujące elementy:
- Xcode 14.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 11
- macOS 10.13
- tvOS 12
- WatchOS 6
- Twój projekt musi być kierowany na te wersje platformy lub nowsze:
Skonfiguruj fizyczne urządzenie Apple lub użyj symulatora, aby uruchomić swoją aplikację.
Oto wymagania wstępne dotyczące usługi Cloud Messaging na platformach Apple:
- Skonfiguruj fizyczne urządzenie Apple .
- Uzyskaj klucz Apple Push Notification Authentication Key dla swojego konta programisty Apple .
- Włącz powiadomienia push w Xcode w App > Capabilities .
- Zaloguj się do Firebase przy użyciu swojego konta Google.
Jeśli nie masz jeszcze projektu Xcode i chcesz tylko wypróbować produkt Firebase, możesz pobrać jedną z naszych próbek szybkiego startu .
Krok 1 : Utwórz projekt Firebase
Zanim dodasz Firebase do swojej aplikacji Apple, musisz utworzyć projekt Firebase, aby połączyć się z aplikacją. Odwiedź stronę Projekty Firebase, aby dowiedzieć się więcej o projektach Firebase.
Krok 2 : Zarejestruj swoją aplikację w Firebase
Aby używać Firebase w aplikacji Apple, musisz zarejestrować swoją aplikację w projekcie Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.
Przejdź do konsoli Firebase .
Na środku strony przeglądu projektu kliknij ikonę iOS+ , aby uruchomić proces konfiguracji.
Jeśli już dodałeś aplikację do swojego projektu Firebase, kliknij Dodaj aplikację , aby wyświetlić opcje platformy.
Wprowadź identyfikator pakietu swojej aplikacji w polu Identyfikator pakietu .
Identyfikator pakietu jednoznacznie identyfikuje aplikację w ekosystemie Apple.
Znajdź swój identyfikator pakietu: otwórz swój projekt w Xcode, wybierz aplikację najwyższego poziomu w nawigatorze projektu, a następnie wybierz kartę Ogólne .
Wartością pola Identyfikator pakietu jest identyfikator pakietu (na przykład
com.yourcompany.yourproject
).Pamiętaj, że w wartości identyfikatora pakietu rozróżniana jest wielkość liter i nie można jej zmienić w przypadku tej aplikacji Firebase po jej zarejestrowaniu w projekcie Firebase.
(Opcjonalnie) Wprowadź inne informacje o aplikacji: pseudonim aplikacji i identyfikator App Store .
Pseudonim aplikacji : wewnętrzny, wygodny identyfikator widoczny tylko dla Ciebie w konsoli Firebase
App Store ID : Używany przez Firebase Dynamic Links do przekierowywania użytkowników do Twojej strony App Store oraz przez Google Analytics do importowania zdarzeń konwersji do Google Ads . Jeśli Twoja aplikacja nie ma jeszcze identyfikatora App Store, możesz dodać go później w ustawieniach projektu .
Kliknij Zarejestruj aplikację .
Krok 3 : Dodaj plik konfiguracyjny Firebase
Kliknij Pobierz GoogleService-Info.plist , aby pobrać plik konfiguracyjny Firebase dla platform Apple (
GoogleService-Info.plist
).Plik konfiguracyjny Firebase zawiera unikalne, ale nietajne identyfikatory Twojego projektu. Aby dowiedzieć się więcej o tym pliku konfiguracyjnym, odwiedź stronę Zrozumienie projektów Firebase .
W dowolnym momencie możesz ponownie pobrać plik konfiguracyjny Firebase .
Upewnij się, że nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, takich jak
(2)
.
Przenieś plik konfiguracyjny do katalogu głównego projektu Xcode. Jeśli zostanie wyświetlony monit, wybierz opcję dodania pliku konfiguracyjnego do wszystkich celów.
Jeśli w projekcie masz 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 zestawy SDK Firebase do swojej aplikacji
Użyj Menedżera pakietów Swift, aby zainstalować i zarządzać zależnościami Firebase.
- W Xcode przy otwartym projekcie aplikacji przejdź do File > Add Packages .
- Po wyświetleniu monitu dodaj repozytorium Firebase Apple platforms SDK:
- Wybierz wersję zestawu SDK, której chcesz użyć.
Wybierz biblioteki Firebase, których chcesz użyć.
Jeśli Google Analytics jest włączone w Twoim projekcie Firebase, pamiętaj o dodaniu
FirebaseAnalytics
. W przypadku Analytics bez możliwości zbierania identyfikatorów IDFA zamiast tego dodajFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie zależności w tle.
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 korzystasz z przykładowego projektu szybkiego startu , zrobiliśmy to za Ciebie.
- Zaimportuj moduł
FirebaseCore
do swojegoUIApplicationDelegate
, a także wszelkie inne moduły Firebase, z których korzysta delegat aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Szybki
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Cel C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj udostępnioną instancję
FirebaseApp
w metodzie applicationapplication(_:didFinishLaunchingWithOptions:)
delegata aplikacji:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Szybki
// Use Firebase library to configure APIs FirebaseApp.configure()
Cel C
// Use Firebase library to configure APIs [FIRApp configure];
- Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury
App
za pośrednictwemUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
. Musisz także wyłączyć przełączanie delegatów aplikacji. Aby uzyskać więcej informacji, zobacz instrukcje 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 masz pakiet Firebase SDK dla Google Analytics, możesz uruchomić swoją aplikację, aby wysłać do konsoli Firebase potwierdzenie, ż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 platformami Apple i często zadawane pytania .
Dostępne biblioteki
Ta sekcja zawiera listę produktów Firebase obsługiwanych na platformach Apple. Dowiedz się więcej o tych bibliotekach platformy Apple Firebase:
Firebase Platformy Apple SDK Repozytorium GitHub
Usługa lub Produkt | Strąki | Biblioteki SwiftPM | Dodać Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | Nie dotyczy | |
Analityka | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Sprawdź aplikację | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Dystrybucja aplikacji | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Uwierzytelnianie | pod 'FirebaseAuth' | FirebaseAuth | |
Cloud Firestore | pod 'FirebaseFirestore' | FirebaseFirestore | |
Cloud Functions dla pakietu SDK klienta Firebase | pod 'FirebaseFunctions' | FirebaseFunctions | |
Wiadomości w chmurze | pod 'FirebaseMessaging' | FirebaseMessaging | |
Magazyn w chmurze | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Linki dynamiczne | 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 |
Integruj bez użycia Swift Package Manager
Jeśli nie chcesz używać Swift Package Manager, nadal możesz skorzystać z zestawów SDK Firebase, używając CocoaPods lub bezpośrednio importując frameworki.
KakaoPods
Dowiedz się więcej o integracji CocoaPods z naszego przewodnika .
Ramy
Oprócz obsługi platformy iOS, zip zawiera teraz pliki .xcframework
. Aby uzyskać szczegółowe informacje, zobacz plik README platformy Firebase firmy Apple w witrynie GitHub .
Pobierz zip pakietu SDK środowiska . Jest to plik o wielkości ~200 MB i jego pobranie może trochę potrwać.
Rozpakuj plik, a następnie zintegruj struktury, które chcesz uwzględnić w swojej aplikacji.
Instrukcje dotyczące integracji można znaleźć w jednym z następujących miejsc:
- W repozytorium Firebase iOS SDK GitHub .
- W pliku
README.md
w pobranej dystrybucji zip.
Aby uzyskać informacje dotyczące wersji frameworka lub zależności, zapoznaj się z plikiem
METADATA.md
w pobranej dystrybucji ZIP.Dodaj flagę linkera
-ObjC
wOther Linker Settings
w ustawieniach kompilacji celu.
Następne kroki
Dowiedz się więcej o Firebase:
Odwiedź stronę Projekty Firebase, aby dowiedzieć się więcej o projektach Firebase i sprawdzonych metodach dotyczących projektów.
Poznaj przykładowe aplikacje Firebase .
Zdobądź praktyczne doświadczenie z Firebase iOS Codelab .
Poznaj otwarty kod źródłowy w GitHub .
Przygotuj się do uruchomienia aplikacji:
- Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
- Monitoruj pulpit nawigacyjny Wykorzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
- Przejrzyj listę kontrolną uruchamiania Firebase .
Masz problemy z Firebase i projektem Apple? Odwiedź rozwiązywanie problemów z platformami Apple i często zadawane pytania .
Dodaj usługi Firebase do swojej aplikacji:
Uzyskaj wgląd w zachowania użytkowników dzięki Analytics .
Skonfiguruj uwierzytelnianie użytkownika za pomocą opcji Uwierzytelnianie .
Przechowuj dane, takie jak informacje o użytkownikach, za pomocą Cloud Firestore lub Realtime Database .
Przechowuj pliki, takie jak zdjęcia i filmy, dzięki Cloud Storage .
Wyzwalaj kod zaplecza, który działa w bezpiecznym środowisku dzięki Cloud Functions .
Wysyłaj powiadomienia za pomocą Cloud Messaging .
Dowiedz się, kiedy i dlaczego Twoja aplikacja ulega awarii dzięki Crashlytics .