<penerima>

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 atribut enabled 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 sama

Jika 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 atribut icon 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 atribut label 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 atribut process-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