CellBroadcast

Il modulo CellBroadcast riduce gli sforzi ripetitivi per gli OEM (il che a sua volta riduce la frammentazione nell'ecosistema Android e fornisce un comportamento coerente agli utenti finali) e contribuisce a semplificare i test e la certificazione degli operatori per i requisiti relativi a CellBroadcast (perché il codice non può essere modificato dagli OEM). Questo modulo è aggiornabile, il che significa che può ricevere aggiornamenti delle funzionalità al di fuori del normale ciclo di rilascio di Android.

Formato del pacchetto

Il modulo CellBroadcast è costituito dal seguente servizio e dalla seguente app.

  • Il servizio CellBroadcastService supporta la decodifica degli SMS CellBroadcast, il geofencing per l'avviso di emergenza wireless (WEA) 3.0, i controlli di duplicazione dei messaggi e la trasmissione dei messaggi alle app. Si tratta di un servizio di messaggistica geolocalizzata e geofenced uno-a-molti progettato per inviare messaggi a più utenti di telefoni cellulari, in un'area definita, contemporaneamente. Il servizio è definito dal comitato ETSI GSM, 3GPP e fa parte degli standard di telecomunicazione.

  • L'app CellBroadcastReceiver è un'app di sistema predefinita che gestisce avvisi di emergenza e non (ad esempio avvisi ambra e presidenziali) e presenta le informazioni agli utenti finali in base alle normative regionali e dell'operatore.

Flusso di messaggi CellBroadcast

La figura seguente mostra il flusso dei messaggi CellBroadcast.

Flusso di messaggi CellBroadcastReceiver

Figura 1. Flusso di messaggi CellBroadcastReceiver

  1. Il livello dell'interfaccia radio (RIL) invia una notifica a InBoundSMSHandler in merito a un SMS CellBroadcast CDMA/GSM.

  2. Il framework inoltra l'SMS CellBroadcast al modulo CBS per analizzare ed elaborare il messaggio in arrivo.

  3. Dopo l'elaborazione del messaggio, CellBroadcastService inoltra l'intent all'app CellBroadcastReceiver predefinita del sistema.

  4. L'app CellBroadcastReceiver mostra il messaggio all'utente.

Formato del modulo

CellBroadcastService e l'app CellBroadcastReceiver sono inclusi in un unico file APEX (com.android.cellbroadcast), disponibile per i dispositivi con Android 11 o versioni successive. Il modulo include codice in package/app/CellBroadcastReceiver e migra le classi del framework esistenti in packages/modules/CellBroadcastService.

Dipendenze del modulo

Il modulo CellBroadcast interagisce con il framework utilizzando solo API @SystemApi stabili (nessuna API @hide) e dipende dalle seguenti librerie statiche.

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

Puoi personalizzare la configurazione utilizzando gli overlay delle risorse di runtime (RRO).

Configurazione delle autorizzazioni

Il modulo CellBroadcast è firmato con una firma Google anziché con una firma della piattaforma, il che significa che il modulo perde l'accesso alle autorizzazioni di firma. Android 11 definisce invece la nuova autorizzazione di firma com.android.cellbroadcastservice.FULL_ACCESS_CELL_BROADCAST_HISTORY all'interno del modulo CellBroadcast; solo i pacchetti nel modulo possono ottenere l'autorizzazione perché sono firmati con la stessa chiave. Questa autorizzazione consente all'app CellBroadcastReceiver di avere accesso completo al database all'interno di CellBroadcastService.

La piattaforma concede l'autorizzazione di runtime android.permission.READ_CELL_BROADCASTS all'app per SMS di sistema predefinita per accedere alla cronologia degli avvisi di emergenza.

Integrare il modulo CellBroadcast

Questa sezione descrive come integrare il modulo CellBroadcast.

Eseguire l'integrazione con le impostazioni

Puoi decidere dove integrare le impostazioni di CellBroadcast nell'app Impostazioni (gli utenti finali accedono alla pagina delle impostazioni di CellBroadcast da Impostazioni > App e notifiche > Avanzate > Avviso di emergenza). Per avviare l'app CellBroadcastReceiver dall'app Impostazioni, modifica le seguenti configurazioni delle impostazioni con il nome del pacchetto com.android.cellbroadcastreceiver.

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

Integrare le app di messaggistica

Puoi integrare un link dell'app nelle app di messaggistica per aprire la cronologia dei messaggi CellBroadcast. Nell'app Android Messaggi, questa funzionalità è stata integrata in Impostazioni > Avanzate > Avviso di emergenza. Per integrare un link nella tua app di messaggistica, definisci il percorso nell'app di messaggistica e configura il nome del componente per il modulo CellBroadcast come com.android.cellbroadcastreceiver/com.android.cellbroadcastreceiver.CellBroadcastListActivity.

Integrare con la posta in arrivo SMS

Puoi attivare la visualizzazione dei messaggi CellBroadcast nell'app di messaggistica predefinita ignorando la seguente configurazione utilizzando una sovrapposizione di risorse di runtime.

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

Poiché la concessione delle autorizzazioni non rientra nell'ambito del modulo CellBroadcast, devi concedere l'autorizzazione AppOpsManager.OP_WRITE_SMS al modulo CellBroadcast per fornire supporto end-to-end. Per un'implementazione di riferimento AOSP, consulta questa patch SmsApplication.java.

Avvia l'app CellBroadcastReceiver

L'app CellBroadcastReceiver ha i seguenti punti di avvio.

  • Il menu dell'app Impostazioni.

  • Un'app (incluse app di terze parti) come un'app di messaggistica che si collega alla cronologia dei messaggi CellBroadcast.

  • (Facoltativo) Un'icona di avvio dalla schermata Home di Android aggiunta dall'OEM. Per maggiori dettagli, vedi Aggiungere un'icona di avvio.

Impostazioni dell'app CellBroadcastReceiver

Gli screenshot seguenti mostrano il menu delle impostazioni dell'app CellBroadcastReceiver.

Menu delle impostazioni dell&#39;app CellBroadcastReceiver

Figura 2. Menu delle impostazioni dell'app CellBroadcastReceiver

Cronologia avvisi di emergenza

Figura 3. Schermata Cronologia avvisi di emergenza

Aggiungere icone di avvio

Puoi attivare l'accesso alla cronologia dei messaggi CellBroadcast dal launcher delle app e tramite le tue icone di avvio.

  • Per attivare l'accesso alla cronologia dei messaggi dal menu di avvio delle app, esegui l'override della seguente configurazione utilizzando un RRO.

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

  • Per eseguire l'override dell'icona predefinita AOSP, esegui l'override della seguente configurazione utilizzando un RRO.

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

Attivare il codice segreto CMAS

Per attivare il codice segreto CMAS, *#*#CMAS#*#* (*#*#2627#*#* sul tastierino), un'app di composizione deve rilevare il codice speciale di composizione nel formato *#*#code#*#* e gestirlo utilizzando il metodo pubblico sendDialerSpecialCode.

Requisito per le informazioni sull'area: canale 50

Il canale 50 è un canale speciale per gli operatori che trasmettono informazioni relative all'area (ad eccezione di MTN in Sudafrica). Per questo canale, i messaggi di trasmissione non generano una finestra di dialogo o una notifica. I messaggi di trasmissione vengono visualizzati nello stato della SIM del menu Impostazioni o nella barra di stato (ad esempio la visualizzazione di un codice postale).

L'implementazione di Android CellBroadcastService fornisce supporto per le seguenti API nel servizio di trasmissione cellulare per le app Impostazioni e SysUI per ottenere le informazioni sul canale di trasmissione 50. Per implementare questa funzionalità:

  • Registra la trasmissione android.telephony.action.AREA_INFO_UPDATED ed esegui l'override del nome del pacchetto del destinatario config_area_info_receiver_packages tramite un RRO.

  • Associa a CellBroadcastService.CELL_BROADCAST_SERVICE_INTERFACE.

Poiché le app Impostazioni e SysUI non rientrano nell'ambito del modulo CellBroadcast, devi implementare le modifiche in SystemUI o nell'app Impostazioni per fornire supporto end-to-end. Per un'implementazione di riferimento, consulta l'app Impostazioni di CellBroadcastService.

Personalizzazione

Non puoi modificare direttamente il codice sorgente del modulo CellBroadcast, ma puoi utilizzare gli overlay delle risorse di runtime (RRO) per attivare (o disattivare) i parametri (ad esempio, puoi personalizzare il colore delle notifiche e le dimensioni delle finestre di dialogo). Per ignorare i valori predefiniti dei parametri utilizzati nel modulo CellBroadcast, modifica il nome del pacchetto di destinazione in com.android.cellbroadcastreceiver. Inoltre:

Se l'implementazione non include risorse di traduzione delle stringhe dell'interfaccia utente o se le traduzioni non soddisfano le tue aspettative, puoi eseguire l'override delle risorse di traduzione utilizzando un RRO o collaborare con il team di traduzione di Google per eseguire l'upstream delle traduzioni delle stringhe nel modulo CellBroadcast. Se sostituisci le risorse di traduzione, Google deve esporre queste stringhe in overlayable.xml per consentire la sostituzione. Se hai bisogno di ulteriori configurazioni per la personalizzazione della UI, contatta il gruppo di assistenza CellBroadcast.

Esegui migrazione dati

Android 11 include un'app CellBroadcast legacy, che è un meccanismo per conservare e migrare i dati delle app (incluse le impostazioni utente e le cronologie degli avvisi di emergenza) per i dispositivi che eseguono l'upgrade al modulo CellBroadcast. Le implementazioni Android che utilizzano il modulo CellBroadcast devono includere l'app CellBroadcast legacy nella build per la migrazione dei dati. Se la tua implementazione utilizza una soluzione CellBroadcast personalizzata, devi definire un APK CellBroadcastContentProvider per conservare i dati (puoi rimuovere in sicurezza l'APK CellBroadcast legacy in una release successiva).

Sui dispositivi aggiornati per utilizzare il modulo CellBroadcast, il modulo recupera i dati dall'app AOSP LegacyCellBroadcastApp o dall'APK CellBroadcastContentProvider definito dall'OEM tramite l'autorità cellbroadcast-legacy ben definita.

Utilizzare un APK CellBroadcastContentProvider definito dall'OEM

Quando definisci un APK CellBroadcastContentProvider, l'APK deve seguire queste specifiche.

  • L'APK è un APK headless che mostra solo i contenuti del suo database e SharedPreferences tramite un oggetto ContentProvider con l'autorità cellbroadcast-legacy e non è accessibile ad app di terze parti.

  • L'APK è sviluppato e di proprietà dell'OEM, che può continuare a ospitare il proprio schema API nascosto.

Per eseguire la migrazione di SharedPreferences al modulo CellBroadcast, l'APK CellBroadcastContentProvider deve supportare il metodo ContentProvider.call con i seguenti parametri:

  • Autorità: @SystemAPI CellBroadcast.LEGACY_CONTENT_URI
  • Metodo: @SystemAPI CellBroadcast.CALL_METHOD_GET_PREFERENCE

  • Arg: @SystemAPI CellBroadcast.Preference

    Questo è un elenco delle chiavi delle preferenze condivise supportate per il modulo CellBroadcast. I dati provengono da SharedPreferences per il metodo ContentProvider.call.

Per eseguire la migrazione della cronologia dei messaggi al modulo CellBroadcast, l'APK CellBroadcastContentProvider deve supportare il metodo ContentProvider.query con i seguenti parametri:

  • Autorità: @SystemAPI CellBroadcast.LEGACY_CONTENT_URI. Le colonne di query elencano le proprietà dei messaggi supportate per il modulo CellBroadcast. Riceve i dati (dal tuo database) per il metodo ContentProvider.query.

Per un'implementazione di riferimento per CellBroadcastContentProvider,, consulta LegacyCellBroadcastContentProvider.

Test

La suite di test di compatibilità (CTS) di Android verifica la funzionalità delle API di sistema dipendenti dalle app. Puoi anche eseguire il modulo CellBroadcast unit tests/testappsp.

Se l'OEM ha attivato il codice segreto CMAS per un dispositivo, quest'ultimo può supportare la modalità di debug con le seguenti funzionalità.

  • Le allerte di prova sono raggruppate nella sezione Altre allerte con un pulsante di attivazione/disattivazione.

  • La cronologia include tutti i messaggi ricevuti ma non visualizzati, ad esempio messaggi duplicati o messaggi in un'altra lingua.

  • I messaggi mostrano tutti i parametri disponibili, inclusi numero di serie, ID messaggio e data di scadenza.

Per attivare la modalità di debug, digita *#*#CMAS#*#* nel tastierino.

Contatto

Per ulteriori dettagli o domande sul modulo CellBroadcast, contatta il gruppo di assistenza CellBroadcast.