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 [e-mail] ).

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 .

Perhatian: JANGAN kaitkan akun Gmail apa pun dengan akun yang baru dibuat ini.

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:

• Membangun lingkungan bangunan
• Mengenal Git dan Repo
• Mengunduh sumber
• Mengirimkan tambalan

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 ).
Catatan: Jika ini pertama kalinya Anda masuk, Anda harus menerima lisensi.
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

Catatan: Pengajuan perubahan APN dan CarrierConfig ke AOSP tidak menjamin bahwa OEM akan menerima perubahan tersebut. Operator harus bekerja dengan OEM sehingga perubahan yang diperlukan dilakukan pada perangkat mereka.

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 [e-mail] sebagai peninjau.
• Anda juga dapat menambahkan kontak Google Anda ke daftar CC di Gerrit.
• Untuk tujuan pelacakan, Anda dapat mengubah penerima tugas masalah ke [e-mail] .

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.

Catatan: Perubahan pada file APN tidak otomatis berlaku karena perubahan ada di folder perangkat/contoh. Jika Anda bekerja dengan OEM utama, pastikan mereka mengambil informasi terbaru dari AOSP. Biasanya OEM memiliki jadwal reguler di mana mereka memilih informasi terbaru, tetapi jika Anda sedang terburu-buru, hubungi OEM untuk mendorong mereka memperbarui daftar mereka lebih cepat daripada nanti.