APN und CarrierConfig

Mobilfunkanbieter können ihre APN-Informationen (Access Point Name) und ihre anbieterspezifischen Konfigurationseinstellungen (CarrierConfig) im Android Open Source Project (AOSP) aktualisieren.

Google-Konto mit Ihrer geschäftlichen E-Mail-Adresse

Wenn Sie APN-Informationen oder Ihre CarrierConfig aktualisieren möchten, müssen Sie den Antrag über ein Google-Konto mit einer aktiven geschäftlichen E-Mail-Adresse einreichen. Ein APN-Aktualisierungsantrag von Acme Company sollte beispielsweise von einer E-Mail-Adresse wie foobar@acme.com stammen.

Wenn Sie kein Google-Konto haben, das mit Ihrer geschäftlichen E-Mail-Adresse verknüpft ist, melden Sie sich in Ihrem Browser von allen Gmail-Konten ab. Wir empfehlen, eine Funktion für die private Browsernutzung wie ein Inkognitofenster zu verwenden, um Verwechslungen mit Ihren anderen Konten zu vermeiden. Erstellen Sie dann ein Google-Konto mit Ihrer geschäftlichen E-Mail-Adresse.

Lokale Entwicklungsumgebung vorbereiten

Wenn Sie noch nie Code an AOSP gesendet haben, müssen Sie Ihre Build-Umgebung initialisieren, sich mit den Tools vertraut machen und herausfinden, wie Sie Patches einreichen:

Außerdem empfehlen wir Ihnen dringend, den Google Issue Tracker zu verwenden, um Änderungen zu verfolgen.

Fehler melden

  1. Rufen Sie issuetracker.google.com auf und melden Sie sich mit Ihrer geschäftlichen E-Mail-Adresse an (siehe Google-Konto mit Ihrer geschäftlichen E-Mail-Adresse).
  2. Klicken Sie nach der Anmeldung links auf dem Bildschirm auf Problem erstellen.
  3. Wählen Sie unter Komponente die Option Android Public Tracker > Framework aus.
  4. Fahren Sie mit APN-Aktualisierung oder CarrierConfig-Aktualisierung fort, um den Titel und die Beschreibung einzugeben.

APN-Fehler

Legen Sie die Fehlerattribute so fest:

Title: APNs für CarrierXYZ hinzufügen/ändern/entfernen

Beschreibung:Fügen Sie eine detaillierte Beschreibung der gewünschten Änderungen hinzu, einschließlich der APN-Einstellungen selbst.

Fehler bei CarrierConfig

Legen Sie die folgenden Werte für die Fehlerattribute fest:

Titel:Konfigurationsänderungen für CarrierXYZ

Beschreibung:Fügen Sie eine detaillierte Beschreibung der gewünschten Änderungen hinzu.

Änderungen übermitteln

So nehmen Sie Änderungen vor:

  1. Geben Sie an, welche Datei geändert werden soll.
  2. Nehmen Sie Änderungen an der Datei vor.
  3. Committe die Änderungen in deinem lokalen Repository. Folge dazu der Anleitung zum Einreichen von Patches und beachte die Richtlinien für Commit-Nachrichten, einschließlich des empfohlenen Formats.
  4. Nachdem Sie die Änderung in Ihrem persönlichen Verlauf committet haben, laden Sie sie mit dem Befehl repo upload in Gerrit hoch.
  5. Nach einem erfolgreichen Upload gibt repo die URL einer neuen Seite auf Gerrit an. Mit dieser URL können Sie Folgendes tun:
    • Patch auf dem Überprüfungsserver ansehen
    • Kommentare hinzufügen
    • Bestimmte Prüfer für Ihren Patch anfordern

APN-Syntax

Name des Android-Projekts – device/sample

Dateiname(n): etc/apns-full-conf.xml (Google Git-Hauptlink)

Die Datei enthält APN-Einstellungen im XML-Format und dient als Beispieldatei. Das Verhalten von Android-Geräten ändert sich daher nicht.

Eine typische APN-Konfiguration sieht so aus:

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

Testen

  1. Verbinden Sie ein Android-Gerät, auf das Sie Root-Zugriff haben.
  2. Fügen Sie /etc/apns-conf.xml Einstellungen hinzu.
  3. Setzen Sie die APN-Einstellungen zurück.
  4. Prüfen Sie in den APN-Einstellungen, ob die Profile korrekt geladen werden.
  5. Testen Sie für jedes Profil die Datenverbindung, den WLAN-Hotspot und MMS, um sicherzustellen, dass sie ordnungsgemäß funktionieren.

Commit-Nachricht

[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

Beispiel-CL

Eine Beispiel-CL finden Sie unter Beispiel-BICS-APNs.

CarrierConfig-Syntax

Projektname: platform/packages/apps/CarrierConfig

Dateiname(n): assets/carrier_config_.xml (Google-Git-Hauptlink)

Ordnen Sie die entsprechenden XML-Dateien im Ordner „assets“ den entsprechenden MCC-/MNC-Tupeln zu. Die Datei enthält das Konfigurationsobjekt des Mobilfunkanbieters im XML-Format. Die Attributnamen werden als Schlüssel unter CarrierConfigManager definiert. Der Werttyp (int/string/bool) wird durch die Suffixe angegeben.

Typische int-/String-/Boolesche-Attribute sehen so aus:

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

Commit-Nachricht

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

Beispiel-CL

Eine Beispiel-CL findest du in einer aktualisierten Mobilfunkanbieterkonfigurationsdatei.

Überprüfung beantragen

So beantragen Sie eine Überprüfung:

  • Rufen Sie die Gerrit-URL Ihrer Änderung auf und fügen Sie android-carrier-config-review@google.com als Prüfer hinzu.
  • Sie können Ihren Google-Kontakt auch der CC-Liste in Gerrit hinzufügen.
  • Zu Tracking-Zwecken können Sie die zuständige Person für das Problem in android-carrier-config-review@google.com ändern.

Nachdem ein Eintrag die Überprüfung und Bestätigung durchlaufen hat, wird die Änderung automatisch in das öffentliche Repository von Gerrit zusammengeführt. Andere Nutzer können repo sync ausführen, um das Update in ihren lokalen Client zu ziehen.