Cellulare

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 consente di semplificare i test e la certificazione dell'operatore 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 dall'app.

  • Il servizio CellBroadcastService supporta la decodifica degli SMS CellBroadcast, la recinzione virtuale per l'avviso di emergenza wireless (WEA) 3.0, i controlli di duplicazione dei messaggi e la trasmissione di messaggi alle app. Si tratta di un servizio di messaggistica one-to-many con targeting geografico e recinti virtuali progettato per inviare contemporaneamente messaggi a più utenti di cellulari in un'area definita. Il servizio è definito dal comitato GSM dell'ETSI, 3GPP e fa parte degli standard di telecomunicazione.

  • L'app CellBroadcastReceiver è un'app di sistema predefinita che gestisce gli avvisi di emergenza e non di emergenza (ad esempio gli avvisi di avviso 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 di CellBroadcastReceiver

Figura 1. Flusso di messaggi di CellBroadcastReceiver

  1. Il livello di interfaccia radio (RIL) invia una notifica a InBoundSMSHandler su un SMS di CellBroadcast CDMA/GSM.

  2. Il framework inoltra l'SMS di CellBroadcast al modulo CBS per analizzare e 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

Le app CellBroadcastService e CellBroadcastReceiver sono incluse in un singolo file APEX (com.android.cellbroadcast), disponibile per i dispositivi con Android 11 o versioni successive. Il modulo include il codice in package/app/CellBroadcastReceiver ed esegue la migrazione delle classi del framework esistenti a packages/modules/CellBroadcastService.

Dipendenze del modulo

Il modulo CellBroadcast interagisce con il framework utilizzando solo @SystemApi stabile (senza API @hide) e dipende dalle librerie statiche riportate di seguito.

  • 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 autorizzazioni

Il modulo CellBroadcast è firmato con una firma di 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 poiché 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 all'app SMS di sistema predefinita l'autorizzazione di runtime android.permission.READ_CELL_BROADCASTS 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 di impostazione 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>

Integrazione con app di messaggistica

Puoi integrare un link a un'app nelle app di messaggistica per aprire la cronologia dei messaggi di 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 com.android.cellbroadcastreceiver/com.android.cellbroadcastreceiver.CellBroadcastListActivity il nome del componente per il modulo CellBroadcast.

Integra con la Posta in arrivo SMS

Puoi attivare la visualizzazione dei messaggi CellBroadcast nell'app di messaggistica predefinita overriding la seguente configurazione utilizzando un overlay delle 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 assistenza end-to-end. Per un'implementazione di riferimento AOSP, fai riferimento a questa patch SmsApplication.java.

Avvia l'app CellBroadcastReceiver

L'app CellBroadcastReceiver ha i seguenti punti di lancio.

  • Il menu dell'app Impostazioni.

  • Un'app (incluse app di terze parti), ad esempio un'app di messaggistica, che rimanda 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 lancio.

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 della cronologia degli avvisi di emergenza

Aggiungere icone di avvio

Puoi abilitare l'accesso alla cronologia dei messaggi di CellBroadcast da Avvio applicazioni e tramite le tue icone di lancio.

  • Per consentire l'accesso alla cronologia dei messaggi dal programma di avvio app, sostituisci la seguente configurazione utilizzando un RRO.

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

  • Per eseguire l'override dell'icona predefinita di AOSP, sostituisci la 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 Telefono deve ascoltare il codice speciale del tastierino sotto forma di *#*#code#*#* e gestirlo utilizzando il metodo pubblico sendDialerSpecialCode.

Requisito relativo alle informazioni sull'area: canale 50

Il canale 50 è un canale speciale per le emittenti che trasmettono informazioni relative all'area (tranne 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 il supporto per le seguenti API nel servizio di trasmissione cellulare per consentire alle app Impostazioni e UI del sistema di ricevere le informazioni del canale di trasmissione 50. Per implementarlo, segui questi passaggi:

  • Registra la trasmissione android.telephony.action.AREA_INFO_UPDATED e sostituisci il nome del pacchetto del ricevitore config_area_info_receiver_packages tramite un RRO.

  • Esegui il binding a CellBroadcastService.CELL_BROADCAST_SERVICE_INTERFACE.

Poiché le app Impostazioni e SystemUI non rientrano nell'ambito del modulo CellBroadcast, devi implementare le modifiche in SystemUI o nell'app Impostazioni per fornire assistenza end-to-end. Per un'implementazione di riferimento, consulta l'app Impostazioni 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 nelle finestre di dialogo). Per sostituire i valori predefiniti dei parametri utilizzati nel modulo CellBroadcast, modifica il nome del pacchetto di destinazione incom.android.cellbroadcastreceiver. Inoltre:

Se nell'implementazione mancano le risorse di traduzione delle stringhe dell'interfaccia utente o se le traduzioni non soddisfano le tue aspettative, puoi sostituire le risorse di traduzione utilizzando un RRO o collaborare con il team di traduzione di Google per inviare le traduzioni delle stringhe al 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 dell'interfaccia utente, contatta il gruppo di assistenza di CellBroadcast.

Esegui migrazione dati

Android 11 include un'app CellBroadcast precedente, che è un meccanismo per preservare e eseguire la migrazione dei 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 precedente 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 precedente in una release successiva).

Sui dispositivi di cui è stato eseguito l'upgrade per l'utilizzo del modulo CellBroadcast, il modulo recupera i dati dall'AOSP LegacyCellBroadcastApp o dall'APK CellBroadcastContentProvider definito dall'OEM tramite l'autorità cellbroadcast-legacy.

Utilizzare un APK CellBroadcastContentProvider definito dall'OEM

Quando definisci un APK CellBroadcastContentProvider, questo deve rispettare queste specifiche.

  • L'APK è un APK headless che mostra solo i contenuti del relativo database e SharedPreferences tramite un oggetto ContentProvider con l'autorità cellbroadcast-legacy e non è accessibile alle 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. Acquisisce 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à Android (CTS) verifica la funzionalità delle API di sistema dipendenti dall'app. Puoi anche eseguire il modulo CellBroadcast unit tests/testappsp.

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

  • Gli avvisi di test sono raggruppati in Altri avvisi con un pulsante di attivazione/disattivazione.

  • La cronologia include tutti i messaggi ricevuti, ma non visualizzati, ad esempio messaggi duplicati o 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, componi *#*#CMAS#*#* sulla tastiera.

Contatto

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