APN dan CarrierConfig

Operator dapat memperbarui informasi Nama Titik Akses (APN) dan setelan konfigurasi khusus operator (CarrierConfig) di Project Open Source Android (AOSP).

Akun Google dengan alamat email perusahaan Anda

Untuk memperbarui informasi APN atau CarrierConfig, Anda harus mengirimkan permintaan menggunakan Akun Google dengan alamat email perusahaan yang aktif (misalnya, permintaan pembaruan APN dari Perusahaan Acme harus berasal dari alamat email seperti foobar@acme.com).

Jika Anda tidak memiliki Akun Google yang ditautkan ke alamat email perusahaan, logout dari semua akun Gmail dari browser Anda (sebaiknya gunakan fitur penjelajahan pribadi, seperti jendela Samaran, untuk menghindari kebingungan dengan akun Anda yang lain), lalu buat Akun Google dengan alamat email perusahaan Anda.

Menyiapkan lingkungan pengembangan lokal

Jika belum pernah mengirimkan kode ke AOSP, Anda harus melakukan inisialisasi lingkungan build, memahami alat, dan memahami cara mengirimkan patch:

Selain itu, sebaiknya gunakan Pelacak Masalah Google untuk melacak perubahan.

Laporkan bug

  1. Buka issuetracker.google.com dan login menggunakan alamat email perusahaan Anda (lihat Akun Google dengan alamat email perusahaan Anda).
  2. Setelah login, klik Buat masalah di sisi kiri layar.
  3. Di Component, pilih Android Public Tracker > Framework
  4. Lanjutkan ke Pembaruan APN atau Pembaruan CarrierConfig, sesuai kebutuhan, untuk memasukkan Judul dan Deskripsi.

Bug APN

Tetapkan atribut bug sebagai berikut:

Title: Menambahkan/Mengubah/Menghapus APN untuk CarrierXYZ

Deskripsi: Tambahkan deskripsi mendetail tentang perubahan yang Anda minta, termasuk setelan APN itu sendiri.

Bug CarrierConfig

Tetapkan atribut bug sebagai berikut:

Judul: Perubahan konfigurasi untuk CarrierXYZ

Deskripsi: Tambahkan deskripsi mendetail tentang perubahan yang Anda minta.

Kirim Perubahan

Untuk membuat perubahan:

  1. Identifikasi file yang akan diubah.
  2. Buat perubahan pada file.
  3. Lakukan commit perubahan ke repositori lokal Anda dengan mengikuti petunjuk untuk mengirimkan patch, dengan memperhatikan panduan pesan commit, termasuk format yang direkomendasikan.
  4. Setelah melakukan perubahan pada histori pribadi, upload perubahan tersebut ke Gerrit menggunakan perintah repo upload.
  5. Setelah upload berhasil, repo akan memberikan URL halaman baru di Gerrit. Gunakan URL ini untuk:
    • Melihat patch Anda di server peninjauan
    • Menambahkan komentar
    • Meminta peninjau tertentu untuk patch Anda

Sintaksis APN

Nama project Android - perangkat/contoh

Nama file - etc/apns-full-conf.xml (Link utama Google Git)

File ini berisi setelan APN dalam format XML dan berfungsi sebagai file contoh sehingga tidak ada perubahan pada perilaku perangkat Android.

Konfigurasi APN standar terlihat seperti ini:

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

Pengujian

  1. Hubungkan perangkat Android apa pun yang akses root-nya Anda miliki.
  2. Tambahkan setelan ke /etc/apns-conf.xml.
  3. Reset setelan APN.
  4. Di setelan APN, pastikan profil dimuat dengan benar.
  5. Untuk setiap profil, uji konektivitas data, hotspot Wi-Fi, dan MMS untuk memastikannya berfungsi dengan benar.

Pesan commit

[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

Contoh CL

Lihat Contoh APN BICS untuk contoh CL.

Sintaksis CarrierConfig

Nama project - platform/packages/apps/CarrierConfig

Nama file - assets/carrier_config_.xml (Link utama Google Git)

Identifikasi file XML yang relevan di folder aset berdasarkan tuple MCC/MNC yang relevan. File ini berisi objek konfigurasi operator dalam format XML. Nama atribut ditentukan sebagai kunci di bagian CarrierConfigManager, dan jenis nilai (int/string/bool) ditunjukkan oleh akhiran.

Atribut int/string/bool standar terlihat seperti ini:

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

Pesan commit

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

Contoh CL

Lihat file konfigurasi operator yang diperbarui untuk mengetahui contoh CL.

Minta peninjauan

Untuk meminta peninjauan:

  • Buka URL Gerrit untuk perubahan Anda dan tambahkan android-carrier-config-review@google.com sebagai peninjau.
  • Anda juga dapat menambahkan kontak Google Anda ke daftar CC di Gerrit.
  • Untuk tujuan pelacakan, Anda dapat mengubah penerima masalah menjadi android-carrier-config-review@google.com.

Setelah pengiriman berhasil melalui proses peninjauan dan verifikasi, Gerrit akan otomatis menggabungkan perubahan ke repositori publik. Pengguna lain dapat menjalankan repo sync untuk menarik update ke klien lokal mereka.