- بناء الجملة:
<application android:allowTaskReparenting=["true" | "false"] android:allowBackup=["true" | "false"] android:allowClearUserData=["true" | "false"] android:allowCrossUidActivitySwitchFromBelow=["true" | "false"] android:allowNativeHeapPointerTagging=["true" | "false"] android:appCategory=["accessibility" | "audio" | "game" | "image" | "maps" | "news" | "productivity" | "social" | "video"] android:backupAgent="string" android:backupInForeground=["true" | "false"] android:banner="drawable resource" android:dataExtractionRules="string resource" android:debuggable=["true" | "false"] android:description="string resource" android:enabled=["true" | "false"] android:extractNativeLibs=["true" | "false"] android:fullBackupContent="string" android:fullBackupOnly=["true" | "false"] android:gwpAsanMode=["always" | "never"] android:hasCode=["true" | "false"] android:hasFragileUserData=["true" | "false"] android:hardwareAccelerated=["true" | "false"] android:icon="drawable resource" android:isGame=["true" | "false"] android:isMonitoringTool=["parental_control" | "enterprise_management" | "other"] android:killAfterRestore=["true" | "false"] android:largeHeap=["true" | "false"] android:label="string resource" android:logo="drawable resource" android:manageSpaceActivity="string" android:name="string" android:networkSecurityConfig="xml resource" android:permission="string" android:persistent=["true" | "false"] android:process="string" android:restoreAnyVersion=["true" | "false"] android:requestLegacyExternalStorage=["true" | "false"] android:requiredAccountType="string" android:resizeableActivity=["true" | "false"] android:restrictedAccountType="string" android:supportsRtl=["true" | "false"] android:taskAffinity="string" android:testOnly=["true" | "false"] android:theme="resource or theme" android:uiOptions=["none" | "splitActionBarWhenNarrow"] android:usesCleartextTraffic=["true" | "false"] android:vmSafeMode=["true" | "false"] > . . . </application>
- الواردة في:
<manifest>
- يمكن أن يحتوي على:
<activity>
<activity-alias>
<meta-data>
<service>
<receiver>
<profileable>
<provider>
<uses-library>
<uses-native-library>
- description:
إعلان التطبيق. يحتوي هذا العنصر على عناصر فرعية التي تعلن عن كل مكوِّن من مكونات التطبيق ولها سمات يمكن أن تؤثر على جميع المكونات.
يمكن أن يساعد العديد من هذه السمات، مثل "
icon
" و"label
" و"permission
" و"process
"taskAffinity
وallowTaskReparenting
، ضبط القيم التلقائية للسمات المقابلة لعناصر المكوِّن. غير ذلك، مثلdebuggable
وenabled
وdescription
وallowClearUserData
، اضبط قيمًا للتطبيق بالكامل لا يتم تجاوزها بواسطة المكونات.- السمات
android:allowTaskReparenting
- ما إذا كان يمكن نقل الأنشطة التي يحددها التطبيق من
المهمة التي جعلتهم في المهمة التي يتناسبون معها عندما كانت تلك المهمة
هو التالي إلى المقدمة.
"true"
إذا كان بإمكانه التنقّل"false"
إذا كان يجب أن يظل مع المهمة التي بدأ منها. القيمة التلقائية هي"false"
.تشير رسالة الأشكال البيانية
<activity>
عنصر خاص لهallowTaskReparenting
يمكن أن تلغي القيمة المحددة هنا. android:allowBackup
تحديد ما إذا كان سيتم السماح للتطبيق بالمشاركة في عملية النسخ الاحتياطي واستعادة البنية التحتية. إذا تم ضبط هذه السمة على
"false"
، لا يتم إجراء نسخ احتياطي للتطبيق أو استعادته، حتى من خلال نسخة احتياطية للنظام بالكامل تتسبب في حفظ جميع بيانات التطبيق باستخدامadb
. القيمة التلقائية لهذه السمة هي"true"
.ملاحظة: بالنسبة إلى التطبيقات التي تستهدف الإصدار 12 من نظام التشغيل Android (المستوى 31 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث، ينطبق هذا السلوك يختلف. لا يمكنك إيقاف النقل من جهاز إلى آخر على أجهزة بعض الشركات المصنِّعة للأجهزة. من ملفات تطبيقك.
ومع ذلك، يمكنك إيقاف الاحتفاظ بنسخة احتياطية من ملفات تطبيقك واستعادتها عبر السحابة الإلكترونية من خلال ضبط هذه السمة إلى
"false"
، حتى إذا كان تطبيقك يستهدف الإصدار 12 من Android (المستوى 31 من واجهة برمجة التطبيقات) أعلى.لمزيد من المعلومات، يُرجى الاطّلاع على قسم الاحتفاظ بنسخة احتياطية والاستعادة من الصفحة التي تصف التغييرات في سلوك التطبيقات التي تستهدف الإصدار 12 من نظام التشغيل Android (المستوى 31 من واجهة برمجة التطبيقات) أعلى.
android:allowClearUserData
تحديد ما إذا كان سيتم السماح للتطبيق بإعادة تعيين بيانات المستخدمين أم لا. تتضمن هذه البيانات علامات مثل ما إذا كان المستخدم قد رأى تلميحات تمهيدية، مثل بالإضافة إلى الإعدادات والتفضيلات التي يمكن تخصيصها للمستخدم. والقيمة الافتراضية لهذه
"true"
.ملاحظة: يمكن فقط للتطبيقات التي تشكّل جزءًا من صورة النظام أن تعلن عن هذه السمة بشكل صريح. لا يمكن للتطبيقات التابعة لجهات خارجية تضمين هذا العنصر في ملفات البيان الخاصة بها.
لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على الاحتفاظ بنسخة احتياطية من البيانات.
android:allowCrossUidActivitySwitchFromBelow
يحدد ما إذا كانت الأنشطة الموجودة أسفل هذا النشاط في المهمة يمكن أن تبدأ أيضًا أنشطة أخرى أو إنهاء المهمة.
بدءًا من المستوى المستهدَف
Build.VERSION_CODES.VANILLA_ICE_CREAM
لحزمة تطوير البرامج (SDK) قد يتم منعهم من بدء أنشطة جديدة أو إنهاء مهمتهم ما لم يكن النشاط الرئيسي تنتمي هذه المهمة إلى المعرف الفريد نفسه لأسباب تتعلق بالأمان.يؤدي ضبط هذه العلامة على
true
إلى السماح لتطبيق التشغيل بتجاهل التقييد في حال يكون هذا النشاط في الأعلى. يتم دائمًا استثناء التطبيقات التي تطابق المعرّف الفريد لهذا النشاط.لمزيد من المعلومات، يُرجى الاطّلاع على بدء تشغيل الأنشطة في الخلفية الآمنة.
android:allowNativeHeapPointerTagging
ما إذا كان التطبيق يمكّن ميزة وضع علامات مؤشر أداء العناصر في الذاكرة. إن القيمة الافتراضية هذه السمة هي
"true"
.ملاحظة: لا يعالج إيقاف هذه الميزة بسبب مشكلة في صحة الرمز الأساسي. وقد لا تتيح الأجهزة المستقبلية استخدام علامة البيان هذه.
لمزيد من المعلومات، يُرجى الاطّلاع على المؤشرات التي تم وضع علامات عليها.
android:appCategory
لتعريف فئة هذا التطبيق. تُستخدَم الفئات لتجميع تطبيقات متعددة معًا في مجموعات ذات مغزى، على سبيل المثال عند تلخيص البطارية أو الشبكة أو استخدام القرص. حدِّد هذه القيمة فقط للتطبيقات التي تتلاءم جيدًا مع أحد الفئات المحددة.
يجب أن تكون القيمة واحدة من القيم الثابتة التالية.
القيمة الوصف accessibility
التطبيقات المخصّصة لتسهيل الاستخدام في المقام الأول، مثل برامج قراءة الشاشة audio
التطبيقات التي تعمل بشكل أساسي مع الصوت أو الموسيقى، مثل مشغّلات الموسيقى game
التطبيقات التي تتضمّن في الأساس ألعابًا image
التطبيقات التي تعمل بشكل أساسي مع الصور أو الصور، مثل تطبيقات الكاميرا أو معرض الصور maps
التطبيقات التي يكون الغرض منها بشكل أساسي تطبيقات الخرائط، مثل تطبيقات التنقّل news
التطبيقات المستخدَمة في مجال الأخبار في المقام الأول، مثل الصحف أو المجلات أو التطبيقات الرياضية productivity
التطبيقات التي تعمل في الأساس على زيادة الإنتاجية، مثل التخزين في السحابة الإلكترونية أو التطبيقات في مكان العمل social
التطبيقات التي تشكّل في الأساس تطبيقات اجتماعية، مثل تطبيقات المراسلة أو التواصل أو البريد الإلكتروني أو شبكات التواصل الاجتماعي video
التطبيقات التي تعمل بشكل أساسي مع الفيديوهات أو الأفلام، مثل تطبيقات بث الفيديو المباشر android:backupAgent
- اسم الفئة التي تنفّذ الوكيل الاحتياطي للتطبيق،
فئة فرعية من
BackupAgent
. قيمة السمة هي اسم فئة مؤهل بالكامل، مثل"com.example.project.MyBackupAgent"
. ومع ذلك، وكاختصار، إذا كان الحرف الأول من الاسم نقطة، على سبيل المثال،".MyBackupAgent"
، فسيتم إلحاقه بالحقل اسم الحزمة المحددة في<manifest>
العنصر.لا يوجد إعداد افتراضي. يجب أن يكون الاسم محددًا.
android:backupInForeground
- يشير إلى أن
عمليات التحميل التلقائي
يمكن تنفيذه على هذا التطبيق حتى إذا كان التطبيق في الواجهة الأمامية.
الولاية. يوقف النظام تشغيل التطبيق أثناء عملية النسخ الاحتياطي التلقائي،
لذا استخدم هذه السمة بحذر. يمكن أن يؤدي ضبط هذه العلامة على
"true"
إلى التأثير في التطبيق. السلوك عندما يكون التطبيق نشطًا.والقيمة التلقائية هي
"false"
، ما يعني أنّ نظام التشغيل يتجنّب الاحتفاظ بنسخة احتياطية من التطبيق أثناء تشغيله في المقدّمة، مثل تطبيق موسيقى يشغّلون الموسيقى بشكل نشط باستخدام خدمة في ولايةstartForeground()
. android:banner
- مورد قابل للرسم
يقدم بانر رسومي موسَّع للعنصر المرتبط به. الاستخدام مع
<application>
لتقديم بانر تلقائي لجميع أنشطة التطبيق أو مع<activity>
لتقديم بانر لنشاط معين.يستخدم النظام البانر لتمثيل تطبيق في شاشة Android TV الرئيسية. لذلك، حدد ذلك فقط للتطبيقات التي لها نشاط يعالج هدف واحد (
CATEGORY_LEANBACK_LAUNCHER
).يتم تعيين هذه السمة كمرجع لمورد قابل للرسم يحتوي على الصورة، على سبيل المثال
"@drawable/banner"
. لا يوجد بانر تلقائي.لمزيد من المعلومات، يُرجى مراجعة توفير إعلان بانر للشاشة الرئيسية
android:dataExtractionRules
يمكن للتطبيقات ضبط هذه السمة على مورد XML حيث تحدد تحدِّد الملفات والأدلة التي يمكن نسخها من الجهاز كجزء من عملية الاحتفاظ بنسخة احتياطية أو وعمليات النقل.
للحصول على معلومات حول تنسيق ملف XML، يُرجى الاطّلاع على الاحتفاظ بنسخة احتياطية والاستعادة.
android:debuggable
- ما إذا كان من الممكن تصحيح أخطاء التطبيق، حتى أثناء تشغيله
على جهاز في وضع المستخدم. تبلغ درجة الحرارة
"true"
إذا كانت و"false"
. إن لم يكن كذلك. القيمة التلقائية هي"false"
. android:description
- نص عن التطبيق يمكن للمستخدمين قراءته، وهو أطول وأكثر وصفية من تصنيف التطبيق. يتم تعيين القيمة كمرجع لمورد السلسلة. وعلى عكس التصنيف، لا يمكن أن تكون سلسلة أولية. لا يوجد قيمة افتراضية.
android:enabled
- ما إذا كان نظام Android يمكنه إنشاء مثيل لمكونات
التطبيق. تبلغ درجة الحرارة
"true"
إذا أمكن و"false"
. إن لم يكن كذلك. وإذا كانت القيمة"true"
، سيتم تحديد قيمة تحدِّد السمةenabled
ما إذا كان هذا المكوِّن مفعَّلاً. إذا كانت القيمة هي"false"
، ستلغي القيمة القيم الخاصة بالمكون، ويتم إيقاف كل المكونات.القيمة التلقائية هي
"true"
. android:extractNativeLibs
- تشير هذه السمة إلى ما إذا كانت أداة تثبيت الحزمة تستخرج المكتبات الأصلية من
APK إلى نظام الملفات. وفي حال ضبط السياسة على
"false"
، سيتم تخزين مكتباتك الأصلية. غير مضغوط في حزمة APK. على الرغم من أنّ حزمة APK قد تكون أكبر حجمًا، يتم تحميل تطبيقك بشكل أسرع. لأنّ المكتبات يتم تحميلها مباشرةً من حزمة APK في وقت التشغيلتعتمد القيمة التلقائية للسمة
extractNativeLibs
علىminSdkVersion
إصدار AGP الذي تستخدمه. في معظم الحالات، يكون السلوك الافتراضي هو ما تريده على الأرجح، لست مضطرًا إلى ضبط هذه السمة بشكل صريح android:fullBackupContent
- تشير هذه السمة إلى ملف XML يحتوي على قواعد النسخ الاحتياطي الكاملة
التحميل التلقائي:
وتحدّد هذه القواعد الملفات التي يتم الاحتفاظ بنسخة احتياطية منها. لمزيد من المعلومات، يُرجى الاطّلاع على
بنية إعدادات XML
التحميل التلقائي.
هذه السمة اختيارية. وإذا لم يتم تحديده، فسيتم تلقائيًا استخدام ميزة التحميل التلقائي تتضمن معظم ملفات تطبيقك. لمزيد من المعلومات، يُرجى مراجعة الملفات التي تم الاحتفاظ بنسخة احتياطية منها
android:fullBackupOnly
- تشير هذه السمة إلى ما إذا كان من المناسب استخدام
التحميل التلقائي على الأجهزة
مكان توفرها. إذا تم ضبط السياسة على "
"true"
"، سينفّذ تطبيقك أداءً جيدًا. ميزة التحميل التلقائي عند تثبيت التطبيق على جهاز يعمل بالإصدار Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات) أعلى. على الأجهزة القديمة، يتجاهل تطبيقك هذه السمة ويعمل النُسخ الاحتياطية للمفتاح/القيمة.القيمة التلقائية هي
"false"
. android:gwpAsanMode
- تشير هذه السمة إلى ما إذا كان من المناسب استخدام
GWP-ASan، وهي ميزة أصلية لتوزيع الذاكرة تساعد
العثور على أخطاء "للاستخدام بعد الاستخدام" وتجاوز سعة المخزن المؤقت لأجزاء من الذاكرة.
القيمة التلقائية هي
"never"
. android:hasCode
- سواء كان التطبيق يحتوي على أي رمز DEX، أي رمز برمجي يستخدم
لغة البرمجة Kotlin أو Java.
يكون
"true"
إذا كان كذلك و"false"
إذا لم يكن كذلك. عندما هي"false"
، لا يحاول النظام تحميل أي تطبيق التعليمات البرمجية عند إطلاق المكونات. القيمة التلقائية هي"true"
.وإذا كان التطبيق يتضمن رمزًا أصليًا (C/C++ )، ولكن بدون رمز DEX، يجب يمكن ضبطها على
"false"
. في حال ضبط السياسة على"true"
عند ضبط حزمة APK لا يحتوي على رمز DEX، قد يتعذّر تحميل التطبيق.يجب أن يراعي هذا الموقع الرمز البرمجي المضمّن في التطبيق من خلال والتبعيات لديك إذا كان التطبيق يعتمد على ميزة AAR التي تستخدم يجب إدخال رمز Java أو Kotlin، أو رمز JAR مباشرةً، وهو
app:hasCode
"true"
، أو يمكن حذفها لأنّ هذه هي القيمة التلقائية.على سبيل المثال، قد يدعم تطبيقك عرض الميزات في Play وتضمين الميزات والوحدات التي لا تنشئ أي ملفات DEX، وهي رمز بايت محسّن لنظام Android بدون خادم. إذا كان الأمر كذلك، يجب عليك ضبط هذه السمة على
"false"
في بيان الوحدة. لتجنب أخطاء بيئة التشغيل. android:hasFragileUserData
- ما إذا كان سيتم عرض طلب للمستخدم
الاحتفاظ ببيانات التطبيق عند إلغاء المستخدم تثبيت التطبيق القيمة التلقائية هي
"false"
. android:hardwareAccelerated
- ما إذا كان سيتم تفعيل العرض المسرّع بالأجهزة للجميع
في هذا التطبيق. تكون الساعة
"true"
إذا كانت. مفعَّلة و"false"
إذا لم يتم تفعيلها. القيمة التلقائية هي"true"
في حال ضبط الإعدادات. إماminSdkVersion
أوtargetSdkVersion
إلى"14"
أو أعلى. بخلاف ذلك، هي"false"
.بدءًا من Android 3.0 (المستوى 11 من واجهة برمجة التطبيقات)، سيعمل عارض OpenGL الذي يسرّع الجهاز على متاحة للتطبيقات لتحسين أداء العديد من الرسومات ثنائية الأبعاد الشائعة العمليات التجارية. عند تفعيل عارض الأجهزة التي تم تسريعها، تجري معظم العمليات في Canvas وPaint وXfermode وColorFilter وShader والكاميرا.
وبذلك ستحصل على صور متحركة أكثر سلاسة وتنقّل أكثر سلاسة وتحسينًا والاستجابة بشكل عام، حتى بالنسبة للتطبيقات التي لا تستخدم بشكل صريح مكتبات OpenGL لإطار العمل.
لا يتم تسريع جميع عمليات OpenGL 2D. في حال تفعيل الخيار عارض الأجهزة المسرّعة، واختبار التطبيق حتى يتمكن الاستفادة من العارض بدون أخطاء.
لمزيد من المعلومات، يُرجى الاطّلاع على تسريع الأجهزة الدليل.
android:icon
- رمز للتطبيق بالكامل والرمز التلقائي للتطبيق
كل مكون من مكونات التطبيق. الاطّلاع على الشخص
icon
سمة<activity>
,<activity-alias>
,<service>
,<receiver>
،<provider>
عنصرًايتم تعيين هذه السمة كمرجع لمورد قابل للرسم يحتوي على الصورة، مثل
"@drawable/icon"
. ليس هناك رمز تلقائي. android:isGame
- ما إذا كان التطبيق لعبة. قد يجمّع النظام التطبيقات المصنّفة معًا
كألعاب أو عرضها بشكل منفصل عن التطبيقات الأخرى. والقيمة التلقائية هي
"false"
. android:isMonitoringTool
يشير إلى أن هذا التطبيق مصمم لمراقبة أفراد آخرين.
ملاحظة: إذا أعلن تطبيق عن هذه السمة في ملف البيان الخاص به، يجب على المطوِّر اتبع برنامج Stalkerware لنشر التطبيق على Google Play.
لا يوجد قيمة افتراضية. على المطوِّر تحديد إحدى القيم التالية:
القيمة الوصف "parental_control"
حملة تطبيقات تلبّي أدوات رقابة الأهل وتستهدف بشكل خاص الأهل الذين يريدون إبقاء أطفالهم آمِن "enterprise_management"
حملة تطبيقات يلبي احتياجات المؤسسات التي تريد إدارة الأجهزة الممنوحة للموظفين وتتبعها. "other"
تلبية التطبيق لأحد الاستخدامات حالة لم يتم تحديدها بطريقة أخرى في هذا الجدول. android:killAfterRestore
ما إذا كان سيتم إنهاء التطبيق بعد تمت استعادة الإعدادات أثناء عملية استعادة النظام بالكامل. لا تتسبب عمليات استعادة الحزمة الواحدة في إحداث مشكلات في التطبيق إيقاف التشغيل. عادةً ما تتم عمليات استعادة النظام بالكامل مرة واحدة فقط، عند إعداد الهاتف لأول مرة. ولا تستخدم التطبيقات التابعة لجهات خارجية بحاجة إلى استخدام هذه السمة.
والقيمة التلقائية هي
"true"
، ما يعني أنّه بعد فتح التطبيق تنتهي من معالجة البيانات أثناء استعادة النظام بالكامل، ويتم إنهاؤها.android:largeHeap
ما إذا تم إنشاء عمليات التطبيق باستخدام رمز Dalvik كبير الحجم ينطبق هذا على جميع العمليات التي تم إنشاؤها للتطبيق. وهو لا ينطبق إلا على أول تطبيق تم تحميله في الدفع. إذا كنت تستخدم رقم تعريف مستخدم مشتركًا للسماح لعدة تطبيقات باستخدام عملية ما، سيتم تطبيق جميع هذه العمليات استخدام هذا الخيار باستمرار لتجنب النتائج غير المتوقعة.
لا تحتاج معظم التطبيقات إلى ذلك وتركز بدلاً من ذلك على تقليل استخدامها بشكل عام للذاكرة تحسين الأداء. كما أن تفعيل ذلك لا يضمن زيادة ثابتة في الذاكرة المتاحة، وذلك لأن بعض الأجهزة مقيَّدة بإجمالي الذاكرة المتاحة.
للاستعلام عن حجم الذاكرة المتاح في وقت التشغيل، استخدِم الطريقتين
getMemoryClass()
أوgetLargeMemoryClass()
.android:label
- تصنيف سهل القراءة للمستخدم على التطبيق ككل وتصنيف تلقائي
لكل مكون من مكونات التطبيق. الاطّلاع على الشخص
label
سمة<activity>
,<activity-alias>
,<service>
,<receiver>
،<provider>
عنصرًايتم تعيين التسمية كمرجع لمورد السلسلة، بحيث يمكن ترجمتها مثل السلاسل الأخرى في واجهة المستخدم. ومع ذلك، ولتسهيل الأمر أثناء تطوير التطبيق، ويمكن أيضًا ضبطه كسلسلة أولية.
android:logo
- شعار للتطبيق بالكامل وشعار تلقائي للأنشطة
يتم تعيين هذه السمة كمرجع لمورد قابل للرسم يحتوي على
الصورة، مثل
"@drawable/logo"
. لا يتوفّر شعار تلقائي. android:manageSpaceActivity
- الاسم المؤهّل بالكامل لفئة فرعية
Activity
يستخدمها النظام للسماح للمستخدمين بإدارة الذاكرة التي يشغلها التطبيق على الجهاز. يتم تعريف النشاط أيضًا باستخدام العنصر<activity>
. android:name
- اسم
Application
المؤهل بالكامل فئة فرعية تم تنفيذها للتطبيق. عند بدء عملية تقديم الطلب يتم إنشاء مثيل لهذه الفئة قبل أي من والمكونات.الفئة الفرعية اختيارية. ولا تحتاج معظم التطبيقات إلى أداة. وفي غياب فئة فرعية، يستخدم Android مثيلاً للقاعدة صف واحد (
Application
). android:networkSecurityConfig
تُحدِّد اسم ملف XML الذي يحتوي على عنوان ملف تطبيقك أمان الشبكة الضبط. القيمة هي مرجع إلى ملف موارد XML الذي يحتوي على الإعدادات.
تمّت إضافة هذه السمة في المستوى 24 من واجهة برمجة التطبيقات.
android:permission
- اسم الإذن الذي يحتاجه العملاء للتفاعل
بواسطة التطبيق. وهذه السمة هي طريقة ملائمة لضبط
الذي ينطبق على جميع مكونات التطبيق. من المهم
يتم الاستبدال من خلال ضبط سمات
permission
للفرد والمكونات.لمزيد من المعلومات حول الأذونات، يمكنك الاطّلاع على الأذونات في نظرة عامة على بيان التطبيق نصائح الأمان:
android:persistent
- ما إذا كان التطبيق سيظل قيد التشغيل في جميع الأوقات من المهم
"true"
إذا كان الأمر كذلك و"false"
إذا لم يكن كذلك. القيمة التلقائية"false"
. لا تضبط التطبيقات هذه العلامة عادةً. وضع "الاستمرارية" مخصّص فقط لتطبيقات معيّنة من تطبيقات النظام. android:process
- اسم العملية التي يتم فيها تشغيل جميع مكوّنات التطبيق.
يمكن لكل مكوّن إلغاء هذا الخيار التلقائي من خلال ضبط
process
خاص به. .ينشئ Android بشكل تلقائي عملية لأحد التطبيقات عند من مكوناته بحاجة إلى التشغيل. ثم يتم تشغيل جميع المكونات في هذه العملية. يتطابق اسم العملية الافتراضية مع اسم الحزمة الذي تحدده العنصر
<manifest>
.من خلال تعيين هذه السمة على اسم عملية تتم مشاركته مع التطبيق، يمكنك الترتيب لتشغيل مكونات كلا التطبيقين في نفس العملية، ولكن فقط إذا كان التطبيقان يتشاركان أيضًا في رقم تعريف المستخدم وتم توقيعها باستخدام الشهادة نفسها.
إذا كان الاسم المعيّن لهذه السمة يبدأ بنقطتين (
:
)، تكون قيمة عملية خاصة بالتطبيق، عند الحاجة إليها. إذا بدأ اسم العملية بحرف صغير، فإن عملية عامة يتم إنشاء يحمل هذا الاسم. يمكن مشاركة عملية عمومية مع التطبيقات، ومن ثم يقلل استخدام الموارد. android:restoreAnyVersion
- يشير إلى أن التطبيق جاهز لمحاولة استعادة أي
مجموعة بيانات تم نسخها احتياطيًا، حتى إذا تم تخزين النسخة الاحتياطية من خلال إصدار أحدث
من التطبيق أكثر من المثبت حاليًا على الجهاز. الإعداد
هذه السمة إلى
"true"
يتيح مدير النسخ الاحتياطي محاولة الاستعادة حتى عندما يشير عدم تطابق الإصدار إلى أن البيانات غير متوافق. يُرجى توخي الحذر عند الاستخدام.القيمة التلقائية لهذه السمة هي
"false"
. android:requestLegacyExternalStorage
-
ما إذا كان التطبيق يريد إيقاف مساحة تخزين إضافية.
ملاحظة: وفقًا للتغييرات ذات الصلة بالسياسة أو التطبيق ، فقد لا يفي النظام بطلب إلغاء الاشتراك هذا.
android:requiredAccountType
- يحدد هذا الإعداد نوع الحساب الذي يتطلبه التطبيق ليعمل.
إذا كان تطبيقك يتطلّب السمة
Account
، يجب أن تكون قيمة هذه السمة يتوافق مع أداة مصادقة الحساب والنوع الذي يستخدمه تطبيقك، على النحو المحدّد فيAuthenticatorDescription
مثل"com.google"
.تشير القيمة الافتراضية "فارغ" إلى أن التطبيق يمكن أن يعمل بدون أي حسابات.
لأنّ الملفات الشخصية محظورة لا يمكنك إضافة حسابات، لأنّ تحديد هذه السمة يجعل تطبيقك غير متاحة في ملف شخصي مقيَّد ما لم توضح أيضًا مستندات
android:restrictedAccountType
مع نفس القيمة.تنبيه: إذا كانت بيانات الحساب قد تكشف عن معلومات تحديد الهوية الشخصية، فمن المهم تعلن عن هذه السمة وتترك قيمة
android:restrictedAccountType
فارغة، بحيث لا يمكن للملفات الشخصية المحظورة استخدام تطبيقك للوصول إلى معلومات شخصية تخص المستخدم المالك.تمّت إضافة هذه السمة في المستوى 18 من واجهة برمجة التطبيقات.
android:resizeableActivity
-
تحدِّد هذه السياسة ما إذا كان التطبيق يتيح وضع النوافذ المتعددة. إِنْتَ يمكنك تعيين هذه السمة في
<activity>
أو<application>
.في حال ضبط هذه السمة على
"true"
، يمكن للمستخدم بدء النشاط في وضع تقسيم الشاشة ووضع التصميم الحر. إذا ضبطت السمة على"false"
، سيتم تطبيق لا يمكن اختباره أو تحسينه ليناسب بيئة متعددة النوافذ. يمكن للنظام الاستمرار في وضع النشاط في وضع النوافذ المتعددة مع تطبيق وضع التوافق.إنّ ضبط هذه السمة على
"true"
لا يضمن عدم توفّرها التطبيقات الأخرى في وضع النوافذ المتعددة المرئية على الشاشة، مثل "نافذة ضمن النافذة" على شاشات أخرى. لذلك، لا يعني ضبط هذه العلامة أنّ تطبيقك إمكانية الوصول إلى الموارد الحصرية.بالنسبة إلى التطبيقات التي تستهدف المستوى 24 من واجهة برمجة التطبيقات أو المستويات الأعلى، يكون الإعداد التلقائي هو
"true"
.إذا كان تطبيقك يستهدف المستوى 31 من واجهة برمجة التطبيقات أو مستوى أعلى، ستعمل هذه السمة بشكل مختلف على التطبيقات الصغيرة والكبيرة. الشاشات:
- الشاشات الكبيرة (sw >= 600dp): تتيح جميع التطبيقات وضع النوافذ المتعددة. تشير السمة إلى
ما إذا كان من الممكن تغيير حجم التطبيق، وليس ما إذا كان التطبيق يتوافق مع وضع النوافذ المتعددة. في حال حذف
resizeableActivity="false"
، يتم ضبط التطبيق في وضع التوافق عند الضرورة. للتوافق مع أبعاد العرض. - الشاشات الصغيرة (sw < 600dp): إذا كانت
resizeableActivity="true"
والحد الأدنى العرض والحد الأدنى لارتفاع النشاط الرئيسي ضمن متطلبات النوافذ المتعددة، يدعم وضع النوافذ المتعددة. إذاresizeableActivity="false"
، لن يتمكن التطبيق من تتيح وضع النوافذ المتعددة بغض النظر عن الحد الأدنى للعرض والارتفاع للنشاط.
ملاحظة: يمكن للشركات المصنّعة للأجهزة إلغاء المستوى 31 من واجهة برمجة التطبيقات. السلوك.
تمّت إضافة هذه السمة في المستوى 24 من واجهة برمجة التطبيقات.
ملاحظة: يتم تطبيق قيمة النشاط الجذري للمهمة على جميع الأنشطة الإضافية التي تم إطلاقها في المهمة. أي، إذا كان النشاط الجذري يمكن تغيير حجم مهمة ما، فإن النظام سيتعامل مع جميع الأنشطة الأخرى في مهمة على أنها يمكن تغيير حجمها. إذا تعذّر تغيير حجم نشاط الجذر، يتم استخدام عدم تغيير حجم الأنشطة في المهمة.
- الشاشات الكبيرة (sw >= 600dp): تتيح جميع التطبيقات وضع النوافذ المتعددة. تشير السمة إلى
ما إذا كان من الممكن تغيير حجم التطبيق، وليس ما إذا كان التطبيق يتوافق مع وضع النوافذ المتعددة. في حال حذف
android:restrictedAccountType
- يحدد هذا الإعداد نوع الحساب الذي يتطلبه هذا التطبيق ويشير إلى الملفات الشخصية المحظورة.
الوصول إلى هذه الحسابات التي تخص المستخدم المالك. إذا كان تطبيقك يتطلب
يمكن أن يكون لدى
Account
والملفات الشخصية المقيّدة بالوصول إلى حسابات المستخدم الأساسي، يجب أن تكون قيمة هذه السمة مع نوع مصادقة الحساب الذي يستخدمه تطبيقك، التي يحددهاAuthenticatorDescription
، مثل"com.google"
.القيمة التلقائية هي "خالية" وتشير إلى أن التطبيق يمكن أن يعمل بدون أي الحسابات.
تنبيه: يتيح تحديد هذه السمة للملفات الشخصية المحظورة استخدام تطبيق يحتوي على حسابات تخص المستخدم المالك، وقد يكشف عن ذلك معلومات تحديد الهوية الشخصية. المعلومات. إذا كان الحساب يكشف عن تفاصيل شخصية، يُرجى عدم استخدام هذه السمة. بدلاً من ذلك، يجب تقديم بيان عن السمة
android:requiredAccountType
. لجعل تطبيقك غير متوفّر للملفات الشخصية المحظورةتمّت إضافة هذه السمة في المستوى 18 من واجهة برمجة التطبيقات.
android:supportsRtl
توضح ما إذا كان تطبيقك مستعدًا لدعم التنسيقات من اليمين إلى اليسار (RTL).
إذا تم ضبط هذا الإعداد على
"true"
targetSdkVersion
على 17 أو أعلى، فإن العديد من واجهات برمجة التطبيقات RTL يتم تفعيلها واستخدامها من قِبل النظام ليتمكّن تطبيقك من عرض تنسيقات التنسيق من اليمين إلى اليسار. في حال ضبط هذه السياسة على"false"
أو ضبطtargetSdkVersion
على 16 أو أقل، سيتم تجاهل واجهات برمجة التطبيقات ذات التنسيق "RTL". أو لا يكون لها أي تأثير، ويعمل التطبيق بالطريقة نفسها بغض النظر عن التنسيق المرتبط باختيار لغة المستخدم. أي أن تخطيطاتك دائمًا من اليسار إلى اليمين.القيمة التلقائية لهذه السمة هي
"false"
.تمّت إضافة هذه السمة في المستوى 17 من واجهة برمجة التطبيقات.
android:taskAffinity
- اسم تقارب ينطبق على جميع الأنشطة داخل التطبيق،
باستثناء تلك التي لها اهتمامات مختلفة
taskAffinity
ذات الصلة. اطّلِع على تلك السمة للحصول على مزيد من المعلومات.تشترك جميع الأنشطة داخل التطبيق في نفس التقارب. اسم شريحة الجمهور ذات الاهتمامات المشتركة هذه هو نفسه اسم الحزمة التي تم ضبطها من قِبل العنصر
<manifest>
. android:testOnly
- يشير إلى ما إذا كان هذا التطبيق مخصَّصًا لأغراض الاختبار فقط. على سبيل المثال:
فقد يكشف عن وظائف أو بيانات خارجية يمكن أن تتسبب في أمان
ولكن يجب أن تكون مفيدة للاختبار. لا يتم تثبيت هذا النوع من ملفات APK إلا
من خلال
adb
. لا يمكنك نشره على Google Play.يضيف "استوديو Android" هذه السمة تلقائيًا عند النقر على تشغيل
android:theme
- إشارة إلى مورد نمط يحدّد مظهرًا تلقائيًا للجميع
الأنشطة في التطبيق. يمكن أن تلغي الأنشطة الفردية
كإعداد تلقائي من خلال ضبط
theme
الخاصة بها ذات الصلة. لمزيد من المعلومات، يُرجى الاطّلاع على الأنماط والمظاهر. android:uiOptions
- خيارات إضافية في واجهة المستخدم لأحد الأنشطة. يجب أن تكون القيمة واحدة مما يلي:
القيمة الوصف "none"
ما مِن خيارات إضافية لواجهة المستخدم. هذا هو الخيار التلقائي. "splitActionBarWhenNarrow"
يضيف شريط في أسفل الشاشة لعرض بنود العمل في شريط التطبيقات، ويُعرف أيضًا باسم شريط الإجراءات عند مقيدة للمساحة الأفقية، كما هو الحال عند الوضع الرأسي على الهاتف. بدلاً من رمز صغير عدد بنود العمل التي تظهر في شريط التطبيق أعلى الشاشة، ويمثل شريط التطبيق مقسمة إلى قسم التنقل العلوي والشريط السفلي لبنود العمل. وهذا يعني أنه من المعقول مقدار المساحة المتاحة لبنود العمل وللتنقل والعنوان والعناصر في الجزء العلوي. لا يتم تقسيم عناصر القائمة على الشريطين. تظهر دائمًا لمزيد من المعلومات حول شريط التطبيقات، اطّلِع على مقالة إضافة شريط التطبيقات.
تمّت إضافة هذه السمة في المستوى 14 من واجهة برمجة التطبيقات.
android:usesCleartextTraffic
- تشير إلى ما إذا كان التطبيق يهدف إلى استخدام حركة بيانات cleartext Network، مثل cleartext HTTP.
أما القيمة التلقائية للتطبيقات التي تستهدِف المستوى 27 من واجهة برمجة التطبيقات أو أقل منه، فهي
"true"
. التطبيقات التي مستوى واجهة برمجة التطبيقات المستهدَف 28 أو أعلى تلقائيًا هو"false"
.عند ضبط السمة على
"false"
، تتم إضافة مكوّنات النظام الأساسي، مثل HTTP وFTP. المكدسات وDownloadManager
MediaPlayer
، رفض التطبيقات لاستخدام حركة مرور النص الواضح.ننصح مكتبات الجهات الخارجية بشدة باحترام هذا معين. إن السبب الرئيسي لتجنب حركة البيانات ذات النص الواضح هو الافتقار إلى السرية، والأصالة، والحماية من التلاعب. يمكن لمهاجم الشبكة التنصت على المعلومات المنقولة البيانات وتعديلها أيضًا بدون أن يتم اكتشافها.
يتم تكريم هذه العلامة على أساس بذل أفضل الجهود لأنه يستحيل منع أي نصوص واضحة الزيارات الواردة من تطبيقات Android مع الأخذ في الاعتبار مستوى الوصول الممنوح لهم. على سبيل المثال، هناك لا توقّع أن تمتثل واجهة برمجة التطبيقات
Socket
هذه العلامة، لأنها لا تستطيع تحديد ما إذا كانت حركة المرور الخاصة بها بنص واضح.ومع ذلك، فإن معظم حيث تتم معالجة حركة بيانات الشبكة من التطبيقات عن طريق مكدسات ومكونات الشبكة ذات المستوى الأعلى، والتي يمكنها وتقدير هذه العلامة إما بقراءتها من
ApplicationInfo.flags
أوNetworkSecurityPolicy.isCleartextTrafficPermitted()
ملاحظة: يستخدم
WebView
هذه السمة التي تستهدف المستوى 26 من واجهة برمجة التطبيقات والمستويات الأعلى.أثناء تطوير التطبيق، يمكن استخدام الوضع StrictMode لتحديد أي زيارات بنص واضح من التطبيق. لمزيد من المعلومات، يُرجى مراجعة
StrictMode.VmPolicy.Builder.detectCleartextNetwork()
تمّت إضافة هذه السمة في المستوى 23 من واجهة برمجة التطبيقات.
يتم تجاهل هذه العلامة على نظام التشغيل Android 7.0 (المستوى 24 لواجهة برمجة التطبيقات) والإصدارات الأحدث إذا كانت إحدى ميزات أمان شبكة Android الإعداد متوفّر.
android:vmSafeMode
تشير القيمة - إلى ما إذا كان التطبيق يريد تشغيل الجهاز الافتراضي (VM).
في الوضع الآمن. القيمة التلقائية هي
"false"
.تمّت إضافة هذه السمة في المستوى 8 من واجهة برمجة التطبيقات، حيث تم ضبط قيمة
"true"
على إيقاف المحول البرمجي لـ Dalvik في الوقت المناسب (JIT).تمّ تعديل هذه السمة في المستوى 22 من واجهة برمجة التطبيقات، حيث بلغت القيمة
"true"
محول تجميع ART مسبقًا (AOT).
بدءًا من AGP 4.2.0، فإن خيار DSL
useLegacyPackaging
يستبدل سمة البيانextractNativeLibs
. استخدامuseLegacyPackaging
في ملفbuild.gradle
لتطبيقك بدلاً منextractNativeLibs
في ملف البيان لإعداد المكتبة الأصلية أسلوب الضغط. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظة الإصدار. استخدام DSL لتجميع المكتبات الأصلية المضغوطة- تم تقديمها في:
- المستوى 1 من واجهة برمجة التطبيقات
- راجِع أيضًا:
<activity>
<service>
<receiver>
<provider>
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[{
"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":"غير ذلك"
}]
{
"lastModified": "تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)",
"confidential": False
}