Wymagania wstępne
Zainstaluj następujące elementy:
- Xcode 14.1 lub nowsza wersja
Sprawdź, czy 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ć aplikację.
- Zaloguj się w Firebase za pomocą Konto Google.
Jeśli nie masz jeszcze projektu Xcode i chcesz tylko wypróbować Firebase możesz pobrać nasze krótkie wprowadzenia.
Krok 1. Utwórz projekt Firebase
Zanim dodasz Firebase do swojej aplikacji Apple, musisz utworzyć taką aplikację projekt, aby połączyć się z aplikacją. Odwiedź Więcej informacji o projektach Firebase Projekty Firebase.
Krok 2. Zarejestruj aplikację w Firebase
Aby używać Firebase w swojej aplikacji Apple, musisz ją zarejestrować w projekt Firebase. Rejestracja aplikacji często nazywa się „dodawaniem” aplikacji na w projektach AI.
Otwórz konsolę Firebase.
Na środku strony przeglądu projektu kliknij ikonę iOS+. aby rozpocząć proces konfiguracji.
Jeśli masz już aplikację w projekcie Firebase, kliknij Dodaj aplikację. aby wyświetlić opcje platformy.
W polu identyfikator pakietu wpisz identyfikator pakietu aplikacji.
(Opcjonalnie) Wpisz inne informacje o aplikacji: Nazwa aplikacji i identyfikator App Store.
Kliknij Zarejestruj aplikację.
Krok 3. Dodaj plik konfiguracji Firebase
Kliknij Download GoogleService-Info.plist, aby otrzymać Firebase Apple plik konfiguracji platform (
GoogleService-Info.plist
).Przenieś plik konfiguracji do katalogu głównego projektu Xcode. Jeśli pojawi się taka prośba, wybierz, aby dodać plik konfiguracyjny do wszystkich środowisk docelowych.
Jeśli masz w projekcie kilka identyfikatorów pakietów, musisz powiązać każdy z nich
Identyfikator zarejestrowanej aplikacji w konsoli Firebase, aby każda aplikacja mogła mieć
własny plik GoogleService-Info.plist
.
Krok 4. Dodaj pakiety SDK Firebase do aplikacji
Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.
- W Xcode po otwarciu projektu aplikacji przejdź do File > Dodaj pakiety.
- Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:
- Wybierz wersję pakietu SDK, której chcesz używać.
Wybierz biblioteki Firebase, których chcesz używać.
Jeśli w projekcie Firebase masz włączoną usługę Google Analytics, upewnij się, aby dodać
FirebaseAnalytics
. W przypadku Analytics bez zbierania danych IDFA , dodaj w zamianFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub zależności w tle.
Krok 5. Zainicjuj Firebase w swojej aplikacji
Ostatnim krokiem jest dodanie kodu inicjującego do aplikacji. Być może masz Ten proces został już przez Ciebie wykonany w ramach dodawania Firebase do Twojej aplikacji. Jeśli używasz tagu quickstart sample project, to już za Ciebie.
- Zaimportuj moduł
FirebaseCore
doUIApplicationDelegate
, jak i wszelkie inne Moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć Cloud Firestore i Uwierzytelniania: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
FirebaseApp
współdzielonej instancji w uprawnieniach przedstawiciela aplikacji Metodaapplication(_:didFinishLaunchingWithOptions:)
: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ć i dołączyć przedstawiciela aplikacji.
do struktury
App
za pomocąUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Dla: 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 masz pakiet SDK Firebase dla Google Analytics, możesz aplikacji, aby wysłać weryfikację do konsoli Firebase Firebase został zainstalowany.
To wszystko. Możesz przejść do kolejnych kroków.
Jeśli jednak masz problemy z konfiguracją, odwiedź Rozwiązywanie problemów z platformami Apple Najczęstsze pytania.
Dostępne biblioteki
W tej sekcji znajdziesz usługi Firebase obsługiwane na platformach Apple. Ucz się o tych bibliotekach platformy Firebase Apple:
repozytorium GitHub z pakietu SDK platform Firebase Apple
Usługa lub produkt | Pody | Biblioteki SwiftPM | Dodać Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
Nie dotyczy | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
Sprawdzanie aplikacji | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
Rozpowszechnianie aplikacji | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Uwierzytelnianie | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Pakiet SDK klienta Cloud Functions dla Firebase | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Komunikacja w chmurze | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Linki dynamiczne | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
Wysyłanie wiadomości w aplikacji | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(wymagane) |
Instalacje Firebase | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Interfejsy API modelu niestandardowego Firebase ML | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Monitorowanie wydajności | pod 'FirebasePerformance' |
FirebasePerformance |
|
Baza danych czasu rzeczywistego | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Zdalna konfiguracja | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI dla Firebase | Nie dotyczy | FirebaseVertexAI-Preview |
Przeprowadź integrację bez korzystania z menedżera pakietów Swift
Jeśli nie chcesz korzystać z menedżera pakietów Swift, możesz skorzystać z pakiety SDK Firebase przy użyciu CocoaPods lub bezpośrednio importując platformy.
CocoaPods
Więcej informacji o integracji z CocoaPods znajdziesz tutaj: naszym przewodniku.
Platformy
Oprócz obsługi platformy iOS plik ZIP zawiera teraz .xcframework
. Więcej informacji znajdziesz w artykule Firebase
Platformy Apple z pakietem SDK README w obszarze README
GitHub
,
Pobierz plik ZIP pakietu SDK platformy Firebase. Rozmiar pliku to ok. 200 MB. Może to potrwać trochę czasu do pobrania.
Rozpakuj plik i zintegruj platformy, które chcesz uwzględnić w aplikacji.
Instrukcje integracji można znaleźć w jednym z następujących miejsc:
- W repozytorium GitHub pakietu SDK Firebase na iOS.
- W pliku
README.md
w pobranym pliku ZIP.
Informacje o wersjach i zależności platformy znajdziesz w
METADATA.md
w pobranym pliku ZIP.Dodaj parametr
-ObjC
flaga łącząca wOther Linker Settings
w ustawieniach kompilacji celu.
Dalsze kroki
Więcej informacji o Firebase:
Więcej informacji znajdziesz w artykule Omówienie projektów Firebase. o projektach Firebase i sprawdzonych metodach związanych z projektami.
Zobacz przykładowe aplikacje Firebase.
Zdobądź praktyczne doświadczenie dzięki Firebase na iOS Ćwiczenia z programowania.
Dowiedz się więcej do otwartego kodu źródłowego w GitHubie.
Przygotowanie do wprowadzenia aplikacji:
- Określ budżet alerty swojego projektu w konsoli Google Cloud.
- Monitorowanie korzystania i płatności panel w konsoli Firebase, aby uzyskać ogólny obraz i wielu usług Firebase.
- Zapoznaj się z listą kontrolną uruchamiania Firebase.
Masz problemy z Firebase i projektem Apple? Odwiedź stronę Rozwiązywanie problemów z platformami Apple Najczęstsze pytania.
Dodaj usługi Firebase do aplikacji:
Uzyskuj statystyki dotyczące zachowań użytkowników za pomocą Statystyki.
Skonfiguruj uwierzytelnianie użytkowników za pomocą opcji Uwierzytelnianie.
Przechowuj dane, takie jak informacje o użytkownikach, w Cloud Firestore lub Baza danych czasu rzeczywistego.
Przechowuj pliki, np. zdjęcia i filmy, w: Cloud Storage
Aktywuj kod backendu, który działa w bezpiecznym środowisku za pomocą Cloud Functions.
Wysyłaj powiadomienia przez Komunikacja w chmurze.
Dowiedz się, kiedy i dlaczego występują awarie aplikacji Crashlytics.