APN et CarrierConfig

Les opérateurs peuvent mettre à jour les informations sur le nom du point d'accès (APN) et leurs paramètres de configuration spécifiques à l'opérateur (CarrierConfig) dans le projet Open Source Android (AOSP).

Compte Google avec votre adresse e-mail professionnelle

Pour mettre à jour les informations de l'APN ou votre CarrierConfig, vous devez envoyer la demande à l'aide d'un compte Google associé à une adresse e-mail professionnelle active (par exemple, une demande de mise à jour de l'APN de l'entreprise Acme doit provenir d'une adresse e-mail telle que foobar@acme.com).

Si vous ne possédez pas de compte Google associé à votre adresse e-mail professionnelle, déconnectez-vous de tous les comptes Gmail depuis votre navigateur (nous vous recommandons d'utiliser une fonctionnalité de navigation privée, telle qu'une fenêtre de navigation privée, pour éviter toute confusion avec vos autres comptes), puis créez un compte Google avec votre adresse e-mail professionnelle.

Préparer un environnement de développement local

Si vous n'avez jamais envoyé de code à l'AOSP, vous devez initialiser votre environnement de compilation, vous familiariser avec les outils et comprendre comment envoyer des correctifs:

En outre, nous vous recommandons vivement d'utiliser le outil de suivi des problèmes Google pour suivre les modifications.

Signaler un bug

  1. Accédez à issuetracker.google.com et connectez-vous avec votre adresse e-mail professionnelle (voir Compte Google avec votre adresse e-mail professionnelle).
  2. Après vous être connecté, cliquez sur Créer un problème sur le côté gauche de l'écran.
  3. Dans Composant, sélectionnez Android Public Tracker > Framework.
  4. Passez à Mise à jour de l'APN ou à Mise à jour de CarrierConfig, selon le cas, pour saisir le titre et la description.

Bug de l'APN

Définissez les attributs du bug comme suit:

Title: Ajouter/Modifier/Supprimer des points d'accès pour CarrierXYZ

Description:ajoutez une description détaillée des modifications que vous demandez, y compris les paramètres APN eux-mêmes.

Bug CarrierConfig

Définissez les attributs du bug comme suit:

Titre:Modifications de configuration pour CarrierXYZ

Description:ajoutez une description détaillée des modifications que vous demandez.

Valider les modifications

Pour effectuer des modifications:

  1. Identifiez le fichier à modifier.
  2. Modifier le fichier.
  3. Committez les modifications dans votre dépôt local en suivant les instructions pour envoyer des correctifs, en prêtant attention aux consignes concernant les messages de commit, y compris le format recommandé.
  4. Une fois que vous avez validé votre modification dans votre historique personnel, importez-la dans Gerrit à l'aide de la commande repo upload.
  5. Une fois l'importation effectuée, le dépôt fournit l'URL d'une nouvelle page sur Gerrit. Utilisez cette URL pour :
    • Afficher votre correctif sur le serveur d'examen
    • Ajouter des commentaires
    • Demander des examinateurs spécifiques pour votre correctif

Syntaxe APN

Nom du projet Android : device/sample

Nom du ou des fichiers : etc/apns-full-conf.xml (Lien principal vers Google Git)

Le fichier contient des paramètres APN au format XML et sert d'exemple. Le comportement des appareils Android n'est donc pas modifié.

Voici à quoi ressemble une configuration APN type:

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

Tests

  1. Connectez un appareil Android pour lequel vous disposez d'un accès root.
  2. Ajoutez des paramètres à /etc/apns-conf.xml.
  3. Réinitialisez les paramètres APN.
  4. Dans les paramètres de l'APN, vérifiez que les profils sont chargés correctement.
  5. Pour chaque profil, testez la connectivité de données, le point d'accès Wi-Fi et les MMS pour vous assurer qu'ils fonctionnent correctement.

Message de commit

[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

Exemple de LM

Pour obtenir un exemple de CL, consultez Exemples d'APN BICS.

Syntaxe de CarrierConfig

Nom du projet : platform/packages/apps/CarrierConfig

Nom(s) de fichier : assets/carrier_config_.xml (Lien principal Google Git)

Identifiez le ou les fichiers XML pertinents dans le dossier des composants à l'aide de la ou des paires MCC/MNC appropriées. Le fichier contient l'objet de configuration de l'opérateur au format XML. Les noms d'attributs sont définis comme des clés sous CarrierConfigManager, et le type de valeur (int/chaîne/bool) est indiqué par les suffixes.

Les attributs int/string/bool standards se présentent comme suit:

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

Message de commit

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

Exemple de LM

Consultez un fichier de configuration du transporteur mis à jour pour obtenir un exemple de CL.

Demander un examen

Pour demander un examen:

  • Accédez à l'URL Gerrit de votre modification et ajoutez android-carrier-config-review@google.com en tant qu'examinateur.
  • Vous pouvez également ajouter votre contact Google à la liste de copie sur Gerrit.
  • À des fins de suivi, vous pouvez définir android-carrier-config-review@google.com comme responsable du problème.

Une fois qu'un envoi a été examiné et validé, Gerrit fusionne automatiquement la modification dans le dépôt public. Les autres utilisateurs peuvent exécuter repo sync pour extraire la mise à jour dans leur client local.