APN et CarrierConfig

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

Compte Google avec votre adresse e-mail professionnelle

Pour mettre à jour les informations 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 dans 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 à AOSP, 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 l'outil de suivi des problèmes Google 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. Après vous être connecté, cliquez sur Créer un problème sur la gauche de l'écran.
  3. Dans Component (Composant), sélectionnez Android Public Tracker > Framework.
  4. Poursuivez avec 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 :

Title: Ajouter/Modifier/Supprimer les APNs 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 :

Title: Modifications de la configuration pour CarrierXYZ

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. Modifiez le fichier.
  3. Validez les modifications apportées à votre dépôt local en suivant les instructions pour envoyer des correctifs. Veillez à respecter les consignes concernant les messages de validation, 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 réussie, repo 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 réviseurs spécifiques pour votre correctif

Syntaxe APN

Nom du projet Android : device/sample

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

Le fichier contient des paramètres APN au format XML et sert de fichier exemple. Le comportement des appareils Android ne change donc pas.

Voici à quoi ressemble généralement une configuration 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 APN.
  4. Dans les paramètres 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 Exemple d'APNs BICS pour obtenir un exemple de CL.

Syntaxe 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 concernés dans le dossier des composants en fonction du ou des tuples MCC/MNC concernés. Le fichier contient l'objet de configuration de l'opérateur au format XML. Les noms d'attributs sont définis comme clés sous CarrierConfigManager, et le type de valeur (int/string/bool) est indiqué par les suffixes.

Voici à quoi ressemblent les attributs int/string/bool classiques :

<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 de l'opérateur 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 que réviseur.
  • Vous pouvez également ajouter votre contact Google à la liste des destinataires en copie sur Gerrit.
  • Pour le suivi, vous pouvez attribuer le problème à android-carrier-config-review@google.com.

Une fois qu'une proposition 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.