CellBroadcast

Das CellBroadcast-Modul reduziert wiederkehrende Aufgaben für OEMs, was wiederum die Fragmentierung im Android-System verringert und für ein einheitliches Verhalten der Endnutzer sorgt. Außerdem werden die Tests und Zertifizierungen für Mobilfunkanbieter im Hinblick auf CellBroadcast-Anforderungen optimiert, da der Code nicht von OEMs geändert werden kann. Dieses Modul kann aktualisiert werden, d. h. es kann außerhalb des normalen Android-Releasezyklus Funktionsupdates erhalten.

Paketformat

Das CellBroadcast-Modul besteht aus dem folgenden Dienst und der folgenden App.

  • Der Dienst CellBroadcastService unterstützt die Dekodierung von CellBroadcast-SMS, Geofencing für WEA 3.0 (Wireless Emergency Alert), Duplikatprüfungen von Nachrichten und das Senden von Nachrichten an Apps. Es ist ein 1:n-Messagingdienst mit geografischer Ausrichtung und Geofence, mit dem Nachrichten gleichzeitig an mehrere Smartphone-Nutzer in einem bestimmten Gebiet gesendet werden können. Der Dienst wird vom ETSI GSM-Ausschuss, 3GPP, definiert und ist Teil der Telekommunikationsstandards.

  • Die App CellBroadcastReceiver ist eine Standardsystem-App, die Notfall- und andere Warnungen (z. B. Amber- und Präsidentenwarnungen) verarbeitet und die Informationen an Endnutzer gemäß den Bestimmungen des Mobilfunkanbieters und den regionalen Vorschriften anzeigt.

CellBroadcast-Nachrichtenfluss

Die folgende Abbildung zeigt den Ablauf von CellBroadcast-Nachrichten.

Nachrichtenfluss von CellBroadcastReceiver

Abbildung 1: Nachrichtenfluss von CellBroadcastReceiver

  1. Die Radio-Interface-Schicht (Radio Interface Layer, RIL) benachrichtigt InBoundSMSHandler über eine CDMA-/GSM-CellBroadcast-SMS.

  2. Das Framework leitet die CellBroadcast-SMS an das CBS-Modul weiter, um die eingehende Nachricht zu parsen und zu verarbeiten.

  3. Nachdem die Nachricht verarbeitet wurde, leitet CellBroadcastService die Intent an die standardmäßige CellBroadcastReceiver-App des Systems weiter.

  4. Die CellBroadcastReceiver App zeigt die Nachricht dem Nutzer an.

Modulformat

Die CellBroadcastService- und die CellBroadcastReceiver-App sind in einer einzelnen APEX-Datei (com.android.cellbroadcast) enthalten, die für Geräte mit Android 11 oder höher verfügbar ist. Das Modul enthält Code in package/app/CellBroadcastReceiver und migriert vorhandene Framework-Klassen zu packages/modules/CellBroadcastService.

Modulabhängigkeiten

Das CellBroadcast-Modul interagiert mit dem Framework nur über stabile @SystemApi (keine @hide APIs) und hängt von den folgenden statischen Bibliotheken ab.

  • Androidx.legacy_legacy-support-v13
  • Androidx.recyclerview_recyclerview
  • Androidx.preference_preference
  • androidx.legacy_legacy-preference-v14
  • androidx.appcompat_appcompat

Sie können die Konfiguration mithilfe von Laufzeitressourcen-Overlays (RROs) anpassen.

Berechtigungskonfiguration

Das CellBroadcast-Modul ist mit einer Google-Signatur statt einer Plattformsignatur signiert. Das bedeutet, dass das Modul keinen Zugriff mehr auf Signaturberechtigungen hat. Stattdessen definiert Android 11 die neue Signaturberechtigung com.android.cellbroadcastservice.FULL_ACCESS_CELL_BROADCAST_HISTORY im CellBroadcast-Modul. Nur Pakete im Modul können die Berechtigung erhalten, da sie mit demselben Schlüssel signiert sind. Mit dieser Berechtigung hat die App „CellBroadcastReceiver“ vollen Zugriff auf die Datenbank in „CellBroadcastService“.

Die Plattform gewährt der android.permission.READ_CELL_BROADCASTS-Laufzeit der Standard-SMS-App des Systems die Berechtigung zum Zugriff auf den Verlauf der Notfallwarnungen.

CellBroadcast-Modul einbinden

In diesem Abschnitt wird beschrieben, wie Sie das CellBroadcast-Modul einbinden.

In die Einstellungen einbinden

Sie können festlegen, wo die Einstellungen für CellBroadcasts in den Einstellungen integriert werden. Endnutzer rufen die Seite mit den CellBroadcast-Einstellungen über Einstellungen > Apps & Benachrichtigungen > Erweitert > Notfallbenachrichtigung auf. Wenn Sie die App „CellBroadcastReceiver“ über die Einstellungen starten möchten, ändern Sie die folgenden Konfigurationen mit dem Paketnamen com.android.cellbroadcastreceiver.

<!-- Cell broacast receiver package name [DO NOT TRANSLATE] -->
<string name="cell_broadcast_receiver_package">
com.android.cellbroadcastreceiver</string>

In Messaging-Apps einbinden

Sie können einen App-Link in Messaging-Apps einbinden, um den Nachrichtenverlauf von CellBroadcasts zu öffnen. In der Android Messages App ist diese Funktion unter Einstellungen > Erweitert > Notfallbenachrichtigung verfügbar. Wenn Sie einen Link in Ihre eigene Messaging-App einbinden möchten, definieren Sie den Pfad in der Messaging-App und konfigurieren Sie den Komponentennamen für das CellBroadcast-Modul als com.android.cellbroadcastreceiver/com.android.cellbroadcastreceiver.CellBroadcastListActivity.

Mit SMS-Posteingang integrieren

Sie können die Anzeige von CellBroadcast-Nachrichten in der Standard-Messaging-App aktivieren, indem Sie die folgende Konfiguration mit einem Laufzeit-Ressourcen-Overlay überschreiben.

<item type="bool" name="enable_write_alerts_to_sms_inbox" />

Da die Erteilung von Berechtigungen nicht in den Zuständigkeitsbereich des CellBroadcast-Moduls fällt, müssen Sie dem CellBroadcast-Modul die Berechtigung AppOpsManager.OP_WRITE_SMS erteilen, um einen End-to-End-Support zu ermöglichen. Eine AOSP-Referenzimplementierung finden Sie in diesem SmsApplication.java-Patch.

CellBroadcastReceiver App starten

Die App „CellBroadcastReceiver“ hat die folgenden Startpunkte.

  • Das Menü der Einstellungen

  • Eine App (einschließlich Drittanbieter-Apps), z. B. eine Nachrichten-App, die mit dem Nachrichtenverlauf von CellBroadcast verknüpft ist.

  • Optional: Ein Startsymbol vom Android-Startbildschirm, das vom OEM hinzugefügt wurde. Weitere Informationen finden Sie unter Startsymbol hinzufügen.

Einstellungen für die App „CellBroadcastReceiver“

Die folgenden Screenshots zeigen das Menü „Einstellungen“ der App „CellBroadcastReceiver“.

Menü „Einstellungen der App CellBroadcastReceiver“

Abbildung 2: Menü „Einstellungen der App CellBroadcastReceiver“

Bisherige Notfall­benachrichtigungen

Abbildung 3: Bildschirm „Bisherige Notfallbenachrichtigungen“

Startsymbole hinzufügen

Sie können den Zugriff auf den Nachrichtenverlauf von CellBroadcast über den App Launcher und über Ihre eigenen Startsymbole aktivieren.

  • Wenn Sie den Zugriff auf den Nachrichtenverlauf über den App Launcher aktivieren möchten, überschreiben Sie die folgende Konfiguration mit einer RRO.

    <item type="bool" name="show_message_history_in_launcher" />

  • Wenn Sie das Standardsymbol von AOSP überschreiben möchten, überschreiben Sie die folgende Konfiguration mit einer RRO.

    <!-- Customize launcher icon for cellbroadcast history -->
<item type="mipmap" name="ic_launcher_cell_broadcast" />

CMAS-Sicherheitscode aktivieren

Wenn Sie den geheimen CMAS-Code *#*#CMAS#*#* (*#*#2627#*#* auf der Wähltastatur) aktivieren möchten, muss eine Telefonanruf-App auf den speziellen Wählcode in Form von *#*#code#*#* achten und den Code mit der öffentlichen Methode sendDialerSpecialCode verarbeiten.

Anforderung an Informationen zu Gebieten: Channel 50

Channel 50 ist ein spezieller Kanal, über den Mobilfunkanbieter standortbezogene Informationen senden können (außer MTN in Südafrika). Für diesen Kanal führen gestreamte Nachrichten nicht zu einem Dialogfeld oder einer Benachrichtigung. Stattdessen werden Broadcast-Nachrichten im SIM-Status des Einstellungsmenüs oder in der Statusleiste angezeigt (z. B. eine Postleitzahl).

Die Android CellBroadcastService-Implementierung unterstützt die folgenden APIs im Cell Broadcast-Dienst, damit die Einstellungen- und SysUI-Apps die Informationen zu Broadcast-Kanal 50 abrufen können. So implementieren Sie diese Empfehlung:

  • Registriere die Übertragung android.telephony.action.AREA_INFO_UPDATED und überschreibe den Namen des Empfängerpakets config_area_info_receiver_packages über eine RRO.

  • Binden Sie an CellBroadcastService.CELL_BROADCAST_SERVICE_INTERFACE.

Da die Einstellungen und die SysUI-Apps nicht zum CellBroadcast-Modul gehören, müssen Sie Ihre Änderungen in der SystemUI oder in den Einstellungen implementieren, um einen End-to-End-Support zu ermöglichen. Eine Referenzimplementierung finden Sie in der App CellBroadcastService Settings.

Personalisierung

Sie können den Quellcode des CellBroadcast-Moduls nicht direkt ändern. Mit Runtime Resource Overlays (RROs) können Sie jedoch Parameter aktivieren oder deaktivieren. So können Sie beispielsweise die Farbe von Benachrichtigungen und die Abmessungen von Dialogfeldern anpassen. Wenn Sie die Standardwerte der im CellBroadcast-Modul verwendeten Parameter überschreiben möchten, ändern Sie den Namen des Zielpakets in com.android.cellbroadcastreceiver. Darüber hinaus gilt Folgendes:

Wenn in der Implementierung keine Ressourcen für die Übersetzung von UI-Strings vorhanden sind oder die Übersetzungen nicht Ihren Erwartungen entsprechen, können Sie Übersetzungsressourcen mithilfe einer RRO überschreiben oder mit dem Google-Übersetzungsteam zusammenarbeiten, um Stringübersetzungen an das CellBroadcast-Modul weiterzuleiten. Wenn Sie die Übersetzungsressourcen überschreiben, muss Google diese Strings in overlayable.xml offenlegen, damit das Überschreiben möglich ist. Wenn Sie weitere Konfigurationen für die Anpassung der Benutzeroberfläche benötigen, wenden Sie sich an die CellBroadcast-Supportgruppe.

Daten migrieren

Android 11 enthält eine alte CellBroadcast-App, mit der App-Daten (einschließlich Nutzereinstellungen und Notfallwarnungsverläufe) für Geräte, die auf das CellBroadcast-Modul umstellen, beibehalten und migriert werden können. Android-Implementierungen, die das CellBroadcast-Modul verwenden, sollten die alte CellBroadcast-App in ihren Build für die Datenmigration einschließen. Wenn Sie in Ihrer Implementierung eine benutzerdefinierte CellBroadcast-Lösung verwenden, sollten Sie ein CellBroadcastContentProvider-APK definieren, um Daten zu erhalten. Sie können das alte CellBroadcast-APK in einer nachfolgenden Version problemlos entfernen.

Auf Geräten, die auf das CellBroadcast-Modul umgestellt wurden, ruft das Modul Daten entweder über die AOSP LegacyCellBroadcastApp oder das vom OEM definierte CellBroadcastContentProvider-APK über die genau definierte cellbroadcast-legacy-Autorität ab.

OEM-definiertes CellBroadcastContentProvider-APK verwenden

Wenn Sie ein CellBroadcastContentProvider-APK definieren, muss das APK diesen Spezifikationen entsprechen.

  • Das APK ist ein headless APK, das nur den Inhalt seiner Datenbank und SharedPreferences über ein ContentProvider-Objekt mit der cellbroadcast-legacy-Autorität anzeigt. Es ist nicht für Drittanbieter-Apps zugänglich.

  • Die APK wird vom OEM entwickelt und gehört ihm. Dort kann er sein ausgeblendetes API-Schema weiterhin hosten.

Wenn Sie SharedPreferences zum CellBroadcast-Modul migrieren möchten, muss das CellBroadcastContentProvider-APK die Methode ContentProvider.call mit den folgenden Parametern unterstützen:

  • Behörde: @SystemAPI CellBroadcast.LEGACY_CONTENT_URI
  • Methode: @SystemAPI CellBroadcast.CALL_METHOD_GET_PREFERENCE

  • Arg: @SystemAPI CellBroadcast.Preference

    Hier finden Sie eine Liste der unterstützten Schlüssel für freigegebene Einstellungen für das CellBroadcast-Modul. Die Daten stammen für die Methode ContentProvider.call von SharedPreferences.

Wenn Sie den Nachrichtenverlauf in das CellBroadcast-Modul migrieren möchten, muss das CellBroadcastContentProvider-APK die Methode ContentProvider.query mit den folgenden Parametern unterstützen:

  • Behörde: @SystemAPI CellBroadcast.LEGACY_CONTENT_URI. In den Abfragespalten sind die unterstützten Nachrichteneigenschaften für das CellBroadcast-Modul aufgeführt. Nimmt Daten (aus Ihrer Datenbank) für die ContentProvider.query-Methode auf.

Eine Referenzimplementierung für CellBroadcastContentProvider, finden Sie unter LegacyCellBroadcastContentProvider.

Testen

Die Android Compatibility Test Suite (CTS) prüft die Funktionalität von app-abhängigen System-APIs. Sie können auch das CellBroadcast-Modul unit tests/testappsp ausführen.

Wenn der OEM den geheimen CMAS-Code für ein Gerät aktiviert hat, kann dieses Gerät den Debug-Modus mit den folgenden Funktionen unterstützen.

  • Testbenachrichtigungen werden unter Sonstige Benachrichtigungen mit einer Ein-/Aus-Schaltfläche gruppiert.

  • Der Verlauf enthält alle Nachrichten, die empfangen, aber nicht angezeigt wurden, z. B. doppelte Nachrichten oder Nachrichten in einer anderen Sprache.

  • Für Nachrichten werden alle verfügbaren Parameter angezeigt, einschließlich Seriennummer, Nachrichten-ID und Ablaufdatum.

Wenn Sie den Debug-Modus aktivieren möchten, geben Sie im Dialer *#*#CMAS#*#* ein.

Kontakt

Weitere Informationen oder Fragen zum CellBroadcast-Modul richten Sie bitte an die CellBroadcast-Supportgruppe.