APN y CarrierConfig

Los operadores pueden actualizar la información del nombre de punto de acceso (APN) y su configuración específica del operador (CarrierConfig) en el proyecto de código abierto de Android (AOSP).

Cuenta de Google con tu dirección de correo electrónico empresarial

Para actualizar la información del APN o tu CarrierConfig, debes enviar la solicitud con una Cuenta de Google que tenga una dirección de correo electrónico empresarial activa (por ejemplo, una solicitud de actualización del APN de Acme Company debe provenir de una dirección de correo electrónico como foobar@acme.com).

Si no tienes una Cuenta de Google vinculada a tu dirección de correo electrónico corporativo, sal de todas las cuentas de Gmail desde tu navegador (te recomendamos que uses una función de navegación privada, como una ventana de incógnito, para evitar confusiones con tus otras cuentas) y, luego, crea una Cuenta de Google con tu dirección de correo electrónico corporativa.

Prepara un entorno de desarrollo local

Si nunca enviaste código a AOSP, deberás inicializar tu entorno de compilación, familiarizarte con las herramientas y comprender cómo enviar parches:

Además, te recomendamos que uses el Registrador de problemas de Google para hacer un seguimiento de los cambios.

Informa un error

  1. Ve a issuetracker.google.com y accede con tu dirección de correo electrónico corporativa (consulta Cómo usar una Cuenta de Google con tu dirección de correo electrónico corporativa).
  2. Después de acceder, haz clic en Crear problema en el lado izquierdo de la pantalla.
  3. En Componente, selecciona Android Public Tracker > Framework.
  4. Continúa con la actualización de APN o la actualización de CarrierConfig, según corresponda, para ingresar el título y la descripción.

Error de APN

Establece los atributos del error de la siguiente manera:

Título: Cómo agregar/modificar/quitar APN para CarrierXYZ

Descripción: Agrega una descripción detallada de los cambios que solicitas, incluida la configuración del APN.

Error de CarrierConfig

Establece los atributos del error de la siguiente manera:

Título: Cambios de configuración para CarrierXYZ

Descripción: Agrega una descripción detallada de los cambios que solicitas.

Cómo enviar cambios

Para realizar cambios, sigue estos pasos:

  1. Identifica qué archivo quieres cambiar.
  2. Realiza cambios en el archivo.
  3. Confirma los cambios en tu repositorio local. Para ello, sigue las instrucciones para enviar parches y presta atención a los lineamientos de los mensajes de confirmación, incluido el formato recomendado.
  4. Después de confirmar el cambio en tu historial personal, súbelo a Gerrit con el comando repo upload.
  5. Cuando se haya subido correctamente, el repositorio te proporcionará la URL de una página nueva en Gerrit. Usa esta URL para lo siguiente:
    • Cómo ver tu parche en el servidor de revisión
    • Agregar comentarios
    • Solicita revisores específicos para tu parche

Sintaxis de APN

Nombre del proyecto de Android: device/sample

Nombres de archivo: etc/apns-full-conf.xml (vínculo principal de Google Git)

El archivo contiene la configuración de APN en formato XML y sirve como archivo de muestra para que no haya cambios en el comportamiento de los dispositivos Android.

Una configuración de APN típica se ve de la siguiente manera:

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

Prueba

  1. Conecta cualquier dispositivo Android al que tengas acceso de raíz.
  2. Agrega la configuración a /etc/apns-conf.xml.
  3. Restablece la configuración del APN.
  4. En la configuración de APN, confirma que los perfiles se carguen correctamente.
  5. Para cada perfil, prueba la conectividad de datos, el hotspot Wi-Fi y los MMS para asegurarte de que funcionen correctamente.

Mensaje de confirmación

[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

Ejemplo de CL

Consulta APN de BICS de muestra para ver un ejemplo de CL.

Sintaxis de CarrierConfig

Nombre del proyecto: platform/packages/apps/CarrierConfig

Nombres de archivo: assets/carrier_config_.xml (vínculo principal de Google Git)

Identifica los archivos en formato XML relevantes en la carpeta de recursos según las tuplas de MCC/MNC relevantes. El archivo contiene el objeto de configuración del operador en formato XML. Los nombres de los atributos se definen como claves en CarrierConfigManager, y los sufijos indican el tipo de valor (int/string/bool).

Los atributos int, string y bool típicos se ven de la siguiente manera:

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

Mensaje de confirmación

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

Ejemplo de CL

Consulta un archivo de configuración del operador actualizado para ver un ejemplo de CL.

Solicita una revisión

Para solicitar una revisión, haz lo siguiente:

  • Ve a la URL de Gerrit de tu cambio y agrega android-carrier-config-review@google.com como revisor.
  • También puedes agregar tu contacto de Google a la lista de Cc en Gerrit.
  • Para realizar un seguimiento, puedes cambiar el encargado del problema a android-carrier-config-review@google.com.

Cuando un envío pasa por los procesos de revisión y verificación, Gerrit combina el cambio automáticamente en el repositorio público. Otros usuarios pueden ejecutar repo sync para implementar la actualización en su cliente local.