APN i CarrierConfig

Operatorzy mogą aktualizować informacje o nazwie punktu dostępu (APN) i ustawienia konfiguracji specyficzne dla operatora (CarrierConfig) w projekcie Android Open Source Project (AOSP).

konto Google z firmowym adresem e-mail,

Aby zaktualizować informacje o APN lub plik CarrierConfig, musisz przesłać prośbę za pomocą konta Google z aktywnym firmowym adresem e-mail (np. prośba o aktualizację APN od firmy Acme powinna zostać wysłana z adresu e-mail foobar@acme.com).

Jeśli nie masz konta Google połączonego z firmowym adresem e-mail, wyloguj się ze wszystkich kont Gmail w przeglądarce (zalecamy użycie funkcji przeglądania prywatnego, np. okna incognito, aby uniknąć pomyłki z innymi kontami), a następnie utwórz konto Google przy użyciu firmowego adresu e-mail.

Przygotowywanie lokalnego środowiska programistycznego

Jeśli nigdy wcześniej nie przesyłałeś(-aś) kodu do AOSP, musisz zainicjować środowisko kompilacji, zapoznać się z narzędziami i dowiedzieć się, jak przesyłać poprawki:

Zdecydowanie zalecamy też śledzenie zmian za pomocą Google Issue Tracker.

Zgłoś błąd

  1. Otwórz stronę issuetracker.google.com i zaloguj się, używając służbowego adresu e-mail (patrz konto Google ze służbowym adresem e-mail).
  2. Po zalogowaniu się kliknij Utwórz zgłoszenie po lewej stronie ekranu.
  3. W sekcji Component (Komponent) wybierz Android Public Tracker > Framework.
  4. Przejdź do aktualizacji APN lub aktualizacji CarrierConfig, aby wpisać tytuł i opis.

Błąd APN

Ustaw atrybuty błędu w ten sposób:

Title: Dodawanie/modyfikowanie/usuwanie nazw APN dla operatora CarrierXYZ

Opis: dodaj szczegółowy opis zmian, o które prosisz, w tym ustawienia APN.

Błąd konfiguracji operatora

Ustaw atrybuty błędu w ten sposób:

Tytuł: Zmiany konfiguracji dla CarrierXYZ

Opis: dodaj szczegółowy opis zmian, o które prosisz.

Wprowadź zmiany

Aby wprowadzić zmiany:

  1. Wskaż plik, który chcesz zmienić.
  2. Wprowadzać zmiany w pliku,
  3. Zatwierdź zmiany w lokalnym repozytorium, postępując zgodnie z instrukcjami przesyłania poprawek. Zwróć uwagę na wytyczne dotyczące wiadomości o zatwierdzeniu, w tym na zalecany format.
  4. Po wprowadzeniu zmiany w historii osobistej prześlij ją do Gerrita za pomocą polecenia repo upload.
  5. Po przesłaniu repo zwraca adres URL nowej strony w Gerrit. Użyj tego adresu URL, aby:
    • Wyświetlanie poprawki na serwerze weryfikacyjnym
    • Dodawanie komentarzy
    • Prośba o sprawdzenie poprawki przez konkretnych recenzentów

Składnia APN

Nazwa projektu na Androida – urządzenie/próbka

Nazwy plików – etc/apns-full-conf.xml (Główny link do Git w Google)

Plik zawiera ustawienia APN w formacie XML i służy jako plik przykładowy, więc nie ma wpływu na działanie urządzeń z Androidem.

Typowa konfiguracja APN wygląda tak:

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

Testowanie

  1. Podłącz dowolne urządzenie z Androidem, do którego masz dostęp do roota.
  2. Dodaj ustawienia do pliku /etc/apns-conf.xml.
  3. Zresetuj ustawienia APN.
  4. W ustawieniach APN sprawdź, czy profile zostały prawidłowo załadowane.
  5. W przypadku każdego profilu przetestuj połączenie do transmisji danych, hotspot Wi-Fi i MMS, aby upewnić się, że działają prawidłowo.

Komunikat zatwierdzenia

[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

Przykładowa lista zmian

Przykład CL znajdziesz w sekcji Przykładowe APN-y BICS.

Składnia CarrierConfig

Nazwa projektu – platform/packages/apps/CarrierConfig

Nazwy plików – assets/carrier_config_.xml (Google Główny link do Gita)

W folderze zasobów znajdź odpowiednie pliki XML, korzystając z odpowiednich krotek MCC/MNC. Plik zawiera obiekt konfiguracji operatora w formacie XML. Nazwy atrybutów są zdefiniowane jako klucze w  CarrierConfigManager, a typ wartości (int/string/bool) jest oznaczony sufiksami.

Typowe atrybuty int/string/bool wyglądają tak:

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

Komunikat zatwierdzenia

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

Przykładowa lista zmian

Przykład CL znajdziesz w  zaktualizowanym pliku konfiguracji operatora.

Poproś o sprawdzenie

Aby poprosić o sprawdzenie:

  • Otwórz adres URL Gerrit zmiany i dodaj android-carrier-config-review@google.com jako osobę sprawdzającą.
  • Możesz też dodać kontakt z Google do listy DW w Gerrit.
  • Aby śledzić postępy, możesz zmienić osobę przypisaną do zgłoszenia na android-carrier-config-review@google.com.

Gdy przesłane zmiany przejdą proces sprawdzania i weryfikacji, Gerrit automatycznie scali je z publicznym repozytorium. Inni użytkownicy mogą uruchomić polecenie repo sync , aby pobrać aktualizację na lokalnego klienta.