APN et CarrierConfig

Les opérateurs peuvent mettre à jour leurs informations de nom de 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 APN ou votre CarrierConfig, vous devez soumettre la demande à l'aide d'un compte Google avec une adresse e-mail d'entreprise active (par exemple, une demande de mise à jour 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 lié à 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, 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 soumis de code à AOSP auparavant, vous devrez initialiser votre environnement de build, vous familiariser avec les outils et comprendre comment soumettre des correctifs :

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

Déposer 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 le côté gauche de l'écran.
  3. Dans Composant , sélectionnez Android Public Tracker > Framework
  4. Continuez vers la mise à jour APN ou la mise à jour CarrierConfig , selon le cas, pour saisir le titre et la description.

Bogue APN

Définissez les attributs du bug comme suit :

Titre : Ajouter / Modifier / Supprimer des APN pour CarrierXYZ

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

Bogue de CarrierConfig

Définissez les attributs du bug comme suit :

Titre : Modifications de la configuration pour CarrierXYZ

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

Soumettre des changements

Pour apporter des modifications :

  1. Identifiez le fichier à modifier.
  2. Apportez des modifications au fichier.
  3. Validez les modifications dans votre référentiel local en suivant les instructions de soumission des correctifs , en prêtant attention aux directives des messages de validation, y compris le format recommandé.
  4. Après avoir validé votre modification dans votre historique personnel, téléchargez-la sur Gerrit à l'aide de la commande repo upload .
  5. Suite à un téléchargement réussi, le repo fournit l'URL d'une nouvelle page sur Gerrit. Utilisez cette URL pour :
    • Affichez votre correctif sur le serveur de révision
    • Ajoutez des commentaires
    • Demandez des réviseurs spécifiques pour votre correctif

Syntaxe APN

Nom du projet Android – appareil/échantillon

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

Le fichier contient les paramètres APN au format XML et sert de fichier exemple afin qu'il n'y ait aucun changement dans le comportement des appareils Android.

Une configuration APN typique ressemble à ceci :

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

Essai

  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 correctement chargés.
  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 validation

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

Voir Exemples d'APN BICS pour 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(s) fichier(s) XML pertinent(s) dans le dossier d'actifs par le(s) tuple(s) MCC/MNC concerné(s). Le fichier contient l'objet de configuration du transporteur au format XML. Les noms d'attribut sont définis sous forme de clés sous CarrierConfigManager et le type de valeur (int/string/bool) est indiqué par les suffixes.

Les attributs int/string/bool typiques ressemblent à ceci :

<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 validation

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

Consultez un fichier de configuration d'opérateur mis à jour pour un exemple de CL.

Demander un avis

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 CC sur Gerrit.
  • À des fins de suivi, vous pouvez remplacer le responsable du problème par android-carrier-config-review@google.com .

Une fois qu'une soumission a franchi le processus d'examen et de vérification, Gerrit fusionne automatiquement la modification dans le référentiel public. D'autres utilisateurs peuvent exécuter repo sync pour extraire la mise à jour sur leur client local.