Warunki wstępne
Zainstaluj następujące elementy:
- Xcode 13.3.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 10
- macOS 10.12
- telewizor z systemem operacyjnym 12
- zegarekOS 6
- Twój projekt musi być kierowany na te wersje platformy lub nowsze:
Skonfiguruj fizyczne urządzenie Apple lub użyj symulatora do uruchomienia aplikacji.
Oto wymagania wstępne dotyczące Cloud Messaging na platformach Apple:
- Skonfiguruj fizyczne urządzenie Apple .
- Uzyskaj klucz uwierzytelniania Apple Push Notification dla swojego konta Apple Developer .
- Włącz powiadomienia push w Xcode w menu 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ć jeden z naszych przykładów szybkiego startu .
Krok 1 : utwórz projekt Firebase
Zanim dodasz Firebase do swojej aplikacji Apple, musisz utworzyć projekt Firebase, aby połączyć się z Twoją aplikacją. Odwiedź Zrozumienie projektów Firebase , aby dowiedzieć się więcej o projektach Firebase.
Krok 2 : Zarejestruj swoją aplikację w Firebase
Aby korzystać z Firebase w swojej 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ć przepływ pracy instalacji.
Jeśli dodałeś już aplikację do projektu Firebase, kliknij Dodaj aplikację , aby wyświetlić opcje platformy.
Wpisz identyfikator pakietu swojej aplikacji w polu identyfikatora 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 projektów, 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ć dla tej aplikacji Firebase po jej zarejestrowaniu w projekcie Firebase.
(Opcjonalnie) Wpisz inne informacje o aplikacji: pseudonim aplikacji i identyfikator App Store .
Pseudonim aplikacji : wewnętrzny, wygodny identyfikator, który jest widoczny tylko dla Ciebie w konsoli Firebase
App Store ID : używany przez Firebase Dynamic Links do przekierowywania użytkowników na Twoją stronę 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 uzyskać plik konfiguracyjny platform Apple Firebase (
GoogleService-Info.plist
).Plik konfiguracyjny Firebase zawiera unikalne, ale nie tajne 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 pojawi się monit, wybierz, aby dodać plik konfiguracyjny do wszystkich celów.
Jeśli masz w projekcie 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 pakiety SDK Firebase do swojej aplikacji
Użyj Menedżera pakietów Swift, aby zainstalować zależności Firebase i zarządzać nimi.
- W Xcode przy otwartym projekcie aplikacji przejdź do pozycji Plik > Dodaj pakiety .
- Po wyświetleniu monitu dodaj repozytorium SDK platformy Firebase Apple:
- Wybierz wersję pakietu SDK, której chcesz użyć.
Wybierz biblioteki Firebase, których chcesz użyć.
Jeśli w Twoim projekcie Firebase włączono Google Analytics, 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 twoich zależności w tle.
Krok 5 : zainicjuj 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 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 używane przez delegata aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:Szybki
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Cel C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj współużytkowane wystąpienie
FirebaseApp
, zwykle w inicjatorzeApp
lub w metodzieapplication(_:didFinishLaunchingWithOptions:)
:Szybki
// Use Firebase library to configure APIs FirebaseApp.configure()
Cel C
// Use Firebase library to configure APIs [FIRApp configure];
- 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żesz przejść do następnych kroków .
Jeśli jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów z platformami Apple i często zadawane pytania .
Dostępne biblioteki
W tej sekcji wymieniono produkty Firebase obsługiwane na platformach Apple. Dowiedz się więcej o tych bibliotekach platformy Firebase Apple:
Platforma Firebase Apple SDK repozytorium GitHub
Usługa lub produkt | Pody | Biblioteki SwiftPM | Dodać Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | Nie dotyczy | |
Analityka | pod 'FirebaseAnalytics' | FirebaseAnalytics | |
Sprawdzanie aplikacji | pod 'FirebaseAppCheck' | FirebaseAppCheck | |
Dystrybucja aplikacji | pod 'FirebaseAppDistribution' | FirebaseAppDistribution | |
Uwierzytelnianie | pod 'FirebaseAuth' | FirebaseAuth | |
Cloud Firestore | pod 'FirebaseFirestore' | FirebaseFirestore | |
Pakiet SDK Cloud Functions dla klienta Firebase | pod 'FirebaseFunctions' | FirebaseFunctions | |
Wiadomości w chmurze | pod 'FirebaseMessaging' | FirebaseMessaging | |
Magazyn w chmurze | pod 'FirebaseStorage' | FirebaseStorage | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
Dynamiczne linki | 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 |
Integracja bez użycia Swift Package Manager
Jeśli nie chcesz korzystać z Menedżera pakietów Swift, nadal możesz korzystać z pakietów SDK Firebase, używając CocoaPods lub bezpośrednio importując frameworki.
CocoaPods
Dowiedz się więcej o integracji CocoaPods w naszym przewodniku .
Ramy
Oprócz obsługi platformy iOS, zip zawiera teraz pliki .xcframework
. Aby uzyskać szczegółowe informacje, zobacz plik README pakietu SDK platformy Firebase Apple w witrynie GitHub .
Pobierz framework SDK zip . Jest to plik o rozmiarze ~200 MB, którego pobranie może zająć trochę czasu.
Rozpakuj plik, a następnie przejrzyj plik
README
dla struktur, które chcesz uwzględnić w swojej aplikacji.Dodaj flagę konsolidatora
-ObjC
wOther Linker Settings
konsolidatora w ustawieniach kompilacji obiektu docelowego.
Następne kroki
Dowiedz się więcej o Firebase:
Odwiedź stronę Omówienie projektów 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 w Firebase iOS Codelab .
Poznaj kod open source w serwisie GitHub .
Przygotuj się do uruchomienia aplikacji:
- Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
- Monitoruj panel użycia i rozliczeń w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
- Przejrzyj listę kontrolną uruchamiania Firebase .
Masz problem z Firebase i projektem Apple? Odwiedź sekcję Rozwiązywanie problemów i często zadawane pytania dotyczące platform Apple .
Dodaj usługi Firebase do swojej aplikacji:
Uzyskaj wgląd w zachowanie użytkowników dzięki Analytics .
Skonfiguruj uwierzytelnianie użytkownika za pomocą uwierzytelniania .
Przechowuj dane, takie jak informacje o użytkownikach, w Cloud Firestore lub Bazie danych czasu rzeczywistego .
Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage .
Wyzwalaj kod backendu, który działa w bezpiecznym środowisku z Cloud Functions .
Wysyłaj powiadomienia przez Cloud Messaging .
Dowiedz się, kiedy i dlaczego Twoja aplikacja ulega awarii, korzystając z Crashlytics .