APN dan CarrierConfig

Operator dapat memperbarui informasi Nama Titik Akses (APN) dan pengaturan konfigurasi khusus operator ( CarrierConfig ) di Proyek Sumber Terbuka Android (AOSP).

Akun Google dengan alamat email perusahaan Anda

Untuk memperbarui informasi APN atau CarrierConfig Anda, Anda perlu mengirimkan permintaan menggunakan Akun Google dengan alamat email perusahaan yang aktif (misalnya, permintaan pembaruan APN dari Acme Company harus berasal 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.

Mempersiapkan lingkungan pengembangan lokal

Catatan: Daripada menggunakan lingkungan pengembangan lokal, untuk perubahan kecil, Anda dapat menggunakan alat editor sumber Git berbasis browser.

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

• Membangun lingkungan pembangunan
• Mengenal Git dan Repo
• Mengunduh sumbernya
• 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 Komponen , pilih Pelacak Publik Android > Kerangka
4. Lanjutkan ke pembaruan APN atau pembaruan CarrierConfig , jika sesuai, untuk memasukkan Judul dan Deskripsi.

bug APN

Atur atribut bug sebagai berikut:

Judul: Tambah / Ubah / Hapus APN untuk CarrierXYZ

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

Bug Konfigurasi Operator

Atur atribut bug sebagai berikut:

Judul: Perubahan konfigurasi untuk CarrierXYZ

Deskripsi: Tambahkan deskripsi mendetail tentang perubahan yang Anda minta.

Kirim perubahan

Untuk melakukan perubahan:

1. Identifikasi file mana yang akan diubah.
2. Buat perubahan pada file.
3. Komit perubahan pada repositori lokal Anda dengan mengikuti instruksi untuk mengirimkan tambalan , perhatikan pedoman pesan komit, termasuk format yang disarankan.
4. Setelah Anda memasukkan perubahan ke riwayat pribadi Anda, unggah ke Gerrit menggunakan perintah repo upload .
5. Setelah pengunggahan berhasil, repo menyediakan URL halaman baru di Gerrit. Gunakan URL ini untuk:
   • Lihat patch Anda di server review
   • Tambahkan komentar
   • Minta pengulas khusus untuk patch Anda

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

Sintaks APN

Nama proyek Android - perangkat/sampel

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

File tersebut berisi pengaturan APN dalam format XML dan berfungsi sebagai file contoh 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 - aset/carrier_config_ .xml ( tautan utama Google Git )

Identifikasi file XML yang relevan di folder aset berdasarkan tupel MCC/MNC yang relevan. File tersebut 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 peninjauan

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

Setelah penyerahan berhasil melalui proses peninjauan dan verifikasi, Gerrit secara otomatis menggabungkan perubahan tersebut 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/sampel. Jika Anda bekerja dengan OEM utama, pastikan mereka mengambil informasi terbaru dari AOSP. Biasanya OEM memiliki jadwal rutin di mana mereka memilih informasi terbaru, namun jika Anda sedang terburu-buru, hubungi OEM untuk mendorong mereka memperbarui daftar mereka lebih cepat daripada terlambat.