<alias-aktivitas>

sintaksis:

<activity-alias android:enabled=["true" | "false"]
                android:exported=["true" | "false"]
                android:icon="drawable resource"
                android:intentMatchingFlags=["none" | "enforceIntentFilter" | "allowNullAction"]
                android:label="string resource"
                android:name="string"
                android:permission="string"
                android:targetActivity="string" >
    ...
</activity-alias>

terdapat dalam:

<application>

dapat berisi:

<intent-filter>
<meta-data>
<property>

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 atribut enabled 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:intentMatchingFlags

Gunakan atribut ini untuk menyempurnakan cara sistem mencocokkan intent masuk dengan komponen aplikasi. Secara default, tidak ada aturan pencocokan khusus yang diterapkan.

Nilai yang ditetapkan pada tag <activity-alias> akan menggantikan nilai yang ditetapkan pada target <activity> atau diwarisi dari <application> untuk alias tertentu tersebut. Jika tidak ditentukan secara eksplisit di alias, alias akan mewarisi perilaku dari aktivitas target atau aplikasi.

Nilai harus berupa satu atau beberapa tanda berikut, yang dipisahkan oleh '|':

Bendera	Deskripsi
none	Menonaktifkan semua aturan pencocokan khusus untuk maksud masuk. Saat menentukan beberapa tanda, nilai yang bertentangan diselesaikan dengan memberikan prioritas pada tanda none.
enforceIntentFilter	Menerapkan pencocokan yang lebih ketat untuk intent yang masuk: Intent eksplisit harus cocok dengan filter intent komponen target. Intent tanpa tindakan tidak cocok dengan filter intent apa pun.
allowNullAction	Melonggarkan aturan pencocokan untuk mengizinkan pencocokan maksud tanpa tindakan. Flag ini digunakan bersama dengan enforceIntentFilter untuk mencapai perilaku berikut: Intent eksplisit harus cocok dengan filter intent komponen target. Intent tanpa tindakan diizinkan untuk mencocokkan filter intent apa pun.

Untuk mengetahui informasi selengkapnya, lihat bagian Intent yang Lebih Aman di perubahan perilaku Android 16 (level API 36).

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. 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() atau startActivityForResult() 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>