Konfigurowanie aplikacji klienckiej Komunikacja w chmurze Firebase (FCM) w języku C++

Aby napisać wieloplatformową aplikację kliencką Komunikacja w chmurze Firebase (FCM) w języku C++, użyj interfejsu API Komunikacji w chmurze Firebase (FCM). Pakiet SDK C++ działa zarówno na platformy Androida, jak i platformy Apple, ale wymagana jest dodatkowa konfiguracja na każdej z tych platform.

Skonfiguruj Firebase i pakiet SDK FCM

Uzyskiwanie dostępu do tokena rejestracji urządzenia

Po zainicjowaniu biblioteki Komunikacji w chmurze Firebase (FCM) wysyłane jest żądanie tokena rejestracji dla instancji aplikacji klienckiej. Aplikacja otrzyma token z wywołaniem zwrotnym OnTokenReceived, które należy zdefiniować w klasie implementującej firebase::messaging::Listener.

Jeśli chcesz kierować reklamy na to konkretne urządzenie, potrzebujesz dostępu do tego tokena.

Uwaga na temat dostarczania wiadomości w Androidzie

Gdy aplikacja w ogóle nie jest uruchomiona, a użytkownik klika powiadomienie, wiadomość nie jest domyślnie przekierowywana przez wbudowane wywołania zwrotne FCM. W tym przypadku ładunki komunikatów są odbierane przez Intent używany do uruchamiania aplikacji. Aby usługa FCM przekazywała te wiadomości przychodzące do wywołania zwrotnego biblioteki C++, musisz zastąpić metodę onNewIntent w aktywności i przekazać Intent do MessageForwardingService.

import com.google.firebase.messaging.MessageForwardingService;

class MyActivity extends Activity {
  private static final String TAG = "MyActvity";

  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "A message was sent to this app while it was in the background.");
    Intent message = new Intent(this, MessageForwardingService.class);
    message.setAction(MessageForwardingService.ACTION_REMOTE_INTENT);
    message.putExtras(intent);
    message.setData(intent.getData());
    // For older versions of Firebase C++ SDK (< 7.1.0), use `startService`.
    // startService(message);
    MessageForwardingService.enqueueWork(this, message);
  }
}

W wiadomościach odbieranych, gdy aplikacja działa w tle, zawartość pola powiadomień jest wypełniana w obszarze powiadomień w obszarze powiadomień, ale treść tych powiadomień nie jest przekazywana do FCM. Oznacza to, że Message::notification ma wartość null.

W skrócie:

Niestandardowa obsługa wiadomości na Androidzie

Domyślnie powiadomienia wysyłane do aplikacji są przekazywane do ::firebase::messaging::Listener::OnMessageReceived, ale w niektórych przypadkach możesz chcieć je zastąpić. Aby to zrobić na Androidzie, musisz utworzyć niestandardowe klasy, które rozszerzają zakres com.google.firebase.messaging.cpp.ListenerService, a także zaktualizować AndroidManifest.xml projektu.

Zastąp ListenerService metody.

ListenerService to klasa Java, która przechwytuje wiadomości przychodzące wysyłane do aplikacji i kieruje je do biblioteki C++. Gdy aplikacja działa na pierwszym planie (lub gdy działa w tle i otrzymuje ładunek obejmujący tylko dane), wiadomości są przekazywane przez jedno z wywołań zwrotnych udostępnionych w tej klasie. Aby dodać niestandardowe zachowanie do obsługi wiadomości, musisz rozszerzyć domyślny ListenerService FCM:

import com.google.firebase.messaging.cpp.ListenerService;

class MyListenerService extends ListenerService {

Po zastąpieniu metody ListenerService.onMessageReceived możesz wykonywać działania na podstawie otrzymanego obiektu RemoteMessage i pobierać dane wiadomości:

@Override
public void onMessageReceived(RemoteMessage message) {
  Log.d(TAG, "A message has been received.");
  // Do additional logic...
  super.onMessageReceived(message);
}

ListenerService ma też kilka innych metod, które są rzadziej używane. Możesz je również zastąpić. Więcej informacji znajdziesz w dokumentacji FirebaseMessagingService.

@Override
public void onDeletedMessages() {
  Log.d(TAG, "Messages have been deleted on the server.");
  // Do additional logic...
  super.onDeletedMessages();
}

@Override
public void onMessageSent(String messageId) {
  Log.d(TAG, "An outgoing message has been sent.");
  // Do additional logic...
  super.onMessageSent(messageId);
}

@Override
public void onSendError(String messageId, Exception exception) {
  Log.d(TAG, "An outgoing message encountered an error.");
  // Do additional logic...
  super.onSendError(messageId, exception);
}

Zaktualizuj: AndroidManifest.xml

Zapisane klasy niestandardowe muszą zostać uwzględnione w AndroidManifest.xml, aby zaczęły obowiązywać. Upewnij się, że plik manifestu zawiera narzędzia do scalania. W tym celu zadeklaruj w tagu <manifest> odpowiedni atrybut:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.firebase.messaging.cpp.samples"
    xmlns:tools="http://schemas.android.com/tools">

W archiwum firebase_messaging_cpp.aar znajduje się plik AndroidManifest.xml deklarujący domyślną wartość ListenerService usługi FCM. Ten plik manifestu jest zwykle scalony z plikiem manifestu konkretnego projektu, w którym może działać ListenerService. Trzeba zastąpić ten obiekt ListenerService usługą detektora klienta. Aby to zrobić, usuń domyślną wartość ListenerService i dodaj usługę niestandardową. Możesz to zrobić w pliku AndroidManifest.xml projektów w następujący sposób:

<service android:name="com.google.firebase.messaging.cpp.ListenerService"
         tools:node="remove" />

<service android:name="com.google.firebase.messaging.cpp.samples.MyListenerService"
         android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT"/>
  </intent-filter>
</service>

Nowe wersje pakietu SDK Firebase C++ (od wersji 7.1.0) używają parametru JobIntentService, który wymaga dodatkowych modyfikacji w pliku AndroidManifest.xml.

<service android:name="com.google.firebase.messaging.MessageForwardingService"
     android:permission="android.permission.BIND_JOB_SERVICE"
     android:exported="false" >
</service>

Zapobiegaj automatycznemu inicjowaniu

FCM generuje token rejestracji na potrzeby kierowania na urządzenia. Po wygenerowaniu tokena biblioteka przesyła identyfikator i dane konfiguracji do Firebase. Jeśli przed użyciem tokena chcesz uzyskać wyraźną zgodę, możesz zapobiec generowaniu danych podczas konfiguracji, wyłączając FCM (a na Androidzie i w Analytics). Aby to zrobić, dodaj wartość metadanych do Info.plist (nie GoogleService-Info.plist) na platformach Apple lub do AndroidManifest.xml na Androidzie:

<?xml version="1.0" encoding="utf-8"?>
<application>
  <meta-data android:name="firebase_messaging_auto_init_enabled"
             android:value="false" />
  <meta-data android:name="firebase_analytics_collection_enabled"
             android:value="false" />
</application>

FirebaseMessagingAutoInitEnabled = NO

Aby ponownie włączyć FCM, możesz wykonać wywołanie w czasie działania aplikacji:

::firebase::messaging::SetTokenRegistrationOnInitEnabled(true);

Po ustawieniu ta wartość będzie się utrzymywać w przypadku ponownych uruchomień aplikacji.

Radzenie sobie z wiadomościami za pomocą precyzyjnych linków na Androidzie

FCM zezwala na wysyłanie wiadomości zawierających precyzyjny link do Twojej aplikacji. Aby otrzymywać wiadomości zawierające precyzyjny link, musisz dodać nowy filtr intencji do działania, które obsługuje precyzyjne linki w Twojej aplikacji. Filtr intencji powinien przechwytywać precyzyjne linki w Twojej domenie. Jeśli wiadomości nie zawierają precyzyjnego linku, ta konfiguracja nie jest konieczna. W pliku AndroidManifest.xml:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="http"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="https"/>
</intent-filter>

Aby zwiększyć elastyczność filtra intencji, możesz też określić symbol wieloznaczny. Przykład:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="*.example.com" android:scheme="http"/>
  <data android:host="*.example.com" android:scheme="https"/>
</intent-filter>

Gdy użytkownik kliknie powiadomienie zawierające link do określonego schematu i hosta, aplikacja rozpocznie aktywność za pomocą tego filtra intencji, aby obsłużyć link.

Dalsze kroki

Po skonfigurowaniu aplikacji klienckiej możesz zacząć wysyłać wiadomości niższe i tematyczne za pomocą Firebase. Więcej informacji znajdziesz w przykładzie krótkiego wprowadzenia, który możesz pobrać, uruchomić i przejrzeć.

Aby dodać inne, bardziej zaawansowane działania w aplikacji, zapoznaj się z przewodnikami po wysyłaniu wiadomości z serwera aplikacji:

• Wysyłanie wiadomości tematycznych
• Wysyłanie do grup urządzeń

Pamiętaj, że aby korzystać z tych funkcji, musisz mieć implementację serwera.