APN e CarrierConfig

Gli operatori possono aggiornare le informazioni sul nome punto di accesso (APN) e le impostazioni di configurazione specifiche dell'operatore (CarrierConfig) in Android Open Source Project (AOSP).

Account Google con il tuo indirizzo email aziendale

Per aggiornare le informazioni APN o CarrierConfig, devi inviare la richiesta utilizzando un Account Google con un indirizzo email aziendale attivo (ad esempio, una richiesta di aggiornamento APN di Acme Company 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 (ti 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.

Prepara un ambiente di sviluppo locale

Se non hai mai inviato codice ad AOSP, devi inizializzare l'ambiente di build, acquisire familiarità con gli strumenti e capire come inviare patch:

Inoltre, ti consigliamo vivamente di utilizzare Google Issue Tracker per monitorare le modifiche.

Segnala un bug

  1. Vai su 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 dello schermo.
  3. In Componente, seleziona Android Public Tracker > Framework.
  4. Continua con l'aggiornamento APN o con l'aggiornamento CarrierConfig, a seconda dei casi, per inserire il titolo e la descrizione.

Bug APN

Imposta gli attributi del bug come segue:

Title: Add/Modify/Remove APNs for CarrierXYZ

Descrizione: aggiungi una descrizione dettagliata delle modifiche che stai richiedendo, incluse le impostazioni APN.

Bug di CarrierConfig

Imposta gli attributi del bug come segue:

Titolo: Modifiche alla configurazione per CarrierXYZ

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

Invia modifiche

Per apportare modifiche:

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

Sintassi APN

Nome del progetto Android: dispositivo/esempio

Nome o nomi dei 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, quindi non vi è alcun cambiamento nel comportamento dei dispositivi Android.

Una tipica configurazione APN è simile a questa:

<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 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, testa la connettività dati, l'hotspot Wi-Fi e gli 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

Esempio di CL

Per un esempio di CL, vedi Sample BICS APNs.

Sintassi di CarrierConfig

Nome progetto: platform/packages/apps/CarrierConfig

Nome o nomi dei file: assets/carrier_config_.xml (Google Git main link)

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/booleano) è indicato dai suffissi.

I tipici attributi int/string/bool hanno questo 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]

Esempio di CL

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 tua modifica e aggiungi android-carrier-config-review@google.com come revisore.
  • Puoi anche aggiungere il tuo contatto Google all'elenco dei destinatari in copia conoscenza su Gerrit.
  • Ai fini del monitoraggio, puoi modificare l'assegnatario del problema in android-carrier-config-review@google.com.

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