النشاط المستعار

الإعلانات

النشاط المستعار 

 

 

النشاط المستعار <activity-alias>

بناء الجملة

وارد في:

<application>

يمكن أن يحتوي على:

<intent-filter>
<meta-data>

الوصف:

هو اسم مستعار لنشاط، يتم تسميته بواسطة سمة “النشاط المستهدف” targetActivity. الهدف، يجب أن يكون في نفس التطبيق كأسم مستعار، و يجب أن يتم الإعلان عنه قبل الاسم المستعار في ملف الإيضاح.

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

يحدد أي الأغراض، يمكنها تنشيط الهدف من خلال الاسم المستعار و كيف يتعامل النظام مع الاسم المستعار.

مثال، مرشحات الغرض في الاسم المستعار قد تحدد علامتي “android.intent.action.MAIN” و “android.intent.category.LAUNCHER“، مما يؤدي إلى تمثيلها في مشغل التطبيق.

على الرغم من أن لا شيء من المرشحات في النشاط المستهدف نفسه قامت بتعيين هذه الأعلام.

بإستثناء النشاط المستهدف targetActivity، فإن سمات النشاط المُستعار <activity-alias> هي مجموعة فرعية من سمات النشاط.

بالنسبة للسمات في المجموعة الفرعية، ولا واحدة من القيم التي تم تعيينها للهدف، تنقل إلى المستعار.

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

 

السمات:

android:enabled

سواء كان أو لم يكن النشاط المستهدف يمكن تمثيله بواسطة النظام من خلال هذا المُستعار – تأخذ القيمة “true” إذا أمكن تمثيله، وتأخذ القيمة “false” إذا لم يمكن تمثيله. القيمة الإفتراضية هي “true”.

العنصر <application> يحتوي على سمة مُمكنة خاصة به، تنطبق على جميع مكونات التطبيق، بما في ذلك الأنشطة المستعارة.

يجب أن تكون كلٍ من، السمتين <application> و <activity-alias> معينتان على القيمة “true” ليتمكن النظام، من تمثيل النشاط المستهدف من خلال النشاط المستعار. إذا أخذت إحداهما القيمة “false”، فلن يعمل النشاط المستعار.

android:exported

سواء كانت أو لم تكن مكونات التطبيقات الأخرى يمكنها إطلاق “تشغيل” النشاط المستهدف من خلال هذا النشاط المُستعار.

تأخذ القيمة “true” إذا أمكنها ذلك، وتأخذ القيمة “false” إذا لم يمكنها.

إذا أخذت القيمة “false”، فإنه يمكن تشغيل النشاط المستهدف من خلال النشاط المُستعار فقط من خلال، مكونات نفس التطبيق كالمستعار أو التطبيقات التي لها نفس معرف المستخدم.

تعتمد القيمة الإفتراضية على ما إذا كان النشاط المستعار، يحتوي على مرشحات غرض.

غياب أي مرشحات يعني أنه يمكن إستدعاء النشاط من خلال النشاط المُستعار فقط، عن طريق تعيين اسم النشاط المستعار بالضبط.

و هذا يفترض أن النشاط المستعار معد فقط للإستخدام الداخلي في التطبيق (حيث أن التطبيقات الأخرى لا تعرف اسمه) – لذلك فإن القيمة الإفتراضية هي “false”.

من ناحية أخرى، وجود مرشح واحد على الأقل يفترض أن النشاط المستعار معد للإستخدام الخارجي – لذا فإن القيمة الإفتراضية هي “true”.

android:icon

أيقونة للنشاط المستهدف، عند تقديمه للمستخدمين من خلال النشاط المُستعار. لمزيد من المعلومات، راجع سمة أيقونة في العنصر <activity>.

 

android:label

مسمى يمكن للمستخدم قراءته للنشاط المُستعار، عند تقديمه للمستخدمين من خلال النشاط المُستعار. لمزيد من المعلومات راجع سمة مسمى في العنصر <activity>.

 

android:name

اسم فريد للنشاط المستعار. يجب أن يطابق الاسم، اسم الفئة المؤهلة بالكامل.

ولكن على عكس اسم النشاط المستهدف، يكون اسم النشاط المستعار عشوائياً “من إختيارك”؛ لا يشير إلى فئة حقيقيه.

 

android:permission

اسم الأذن التي يجب أن تكون لدى العملاء، ليقوموا بتشغيل النشاط المستهدف أو لجعله يقوم بفعل شيء بواسطة النشاط المُستعار.

إذا لم يتم منح مستدعي ()startActivity أو ()startActivityForResult الأذونات المحددة، فلن يتم تنشيط النشاط المستهدف.

هذه السمة تحل محل أي أذونات مخصصة للنشاط المستهدف. إذا لم يتم تعيينها، فلن تكون هناك حاجة لأذونات للقيام

بتنشيط الهدف من خلال النَشاط المستعار.

لمزيد من المعلومات حول الأذونات، راجع قسم الأذونات في المقدمة.

 

android:targetActivity

اسم النشاط الذي يمكن تنشيطة من خلال النَشاط المستعار. هذا الاسم يجب أن يتطابق مع اسم سمة العنصر

<activity> الذي يسبق المُستعار في ملف الإيضاح.

مقدمه في:
المستوى API 1

راجع أيضاً:
الأنشطة

 


للإطلاع على المقال باللغة الإنجليزية أضغط هنا.

الإعلانات