APN et CarrierConfig

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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 Open Source Android (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 d'Acme Company doit provenir d'une adresse e-mail telle que foobar@acme.com ).

Si vous n'avez pas de compte Google lié à votre adresse e-mail professionnelle, déconnectez-vous de tous les comptes Gmail depuis votre navigateur (nous vous recommandons d'utiliser une fonction 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 construction, vous familiariser avec les outils et comprendre comment soumettre des correctifs :

En outre, nous vous recommandons vivement d'utiliser Google Issue Tracker pour suivre les modifications.

Signaler un bogue

  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 Créer un problème sur le côté gauche de l'écran.
  3. Dans Composant , sélectionnez Android Public Tracker > Framework
  4. Passez à la mise à jour APN ou à la mise à jour CarrierConfig , selon le cas, pour entrer le titre et la description.

Bogue APN

Définissez les attributs de bogue 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 CarrierConfig

Définissez les attributs de bogue 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 du message 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, repo fournit l'URL d'une nouvelle page sur Gerrit. Utilisez cette URL pour :
    • Afficher votre correctif sur le serveur de révision
    • Ajoutez des commentaires
    • Demander 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 Google Git master )

Le fichier contient les paramètres APN au format XML et sert d'exemple de fichier 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 avez 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 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

Échantillon CL

Voir Exemples d'APN BICS pour un exemple CL.

Syntaxe CarrierConfig

Nom du projet : plate-forme/packages/apps/CarrierConfig

Nom(s) de fichier - assets/carrier_config_ .xml ( lien maître Google Git )

Identifiez le(s) fichier(s) XML pertinent(s) dans le dossier des actifs par le(s) tuple(s) MCC/MNC pertinent(s). 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 le CarrierConfigManager et le type de valeur (int/string/bool) est indiqué par les suffixes.

Les attributs typiques int/string/bool 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]

Échantillon CL

Voir un fichier de configuration de transporteur mis à jour pour un exemple CL.

Demander un avis

Pour demander une révision :

  • 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 destinataire 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. Les autres utilisateurs peuvent exécuter la repo sync du référentiel pour extraire la mise à jour dans leur client local.