APN e CarrierConfig

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

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

Para atualizar as informações do APN ou da CarrierConfig, envie 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 do APN da Empresa Acme precisa 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 anônima, como uma janela anônima, para evitar confusão com suas outras contas. 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 para o AOSP, vai precisar inicializar o ambiente de build, se familiarizar com as ferramentas e entender como enviar patches:

Além disso, recomendamos que você use o Google Issue Tracker para acompanhar as mudanças.

Informar 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. Depois de fazer login, clique em Criar problema no lado esquerdo da tela.
  3. Em Component, 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 mudanças que você está pedindo, incluindo as próprias configurações da APN.

Bug da CarrierConfig

Defina os atributos do bug da seguinte maneira:

Título:mudanças na configuração para CarrierXYZ

Descrição:adicione uma descrição detalhada das mudanças que você está pedindo.

Enviar mudanças

Para fazer mudanças:

  1. Identifique qual arquivo precisa ser alterado.
  2. Faça alterações no arquivo.
  3. Confirme as mudanças no 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 a mudança do seu histórico pessoal, faça upload dela para o Gerrit usando o comando repo upload.
  5. Após um upload bem-sucedido, o repo vai fornecer o URL de uma nova página no Gerrit. Use este URL para:
    • Conferir o patch no servidor de análise
    • Adicionar comentários
    • Solicitar revisores específicos para seu patch

Sintaxe APN

Nome do projeto Android: device/sample

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

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

Uma configuração típica de APN tem esta aparência:

<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 em que você tenha acesso de raiz.
  2. Adicione as configurações a /etc/apns-conf.xml.
  3. Redefina as configurações do APN.
  4. Nas configurações da APN, confirme se os perfis estão sendo carregados corretamente.
  5. Para cada perfil, teste a conectividade de dados, o ponto de acesso Wi-Fi e o MMS para garantir que eles funcionem corretamente.

Mensagem de confirmação

[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 de BICS para conferir um exemplo de CL.

Sintaxe de CarrierConfig

Nome do projeto: platform/packages/apps/CarrierConfig

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

Identifique os arquivos XML relevantes na pasta de recursos pelas tuplas MCC/MNC relevantes. 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 int/string/bool típicos têm esta aparência:

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

Mensagem de confirmação

[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 conferir um exemplo de CL.

Pedir uma revisão

Para pedir uma revisão, siga estas etapas:

  • Acesse o URL do Gerrit da sua mudança e adicione android-carrier-config-review@google.com como revisor.
  • Também é possível adicionar seu contato do Google à lista de CC no Gerrit.
  • Para fins de rastreamento, você pode mudar o atribuído do 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 mudança no repositório público. Outros usuários podem executar repo sync para transferir a atualização para o cliente local deles.