APN e CarrierConfig

As operadoras podem atualizar suas informações de Access Point Name (APN) e suas definições de configuração 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 em seu navegador (recomendamos usar um recurso de navegação privada, como uma janela anônima, para evitar confusão com suas outras contas) e, em seguida, 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 que você use o Google Issue Tracker para acompanhar as 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 Component , selecione Android Public Tracker > Framework
  4. Continue com a atualização do APN ou a atualização do CarrierConfig , conforme apropriado, para inserir o título e a descrição.

Erro de APN

Defina os atributos do bug da seguinte forma:

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 forma:

Título: Alterações 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 as 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 confirmação, incluindo o formato recomendado.
  4. Depois de confirmar sua 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 a URL de uma nova página no Gerrit. Use este URL para:
    • Visualize seu patch no servidor de revisão
    • Adicione comentários
    • Solicite revisores específicos para seu patch

Sintaxe do APN

Nome do projeto Android - dispositivo/amostra

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

O arquivo contém as configurações de APN no 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 se parece com isso:

<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 para o qual você tenha acesso root.
  2. Adicione configurações ao /etc/apns-conf.xml.
  3. Redefina as configurações de APN.
  4. Nas configurações de APN, confirme se os perfis foram carregados corretamente.
  5. Para cada perfil, teste a conectividade de dados, ponto de acesso Wi-Fi e MMS para garantir que funcionem 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 APNs BICS de amostra para obter um CL de exemplo.

Sintaxe CarrierConfig

Nome do projeto - platform/packages/apps/CarrierConfig

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

Identifique o(s) arquivo(s) XML relevante(s) na pasta de ativos pela(s) tupla(s) MCC/MNC relevante(s). O arquivo contém o objeto de configuração da operadora no 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 típicos int/string/bool 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

Veja um arquivo de configuração de operadora atualizado para um exemplo de CL.

Solicite uma revisão

Para solicitar uma revisão:

  • Acesse 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 no 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, o Gerrit mescla automaticamente a alteração no repositório público. Outros usuários podem executar a repo sync para obter a atualização em seu cliente local.