Dostosowywanie wiadomości Firebase w aplikacji

Funkcja Firebase Wysyłanie wiadomości w aplikacji udostępnia przydatny zestaw wstępnie skonfigurowanych zachowań i typów wiadomości z domyślnym wyglądem i stylem, ale w niektórych przypadkach możesz rozszerzyć zachowanie i treść wiadomości. Funkcja Wysyłanie wiadomości w aplikacji pozwala dodawać działania do wiadomości i dostosowywać wygląd i styl wiadomości.

Dodaj działanie do wiadomości

Dzięki akcjom możesz wykorzystać wiadomości w aplikacji, aby kierować użytkowników na stronę lub na określony ekran w aplikacji.

Funkcja Wysyłania wiadomości w aplikacji Firebase używa modułów obsługi linków do przetwarzania działań. Pakiet SDK może używać wielu modułów obsługi, więc jeśli Twoja aplikacja już ma taki moduł, funkcja wysyłania wiadomości w aplikacji może z niego korzystać bez konieczności dodatkowej konfiguracji. Jeśli nie masz jeszcze modułu obsługi, możesz korzystać z Linków dynamicznych Firebase. Więcej informacji znajdziesz w artykule Tworzenie linków dynamicznych w iOS.

Dodaj działanie do wiadomości za pomocą konsoli Firebase

Gdy aplikacja ma moduł obsługi linków, możesz utworzyć kampanię z działaniem. W konsoli Firebase otwórz Wiadomości i rozpocznij nową kampanię lub edytuj już istniejącą. Podaj w niej kartę, tekst przycisku i działanie przycisku, działanie związane z obrazem lub działanie banera, które stanowią odpowiedni precyzyjny link.

Format czynności zależy od wybranego układu wiadomości. W oknach modalnych znajdują się przyciski poleceń z dostosowywanym tekstem przycisku, kolorem tekstu i kolorem tła. Obrazy i górne banery z kolei stają się interaktywne i po kliknięciu wywołują określone działanie.

Modyfikowanie wyglądu i stylu wiadomości

Funkcja Firebase Wysyłanie wiadomości w aplikacji umożliwia dostosowanie wyświetlania wiadomości przez zmianę sposobu renderowania układu wiadomości, stylów czcionek, kształtów przycisków oraz innych szczegółów. Istnieją 2 sposoby modyfikowania sposobu wyświetlania wiadomości: można zmienić domyślny sposób wyświetlania wiadomości w aplikacji Firebase lub utworzyć od podstaw własną bibliotekę wyświetlania wiadomości.

Uwaga: ta usługa nie jest dostępna na urządzeniach z systemem macOS, Mac Catalyst, App Clip i WatchOS.

Zmodyfikuj wyświetlacze domyślne

Najprostszym sposobem dostosowania wiadomości jest wykorzystanie domyślnego kodu wyświetlania wiadomości w aplikacji Firebase.

Klonowanie repozytorium firebase-ios-sdk

Na początek skopiuj najnowszą wersję repozytorium firebase-ios-sdk i otwórz katalog InAppMessaging.

Wybierz typy wiadomości do zmodyfikowania

W ramach sklonowania repozytorium możesz zmodyfikować dowolne lub wszystkie typy wiadomości Firebase Wysyłanie wiadomości w aplikacji: Card, Modal, Banner i ImageOnly. Każdy typ odpowiada układowi wiadomości w procesie tworzenia kampanii Firebase Wysyłanie wiadomości w aplikacji.

W związku z tym każdy typ ma dostęp do innego zbioru danych określonego przez opcje dostosowania kampanii w konsoli Firebase:

Typ tytułTekst Tekst główny kolortekstu backgroundColor Dane_obrazów Przycisk polecenia Przycisk dodatkowego działania
Karta
Okno modalne
Baner
Tylko obraz

Modyfikowanie kodu renderowania wyświetlania wiadomości

Mając na uwadze ograniczenia dotyczące typów wiadomości, możesz dowolnie modyfikować te typy wiadomości. Możesz utworzyć baner, który będzie się wyświetlać u dołu aplikacji, poruszać się po przycisku polecenia w oknie, umieścić wiadomość w aplikacji w sekcji aktywności użytkownika i wprowadzić dowolną inną modyfikację, która dopasuje wygląd wiadomości do Twojej aplikacji.

Podczas modyfikowania wyświetlania wiadomości musisz zwrócić uwagę na 2 główne kwestie:

Zmodyfikuj pliki w katalogach preferowanych typów wiadomości i odpowiadających im sekcjach pliku .storyboard, aby utworzyć komunikaty niestandardowe.

Zaktualizuj plik podfile, aby używał zmodyfikowanego kodu InAppMessaging

Jeśli chcesz, aby funkcja Firebase Wysyłanie wiadomości w aplikacji używała zmodyfikowanych widoków wiadomości zamiast domyślnych, zaktualizuj plik podfile, tak aby korzystał z dostosowanej biblioteki InAppMessaging: 

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end
Gdy to zrobisz, możesz zaktualizować pody, przebudować aplikację i wyświetlać nowe, dostosowane komunikaty.

Utwórz własną bibliotekę wyświetlania wiadomości

Nie możesz tworzyć interfejsu do wyświetlania wiadomości przy użyciu biblioteki InAppMessaging. Możesz też napisać własny kod od zera.

Tworzenie klasy implementującej protokół InAppMessagingDisplay

Funkcja Firebase Wysyłanie wiadomości w aplikacji używa klasy InAppMessaging do obsługi komunikacji między serwerami Firebase a Twoją aplikacją. Ta klasa z kolei używa protokołu InAppMessagingDisplay do wyświetlania odbieranych wiadomości. Aby utworzyć własną bibliotekę wyświetlania, napisz klasę, która implementuje protokół.

Definicja protokołu i dokumentacja zgodności z nim znajduje się w pliku FIRInAppMessagingDisplay.h w bibliotece InAppMessaging.

Skonfiguruj aplikację messageDisplayComponent tak, aby mogła korzystać z biblioteki wyświetlania wiadomości

InAppMessaging używa właściwości messageDisplayComponent do określenia, którego obiektu ma używać do wyświetlania wiadomości. Ustaw tę właściwość na obiekt klasy wyświetlania wiadomości, aby usługa Firebase Wiadomości w aplikacji wiedziała, że ma wykorzystać Twoją bibliotekę do renderowania wiadomości:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance