تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

<التطبيق>

بناء الجملة:

<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

بدءًا من AGP 4.2.0، فإن خيار DSL useLegacyPackaging يستبدل سمة البيان extractNativeLibs. استخدام useLegacyPackaging في ملف build.gradle لتطبيقك بدلاً من extractNativeLibs في ملف البيان لإعداد المكتبة الأصلية أسلوب الضغط. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظة الإصدار. استخدام DSL لتجميع المكتبات الأصلية المضغوطة

تشير هذه السمة إلى ما إذا كانت أداة تثبيت الحزمة تستخرج المكتبات الأصلية من 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".

تحذير: تم إيقاف هذه السمة نهائيًا. بدلاً من ذلك، يمكنك استخدام appCategory تم تعيين السمة على game.

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 من واجهة برمجة التطبيقات.

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

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" يضيف شريط في أسفل الشاشة لعرض بنود العمل في شريط التطبيقات، ويُعرف أيضًا باسم شريط الإجراءات عند مقيدة للمساحة الأفقية، كما هو الحال عند الوضع الرأسي على الهاتف. بدلاً من رمز صغير عدد بنود العمل التي تظهر في شريط التطبيق أعلى الشاشة، ويمثل شريط التطبيق مقسمة إلى قسم التنقل العلوي والشريط السفلي لبنود العمل. وهذا يعني أنه من المعقول مقدار المساحة المتاحة لبنود العمل وللتنقل والعنوان والعناصر في الجزء العلوي. لا يتم تقسيم عناصر القائمة على الشريطين. تظهر دائمًا

القيمة	الوصف
`"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).

تم تقديمها في:

المستوى 1 من واجهة برمجة التطبيقات

راجِع أيضًا:

<activity>
<service>
<receiver>
<provider>