APN e CarrierConfig

As operadoras podem atualizar as informações do nome do ponto de acesso (APN) e as configurações específicas da operadora ( CarrierConfig ) no Android Open Source Project (AOSP).

Conta do Google com seu endereço de e-mail corporativo

Para atualizar as informações de APN ou seu CarrierConfig, você precisa enviar a solicitação usando uma Conta do Google com um endereço de e-mail corporativo ativo (por exemplo, uma solicitação de atualização de APN da Acme Company deve vir de um endereço de e-mail como foobar@acme.com ).

Se você não tiver uma Conta do Google vinculada ao seu endereço de e-mail corporativo, saia de todas as contas do Gmail no seu navegador (recomendamos usar um recurso de navegação privada, como uma janela anônima, para evitar confusão com suas outras contas) e depois crie uma conta do Google com seu endereço de e-mail corporativo .

Preparar um ambiente de desenvolvimento local

Se você nunca enviou código ao AOSP antes, precisará inicializar seu ambiente de compilação, familiarizar-se com as ferramentas e entender como enviar patches:

Além disso, recomendamos fortemente que você use o Google Issue Tracker para rastrear alterações.

Registrar um bug

  1. Acesse issuetracker.google.com e faça login usando seu endereço de e-mail corporativo (consulte Conta do Google com seu endereço de e-mail corporativo ).
  2. Após fazer login, clique em Criar problema no lado esquerdo da tela.
  3. Em Componente , selecione Android Public Tracker > Framework
  4. Continue para APN update ou CarrierConfig update , conforme apropriado, para inserir o título e a descrição.

Bug de APN

Defina os atributos do bug da seguinte maneira:

Título: Adicionar / Modificar / Remover APNs para CarrierXYZ

Descrição: adicione uma descrição detalhada das alterações que você está solicitando, incluindo as próprias configurações de APN.

Bug CarrierConfig

Defina os atributos do bug da seguinte maneira:

Título: Mudanças de configuração para CarrierXYZ

Descrição: adicione uma descrição detalhada das alterações que você está solicitando.

Enviar alterações

Para fazer alterações:

  1. Identifique qual arquivo alterar.
  2. Faça alterações no arquivo.
  3. Confirme as alterações em seu repositório local seguindo as instruções para enviar patches , prestando atenção às diretrizes da mensagem de commit, incluindo o formato recomendado.
  4. Depois de confirmar a alteração em seu histórico pessoal, carregue-a no Gerrit usando o comando repo upload .
  5. Após um upload bem-sucedido, o repositório fornece o URL de uma nova página no Gerrit. Use este URL para:
    • Veja seu patch no servidor de revisão
    • Adicione comentários
    • Solicite revisores específicos para seu patch

Sintaxe APN

Nome do projeto Android – dispositivo/amostra

Nome(s) do(s) arquivo(s) - etc/apns-full-conf.xml ( link principal do Google Git )

O arquivo contém configurações de APN em formato XML e serve como arquivo de amostra para que não haja alteração no comportamento dos dispositivos Android.

Uma configuração típica de APN é assim:

<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"
/>

Teste

  1. Conecte qualquer dispositivo Android ao qual você tenha acesso root.
  2. Adicione configurações a /etc/apns-conf.xml.
  3. Redefinir as configurações de APN.
  4. Nas configurações de APN, confirme se os perfis estão carregados corretamente.
  5. Para cada perfil, teste a conectividade de dados, o ponto de acesso Wi-Fi e o MMS para garantir que funcionam corretamente.

Confirmar mensagem

[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

Exemplo de CL

Consulte Exemplos de APNs BICS para obter um exemplo de CL.

Sintaxe CarrierConfig

Nome do projeto – plataforma/pacotes/apps/CarrierConfig

Nome(s) do(s) arquivo(s) - assets/carrier_config_ .xml ( link principal do Google Git )

Identifique os arquivos XML relevantes na pasta de ativos pelas tuplas MCC/MNC relevantes. O arquivo contém o objeto de configuração da operadora em formato XML. Os nomes dos atributos são definidos como chaves no CarrierConfigManager e o tipo de valor (int/string/bool) é indicado pelos sufixos.

Os atributos int/string/bool típicos são assim:

<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" />

Confirmar mensagem

[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]

Exemplo de CL

Consulte um arquivo de configuração da operadora atualizado para obter um exemplo de CL.

Solicite uma revisão

Para solicitar uma revisão:

  • Vá para o URL Gerrit da sua alteração e adicione android-carrier-config-review@google.com como revisor.
  • Você também pode adicionar seu contato do Google à lista CC do Gerrit.
  • Para fins de rastreamento, você pode alterar o responsável pelo problema para android-carrier-config-review@google.com .

Depois que um envio passa pelo processo de revisão e verificação, Gerrit mescla automaticamente a alteração no repositório público. Outros usuários podem executar repo sync para enviar a atualização para seu cliente local.