<penerima>
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
- 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:directBootAwareApakah 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
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 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# <receiver\u003e\n\nsyntax:\n:\n\n ```xml\n \u003creceiver android:directBootAware=[\"true\" | \"false\"]\n android:enabled=[\"true\" | \"false\"]\n android:exported=[\"true\" | \"false\"]\n android:icon=\"drawable resource\"\n android:label=\"string resource\"\n android:name=\"string\"\n android:permission=\"string\"\n android:process=\"string\" \u003e\n ...\n \u003c/receiver\u003e\n ```\n\ncontained in:\n: [\u003capplication\u003e](/guide/topics/manifest/application-element)\n\ncan contain:\n: [\u003cintent-filter\u003e](/guide/topics/manifest/intent-filter-element)\n\n [\u003cmeta-data\u003e](/guide/topics/manifest/meta-data-element)\n\ndescription:\n: Declares a broadcast receiver, a [BroadcastReceiver](/reference/android/content/BroadcastReceiver)\n subclass, as one of the application's components. Broadcast receivers enable\n applications to receive intents that are broadcast by the system or by other\n applications, even when other components of the application aren't running.\n\n\n There are two ways to make a broadcast receiver known to the system. One is to\n declare it in the manifest file with this element. The other is to create\n the receiver dynamically in code and register it with the\n [Context.registerReceiver()](/reference/android/content/Context#registerReceiver(android.content.BroadcastReceiver,%20android.content.IntentFilter))\n method or one of its overloaded versions.\n\n\n For more information about how to dynamically create receivers, see the\n [BroadcastReceiver](/reference/android/content/BroadcastReceiver) class\n description.\n\n\n If this receiver handles non-system broadcasts, specify a value for `android:exported`.\n Set this value to `\"true\"` if you want your receiver to be able to\n receiver broadcasts from other applications or `\"false\"` if you only\n want your receiver to be able to receive broadcasts from your own app.\n\n\n You don't have to remove the `android:permission` attribute if you\n already declared it.\n\n\n **Warning:** Limit how many broadcast\n receivers you set in your app. Having too many broadcast receivers can\n affect your app's performance and the battery life of users' devices.\n For more information about APIs you can use instead of the\n `BroadcastReceiver` class for scheduling background work, see\n [Background optimization](/topic/performance/background-optimization).\n\nattributes:\n:\n\n `android:directBootAware`\n\n : Whether the broadcast receiver is *Direct-Boot aware*, that\n is, whether it can run before the user unlocks the device.\n\n **Note:** During\n [Direct Boot](/training/articles/direct-boot), a broadcast\n receiver in your application can only access the data that is stored in\n *device protected* storage.\n\n The default value is `\"false\"`.\n\n `android:enabled`\n : Whether the broadcast receiver can be instantiated by the system. It's\n `\"true\"` if it can be, and `\"false\"` if not. The default value\n is `\"true\"`.\n\n\n The [\u003capplication\u003e](/guide/topics/manifest/application-element) element has its own\n [enabled](/guide/topics/manifest/application-element#enabled) attribute that applies to all\n application components, including broadcast receivers. The\n `\u003capplication\u003e` and\n `\u003creceiver\u003e` attributes must both be `\"true\"` for\n the broadcast receiver to be enabled. If either is `\"false\"`, it's\n disabled and can't be instantiated.\n\n `android:exported`\n : Whether the broadcast receiver can receive messages from non-system sources\n outside its application. It's `\"true\"` if it can, and `\"false\"`\n if not. If `\"false\"`, the only messages the broadcast receiver\n receives are those sent by the system, components of the same application, or applications\n with the same user ID.\n\n\n If unspecified, the default value depends on whether the broadcast receiver contains intent\n filters. If the receiver contains at least one intent filter, then the default value is\n `\"true\"`. Otherwise, the default value is `\"false\"`.\n\n\n This attribute is not the only way to limit a broadcast receiver's external exposure.\n You can also use a permission to limit the external entities that can send it messages.\n See the [permission](/guide/topics/manifest/receiver-element#prmsn) attribute.\n\n `android:icon`\n : An icon representing the broadcast receiver. This attribute is set\n as a reference to a drawable resource containing the image definition.\n If it isn't set, the icon specified for the application as a whole is used\n instead. See the [\u003capplication\u003e](/guide/topics/manifest/application-element)\n element's [icon](/guide/topics/manifest/application-element#icon) attribute.\n\n\n The broadcast receiver's icon, whether set here or by the\n `\u003capplication\u003e` element, is also the\n default icon for all the receiver's intent filters. See the\n [\u003cintent-filter\u003e](/guide/topics/manifest/intent-filter-element) element's\n [icon](/guide/topics/manifest/intent-filter-element#icon) attribute.\n\n `android:label`\n : A user-readable label for the broadcast receiver. If this attribute isn't\n set, the label set for the application as a whole is\n used instead. See the [\u003capplication\u003e](/guide/topics/manifest/application-element) element's\n [label](/guide/topics/manifest/application-element#label) attribute.\n\n\n The broadcast receiver's label, whether set here or by the\n `\u003capplication\u003e` element, is also the\n default label for all the receiver's intent filters. See the\n [\u003cintent-filter\u003e](/guide/topics/manifest/intent-filter-element) element's\n [label](/guide/topics/manifest/intent-filter-element#label) attribute.\n\n\n The label is set as a reference to a string resource, so that\n it can be localized like other strings in the user interface.\n However, as a convenience while you're developing the application,\n it can also be set as a raw string.\n\n `android:name`\n : The name of the class that implements the broadcast receiver, a subclass of\n [BroadcastReceiver](/reference/android/content/BroadcastReceiver). This is a fully qualified\n class name, such as `\"com.example.project.ReportReceiver\"`. However,\n as a shorthand, if the first character of the name is a period, for example,\n `\".ReportReceiver\"`, it is appended to the package name specified in\n the [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element) element.\n\n Once you publish your application, [don't\n change this name](http://android-developers.blogspot.com/2011/06/things-that-cannot-change.html), unless you set [android:exported](#exported)`=\"false\"`.\n\n\n There is no default. The name must be specified.\n\n `android:permission`\n : The name of a permission that broadcasters need in order to send a\n message to the broadcast receiver.\n If this attribute isn't set, the permission set by the\n [\u003capplication\u003e](/guide/topics/manifest/application-element) element's\n [permission](/guide/topics/manifest/application-element#prmsn) attribute applies\n to the broadcast receiver. If neither attribute is set, the receiver\n isn't protected by a permission.\n\n\n For more information about permissions, see the\n [Permissions](/guide/topics/manifest/manifest-intro#perms)\n section in the app manifest overview and\n [Security tips](/guide/topics/security/security).\n\n `android:process`\n\n : The name of the process in which the broadcast receiver runs. Normally, all components of an application run in the default process created for the application. It has the same name as the application package.\u003cbr /\u003e\n\n The\n [\u003capplication\u003e](/guide/topics/manifest/application-element) element's\n [process](/guide/topics/manifest/application-element#proc) attribute can set a different\n default for all components. But each component can override the default\n with its own `process` attribute, letting you spread your\n application across multiple processes.\n\n\n If the name assigned to this attribute begins with a colon (`:`), a new\n process, private to the application, is created when it's needed, and\n the broadcast receiver runs in that process.\n\n\n If the process name begins with a lowercase character, the receiver runs\n in a global process of that name, provided that it has permission to do so.\n This lets components in different applications share a process, reducing\n resource usage.\n\nintroduced in:\n: API level 1"]]
