- بناء الجملة:
<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>
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-10-18 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]