Dodaj Firebase do projektu Apple

Wymagania wstępne

• Zainstaluj te elementy:

  • Xcode 26.2 lub nowsze

• Upewnij się, że Twój projekt spełnia te wymagania:

  • Twój projekt musi być przeznaczony na te wersje platformy lub nowsze:
    • iOS 15
    • macOS 11
    • tvOS 15
    • watchOS 8

• Skonfiguruj fizyczne urządzenie Apple lub użyj symulatora, aby uruchomić aplikację.

  Czy chcesz użyć Cloud Messaging?

  W przypadku Cloud Messaging na platformach Apple wymagania wstępne są następujące:

  • Skonfiguruj fizyczne urządzenie Apple.
  • Uzyskaj klucz uwierzytelniania usługi Apple Push Notification na koncie dewelopera Apple.
  • Włącz powiadomienia push w Xcode w sekcji App > Capabilities (Aplikacja > Funkcje).

Jeśli nie masz jeszcze projektu Xcode i chcesz tylko wypróbować usługę Firebase, możesz pobrać jeden z naszych przykładowych projektów.

Krok 1. Utwórz projekt w Firebase

Zanim dodasz Firebase do aplikacji na urządzenia Apple, musisz utworzyć projekt Firebase, aby połączyć go z aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Informacje o projektach Firebase.

Wyświetl instrukcje tworzenia projektu w Firebase

Dopiero zaczynasz korzystać z Firebase lub Cloud

Jeśli dopiero zaczynasz korzystać z Firebase lub Google Cloud, wykonaj te czynności.
Możesz też wykonać te czynności, jeśli chcesz utworzyć zupełnie nowy projekt w Firebase (i powiązany z nim projekt Google Cloud).

1. Zaloguj się w Firebase konsoli.
2. Kliknij przycisk, aby utworzyć nowy projekt w Firebase.

3. W polu tekstowym wpisz nazwę projektu.

   Jeśli należysz do organizacji Google Cloud, możesz opcjonalnie wybrać folder, w którym chcesz utworzyć projekt.

4. Jeśli pojawi się odpowiedni komunikat, przeczytaj i zaakceptuj warunki korzystania z Firebase, a potem kliknij Dalej.
5. (Opcjonalnie) Włącz pomoc AI w Firebase konsoli (nazywaną „Gemini w Firebase”), która może Ci pomóc w rozpoczęciu pracy i usprawnieniu procesu programowania.

6. (Opcjonalnie) Skonfiguruj Google Analytics w projekcie, co umożliwi optymalne korzystanie z tych usług Firebase:Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging i Remote Config (w tym personalizację).

   Wybierz istniejące Google Analyticskonto lub utwórz nowe. Jeśli tworzysz nowe konto, wybierz Analyticslokalizację raportowania, a potem zaakceptuj ustawienia udostępniania danych i Google Analyticswarunki projektu.

7. Kliknij Utwórz projekt.

Firebase utworzy projekt, udostępni wstępne zasoby i włączy ważne interfejsy API. Po zakończeniu procesu otworzy się strona przeglądu projektu w Firebase w Firebase konsoli.

Istniejący projekt w chmurze

Jeśli chcesz zacząć korzystać z Firebase w przypadku istniejącego projektuGoogle Cloud, wykonaj te czynności. Dowiedz się więcej o  dodawaniu Firebase do istniejącego Google Cloud projektu i rozwiązywaniu związanych z tym problemów.

1. Zaloguj się w Firebasekonsoli na konto, które daje Ci dostęp do istniejącego Google Cloud projektu.
2. Kliknij przycisk, aby utworzyć nowy projekt w Firebase.
3. U dołu strony kliknij Dodaj Firebase do projektu Google Cloud.
4. W polu tekstowym zacznij wpisywać nazwę projektu, a następnie wybierz projekt z wyświetlonej listy.
5. Kliknij Otwórz projekt.
6. Jeśli pojawi się odpowiedni komunikat, przeczytaj i zaakceptuj warunki korzystania z Firebase, a potem kliknij Dalej.
7. (Opcjonalnie) Włącz pomoc AI w Firebase konsoli (nazywaną „Gemini w Firebase”), która może Ci pomóc w rozpoczęciu pracy i usprawnieniu procesu programowania.

8. (Opcjonalnie) Skonfiguruj Google Analytics w projekcie, co umożliwi optymalne korzystanie z tych usług Firebase:Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging i Remote Config (w tym personalizację).

   Wybierz istniejące Google Analyticskonto lub utwórz nowe. Jeśli tworzysz nowe konto, wybierz Analyticslokalizację raportowania, a potem zaakceptuj ustawienia udostępniania danych i Google Analyticswarunki projektu.

9. Kliknij Dodaj Firebase.

Firebase dodaje Firebase do istniejącego projektu. Po zakończeniu procesu otworzy się strona przeglądu projektu w Firebase w Firebase konsoli.

Krok 2. Zarejestruj aplikację w Firebase

Aby korzystać z Firebase w aplikacji na urządzenia Apple, musisz zarejestrować aplikację w projekcie w Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.

1. Otwórz Firebasekonsolę.

2. W centrum strony „Opis” projektu kliknij ikonę iOS+, aby uruchomić proces konfiguracji.

   Jeśli aplikacja została już dodana do projektu w Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy.

3. W polu bundle ID wpisz identyfikator pakietu aplikacji.

   Co to jest identyfikator pakietu i gdzie go znaleźć?

   • Identyfikator pakietu jednoznacznie identyfikuje aplikację w ekosystemie Apple.

   • Znajdź identyfikator pakietu: otwórz projekt w Xcode, wybierz aplikację najwyższego poziomu w nawigatorze projektu, a następnie wybierz kartę Ogólne.

     Wartość pola Identyfikator pakietu to identyfikator pakietu (np. com.yourcompany.yourproject).

   • Pamiętaj, że wielkość liter w wartości identyfikatora pakietu ma znaczenie i nie można jej zmienić w przypadku tej aplikacji w Firebase po zarejestrowaniu jej w projekcie w Firebase.

4. (Opcjonalnie) wpisz inne informacje o aplikacji: pseudonim aplikacji i identyfikator App Store.

   Jak w Firebase używane są pseudonim aplikacji i identyfikator aplikacji w App Store?

   • Pseudonim aplikacji: wewnętrzny identyfikator ułatwiający rozpoznawanie aplikacji, widoczny tylko w Firebase konsoli.

   • Identyfikator App Store: używany przez Firebase Dynamic Links do przekierowywania użytkowników na stronę aplikacji w App Store i przez Google Analytics do importowania zdarzeń konwersji do Google Ads. Jeśli Twoja aplikacja nie ma jeszcze identyfikatora sklepu z aplikacjami, możesz go dodać później w ustawieniach projektu.

5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

1. Kliknij Download GoogleService-Info.plist, aby pobrać plik konfiguracyjny Firebase aplikacji (GoogleService-Info.plist).

   Co musisz wiedzieć o tym pliku konfiguracji?

   • Plik konfiguracyjny Firebase zawiera unikalne, ale nie tajne identyfikatory projektu i aplikacji. Więcej informacji o tym pliku konfiguracyjnym znajdziesz w artykule Informacje o projektach Firebase.

   • W każdej chwili możesz ponownie pobrać plik konfiguracyjny Firebase.

   • Sprawdź, czy nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, np. (2).

2. Przenieś plik konfiguracyjny do katalogu głównego projektu Xcode. Jeśli pojawi się odpowiedni komunikat, kliknij, aby dodać plik konfiguracyjny do wszystkich miejsc docelowych.

Jeśli w projekcie masz kilka identyfikatorów pakietu, 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 instalowania zależności Firebase i zarządzania nimi używaj Swift Package Manager.

1. W Xcode otwórz projekt aplikacji i kliknij File > Add Packages (Plik > Dodaj pakiety).
2. Gdy pojawi się odpowiedni komunikat, dodaj repozytorium pakietu SDK Firebase na platformy Apple:

  https://github.com/firebase/firebase-ios-sdk

3. Wybierz wersję pakietu SDK, której chcesz używać.

4. Wybierz biblioteki Firebase, których chcesz używać.

   Jeśli w projekcie w Firebase włączona jest funkcja Google Analytics, dodaj FirebaseAnalytics. Zapewnia to wszystkie funkcje analityczne. Możesz też wybrać poszczególne funkcje. Więcej informacji znajdziesz w sekcji Najczęstsze pytania dotyczącej najnowszej organizacji modułów w Google Analytics pakietu SDK Firebase.

Po zakończeniu Xcode automatycznie zacznie przetwarzać i pobierać zależności w tle.

Krok 5. Zainicjuj Firebase w aplikacji

Ostatnim krokiem jest dodanie do aplikacji kodu inicjującego. Być może masz już to za sobą, jeśli dodawałeś(-aś) Firebase do aplikacji. Jeśli korzystasz z projektu przykładowego szybkiego startu, to zadanie zostało już wykonane.

1. Zaimportuj moduł FirebaseCore w pliku UIApplicationDelegate, a także inne moduły Firebase używane przez delegata 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;
   // ...
         

2. Skonfiguruj FirebaseApp współdzielone wystąpienie w metodzie application(_:didFinishLaunchingWithOptions:) delegata 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];

3. Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć zamianę delegata aplikacji. Więcej informacji znajdziesz w instrukcjach dotyczących SwiftUI.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Jeśli masz w aplikacji pakiet SDK Firebase dla Google Analytics, możesz ją uruchomić, aby wysłać do konsoli Firebase potwierdzenie, że Firebase został zainstalowany.

To wszystko. Możesz od razu przejść do dalszych kroków.

Jeśli masz problemy z konfiguracją, zapoznaj się z rozwiązywaniem problemów i najczęstszymi pytaniami dotyczącymi platform Apple.

Dostępne biblioteki

Ta sekcja zawiera listę usług Firebase obsługiwanych na platformach Apple. Dowiedz się więcej o tych bibliotekach Firebase na platformę Apple:

• Dokumentacja źródłowa (Swift | Obj-C)

• Pakiet SDK Firebase na platformy Apple – repozytorium GitHub

Usługa lub produkt	Nazwa biblioteki lub platformy	Chcesz dodać Analytics?
AdMob	GoogleMobileAds
Firebase AI Logic 1	FirebaseAILogic
Analytics	FirebaseAnalytics
App Check	FirebaseAppCheck
App Distribution	FirebaseAppDistribution
Authentication	FirebaseAuth
Cloud Firestore	FirebaseFirestore
Cloud Functions for Firebase Client SDK	FirebaseFunctions
Cloud Messaging	FirebaseMessaging
Cloud Storage	FirebaseStorage
Crashlytics	FirebaseCrashlytics
In-App Messaging	FirebaseInAppMessaging	(wymagane)
Firebase instalacje	FirebaseInstallations
Performance Monitoring	FirebasePerformance
Realtime Database	FirebaseDatabase
Remote Config	FirebaseRemoteConfig
SQL Connect 2	FirebaseDataConnect
PRZESTARZAŁE LUB NIEWSPIERANE BIBLIOTEKI
Dynamic Links	FirebaseDynamicLinks
Firebase ML Interfejsy API modeli niestandardowych	FirebaseMLModelDownloader

^{1 Firebase AI Logic (FirebaseAILogic) was formerly called "Vertex AI in Firebase" and distributed under the FirebaseVertexAI module. Firebase AI Logic był wcześniej rozpowszechniany w ramach modułu FirebaseAI.}

^{2 Firebase SQL Connect nosiło wcześniej nazwę „Firebase Data Connect”.}

Integracja bez użycia Swift Package Manager

Jeśli nie chcesz używać Swift Package Manager, możesz zintegrować Firebase, importując bezpośrednio wstępnie skompilowane platformy.

Platformy

Oprócz obsługi platformy iOS plik ZIP zawiera teraz pliki .xcframework. Szczegółowe informacje znajdziesz w pliku README pakietu SDK Firebase na platformy Apple w GitHub.

1. Pobierz plik ZIP z pakietem SDK platformy. Jest to plik o rozmiarze około 200 MB, więc pobieranie może potrwać.

2. Rozpakuj plik, a następnie zintegruj z aplikacją wybrane przez siebie platformy.

   Instrukcje integracji znajdziesz w tych miejscach:

   • W repozytorium GitHub pakietu SDK Firebase na iOS.
   • W pliku README.md w pobranym pliku ZIP.

   Informacje o wersjach platformy lub zależnościach znajdziesz w pliku METADATA.md w pobranym pliku ZIP.

3. Dodaj -ObjCflagę linkera w Other Linker Flags w ustawieniach kompilacji elementu docelowego.

Dalsze kroki

Więcej informacji o Firebase:

• Więcej informacji o projektach Firebase i sprawdzonych metodach dotyczących projektów znajdziesz w artykule Projekty Firebase.

• Poznaj przykładowe aplikacje Firebase.

• Zdobądź praktyczne doświadczenie dzięki ćwiczeniu Firebase na iOS.

• Zapoznaj się z kodem open source na GitHubie.

• Przygotuj się do uruchomienia aplikacji:

  • Skonfiguruj alerty dotyczące budżetu dla projektu w Google Cloud konsoli.
  • Monitoruj panel Wykorzystanie i rozliczenia w Firebase konsoli, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
  • Zapoznaj się z listą kontrolną dotyczącą uruchamiania Firebase.

• Masz problemy z Firebase i projektem Apple? Zapoznaj się z najczęstszymi pytaniami i odpowiedziami dotyczącymi rozwiązywania problemów na platformach Apple.

Dodaj do aplikacji usługi Firebase:

• Twórz funkcje generatywnej AI za pomocą modeli Gemini, korzystając z Firebase AI Logic.

• Uzyskuj statystyki dotyczące zachowań użytkowników dzięki Analytics.

• Skonfiguruj uwierzytelnianie użytkowników za pomocą metody Authentication.

• przechowywać dane, takie jak informacje o użytkownikach, za pomocą Cloud Firestore lub Realtime Database;

• Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage.

• Wywoływanie kodu backendu, który działa w bezpiecznym środowisku, za pomocą funkcji Cloud Functions.

• Wysyłaj powiadomienia za pomocą Cloud Messaging.

• Dowiedz się, kiedy i dlaczego Twoja aplikacja ulega awarii, korzystając z Crashlytics.