- sintaksis:
<activity-alias android:enabled=["true" | "false"] android:exported=["true" | "false"] android:icon="drawable resource" android:label="string resource" android:name="string" android:permission="string" android:targetActivity="string" > ... </activity-alias>
- terdapat dalam:
<application>
- dapat berisi:
<intent-filter>
<meta-data>
- deskripsi:
- Alias untuk aktivitas, diberi nama oleh atribut
targetActivity
. Target harus berada dalam aplikasi yang sama dengan alias dan dideklarasikan sebelum alias di dalam manifes.Alias menampilkan aktivitas target sebagai entity independen, dan dapat memiliki kumpulan filter intentnya sendiri. Selain itu, bukan filter intent pada aktivitas target itu sendiri, tentukan intent yang dapat mengaktifkan target melalui alias dan cara sistem memperlakukan alias.
Misalnya, filter intent pada alias dapat menentukan tanda
"android.intent.action.MAIN"
dan"android.intent.category.LAUNCHER"
, menyebabkannya ditampilkan dalam peluncur aplikasi, meskipun tidak ada satu pun filter pada aktivitas target tersebut yang menetapkan tanda ini.Kecuali
targetActivity
, atribut<activity-alias>
adalah subset atribut<activity>
. Untuk atribut dalam subset, tidak satu pun nilai yang ditetapkan untuk target yang dialihkan ke alias. Namun, untuk atribut yang tidak ada dalam subset, nilai yang ditetapkan untuk aktivitas target juga berlaku untuk alias. - atribut:
android:enabled
- Apakah aktivitas target dapat dibuat instance-nya oleh sistem melalui
alias ini.
"true"
jika ya, dan"false"
jika tidak. Nilai defaultnya adalah"true"
.Elemen
<application>
memiliki atributenabled
tersendiri yang berlaku untuk semua komponen aplikasi, termasuk alias aktivitas. Atribut<application>
dan<activity-alias>
harus berupa"true"
agar sistem dapat membuat instance aktivitas target melalui alias. Jika salah satunya adalah"false"
, alias tersebut tidak berfungsi. android:exported
- Apakah komponen aplikasi lain dapat meluncurkan aktivitas target
melalui alias ini.
"true"
jika ya, dan"false"
jika tidak. Jika"false"
, aktivitas target dapat diluncurkan melalui alias, hanya dengan komponen aplikasi yang sama dengan alias atau aplikasi dengan ID pengguna yang sama.Nilai defaultnya bergantung pada apakah alias berisi filter intent atau tidak. Tidak adanya filter apa pun berarti bahwa aktivitas dapat dipanggil melalui alias hanya dengan menentukan nama alias yang tepat. Hal ini menyiratkan bahwa alias hanya ditujukan untuk penggunaan internal aplikasi, karena orang lain tidak tahu namanya. Jadi, nilai defaultnya adalah
"false"
. Di sisi lain, keberadaan setidaknya satu filter menyiratkan bahwa alias ini dimaksudkan untuk penggunaan eksternal, sehingga nilai defaultnya adalah"true"
. android:icon
- Ikon untuk aktivitas target saat ditampilkan kepada pengguna melalui alias.
Untuk mengetahui informasi selengkapnya, lihat atribut
icon
elemen<activity>
. android:label
- Label yang dapat dibaca pengguna untuk alias saat ditampilkan kepada pengguna melalui alias.
Untuk mengetahui informasi selengkapnya, lihat atribut
label
elemen<activity>
. android:name
- Nama unik untuk alias. Nama ini menyerupai nama class yang sepenuhnya memenuhi syarat. Namun, tidak seperti nama aktivitas target, nama alias bersifat tidak tentu. Nama ini tidak merujuk ke class yang sebenarnya.
android:permission
- Nama izin yang harus dimiliki klien untuk meluncurkan aktivitas target
atau membuatnya melakukan sesuatu menggunakan alias. Jika pemanggil
startActivity()
ataustartActivityForResult()
tidak diberi izin yang ditentukan, aktivitas target tidak akan diaktifkan.Atribut ini menggantikan setiap izin yang ditetapkan untuk aktivitas target. Jika tidak ditetapkan, izin tidak diperlukan untuk mengaktifkan target melalui alias.
Untuk mengetahui informasi selengkapnya tentang izin, lihat bagian Izin di ringkasan manifes aplikasi.
android:targetActivity
- Nama aktivitas yang dapat diaktifkan melalui alias.
Nama ini harus cocok dengan atribut
name
elemen<activity>
yang mendahului alias di dalam manifes.
- diperkenalkan di:
- API level 1
- lihat juga:
<activity>
<alias-aktivitas>
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,["# <activity-alias\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cactivity-alias 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:targetActivity=\"string\" \u003e\n ...\n \u003c/activity-alias\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: An alias for an activity, named by the `targetActivity`\n attribute. The target must be in the same application as the\n alias and declared before the alias in the manifest.\n\n\n The alias presents the target activity as an independent entity, and can have its own set of intent\n filters. They, rather than the\n intent filters on the target activity itself, determine which intents\n can activate the target through the alias and how the system\n treats the alias.\n\n For example, the intent filters on the alias might\n specify the [\"android.intent.action.MAIN\"](/reference/android/content/Intent#ACTION_MAIN)\n and [\"android.intent.category.LAUNCHER\"](/reference/android/content/Intent#CATEGORY_LAUNCHER)\" flags, causing it to\n be represented in the application launcher, even though none of the\n filters on the target activity itself set these flags.\n\n\n With the exception of `targetActivity`, `\u003cactivity-alias\u003e`\n attributes are a subset of [\u003cactivity\u003e](/guide/topics/manifest/activity-element) attributes.\n For attributes in the subset, none of the values set for the target carry over\n to the alias. However, for attributes not in the subset, the values set for\n the target activity also apply to the alias.\n\nattributes:\n:\n\n `android:enabled`\n : Whether the target activity can be instantiated by the system through\n this alias. `\"true\"` if it can be, and `\"false\"` if not.\n The default value 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 activity aliases. The\n `\u003capplication\u003e` and `\u003cactivity-alias\u003e`\n attributes must both be `\"true\"` for the system to be able to instantiate\n the target activity through the alias. If either is `\"false\"`, the alias\n doesn't work.\n\n `android:exported`\n : Whether the components of other applications can launch the target activity\n through this alias. `\"true\"` if they can, and `\"false\"` if not.\n If `\"false\"`, the target activity can be launched through the alias only by\n components of the same application as the alias or applications with the same user ID.\n\n\n The default value depends on whether the alias contains intent filters. The\n absence of any filters means that the activity can be invoked through the alias\n only by specifying the exact name of the alias. This implies that the alias\n is intended only for application-internal use, since others don't know its name.\n So, the default value is `\"false\"`.\n On the other hand, the presence of at least one filter implies that the alias\n is intended for external use, so the default value is `\"true\"`.\n\n `android:icon`\n : An icon for the target activity when presented to users through the alias.\n For more information, see the [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element's\n [icon](/guide/topics/manifest/activity-element#icon) attribute.\n\n `android:label`\n : A user-readable label for the alias when presented to users through the alias.\n For more information, see the [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element's\n [label](/guide/topics/manifest/activity-element#label) attribute.\n\n \u003cbr /\u003e\n\n `android:name`\n\n : A unique name for the alias. The name resembles a fully qualified class name. But, unlike the name of the target activity, the alias name is arbitrary. It doesn't refer to an actual class. \u003cbr /\u003e\n\n `android:permission`\n : The name of a permission that clients must have to launch the target activity\n or get it to do something using the alias. If a caller of\n [startActivity()](/reference/android/content/Context#startActivity(android.content.Intent)) or\n [startActivityForResult()](/reference/android/app/Activity#startActivityForResult(android.content.Intent, int))\n isn't granted the specified permission, the target activity isn't activated.\n\n This attribute supplants any permission set for the target activity itself. If\n it isn't set, a permission isn't needed to activate the target through the alias.\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.\n\n `android:targetActivity`\n : The name of the activity that can be activated through the alias.\n This name must match the `name` attribute of an\n [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element that precedes\n the alias in the manifest.\n\n \u003cbr /\u003e\n\nintroduced in:\n: API level 1\n\nsee also:\n: [\u003cactivity\u003e](/guide/topics/manifest/activity-element)"]]