APN e CarrierConfig

Gli operatori possono aggiornare le informazioni sul nome dell'Access Point (APN) e le impostazioni di configurazione specifiche dell'operatore (CarrierConfig) nel progetto open source Android (AOSP).

Account Google con il tuo indirizzo email aziendale

Per aggiornare le informazioni APN o il CarrierConfig, devi inviare la richiesta utilizzando un Account Google con un indirizzo email aziendale attivo (ad esempio, una richiesta di aggiornamento APN della Società Acme deve provenire da un indirizzo email come foobar@acme.com).

Se non hai un Account Google collegato al tuo indirizzo email aziendale, esci da tutti gli account Gmail dal browser (consigliamo di utilizzare una funzionalità di navigazione privata, ad esempio una finestra di navigazione in incognito, per evitare confusione con gli altri account) e poi crea un Account Google con il tuo indirizzo email aziendale.

Preparare un ambiente di sviluppo locale

Se non hai mai inviato codice ad AOSP, devi inizializzare l'ambiente di compilazione, familiarizzare con gli strumenti e capire come inviare le patch:

Inoltre, ti consigliamo vivamente di utilizzare il tracker dei problemi di Google per monitorare le modifiche.

Segnala un bug

  1. Vai alla pagina issuetracker.google.com e accedi utilizzando il tuo indirizzo email aziendale (vedi Account Google con il tuo indirizzo email aziendale).
  2. Dopo aver eseguito l'accesso, fai clic su Crea problema sul lato sinistro della schermata.
  3. In Componente, seleziona Tracker pubblico Android > Framework.
  4. Vai ad Aggiornamento APN o Aggiornamento CarrierConfig, se opportuno, per inserire il titolo e la descrizione.

Bug APN

Imposta gli attributi del bug come segue:

Titolo: Aggiungere/modificare/rimuovere gli APN per l'operatore XYZ

Descrizione: aggiungi una descrizione dettagliata delle modifiche richieste, incluse le impostazioni APN stesse.

Bug di CarrierConfig

Imposta gli attributi del bug come segue:

Titolo: Modifiche alla configurazione per OperatoreXYZ

Descrizione: aggiungi una descrizione dettagliata delle modifiche che stai richiedendo.

Invia modifiche

Per apportare modifiche:

  1. Identifica il file da modificare.
  2. Apportare modifiche al file.
  3. Esegui il commit delle modifiche nel tuo repository locale seguendo le istruzioni per inviare patch, prestando attenzione alle linee guida per i messaggi di commit, incluso il formato consigliato.
  4. Dopo aver eseguito il commit della modifica nella tua cronologia personale, caricala su Gerrit utilizzando il comando repo upload.
  5. Dopo un caricamento riuscito, il repo fornisce l'URL di una nuova pagina su Gerrit. Utilizza questo URL per:
    • Visualizzare il patch sul server di revisione
    • Aggiungere commenti
    • Richiedere revisori specifici per la patch

Sintassi APN

Nome del progetto Android: device/sample

Nomi file: etc/apns-full-conf.xml (link principale di Google Git)

Il file contiene le impostazioni APN in formato XML e funge da file di esempio, pertanto il comportamento dei dispositivi Android non cambia.

Una configurazione APN tipica è la seguente:

<apn carrier="CarrierXYZ"
      mcc="123"
      mnc="123"
      apn="carrierxyz"
      type="default,supl,mms,ims,cbs"
      mmsc="http://mms.carrierxyz.com"
      mmsproxy="0.0.0.0"
      mmsport="80"
      bearer_bitmask="4|5|6|7|8|12"
/>

Test

  1. Collega qualsiasi dispositivo Android per cui disponi dell'accesso come utente root.
  2. Aggiungi le impostazioni a /etc/apns-conf.xml.
  3. Ripristina le impostazioni APN.
  4. Nelle impostazioni APN, verifica che i profili siano caricati correttamente.
  5. Per ogni profilo, verifica la connettività dati, l'hotspot Wi-Fi e l'MMS per assicurarti che funzionino correttamente.

Messaggio di commit

[Example - "Add CarrierXYZ apns to sample apns"]
Bug: [Issue ID from Google Issue Tracker]
Test: No change to behavior as this is only a sample file

Elenco modifiche di esempio

Per un esempio di CL, consulta APN BICS di esempio.

Sintassi di CarrierConfig

Nome progetto: platform/packages/apps/CarrierConfig

Nomi file: assets/carrier_config_.xml (link principale del repository Git di Google)

Identifica i file XML pertinenti nella cartella degli asset in base alle tuple MCC/MNC pertinenti. Il file contiene l'oggetto di configurazione dell'operatore in formato XML. I nomi degli attributi sono definiti come chiavi in CarrierConfigManager e il tipo di valore (int/stringa/bool) è indicato dai suffissi.

Gli attributi int/string/bool tipici hanno il seguente aspetto:

<int name="vvm_port_number_int" value="5499" />
<string name="vvm_type_string">vvm_type_omtp</string >
<boolean name="vvm_cellular_data_required_bool" value="true" />

Messaggio di commit

[Example - "Add VVM settings for CarrierXYZ"]

[Example - "Updated <mccmnc> carrier config file to include VVM settings
as defined by CarrierXYZ."]

Bug: [Issue ID from Google Issue Tracker]
Test: [Testing notes]

Elenco modifiche di esempio

Consulta un file di configurazione dell'operatore aggiornato per un esempio di CL.

Richiedi una revisione

Per richiedere una revisione:

  • Vai all'URL Gerrit della modifica e aggiungi android-carrier-config-review@google.com come revisore.
  • Puoi anche aggiungere il tuo contatto Google all'elenco Cc su Gerrit.
  • Per scopi di monitoraggio, puoi modificare l'assegnatario del problema in android-carrier-config-review@google.com.

Dopo che un invio supera la procedura di revisione e verifica, Gerrit unisce automaticamente la modifica al repository pubblico. Gli altri utenti possono eseguire repo sync per scaricare l'aggiornamento nel proprio client locale.