APN et CarrierConfig

Les opérateurs peuvent mettre à jour leurs 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 Android Open Source (AOSP).

Compte Google avec votre adresse e-mail professionnelle

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

Si vous ne disposez pas d'un compte Google associé à votre adresse e-mail professionnelle , déconnectez-vous de tous les comptes Gmail de votre navigateur (nous vous recommandons d'utiliser une fonctionnalité de navigation privée, comme 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 à AOSP auparavant, vous devrez initialiser votre environnement de compilation, vous familiariser avec les outils et comprendre comment envoyer des correctifs :

De plus, nous vous recommandons vivement d'utiliser le Google Issue Tracker pour suivre les modifications.

Signaler un bug

  1. Accédez à issuetracker.google.com et connectez-vous à l'aide de votre adresse e-mail professionnelle (voir Compte Google avec votre adresse e-mail professionnelle).
  2. Une fois connecté, cliquez sur Create issue (Créer un problème) sur le côté gauche de l' écran.
  3. Dans Component (Composant), sélectionnez Android Public Tracker > Framework.
  4. Passez à la mise à jour de l'APN ou à la 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 :

Titre : Ajouter/Modifier/Supprimer des APN pour l'opérateur XYZ

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

Bug de CarrierConfig

Définissez les attributs du bug comme suit :

Titre : Modifications de la configuration pour l'opérateur XYZ

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

Valider les modifications

Pour apporter des modifications :

  1. Identifiez le fichier à modifier.
  2. Apportez des modifications au fichier.
  3. Validez les modifications dans votre dépôt local en suivant les instructions pour envoyer des correctifs, en prêtant attention aux consignes concernant le message 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 repo upload commande.
  5. Une fois l'importation réussie, 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 de l'APN

Nom du projet Android : device/sample

Nom(s) de fichier(s) : etc/apns-full-conf.xml (lien principal Google Git)

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

Voici à quoi ressemble généralement une configuration d'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"
/>

Tests

  1. Connectez n'importe quel 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 de l'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é des 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

Consultez la section Exemple d'APN BICS pour obtenir un exemple de LM.

Syntaxe de CarrierConfig

Nom du projet : platform/packages/apps/CarrierConfig

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

Identifiez le ou les fichiers XML pertinents dans le dossier "assets" à l'aide du ou des tuples MCC/MNC appropriés. Le fichier contient l'objet de configuration de l'opérateur au format XML. Les noms d'attribut sont définis comme des clés sous les CarrierConfigManager, et le type de valeur (int/string/bool) est indiqué par les suffixes.

Voici à quoi ressemblent généralement les attributs int/string/bool :

<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 d'opérateur mis à jour pour obtenir un exemple de LM.

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 CC sur Gerrit.
  • À des fins de suivi, vous pouvez modifier l'attributaire du problème en android-carrier-config-review@google.com.

Une fois qu'un envoi a passé le processus d'examen et de validation, 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.