APN und CarrierConfig

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

Google-Konto mit Ihrer Firmen-E-Mail-Adresse

Um APN-Informationen oder Ihre CarrierConfig zu aktualisieren, müssen Sie die Anfrage über ein Google-Konto mit einer aktiven Unternehmens-E-Mail-Adresse senden (eine APN-Aktualisierungsanfrage von Acme Company sollte beispielsweise von einer E-Mail-Adresse wie foobar@acme.com kommen).

Wenn Sie kein Google-Konto haben, das mit Ihrer Firmen-E-Mail-Adresse verknüpft ist, melden Sie sich über Ihren Browser von allen Gmail-Konten ab (wir empfehlen die Verwendung einer privaten Browserfunktion, z. B. eines Inkognito-Fensters, um Verwechslungen mit Ihren anderen Konten zu vermeiden) und dann Erstellen Sie ein Google-Konto mit Ihrer Firmen-E-Mail-Adresse .

Bereiten Sie eine lokale Entwicklungsumgebung vor

Wenn Sie noch nie zuvor Code an AOSP übermittelt haben, müssen Sie Ihre Build-Umgebung initialisieren, sich mit den Tools vertraut machen und verstehen, wie Sie Patches übermitteln:

Darüber hinaus empfehlen wir Ihnen dringend, den Google Issue Tracker zu verwenden, um Änderungen zu verfolgen.

Melden Sie einen Fehler

  1. Gehen Sie zu issuetracker.google.com und melden Sie sich mit Ihrer Firmen-E-Mail-Adresse an (siehe Google-Konto mit Ihrer Firmen-E-Mail-Adresse ).
  2. Klicken Sie nach der Anmeldung auf der linken Seite des Bildschirms auf „Problem erstellen“ .
  3. Wählen Sie in Component die Option Android Public Tracker > Framework aus
  4. Fahren Sie mit APN-Update bzw. CarrierConfig-Update fort, um den Titel und die Beschreibung einzugeben.

APN-Fehler

Legen Sie die Fehlerattribute wie folgt fest:

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

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

CarrierConfig-Fehler

Legen Sie die Fehlerattribute wie folgt fest:

Titel: Konfigurationsänderungen für CarrierXYZ

Beschreibung: Fügen Sie eine detaillierte Beschreibung der von Ihnen angeforderten Änderungen hinzu.

Änderungen einreichen

Um Änderungen vorzunehmen:

  1. Identifizieren Sie, welche Datei geändert werden soll.
  2. Nehmen Sie Änderungen an der Datei vor.
  3. Übernehmen Sie die Änderungen in Ihr lokales Repository, indem Sie den Anweisungen zum Einreichen von Patches folgen und dabei die Richtlinien für Commit-Nachrichten, einschließlich des empfohlenen Formats, beachten.
  4. Nachdem Sie Ihre Änderung an Ihrem persönlichen Verlauf übernommen haben, laden Sie sie mit dem repo upload Befehl auf Gerrit hoch.
  5. Nach einem erfolgreichen Upload stellt Repo die URL einer neuen Seite zu Gerrit bereit. Verwenden Sie diese URL, um:
    • Sehen Sie sich Ihren Patch auf dem Überprüfungsserver an
    • Füge Kommentare hinzu
    • Fordern Sie bestimmte Prüfer für Ihren Patch an

APN-Syntax

Android-Projektname – Gerät/Beispiel

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

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

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. Schließen Sie ein beliebiges Android-Gerät an, für das Sie Root-Zugriff haben.
  2. Fügen Sie Einstellungen zu /etc/apns-conf.xml hinzu.
  3. APN-Einstellungen zurücksetzen.
  4. Bestätigen Sie in den APN-Einstellungen, dass die Profile korrekt geladen werden.
  5. Testen Sie für jedes Profil die Datenkonnektivität, 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

Probe CL

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

CarrierConfig-Syntax

Projektname – Plattform/Pakete/Apps/CarrierConfig

Dateiname(n) – asset/carrier_config_ .xml ( Google Git-Hauptlink )

Identifizieren Sie die relevante(n) XML-Datei(en) im Assets-Ordner anhand des/der relevanten MCC/MNC-Tupel(s). Die Datei enthält das Trägerkonfigurationsobjekt im XML-Format. Die Attributnamen werden als Schlüssel unter CarrierConfigManager definiert und der Werttyp (int/string/bool) wird durch die Suffixe angegeben.

Typische int/string/bool-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]

Probe CL

Ein Beispiel-CL finden Sie in einer aktualisierten Carrier-Konfigurationsdatei .

Fordern Sie eine Bewertung an

Um eine Bewertung anzufordern:

  • Gehen Sie zur Gerrit-URL Ihrer Änderung und fügen Sie android-carrier-config-review@google.com als Prüfer hinzu.
  • Sie können Ihren Google-Kontakt auch zur CC-Liste auf Gerrit hinzufügen.
  • Zu Nachverfolgungszwecken können Sie den Beauftragten des Problems in android-carrier-config-review@google.com ändern.

Nachdem eine Einreichung den Überprüfungs- und Verifizierungsprozess durchlaufen hat, führt Gerrit die Änderung automatisch in das öffentliche Repository ein. Andere Benutzer können repo sync ausführen, um das Update in ihren lokalen Client zu laden.