<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>
description:
اسم مستعار لنشاط، وتسميته السمة targetActivity. يجب أن يكون الهدف في تطبيق الاسم المستعار وأن يكون معرَّفًا قبل الاسم المستعار في البيان.

ويقدم الاسم المستعار النشاط المستهدف ككيان مستقل، ويمكن أن يكون له مجموعته الخاصة من فلاتر الأهداف. وبدلاً من فلاتر النية على النشاط المستهدف نفسه، فإنها تحدد الأغراض التي يمكنها تنشيط الهدف من خلال الاسم المستعار وكيف يتعامل النظام مع الاسم المستعار.

على سبيل المثال، قد تحدد فلاتر الأهداف على الاسم المستعار علامتَي "android.intent.action.MAIN" و"android.intent.category.LAUNCHER""، ما يؤدي إلى ظهورهما في مشغّل التطبيقات، على الرغم من أنّ أيًا من فلاتر النشاط المستهدف نفسه لم يحدّد هذه العلامات.

تُعدّ السمات <activity-alias>، باستثناء targetActivity، مجموعة فرعية من سمات <activity>. بالنسبة إلى السمات في المجموعة الفرعية، لا يتم نقل أي من القيم المضبوطة للهدف إلى الاسم المستعار. ومع ذلك، بالنسبة إلى السمات غير الموجودة في المجموعة الفرعية، تنطبق القيم المضبوطة للنشاط المستهدف على الاسم المستعار أيضًا.

السمات:
android:enabled
ما إذا كان يمكن إنشاء مثيل للنشاط المستهدف من خلال النظام من خلال هذا الاسم المستعار. و"true" في حال كان الأمر كذلك، و"false" إذا لم يكن الأمر كذلك. القيمة التلقائية هي "true".

ويتضمّن العنصر <application> سمة enabled الخاصة به والتي تنطبق على جميع مكوّنات التطبيقات، بما في ذلك الأسماء المستعارة للأنشطة. يجب ضبط السمتَين <application> و<activity-alias> على "true" لكي يتمكّن النظام من إنشاء مثيل للنشاط المستهدَف من خلال الاسم المستعار. إذا كان أي منهما هو "false"، لن يعمل الاسم المستعار.

android:exported
ما إذا كان بإمكان مكونات التطبيقات الأخرى تشغيل النشاط المستهدَف من خلال هذا الاسم المستعار. "true" إذا كان بإمكانك، و"false" إذا لم يكن بإمكانك. إذا كان "false"، لا يمكن تشغيل النشاط المستهدف من خلال الاسم المستعار إلا من خلال مكوّنات من التطبيق نفسه مثل الاسم المستعار أو التطبيقات التي لها رقم تعريف المستخدم نفسه.

تعتمد القيمة التلقائية على ما إذا كان الاسم المستعار يحتوي على فلاتر أهداف. يعني غياب أي عوامل تصفية أنه لا يمكن استدعاء النشاط من خلال الاسم المستعار إلا من خلال تحديد الاسم الدقيق للاسم المستعار. وهذا يعني أن الاسم المستعار مخصص فقط للاستخدام الداخلي للتطبيق، حيث إن الآخرين لا يعرفون اسمه. وبالتالي، تكون القيمة التلقائية "false". في المقابل، يشير توفُّر فلتر واحد على الأقل إلى أنّ الاسم المستعار مخصّص للاستخدام الخارجي، وبالتالي تكون القيمة التلقائية "true".

android:icon
رمز للنشاط المستهدَف عند عرضه للمستخدمين من خلال العنوان البديل للبريد الإلكتروني. لمزيد من المعلومات، اطّلِع على السمة icon الخاصة بالعنصر <activity>.
android:label
تصنيف يمكن للمستخدمين قراءته للاسم المستعار عند تقديمه للمستخدمين من خلال العنوان البديل للبريد الإلكتروني. لمزيد من المعلومات، اطّلِع على السمة label الخاصة بالعنصر <activity>.

android:name
اسم فريد للاسم المستعار. يشبه الاسم اسم فئة مؤهل بالكامل. ولكن على عكس اسم النشاط المستهدف، يكون الاسم المستعار عشوائيًا. ولا يشير إلى فئة فعلية.

android:permission
اسم الإذن الذي يجب أن يكون لدى العملاء لتشغيل النشاط المستهدف أو حملهم على تنفيذ إجراء باستخدام الاسم المستعار. إذا لم يتم منح المتصل بالأرقام startActivity() أو startActivityForResult() الإذن المحدد، لن يتم تفعيل النشاط المستهدف.

تحل هذه السمة محل أي إذن تم تعيينه للنشاط المستهدف نفسه. وإذا لم يتم ضبطه، لا يلزم الحصول على إذن لتفعيل الهدف من خلال الاسم المستعار.

لمزيد من المعلومات حول الأذونات، يمكنك الاطّلاع على قسم الأذونات في نظرة عامة على بيان التطبيق.

android:targetActivity
اسم النشاط الذي يمكن تفعيله من خلال العنوان البديل للبريد الإلكتروني. يجب أن يتطابق هذا الاسم مع السمة name للعنصر <activity> الذي يسبق الاسم المستعار في البيان.

تم تقديمه في:
المستوى 1 من واجهة برمجة التطبيقات
راجِع أيضًا:
<activity>