- sintaksis:
<receiver android:directBootAware=["true" | "false"] android:enabled=["true" | "false"] android:exported=["true" | "false"] android:icon="drawable resource" android:label="string resource" android:name="string" android:permission="string" android:process="string" > ... </receiver>
- terdapat dalam:
<application>
- dapat berisi:
<intent-filter>
<meta-data>
- deskripsi:
- Mendeklarasikan penerima siaran, subclass
BroadcastReceiver
, sebagai salah satu komponen aplikasi. Penerima siaran memungkinkan aplikasi menerima intent yang disiarkan oleh sistem atau aplikasi lain, meskipun komponen aplikasi lain tidak berjalan.Ada dua cara untuk membuat penerima siaran diketahui sistem. Salah satunya adalah mendeklarasikan dalam file manifes dengan elemen ini. Kedua, dengan membuat penerima secara dinamis dalam kode dan mendaftarkannya dengan metode
Context.registerReceiver()
atau salah satu versi overload-nya.Untuk mengetahui informasi selengkapnya tentang cara membuat penerima secara dinamis, lihat deskripsi class
BroadcastReceiver
.Jika penerima ini menangani siaran non-sistem, tentukan nilai untuk
android:exported
. Setel nilai ini ke"true"
jika Anda ingin penerima dapat menerima siaran dari aplikasi lain, atau"false"
jika Anda hanya ingin agar penerima dapat menerima siaran dari aplikasi Anda sendiri.Anda tidak perlu menghapus atribut
android:permission
jika sudah mendeklarasikannya.Peringatan: Batasi jumlah penerima siaran yang Anda tetapkan dalam aplikasi. Terlalu banyak penerima siaran dapat memengaruhi performa aplikasi dan masa pakai baterai perangkat pengguna. Untuk mengetahui informasi selengkapnya tentang API yang dapat Anda gunakan, bukan class
BroadcastReceiver
untuk menjadwalkan tugas latar belakang, lihat Pengoptimalan latar belakang. - atribut:
android:directBootAware
Apakah penerima siaran tersebut Direct-Boot aware, yaitu apakah penerima siaran dapat dijalankan sebelum pengguna membuka kunci perangkat.
Catatan: Selama Direct Boot, penerima siaran dalam aplikasi hanya dapat mengakses data dalam penyimpanan yang dilindungi di perangkat.
Nilai default-nya adalah
"false"
.android:enabled
- Apakah penerima siaran dapat dibuat instance-nya oleh sistem. Nilainya
"true"
jika ya, dan"false"
jika tidak. Nilai defaultnya adalah"true"
.Elemen
<application>
memiliki atributenabled
tersendiri yang berlaku untuk semua komponen aplikasi, termasuk penerima siaran. Atribut<application>
dan<receiver>
harus berupa"true"
agar penerima siaran dapat diaktifkan. Jika salah satunya adalah"false"
, penerima siaran tersebut dinonaktifkan dan tidak dapat dibuat instance-nya. android:exported
- Apakah penerima siaran dapat menerima pesan dari sumber non-sistem
di luar aplikasinya.
"true"
jika ya, dan"false"
jika tidak. Jika"false"
, satu-satunya pesan yang diterima penerima siaran adalah pesan yang dikirim oleh sistem, komponen aplikasi yang sama, atau aplikasi dengan ID pengguna yang samaJika tidak ditentukan, nilai default-nya bergantung pada apakah penerima siaran memuat filter intent atau tidak Jika penerima berisi minimal satu filter intent, nilai default-nya adalah
"true"
. Jika tidak, nilai defaultnya adalah"false"
.Atribut ini bukanlah satu-satunya cara untuk membatasi eksposur eksternal penerima siaran. Anda juga dapat menggunakan izin untuk membatasi entitas eksternal yang dapat mengirim pesan ke penerima siaran tersebut. Lihat atribut
permission
. android:icon
- Ikon yang menggambarkan penerima siaran. Atribut ini ditetapkan
sebagai referensi ke resource drawable yang berisi definisi gambar.
Jika tidak disetel, ikon yang ditetapkan untuk aplikasi secara keseluruhan
akan digunakan. Lihat atribut
icon
milik elemen<application>
.Ikon penerima siaran, baik yang ditetapkan di sini maupun oleh elemen
<application>
, juga merupakan ikon default untuk semua filter intent penerima. Lihat atributicon
elemen<intent-filter>
). android:label
- Label yang dapat dibaca pengguna untuk penerima siaran. Jika atribut ini tidak
ditetapkan, label yang ditetapkan untuk aplikasi secara keseluruhan
akan digunakan. Lihat atribut
label
milik elemen<application>
.Label penerima siaran, baik yang ditetapkan di sini maupun oleh elemen
<application>
, juga merupakan label default untuk semua filter intent penerima. Lihat atributlabel
elemen<intent-filter>
).Label ini ditetapkan sebagai referensi ke resource string sehingga dapat dilokalkan seperti string lain pada antarmuka pengguna. Namun, untuk memudahkan Anda mengembangkan aplikasi, label ini juga dapat ditetapkan sebagai string mentah.
android:name
- Nama class yang mengimplementasikan penerima siaran, subclass
dari
BroadcastReceiver
. Nama ini adalah nama class yang sepenuhnya memenuhi syarat, seperti"com.example.project.ReportReceiver"
. Namun, sebagai penyingkat, jika karakter pertama dari nama tersebut adalah titik, misalnya".ReportReceiver"
, karakter itu ditambahkan ke nama paket yang ditetapkan dalam elemen<manifest>
.Setelah Anda memublikasikan aplikasi, jangan ubah nama ini, kecuali jika Anda menetapkan
android:exported="false"
.Tidak ada default untuknya. Nama ini harus ditetapkan.
android:permission
- Nama izin yang dibutuhkan penyiar untuk mengirim
pesan ke penerima siaran.
Jika atribut ini tidak ditetapkan, izin yang ditetapkan oleh
atribut
permission
milik elemen<application>
diterapkan untuk penerima siaran tersebut. Jika tidak ada atribut yang ditetapkan, penerima tersebut tidak dilindungi oleh izin.Untuk mengetahui informasi selengkapnya tentang izin, lihat bagian Izin di ringkasan manifes aplikasi dan Tips keamanan.
android:process
- Nama proses tempat penerima siaran berjalan.
Biasanya, semua komponen aplikasi akan dijalankan dalam proses default yang dibuat
untuk aplikasi tersebut. Proses ini memiliki nama yang sama dengan paket aplikasi.
Atribut
process
milik elemen<application>
dapat menetapkan default yang berbeda untuk semua komponen. Namun, setiap komponen dapat mengganti nilai default dengan atributprocess
-nya sendiri, sehingga Anda dapat menyebarkan aplikasi ke beberapa proses.Jika nama yang ditetapkan pada atribut ini diawali dengan tanda titik dua (
:
), proses baru yang bersifat pribadi untuk aplikasi akan dibuat saat diperlukan, dan penerima siaran akan berjalan dalam proses tersebut.Jika nama proses dimulai dengan karakter huruf kecil, penerima akan berjalan pada proses global dari nama tersebut, jika memiliki izin untuk melakukannya. Hal ini memungkinkan komponen dalam aplikasi yang berbeda untuk berbagi proses, sehingga mengurangi penggunaan resource.
- diperkenalkan di:
- API level 1
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-08-20 UTC.
[]
[]
{
"last_modified": "Terakhir diperbarui pada 2024-08-20 UTC.",
"state": ""
}