APN y CarrierConfig

Los operadores pueden actualizar la información del nombre del punto de acceso (APN) y los parámetros de configuración específicos 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 corporativa, 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 al 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 Google Issue Tracker 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 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 Component, 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: 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 debes cambiar.
  2. Realiza cambios en el archivo.
  3. Confirma los cambios en tu repositorio local siguiendo las instrucciones para enviar parches y prestando 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 cargado correctamente, el repositorio 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

Nombre(s) de archivo: etc/apns-full-conf.xml (Vínculo principal de Git de Google)

El archivo contiene la configuración del APN en formato XML y sirve como archivo de muestra, por lo que no hay cambios en el comportamiento de los dispositivos Android.

Una configuración típica de APN 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 administrador.
  2. Agrega parámetros de configuración a /etc/apns-conf.xml.
  3. Restablece la configuración del APN.
  4. En la configuración del APN, confirma que los perfiles se hayan cargado 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

CL de muestra

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

Sintaxis de CarrierConfig

Nombre del proyecto: platform/packages/apps/CarrierConfig

Nombre(s) de archivo: assets/carrier_config_.xml (Vínculo principal de Git de Google)

Identifica los archivos XML pertinentes en la carpeta de recursos por las tuplas de MCC/MNC correspondientes. 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 típicos de int/string/bool 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]

CL de muestra

Consulta un archivo de configuración de 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 fines de seguimiento, puedes cambiar el asignatario 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.