- نحو:
<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:enableOnBackInvokedCallback=["true" | "false"] android:extractNativeLibs=["true" | "false"] android:forceQueryable=["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:intentMatchingFlags=["none" | "enforceIntentFilter" | "allowNullAction"] android:isGame=["true" | "false"] android:isMonitoringTool=["parental_control" | "enterprise_management" | "other"] android:killAfterRestore=["true" | "false"] android:largeHeap=["true" | "false"] android:label="string resource" android:localeConfig="xml resource" android:logo="drawable resource" android:manageSpaceActivity="string" android:name="string" android:networkSecurityConfig="xml resource" android:pageSizeCompat=["true" | "false"] 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><property>- description:
اظهارنامه برنامه. این عنصر حاوی زیرعنصرهایی است که هریک از مؤلفههای برنامه را اعلام میکند و دارای مشخصههایی است که میتواند بر همه مؤلفهها تأثیر بگذارد.
بسیاری از این مشخصهها، مانند
icon،label،permission،process،taskAffinity، وallowTaskReparenting، مقادیر پیشفرضی را برای مشخصههای متناظر عناصر مؤلفه تنظیم میکنند. سایرین، مثلdebuggable،enabled،description، وallowClearUserData، مقادیری را برای کل برنامه تنظیم میکنند و توسط مؤلفهها لغو نمیشوند.- مشخصهها
android:allowTaskReparenting- اینکه آیا فعالیتهایی که برنامه تعریف میکند میتوانند از تکلیفی که آنها را شروع کرده است به تکلیفی که با آن قرابت دارند منتقل شوند، وقتی که آن تکلیف در مرحله بعدی به جلو آورده میشود. اگر بتوانند حرکت کنند،
"true"است و اگر باید در تکلیفی که شروع کردهاند باقی بمانند،"false"است. مقدار پیشفرض"false"است.عنصر
<activity>مشخصهallowTaskReparentingخود را دارد که میتواند مقدار تنظیمشده در اینجا را لغو کند. android:allowBackupاینکه آیا به برنامه اجازه داده شود در زیرساخت پشتیبانگیری و بازیابی شرکت کند یا نه. اگر این مشخصه روی
"false"تنظیم شده باشد، هیچگاه پشتیبانگیری یا بازیابی برای برنامه انجام نمیشود و همه پشتیبانگیریهای ابری و انتقالهای دستگاهبهدستگاه (D2D) غیرفعال میشود، حتی با پشتیبانگیری کامل سیستم که درغیراینصورت باعث میشود همه دادههای برنامه بااستفاده ازadbذخیره شود. مقدار پیشفرض این مشخصه"true"است. اگر برنامهتان دادههای حساس را پردازش میکند، میتوانید این مشخصه را روی"true"تنظیم کنید وandroid:dataExtractionRulesرا پیکربندی کنید تا کلیدهای حساس یا حافظههای پنهان موقت را بهطور ایمن مستثنی کنید و درعینحال اولویتهای کاربر و تداوم را حفظ کنید.توجه: برای برنامههایی که Android 12 (سطح میانای برنامهسازی کاربردی ۳۱) یا بالاتر را هدفیابی میکنند، این رفتار متفاوت است. در دستگاههای برخیاز سازندگان دستگاه، نمیتوانید انتقال دستگاهبهدستگاه فایلهای برنامهتان را غیرفعال کنید.
بااینحال، میتوانید پشتیبانگیری و بازیابی مبتنی بر فضای ابری فایلهای برنامهتان را با تنظیم این مشخصه روی
"false"غیرفعال کنید، حتی اگر برنامه شما Android 12 (سطح میانای برنامهسازی کاربردی ۳۱) یا بالاتر را هدف قرار دهد.برای اطلاعات بیشتر، بخش پشتیبانگیری و بازیابی صفحهای را ببینید که تغییرات رفتاری برنامههایی را که Android 12 (سطح میانای برنامهسازی کاربردی ۳۱) یا بالاتر را هدف قرار میدهند شرح میدهد.
android:allowClearUserDataاینکه آیا به برنامه اجازه داده شود دادههای کاربر را بازنشانی کند یا نه. این دادهها شامل پرچمها، مانند اینکه آیا کاربر نکتهابزارهای مقدماتی را دیده است یا نه، و همچنین تنظیمات و اولویتهای قابلسفارشیسازی توسط کاربر است. مقدار پیشفرض این مشخصه
"true"است.توجه: فقط برنامههایی که بخشی از تصویر سیستم هستند میتوانند این مشخصه را بهطور صریح اعلام کنند. برنامههای طرف سوم نمیتوانند این مشخصه را در فایلهای مانیفست خود لحاظ کنند.
برای اطلاعات بیشتر، به نمای کلی پشتیبانگیری از دادهها مراجعه کنید.
android:allowCrossUidActivitySwitchFromBelowمشخص میکند که آیا فعالیتهای برنامههای دیگر در همان تکلیف میتواند روی این برنامه راهاندازی شود یا نه. اگر روی
"false"تنظیم شود، راهاندازی فعالیتهایی که این برنامه را در نمای کاربر جایگزین میکند مسدود میشود.مقدار پیشفرض
"true"است.برای اطلاعات بیشتر، راهنمای راهاندازی ایمن فعالیت پسزمینه را ببینید.
android:allowNativeHeapPointerTaggingاینکه برنامه ویژگی برچسبگذاری اشارهگر Heap را فعال میکند یا نه. مقدار پیشفرض این مشخصه
"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:enableOnBackInvokedCallbackاین پرچم به شما امکان میدهد در سطح برنامه از پویانماییهای پیشبینانه سیستم انصراف دهید.
android:enableOnBackInvokedCallback=falseرا تنظیم کنید تا پویانماییهای اشاره برگشت پیشگویانه در سطح برنامه خاموش شود و به سیستم دستور دهید تا فراخوانیهای میانای برنامهسازی کاربردی پلاتفرمOnBackInvokedCallbackرا نادیده بگیرد.android:extractNativeLibs- این مشخصه نشان میدهد که آیا نصبکننده بسته کتابخانههای بومی را از APK به سیستم فایل استخراج میکند یا نه. اگر روی
"false"تنظیم شده باشد، کتابخانههای بومی شما بهصورت فشردهنشده در APK ذخیره میشوند. اگرچه ممکن است APK شما بزرگتر باشد، برنامه شما سریعتر بار میشود زیرا کتابخانهها مستقیماً از APK در زمان اجرا بار میشوند.مقدار پیشفرض
extractNativeLibsبهminSdkVersionو نسخه AGP که استفاده میکنید بستگی دارد. در بیشتر موارد، رفتار پیشفرض احتمالاً همان چیزی است که میخواهید، و لازم نیست این مشخصه را بهطور صریح تنظیم کنید. android:forceQueryableمشخص میکند که آیا این برنامه برای همه برنامههای دیگر در دستگاه قابلمشاهده است یا نه، صرفنظر از اینکه آن برنامههای دیگر چه چیزی را در برچسبهای
<queries>در مانیفستهایشان اعلام میکنند.مقدار پیشفرض
"false"است.برای اطلاعات بیشتر، راهنمای فیلتر کردن خودکار رؤیتپذیری بسته را ببینید.
android:fullBackupContent- این مشخصه به فایل XML اشاره میکند که حاوی قوانین پشتیبانگیری کامل برای
پشتیبانگیری خودکار است.
این قوانین تعیین میکنند که کدام فایلها پشتیبانگیری شوند. برای اطلاعات بیشتر،
نحو پیکربندی XML
را برای «پشتیبانگیری خودکار» ببینید.
این مشخصه اختیاری است. اگر مشخص نشده باشد، بهطور پیشفرض، «پشتیبانگیری خودکار» اکثر فایلهای برنامهتان را دربرمیگیرد. برای اطلاعات بیشتر، به فایلهایی که پشتیبانگیری میشوند مراجعه کنید.
android:fullBackupOnly- این مشخصه نشان میدهد که آیا از
پشتیبانگیری خودکار در دستگاههایی که
دردسترس است استفاده شود یا نه. اگر روی
"true"تنظیم شده باشد، وقتی برنامهتان در دستگاهی با Android نسخه ۶.۰ (سطح میانای برنامهسازی کاربردی ۲۳) یا بالاتر نصب شود، «پشتیبانگیری خودکار» را انجام میدهد. در دستگاههای قدیمیتر، برنامهتان این مشخصه را نادیده میگیرد و پشتیبانگیریهای کلید/مقدار را انجام میدهد.مقدار پیشفرض
"false"است. android:gwpAsanMode- این مشخصه نشان میدهد که آیا از
GWP-ASan استفاده شود یا نه، ویژگی تخصیصدهنده حافظه محلی که کمک میکند
اشکالهای use-after-free و heap-buffer-overflow پیدا شود.
مقدار پیشفرض
"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 تولید نمیکنند (فایل DEX بایتکد بهینهشده برای پلاتفرم Android است). اگر اینطور است، باید این ویژگی را در فایل مانیفست واحد روی
"false"تنظیم کنید تا از خطاهای زمان اجرا جلوگیری شود. android:hasFragileUserData- اینکه آیا وقتی کاربر برنامه را حذف نصب میکند، پیاموارهای برای حفظ دادههای برنامه به او نشان داده شود یا نه. مقدار پیشفرض
"false"است. android:hardwareAccelerated- اینکه آیا پردازاندن با شتاب سختافزاری برای همه فعالیتها و نماها در این برنامه فعال است یا نه. اگر فعال باشد،
"true"است و اگر فعال نباشد،"false"است. اگرminSdkVersionیاtargetSdkVersionرا روی"14"یا بالاتر تنظیم کنید، مقدار پیشفرض"true"است. درغیراینصورت،"false"است.از Android 3.0 (سطح میانای برنامهسازی کاربردی ۱۱) به بعد، یک پردازنده OpenGL با شتاب سختافزاری برای برنامهها دردسترس است تا عملکرد بسیاری از عملیات گرافیکی دوبعدی رایج را بهبود بخشد. وقتی پردازنده با شتاب سختافزاری فعال باشد، اکثر عملیاتها در Canvas، Paint، Xfermode، ColorFilter، Shader، و Camera شتاب میگیرند.
این امر منجر به پویانماییهای روانتر، پیمایش روانتر، و بهبود واکنشگرایی کلی میشود، حتی برای برنامههایی که بهطور صریح از کتابخانههای OpenGL چارچوب استفاده نمیکنند.
همه عملیاتهای OpenGL 2D شتابدهی نشدهاند. اگر پردازنده با شتاب سختافزاری را فعال میکنید، برنامهتان را آزمایش کنید تا بتواند بدون خطا از پردازنده استفاده کند.
برای اطلاعات بیشتر، راهنمای شتاب سختافزاری را بخوانید.
android:icon- نمادی برای کل برنامه و نماد پیشفرض برای
هریک از مؤلفههای برنامه. مشخصههای فردی
iconرا برای عناصر<activity>،<activity-alias>،<service>،<receiver>، و<provider>ببینید.این مشخصه بهعنوان مرجعی برای منبع ترسیمشدنی حاوی تصویر تنظیم میشود، مانند
"@drawable/icon". نماد پیشفرضی وجود ندارد. android:intentMatchingFlags-
از این مشخصه برای تنظیم دقیق نحوه مطابقت دادن هدفهای ورودی با مؤلفههای برنامه توسط سیستم استفاده کنید. بهطور پیشفرض، هیچ قانون مطابقت خاصی اعمال نمیشود.
این مشخصه را میتوان در برچسب
<application>و همچنین در برچسبهای مؤلفه، ازجمله<activity>،<activity-alias>،<receiver>،<service>، و<provider>مشخص کرد. مقدار تنظیمشده در یک مؤلفه، مقدار تنظیمشده در برچسب<application>را لغو میکند.مقدار باید یک یا چند پرچم زیر باشد که با «
|» از هم جدا شدهاند:پرچم شرح noneهمه قوانین مطابقت ویژه را برای مقصودهای ورودی غیرفعال میکند. هنگام مشخص کردن چند پرچم، مقادیر متناقض با اولویت دادن به پرچم noneحلوفصل میشوند.enforceIntentFilterمطابقت سختگیرانهتری را برای هدفهای ورودی اعمال میکند:
- قصد صریح باید با فیلتر قصد مؤلفه هدف مطابقت داشته باشد.
- «قصدها» بدون کنش با هیچ فیلتر قصدی مطابقت ندارند.
allowNullActionقوانین مطابقت را آسانتر میکند تا به قصدها اجازه دهد بدون کنش مطابقت داشته باشند. این پرچم در ارتباط با
enforceIntentFilterبرای دستیابی به رفتار زیر استفاده میشود:- قصد صریح باید با فیلتر قصد مؤلفه هدف مطابقت داشته باشد.
- قصدهای بدون کنش میتوانند با هر فیلتر قصدی مطابقت داشته باشند.
برای اطلاعات بیشتر، بخش قصدهای ایمنتر را در تغییرات رفتار Android 16 (سطح API ۳۶) ببینید.
android:isGame- اینکه برنامه بازی است یا نه. سیستم ممکن است برنامههایی را که بهعنوان بازی طبقهبندی شدهاند گروهبندی کند یا آنها را جدا از برنامههای دیگر نمایش دهد. پیشفرض
"false"است. android:isMonitoringToolنشان میدهد که این برنامه برای نظارت بر افراد دیگر طراحی شده است.
توجه: اگر برنامهای این مشخصه را در مانیفست خود اعلام کند، توسعهدهنده باید از خطمشی نرمافزار جاسوسی پیروی کند تا بتواند برنامه را در 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:localeConfigارجاع به منبع XML که فهرست مناطق زبانی پشتیبانیشده توسط برنامه را مشخص میکند. سیستم از این مورد برای پشتیبانی از اولویتهای زبان هر برنامه استفاده میکند.
برای اطلاعات بیشتر، راهنمای اولویتهای زبان هر برنامه را ببینید.
android:logo- نشانوارهای برای کل برنامه و نشانواره پیشفرض برای فعالیتها.
این مشخصه بهعنوان مرجعی برای منبع ترسیمشدنی حاوی تصویر تنظیم میشود، مانند
"@drawable/logo". نشانواره پیشفرضی وجود ندارد. android:manageSpaceActivity- نام کاملاً واجدشرایط زیرکلاس
Activityکه سیستم راهاندازی میکند تا به کاربران اجازه دهد حافظه اشغالشده توسط برنامه در دستگاه را مدیریت کنند. فعالیت با عنصر<activity>نیز اعلام میشود. android:name- نام کاملاً واجدشرایط
Applicationزیرکلاس پیادهسازیشده برای برنامه. وقتی فرایند برنامه شروع میشود، این کلاس قبلاز هرکدام از مؤلفههای برنامه نمونهسازی میشود.زیرکلاس اختیاری است. اکثر برنامهها به آن نیاز ندارند. درصورت نبود زیرکلاس، Android از نمونهای از کلاس پایه
Applicationاستفاده میکند. android:networkSecurityConfigنام فایل XML را که حاوی پیکربندی امنیت شبکه برنامه شما است مشخص میکند. این مقدار مرجعی به فایل منبع XML است که حاوی پیکربندی است.
این مشخصه در سطح میانای برنامهسازی کاربردی ۲۴ اضافه شده است.
android:pageSizeCompatتنظیمات سازگاری کاربر یا پلاتفرم را برای اندازههای صفحه ۱۶ کیلوبایتی لغو میکند، که به شما امکان میدهد حالت سازگاری مستقل از صفحه را برای این برنامه بهاجبار روشن یا خاموش کنید.
برای اطلاعات بیشتر، راهنمای پشتیبانی از اندازههای صفحه ۱۶ کیلوبایتی را ببینید.
android:permission- نام اجازهای که مشتریان برای تعامل با برنامه به آن نیاز دارند. این مشخصه روشی مناسب برای تنظیم اجازهای است که بر همه مؤلفههای برنامه اعمال میشود. این مقدار با تنظیم مشخصههای
permissionمؤلفههای جداگانه بازنویسی میشود.برای اطلاعات بیشتر درباره اجازهها، به بخش اجازهها در نمای کلی مانیفست برنامه و نکات امنیتی مراجعه کنید.
android:persistent- اینکه برنامه همیشه درحال اجرا باقی میماند یا نه. اگر اینطور باشد،
"true"است و اگر نه،"false"است. مقدار پیشفرض"false"است. برنامهها معمولاً این پرچم را تنظیم نمیکنند. حالت پایداری فقط برای برخیاز برنامههای سیستم درنظر گرفته شده است. android:process- نام فرایندی که همه مؤلفههای برنامه در آن اجرا میشود.
هر مؤلفه میتواند با تنظیم کردن مشخصه
processخودش، این پیشفرض را لغو کند.بهطور پیشفرض، Android زمانی فرایندی برای برنامه ایجاد میکند که اولین مؤلفه آن نیاز به اجرا داشته باشد. سپس همه مؤلفهها در آن فرایند اجرا میشوند. نام فرایند پیشفرض با نام بسته تنظیمشده توسط عنصر
<manifest>مطابقت دارد.با تنظیم این مشخصه روی نام فرایندی که با برنامه دیگری همرسانی شده است، میتوانید مؤلفههای هر دو برنامه را طوری تنظیم کنید که در یک فرایند اجرا شوند، اما فقط درصورتیکه دو برنامه شناسه کاربر مشترک داشته باشند و با گواهینامه یکسانی امضا شده باشند.
اگر نام اختصاصدادهشده به این مشخصه با دونقطه (
:) شروع شود، درصورت نیاز، فرایند جدیدی که برای برنامه خصوصی است ایجاد میشود. اگر نام فرایند با نویسه حرف کوچک شروع شود، فرایند سراسری با آن نام ایجاد میشود. یک فرایند جهانی میتواند با برنامههای دیگر همرسانی شود و مصرف منابع را کاهش دهد. android:restoreAnyVersion- نشان میدهد که برنامه آماده است تا برای بازیابی هر مجموعه داده پشتیبانگیریشدهای تلاش کند،
حتی اگر نسخه جدیدتری از برنامه نسبتبه نسخه فعلی نصبشده در دستگاه،
پشتیبانگیری را ذخیره کرده باشد. تنظیم
این مشخصه روی
"true"به «مدیر پشتیبانگیری» اجازه میدهد حتی زمانیکه عدم تطابق نسخه نشان میدهد دادهها ناسازگار هستند، بازیابی را امتحان کنید. بااحتیاط استفاده کنید!$1مقدار پیشفرض این مشخصه
"false"است. android:requestLegacyExternalStorage-
اینکه برنامه میخواهد از فضای ذخیرهسازی محدود انصراف دهد یا نه.
توجه: بسته به تغییرات مربوط به خطمشی یا سازگاری برنامه، ممکن است سیستم این درخواست انصراف را نپذیرد.
android:requiredAccountType- نوع حساب موردنیاز برای عملکرد برنامه را مشخص میکند.
اگر برنامهتان به
Accountنیاز دارد، مقدار این مشخصه باید با نوع اصالتسنج حساب که برنامهتان استفاده میکند مطابقت داشته باشد، همانطور که توسطAuthenticatorDescriptionتعریف شده است، مانند"com.google".مقدار پیشفرض null است و نشان میدهد که برنامه میتواند بدون هیچ حسابی کار کند.
چون نمایههای محدودشده نمیتوانند حساب اضافه کنند، مشخص کردن این مشخصه باعث میشود برنامهتان از نمایه محدودشده دردسترس نباشد، مگراینکه
android:restrictedAccountTypeرا نیز با همان مقدار اعلام کنید.احتیاط: اگر دادههای حساب ممکن است اطلاعات شناساننده شخصی را آشکار کند، مهم است که این مشخصه را اعلام کنید و
android:restrictedAccountTypeرا تهی بگذارید تا نمایههای محدودشده نتوانند از برنامه شما برای دسترسی به اطلاعات شخصی متعلق به کاربر مالک استفاده کنند.این مشخصه در سطح میانای برنامهسازی کاربردی ۱۸ اضافه شده است.
android:resizeableActivity-
مشخص میکند که آیا برنامه از حالت چندپنجرهای پشتیبانی میکند یا نه.
میتوانید این مشخصه را در عنصر
<activity>یا<application>تنظیم کنید.اگر این مشخصه را روی
"true"تنظیم کنید، کاربر میتواند فعالیت را در حالتهای صفحه دونیمه و قالب آزاد راهاندازی کند. اگر مشخصه را روی"false"تنظیم کنید، برنامه نمیتواند برای محیط چندپنجرهای آزمایش یا بهینهسازی شود. سیستم همچنان میتواند فعالیت را در حالت چندپنجرهای با اعمال حالت سازگاری قرار دهد.تنظیم این مشخصه روی
"true"تضمین نمیکند که هیچ برنامه دیگری در حالت چندپنجرهای روی صفحهنمایش، مانند تصویردرتصویر، یا روی نمایشگرهای دیگر قابلمشاهده نباشد. بنابراین، تنظیم این پرچم بهمعنای این نیست که برنامهتان دسترسی انحصاری به منابع دارد.برای برنامههایی که سطح میانای برنامهسازی کاربردی ۲۴ یا بالاتر را هدفیابی میکنند، پیشفرض
"true"است.اگر برنامه شما سطح میانای برنامهسازی کاربردی ۳۱ یا بالاتر را هدف قرار میدهد، این مشخصه در صفحهنمایشهای کوچک و بزرگ بهطور متفاوتی عمل میکند:
- صفحهنمایشهای بزرگ (sw >= 600dp): همه برنامهها از حالت چندپنجرهای پشتیبانی میکنند. این مشخصه نشان میدهد که آیا
اندازه برنامه میتواند تغییر کند یا نه، نه اینکه آیا برنامه از حالت چندپنجرهای پشتیبانی میکند یا نه. اگر
resizeableActivity="false"، برنامه درصورت لزوم در حالت سازگاری قرار میگیرد تا با ابعاد نمایشگر مطابقت داشته باشد. - صفحهنمایشهای کوچک (sw < 600dp): اگر
resizeableActivity="true"و حداقل عرض و حداقل ارتفاع فعالیت اصلی در محدوده الزامات چندپنجرهای باشد، برنامه از حالت چندپنجرهای پشتیبانی میکند. اگرresizeableActivity="false"، برنامه از حالت چندپنجرهای پشتیبانی نمیکند، صرفنظر از حداقل عرض و ارتفاع فعالیت.
مقدار فعالیت ریشه تکلیف بر همه فعالیتهای دیگری که در تکلیف راهاندازی میشود اعمال میشود. یعنی اگر فعالیت ریشه یک تکلیف قابلتغییر اندازه باشد، سیستم همه فعالیتهای دیگر در آن تکلیف را قابلتغییر اندازه درنظر میگیرد. اگر فعالیت ریشه تغییرپذیر نباشد، فعالیتهای دیگر در تکلیف تغییرپذیر نیستند.
این مشخصه در سطح میانای برنامهسازی کاربردی ۲۴ اضافه شده است.
- صفحهنمایشهای بزرگ (sw >= 600dp): همه برنامهها از حالت چندپنجرهای پشتیبانی میکنند. این مشخصه نشان میدهد که آیا
اندازه برنامه میتواند تغییر کند یا نه، نه اینکه آیا برنامه از حالت چندپنجرهای پشتیبانی میکند یا نه. اگر
android:restrictedAccountType- نوع حساب موردنیاز این برنامه را مشخص میکند و نشان میدهد که نمایههای محدودشده
میتوانند به حسابهایی که به کاربر مالک تعلق دارند دسترسی داشته باشند. اگر برنامهتان به
Accountنیاز دارد و نمایههای محدودشده میتوانند به حسابهای کاربر اصلی دسترسی داشته باشند، مقدار این مشخصه باید با نوع اصالتسنج حساب استفادهشده توسط برنامهتان مطابقت داشته باشد، همانطور که توسطAuthenticatorDescriptionتعریف شده است، مانند"com.google".مقدار پیشفرض null است و نشان میدهد که برنامه میتواند بدون هیچ حسابی کار کند.
احتیاط: مشخص کردن این مشخصه به نمایههای محدودشده اجازه میدهد از برنامه شما با حسابهایی که متعلق به کاربر مالک است استفاده کنند، که ممکن است اطلاعات شناساننده شخصی را فاش کند. اگر حساب ممکن است جزئیات شخصی را فاش کند، از این مشخصه استفاده نکنید. درعوض، مشخصه
android:requiredAccountTypeرا اعلام کنید تا برنامهتان برای نمایههای محدودشده دردسترس نباشد.این مشخصه در سطح میانای برنامهسازی کاربردی ۱۸ اضافه شده است.
android:supportsRtlاعلام میکند که آیا برنامه شما مایل به پشتیبانی از چیدمانهای راستبهچپ (RTL) است یا نه.
اگر این مقدار روی
"true"تنظیم شده باشد وtargetSdkVersionروی ۱۷ یا بالاتر تنظیم شده باشد، میاناهای برنامهسازی کاربردی راستبهچپ مختلفی توسط سیستم فعال و استفاده میشود تا برنامهتان بتواند چیدمانهای راستبهچپ را نمایش دهد. اگر این مقدار روی"false"تنظیم شده باشد یا اگرtargetSdkVersionروی ۱۶ یا کمتر تنظیم شده باشد، میاناهای برنامهسازی کاربردی RTL نادیده گرفته میشوند یا تأثیری ندارند و برنامه شما بدون توجه به جهت چیدمان مرتبط با انتخاب منطقه کاربر، رفتار یکسانی خواهد داشت. یعنی چیدمانهایتان همیشه چپبهراست است.مقدار پیشفرض این مشخصه
"false"است.این مشخصه در سطح میانای برنامهسازی کاربردی ۱۷ اضافه شده است.
android:taskAffinity- نام وابستگیای که برای همه فعالیتهای درون برنامه اعمال میشود،
بهجز فعالیتهایی که وابستگی متفاوتی را با ویژگیهای خودشان
taskAffinityتنظیم میکنند. برای اطلاعات بیشتر، آن مشخصه را ببینید.بهطور پیشفرض، همه فعالیتهای درون یک برنامه دارای وابستگی یکسانی هستند. نام آن وابستگی با نام بسته تنظیمشده توسط عنصر
<manifest>یکسان است. android:testOnly- نشان میدهد که آیا این برنامه فقط برای اهداف آزمایشی است یا نه. برای مثال، ممکن است عملکرد یا دادههای خارج از خود را افشا کند که میتواند باعث ایجاد حفره امنیتی شود، اما برای آزمایش مفید باشد. این نوع فایل APK فقط ازطریق
adbنصب میشود. نمیتوانید آن را در Google Play منتشر کنید.وقتی روی اجرا
کلیک میکنید، Android Studio بهطور خودکار این مشخصه را اضافه میکند. android:theme- ارجاعی به منبع سبک که زمینه پیشفرضی را برای همه فعالیتها در برنامه تعریف میکند. فعالیتهای جداگانه میتوانند با تنظیم کردن مشخصههای
themeخودشان، تنظیمات پیشفرض را لغو کنند. برای کسب اطلاعات بیشتر، به سبکها و زمینهها بروید. android:uiOptions- Extra options for an activity's UI. باید یکی از مقادیر زیر باشد:
مقدار شرح "none"بدون گزینههای اضافی واسط کاربر. این گزینه پیشفرض است. "splitActionBarWhenNarrow"نواری را به پایین صفحه اضافه میکند تا موارد اقدام را در نوار برنامه (که به آن نوار اقدام نیز میگویند) نمایش دهد، بهویژه زمانی که فضای افقی محدود است، مانند حالت عمودی در گوشی همراه. بهجای تعداد کمی از موارد اقدام که در نوار برنامه در بالای صفحه ظاهر میشوند، نوار برنامه به بخش پیمایش بالا و نوار پایین برای موارد اقدام تقسیم میشود. این یعنی مقدار معقولی فضا برای دستورات اقدام و برای عناصر پیمایش و عنوان در بالا دردسترس است. گزینههای منو در دو نوار تقسیم نشدهاند. آنها همیشه باهم نمایش داده میشوند. برای اطلاعات بیشتر درباره نوار برنامه، به افزودن نوار برنامه مراجعه کنید.
این مشخصه در سطح میانای برنامهسازی کاربردی ۱۴ اضافه شده است.
android:usesCleartextTraffic- نشان میدهد که آیا برنامه قصد دارد از ترافیک شبکه متن ساده، مانند HTTP متن ساده، استفاده کند یا نه.
مقدار پیشفرض برای برنامههایی که سطح میانای برنامهسازی کاربردی ۲۷ یا پایینتر را هدف قرار میدهند
"true"است. برنامههایی که میانای برنامهسازی کاربردی سطح ۲۸ یا بالاتر را هدفیابی میکنند، بهطور پیشفرض به"false"میروند.توجه: این مشخصه درحال منسوخ شدن است و برای برنامههایی که سطح میانای برنامهسازی کاربردی ۳۸ و بالاتر را هدف قرار میدهند نادیده گرفته خواهد شد. پیکربندی امنیت شبکه را برای کنترل ترافیک متن ساده برای سطح میانای برنامهسازی کاربردی ۲۴ و بالاتر مشخص کنید. اگر برنامه شما سطوح میانای برنامهسازی کاربردی ۲۳ و پایینتر را هدف قرار میدهد، باید علاوهبر «پیکربندی امنیت شبکه»،
android:usesCleartextTrafficرا نیز مشخص کنید.وقتی این مشخصه روی
"false"تنظیم شده باشد، مؤلفههای پلاتفرم، برای مثال، پشتههای HTTP و FTP،DownloadManager، وMediaPlayer، درخواستهای برنامه برای استفاده از ترافیک متن آشکار را رد میکنند.کتابخانههای طرف سوم نیز بهشدت تشویق میشوند که این تنظیم را رعایت کنند. دلیل اصلی اجتناب از ترافیک متن آشکار، عدم محرمانگی، اصالت، و محافظت دربرابر دستکاری است. مهاجم شبکه میتواند دادههای منتقلشده را استراق سمع کند و همچنین آن را بدون شناسایی شدن تغییر دهد.
این پرچم براساس بهترین تلاش رعایت میشود زیرا با توجه به سطح دسترسی ارائهشده به برنامههای Android، جلوگیری از همه ترافیکهای متن ساده غیرممکن است. برای مثال، انتظار نمیرود که
SocketAPI از این پرچم پیروی کند، زیرا نمیتواند تعیین کند که ترافیک آن بهصورت متن ساده است یا نه.بااینحال، بیشتر ترافیک شبکه از برنامهها توسط پشتهها و مؤلفههای شبکه سطح بالاتر مدیریت میشود که میتوانند این پرچم را با خواندن آن از
ApplicationInfo.flagsیاNetworkSecurityPolicy.isCleartextTrafficPermitted()رعایت کنند.توجه:
WebViewاین مشخصه را برای برنامههایی که سطح میانای برنامهسازی کاربردی ۲۶ و بالاتر را هدف قرار میدهند رعایت میکند.درحین توسعه برنامه، میتوان از StrictMode برای شناسایی هرگونه ترافیک متن ساده از برنامه استفاده کرد. برای اطلاعات بیشتر، به
StrictMode.VmPolicy.Builder.detectCleartextNetwork()مراجعه کنید.این مشخصه در سطح میانای برنامهسازی کاربردی ۲۳ اضافه شده است.
اگر «پیکربندی امنیت شبکه Android» وجود داشته باشد، این پرچم در Android نسخه ۷.۰ (سطح میانای برنامهسازی کاربردی ۲۴) و بالاتر نادیده گرفته میشود.
android:vmSafeMode- نشان میدهد که آیا برنامه میخواهد ماشین مجازی (VM) در حالت ایمن کار کند یا نه. مقدار پیشفرض
"false"است.این مشخصه در سطح ایپیآی ۸ اضافه شد، که در آن مقدار
"true"کامپایلر درجا (JIT) Dalvik را غیرفعال کرد.این مشخصه در سطح میانای برنامهسازی کاربردی ۲۲ اقتباس شده است، که در آن مقدار
"true"کامپایلر پیشاز موعد (AOT) ART را غیرفعال میکند.
از AGP 4.2.0، گزینه DSL
useLegacyPackagingجایگزین مشخصه مانیفستextractNativeLibsمیشود. برای پیکربندی رفتار فشردهسازی کتابخانه بومی، بهجایextractNativeLibsدر فایل مانیفست، ازuseLegacyPackagingدر فایلbuild.gradleبرنامهتان استفاده کنید. برای اطلاعات بیشتر، یادداشت انتشار استفاده از DSL برای بستهبندی کتابخانههای بومی فشرده را ببینید.- معرفیشده در:
- سطح میانای برنامهسازی کاربردی ۱
- همچنین مراجعه کنید به:
<activity><service><receiver><provider>
<application>
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2026-11-19 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-11-19 بهوقت ساعت هماهنگ جهانی."],[],[]]