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 de código aberto do Android (AOSP).

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

Para atualizar as informações de APN ou o 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 de APN da Acme Company precisa ser enviada 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 navegador. Recomendamos usar um recurso de navegação privada, 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, será necessário inicializar o ambiente de build, conhecer 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 Componente, selecione Android Public Tracker > Framework.
  4. Continue com a atualização da APN ou CarrierConfig, conforme necessário, 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á solicitando, incluindo as próprias configurações de APN.

Bug do 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 mudanças que você está solicitando.

Enviar mudanças

Para fazer mudanças:

  1. Identifique o arquivo que precisa ser mudado.
  2. Faça mudanças no arquivo.
  3. Confirme as mudanças no repositório local seguindo as instruções para enviar patches. Preste atenção às diretrizes de mensagens de commit, 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 fornece o URL de uma nova página no Gerrit. Use este URL para:
    • Ver seu 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 Google Git)

O arquivo contém configurações de APN em formato XML e serve como um arquivo de amostra. Portanto, não há mudança 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 com acesso root.
  2. Adicione configurações a /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, o hotspot 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

CL de exemplo

Consulte Exemplo de APNs do BICS para ver um CL de exemplo.

Sintaxe do 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 "assets" pelas tuplas de 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 em CarrierConfigManager, e o tipo de valor (int/string/bool) é indicado pelos sufixos.

Os atributos típicos int/string/bool 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]

CL de exemplo

Confira um arquivo de configuração de operadora atualizado para ver 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.
  • Você também pode adicionar seu contato do Google à lista de CC no Gerrit.
  • Para fins de acompanhamento, mude o destinatário 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.