APN dan CarrierConfig

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

Akun Google dengan alamat email perusahaan Anda

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

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

Siapkan lingkungan pengembangan lokal

Jika Anda belum pernah mengirimkan kode ke AOSP sebelumnya, Anda perlu menginisialisasi lingkungan build Anda, membiasakan diri dengan alat, dan memahami cara mengirimkan patch:

Selain itu, kami sangat menyarankan Anda menggunakan Google Issue Tracker untuk melacak perubahan.

Ajukan bug

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

bug APN

Atur atribut bug sebagai berikut:

Judul: Tambah / Ubah / Hapus APN untuk CarrierXYZ

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

Bug CarrierConfig

Atur 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 mana yang akan diubah.
  2. Buat perubahan pada file.
  3. Komit perubahan ke repositori lokal Anda dengan mengikuti petunjuk untuk mengirimkan tambalan , perhatikan pedoman pesan komit, termasuk format yang disarankan.
  4. Setelah Anda melakukan perubahan ke riwayat pribadi Anda, unggah ke Gerrit menggunakan perintah repo upload .
  5. Setelah unggahan yang berhasil, repo menyediakan URL halaman baru di Gerrit. Gunakan URL ini untuk:
    • Lihat tambalan Anda di server ulasan
    • Tambahkan komentar
    • Minta pengulas khusus untuk tambalan Anda

Sintaks APN

Nama proyek Android - perangkat/contoh

Nama file - etc/apns-full-conf.xml ( tautan master Google Git )

File tersebut berisi pengaturan APN dalam format XML dan berfungsi sebagai file sampel sehingga tidak ada perubahan perilaku perangkat Android.

Konfigurasi APN tipikal 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 Anda miliki akses rootnya.
  2. Tambahkan pengaturan ke /etc/apns-conf.xml.
  3. Setel ulang pengaturan APN.
  4. Dalam pengaturan APN, konfirmasikan bahwa profil dimuat dengan benar.
  5. Untuk setiap profil, uji konektivitas data, hotspot Wi-Fi, dan MMS untuk memastikan semuanya berfungsi dengan benar.

Pesan komit

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

Sintaks CarrierConfig

Nama proyek - platform/paket/aplikasi/CarrierConfig

Nama file - assets/carrier_config_ .xml ( tautan master Google Git )

Identifikasi file XML yang relevan dalam folder aset dengan tuple PKS/MNC yang relevan. File berisi objek konfigurasi operator dalam format XML. Nama atribut didefinisikan sebagai kunci di bawah CarrierConfigManager , dan jenis nilai (int/string/bool) ditunjukkan oleh sufiks.

Atribut int/string/bool yang khas 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 komit

[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 contoh CL.

Minta ulasan

Untuk meminta peninjauan:

  • Buka URL Gerrit 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 tugas masalah ke android-carrier-config-review@google.com .

Setelah pengajuan berhasil melalui proses peninjauan dan verifikasi, Gerrit secara otomatis menggabungkan perubahan ke dalam repositori publik. Pengguna lain dapat menjalankan repo sync untuk menarik pembaruan ke klien lokal mereka.