APN e CarrierConfig

As operadoras podem atualizar as informações do nome do ponto de acesso (APN) 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 do APN ou sua CarrierConfig, você precisa de: enviar a solicitação usando uma Conta do Google com um e-mail corporativo ativo. (por exemplo, uma solicitação de atualização de APN da Acme Company deve vir de uma endereço de e-mail, como foobar@acme.com).

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

Preparar um ambiente de desenvolvimento local

Caso nunca tenha enviado um código ao AOSP antes, você vai precisar necessário para inicializar seu ambiente de build, familiarizar-se com as ferramentas e entender como enviar patches:

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

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 tela.
  3. Em Componente, selecione Android Public Tracker > Estrutura
  4. Prossiga para a atualização do APN ou CarrierConfig, conforme apropriado, para inserir o Título e a Descrição.

Bug do 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á fazendo solicitação, incluindo as próprias configurações do APN.

Bug de CarrierConfig

Defina os atributos do bug da seguinte maneira:

Título:Mudanças na configuração da operadoraXYZ

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

Enviar mudanças

Para fazer alterações:

  1. Identifique o arquivo que será alterado.
  2. Faça alterações no arquivo.
  3. Confirme as alterações no repositório local seguindo as instruções para enviar patches, prestar atenção às diretrizes das mensagens 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 repositório fornece o URL de uma nova página no Gerrit. Use este URL para:
    • Ver seu patch no servidor de revisão
    • Adicionar comentários
    • Solicitar revisores específicos para seu patch
.

Sintaxe do APN

Nome do projeto do Android: device/sample

Nomes dos arquivos: etc/apns-full-conf.xml (O Google link principal do Git)

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

Veja a seguir uma configuração típica de APN:

<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 raiz.
  2. Adicione configurações a /etc/apns-conf.xml.
  3. Redefinir configurações do APN.
  4. Nas configurações do APN, confirme se os perfis foram carregados corretamente.
  5. Para cada perfil, testar a conectividade de dados, o ponto de acesso Wi-Fi e o MMS para ter certeza de que funcionam 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 Exemplo de APNs do BICS para um exemplo de CL.

Sintaxe de CarrierConfig

Nome do projeto: platform/packages/apps/CarrierConfig

Nomes dos arquivos: assets/carrier_config_.xml (O Google link principal do Git)

Identifique os arquivos XML relevantes na pasta de recursos pela MCC/MNC relevante. tuplas. O arquivo contém o objeto de configuração da operadora no formato XML. A 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

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

Pedir uma revisão

Para pedir uma revisão, siga estas etapas:

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