<activity-alias>

نحو:

<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>

موجود در:

<application>

می تواند شامل:

<intent-filter>
<meta-data>

توضیحات:

نام مستعار یک اکتیویتی که با ویژگی targetActivity نامگذاری شده است. هدف باید در همان برنامه مستعار باشد و قبل از نام مستعار در مانیفست اعلام شود.

نام مستعار فعالیت هدف را به عنوان یک موجودیت مستقل نشان می دهد و می تواند مجموعه ای از فیلترهای هدف خود را داشته باشد. آنها، به جای فیلترهای intent روی فعالیت هدف، تعیین می کنند که کدام intent می تواند هدف را از طریق نام مستعار فعال کند و سیستم چگونه با نام مستعار رفتار می کند.

برای مثال، فیلترهای intent روی نام مستعار ممکن است پرچم‌های "android.intent.action.MAIN" و "android.intent.category.LAUNCHER" " را مشخص کنند و باعث شوند که در راه‌انداز برنامه نمایش داده شود، حتی اگر هیچ یک از فیلترها وجود نداشته باشد. روی فعالیت هدف خود این پرچم ها را تنظیم کنید.

به استثنای targetActivity ، ویژگی‌های <activity-alias> زیرمجموعه‌ای از ویژگی‌های <activity> هستند. برای ویژگی های زیر مجموعه، هیچ یک از مقادیر تعیین شده برای هدف به نام مستعار منتقل نمی شود. با این حال، برای ویژگی‌هایی که در زیرمجموعه نیستند، مقادیر تعیین‌شده برای فعالیت هدف برای نام مستعار نیز اعمال می‌شود.

صفات:

android:enabled

آیا فعالیت هدف می تواند توسط سیستم از طریق این نام مستعار نمونه سازی شود یا خیر. "true" اگر می تواند باشد و "false" اگر نه. مقدار پیش فرض "true" است.

عنصر <application> ویژگی enabled خود را دارد که برای همه اجزای برنامه از جمله نام مستعار فعالیت اعمال می شود. ویژگی‌های <application> و <activity-alias> هر دو باید "true" باشند تا سیستم بتواند فعالیت هدف را از طریق نام مستعار نمونه‌سازی کند. اگر هر کدام "false" باشد، نام مستعار کار نمی کند.

android:exported

آیا اجزای برنامه های کاربردی دیگر می توانند فعالیت هدف را از طریق این نام مستعار راه اندازی کنند یا خیر. اگر بتوانند "true" و اگر نه "false" . اگر "false" باشد، فعالیت هدف را می توان از طریق نام مستعار تنها توسط مؤلفه های همان برنامه کاربردی با نام مستعار یا برنامه هایی با همان شناسه کاربری راه اندازی کرد.

مقدار پیش فرض بستگی به این دارد که آیا نام مستعار حاوی فیلترهای intent باشد یا خیر. عدم وجود فیلتر به این معنی است که فعالیت را می توان از طریق نام مستعار تنها با تعیین نام دقیق نام مستعار فراخوانی کرد. این بدان معناست که نام مستعار فقط برای استفاده داخلی برنامه در نظر گرفته شده است، زیرا دیگران نام آن را نمی دانند. بنابراین، مقدار پیش فرض "false" است. از طرف دیگر، وجود حداقل یک فیلتر نشان می دهد که نام مستعار برای استفاده خارجی در نظر گرفته شده است، بنابراین مقدار پیش فرض "true" است.

android:icon

نمادی برای فعالیت هدف زمانی که از طریق نام مستعار به کاربران ارائه می شود. برای اطلاعات بیشتر، ویژگی icon عنصر <activity> را ببینید.

android:label

یک برچسب قابل خواندن توسط کاربر برای نام مستعار زمانی که از طریق نام مستعار به کاربران ارائه شود. برای اطلاعات بیشتر، ویژگی label عنصر <activity> را ببینید.

android:name

یک نام منحصر به فرد برای نام مستعار. این نام شبیه یک نام کلاس کاملاً واجد شرایط است. اما برخلاف نام فعالیت هدف، نام مستعار دلخواه است. به یک کلاس واقعی اشاره نمی کند.

android:permission

نام مجوزی که مشتریان باید برای راه اندازی فعالیت هدف یا دریافت آن برای انجام کاری با استفاده از نام مستعار داشته باشند. اگر به فراخواننده startActivity() یا startActivityForResult() مجوز مشخص شده داده نشود، فعالیت هدف فعال نمی شود.

این ویژگی جایگزین هر گونه مجوز تنظیم شده برای خود فعالیت هدف می شود. اگر تنظیم نشده باشد، مجوزی برای فعال کردن هدف از طریق نام مستعار لازم نیست.

برای اطلاعات بیشتر در مورد مجوزها، به بخش مجوزها در نمای کلی مانیفست برنامه مراجعه کنید.

android:targetActivity

نام فعالیتی که می توان از طریق نام مستعار فعال کرد. این نام باید با ویژگی name عنصر <activity> که قبل از نام مستعار در مانیفست قرار دارد مطابقت داشته باشد.

معرفی شده در:

API سطح 1

همچنین ببینید:

<activity>