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

Jika Anda tidak memiliki Akun Google yang ditautkan ke alamat email perusahaan, logout dari semua akun Gmail dari browser Anda (sebaiknya gunakan fitur penjelajahan rahasia, seperti jendela Samaran, 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.

Menyiapkan 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 harus menginisialisasi lingkungan build, memahami alat, dan memahami cara mengirimkan patch:

• Membuat lingkungan build
• Memahami Git dan Repo
• Mendownload sumber
• Mengirimkan patch

Selain itu, sebaiknya gunakan Google Issue Tracker untuk melacak perubahan.

Melaporkan bug

1. Buka issuetracker.google.com dan login menggunakan alamat email perusahaan Anda (lihat Akun Google dengan alamat email perusahaan Anda).
Catatan: Jika ini adalah pertama kalinya Anda login, Anda harus menyetujui lisensi.
2. Setelah login, klik Create issue 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

Tetapkan atribut bug sebagai berikut:

Judul: Add/Modify/Remove APNs for CarrierXYZ

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

Bug CarrierConfig

Tetapkan atribut bug sebagai berikut:

Judul: Config changes for CarrierXYZ

Deskripsi: Tambahkan deskripsi mendetail tentang perubahan yang Anda minta.

Mengirimkan perubahan

Untuk melakukan perubahan:

1. Identifikasi file yang akan diubah.
2. Buat perubahan pada file.
3. Lakukan perubahan pada repositori lokal Anda dengan mengikuti petunjuk untuk mengirimkan patch, perhatikan panduan pesan commit, termasuk format yang direkomendasikan.
4. Setelah Anda melakukan perubahan pada histori pribadi, upload 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

Catatan: Pengiriman perubahan APN dan CarrierConfig ke AOSP tidak menjamin bahwa OEM akan mengambil perubahan tersebut. Operator harus bekerja sama dengan OEM agar perubahan yang diperlukan dilakukan di perangkat mereka.

Sintaksis APN

Nama project Android - device/sample

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 dalam 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 memiliki akses root.
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 memastikan semuanya 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

CL contoh

Lihat APN BICS Contoh untuk CL contoh.

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]

CL contoh

Lihat file konfigurasi operator yang diperbarui untuk CL contoh.

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

Setelah pengiriman berhasil melalui proses peninjauan dan verifikasi, Gerrit akan otomatis menggabungkan perubahan ke 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 tersebut berada di folder device/sample. Jika Anda bekerja dengan OEM utama, pastikan mereka mengambil informasi terbaru dari AOSP. Biasanya OEM memiliki jadwal rutin untuk mengambil informasi terbaru, tetapi jika Anda terburu-buru, hubungi OEM untuk mendorong mereka memperbarui daftar mereka lebih cepat.