- نحو:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > ... </intent-filter>
- موجود در:
-
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- باید حاوی:
-
<action>
- می تواند شامل:
-
<category>
<data>
- توضیحات:
- انواع مقاصدی را مشخص می کند که یک فعالیت، سرویس یا گیرنده پخش می تواند به آنها پاسخ دهد. یک فیلتر هدف قابلیتهای مؤلفه اصلی خود را اعلام میکند: فعالیت یا خدماتی که میتواند انجام دهد و گیرنده چه نوع پخشهایی را میتواند انجام دهد.
این مؤلفه را برای دریافت مقاصد از نوع تبلیغ شده باز می کند و در عین حال مواردی را که برای مؤلفه معنی دار نیستند فیلتر می کند. بیشتر محتویات فیلتر با عناصر فرعی
<action>
،<category>
و<data>
آن توصیف میشوند.برای بحث دقیق تر درباره فیلترها، Intents and Intent Filters و بخش Intent filters را در نمای کلی مانیفست برنامه ببینید.
- صفات:
-
android:icon
- نمادی که فعالیت والد، سرویس یا گیرنده پخش را نشان میدهد، وقتی آن مؤلفه به عنوان دارای قابلیت توصیف شده توسط فیلتر به کاربر ارائه میشود.
این ویژگی به عنوان یک مرجع به یک منبع قابل ترسیم حاوی تعریف تصویر تنظیم می شود. مقدار پیش فرض نمادی است که توسط ویژگی
icon
مؤلفه والد تنظیم شده است. اگر والد نمادی را مشخص نکند، پیشفرض نمادی است که توسط عنصر<application>
تنظیم شده است.برای اطلاعات بیشتر درباره نمادهای فیلتر قصد، به بخش نمادها و برچسبها در نمای کلی مانیفست برنامه مراجعه کنید.
-
android:label
- یک برچسب قابل خواندن توسط کاربر برای مؤلفه والد. این برچسب، به جای برچسب تنظیم شده توسط مؤلفه والد، زمانی استفاده می شود که مؤلفه به عنوان دارای قابلیت توصیف شده توسط فیلتر به کاربر ارائه شود.
برچسب به عنوان یک مرجع به یک منبع رشته تنظیم می شود تا بتواند مانند رشته های دیگر در رابط کاربری محلی شود. با این حال، به عنوان یک راحتی در هنگام توسعه برنامه، می توان آن را به عنوان یک رشته خام نیز تنظیم کرد.
مقدار پیش فرض برچسب تنظیم شده توسط مؤلفه والد است. اگر والد برچسبی را مشخص نکند، پیشفرض برچسبی است که توسط ویژگی
label
عنصر<application>
تنظیم شده است.برای اطلاعات بیشتر درباره برچسبهای فیلتر قصد، به بخش نمادها و برچسبها در نمای کلی مانیفست برنامه مراجعه کنید.
-
android:priority
- اولویتی که با توجه به مدیریت مقاصد از نوع توصیف شده توسط فیلتر به مؤلفه والد داده شده است. این ویژگی هم برای فعالیت ها و هم برای گیرنده های پخش معنی دارد.
- اطلاعاتی در مورد توانایی یک فعالیت برای پاسخ دادن به هدفی که با فیلتر مطابقت دارد، نسبت به سایر فعالیتهایی که میتوانند به هدف نیز پاسخ دهند، ارائه میکند. هنگامی که یک هدف میتواند توسط چندین فعالیت با اولویتهای مختلف مدیریت شود، Android فقط آنهایی را با مقادیر اولویت بالاتر به عنوان اهداف بالقوه برای هدف در نظر میگیرد.
ترتیب اجرای گیرندههای پخش برای دریافت پیامهای پخش را کنترل میکند، به طوری که گیرندههایی که دارای مقادیر اولویت بالاتر هستند، قبل از آنهایی که مقادیر کمتری دارند فراخوانی میشوند. این سفارش فقط برای پیام های همزمان اعمال می شود. برای پیامهای ناهمزمان نادیده گرفته میشود.
فقط در صورتی از این ویژگی استفاده کنید که نیاز به تحمیل ترتیب خاصی برای دریافت پخشها دارید یا میخواهید Android را مجبور کنید یک فعالیت را بر فعالیتهای دیگر ترجیح دهد.
مقدار یک عدد صحیح است، مانند
100
. اعداد بالاتر اولویت بیشتری دارند. مقدار پیش فرض0
است.در شرایط خاص اولویت درخواستی نادیده گرفته می شود و مقدار آن به
0
محدود می شود. این زمانی اتفاق می افتد که:- یک برنامه غیرمجاز هر گونه اولویت > 0 را درخواست می کند.
- یک برنامه ممتاز اولویت > 0 را برای
ACTION_VIEW
،ACTION_SEND
،ACTION_SENDTO
یاACTION_SEND_MULTIPLE
درخواست میکند.
برای اطلاعات بیشتر،
setPriority()
را ببینید. -
android:order
ترتیب پردازش فیلتر هنگام تطابق چندین فیلتر.
order
باpriority
از این جهت متفاوت است کهpriority
در بین برنامه ها اعمال می شود، در حالی کهorder
چندین فیلتر منطبق را در یک برنامه ابهام می کند.وقتی چندین فیلتر می توانند مطابقت داشته باشند، به جای آن از یک هدف جهت دار استفاده کنید.
مقدار یک عدد صحیح است، مانند
100
. ابتدا اعداد بالاتر مطابقت داده می شوند. مقدار پیش فرض0
است.این ویژگی در سطح 28 API معرفی شد.
-
android:autoVerify
- آیا Android باید تأیید کند که فایل JSON پیوندهای دارایی دیجیتال از میزبان مشخص شده با این برنامه مطابقت دارد یا خیر.
برای اطلاعات بیشتر، به تأیید پیوندهای برنامه Android مراجعه کنید.
مقدار پیش فرض
false
است.این ویژگی در سطح 23 API معرفی شد.
-
- معرفی شده در:
- API سطح 1
- همچنین ببینید:
-
<action>
<category>
<data>
- نحو:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > ... </intent-filter>
- موجود در:
-
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- باید حاوی:
-
<action>
- می تواند شامل:
-
<category>
<data>
- توضیحات:
- انواع مقاصدی را مشخص می کند که یک فعالیت، سرویس یا گیرنده پخش می تواند به آنها پاسخ دهد. یک فیلتر هدف قابلیتهای مؤلفه اصلی خود را اعلام میکند: فعالیت یا خدماتی که میتواند انجام دهد و گیرنده چه نوع پخشهایی را میتواند انجام دهد.
این مؤلفه را برای دریافت مقاصد از نوع تبلیغ شده باز می کند و در عین حال مواردی را که برای مؤلفه معنی دار نیستند فیلتر می کند. بیشتر محتویات فیلتر با عناصر فرعی
<action>
،<category>
و<data>
آن توصیف میشوند.برای بحث دقیق تر درباره فیلترها، Intents and Intent Filters و بخش Intent filters را در نمای کلی مانیفست برنامه ببینید.
- صفات:
-
android:icon
- نمادی که فعالیت والد، سرویس یا گیرنده پخش را نشان میدهد، وقتی آن مؤلفه به عنوان دارای قابلیت توصیف شده توسط فیلتر به کاربر ارائه میشود.
این ویژگی به عنوان یک مرجع به یک منبع قابل ترسیم حاوی تعریف تصویر تنظیم می شود. مقدار پیش فرض نمادی است که توسط ویژگی
icon
مؤلفه والد تنظیم شده است. اگر والد نمادی را مشخص نکند، پیشفرض نمادی است که توسط عنصر<application>
تنظیم شده است.برای اطلاعات بیشتر درباره نمادهای فیلتر قصد، به بخش نمادها و برچسبها در نمای کلی مانیفست برنامه مراجعه کنید.
-
android:label
- یک برچسب قابل خواندن توسط کاربر برای مؤلفه والد. این برچسب، به جای برچسب تنظیم شده توسط مؤلفه والد، زمانی استفاده می شود که مؤلفه به عنوان دارای قابلیت توصیف شده توسط فیلتر به کاربر ارائه شود.
برچسب به عنوان یک مرجع به یک منبع رشته تنظیم می شود تا بتواند مانند رشته های دیگر در رابط کاربری محلی شود. با این حال، به عنوان یک راحتی در هنگام توسعه برنامه، می توان آن را به عنوان یک رشته خام نیز تنظیم کرد.
مقدار پیش فرض برچسب تنظیم شده توسط مؤلفه والد است. اگر والد برچسبی را مشخص نکند، پیشفرض برچسبی است که توسط ویژگی
label
عنصر<application>
تنظیم شده است.برای اطلاعات بیشتر درباره برچسبهای فیلتر قصد، به بخش نمادها و برچسبها در نمای کلی مانیفست برنامه مراجعه کنید.
-
android:priority
- اولویتی که با توجه به مدیریت مقاصد از نوع توصیف شده توسط فیلتر به مؤلفه والد داده شده است. این ویژگی هم برای فعالیت ها و هم برای گیرنده های پخش معنی دارد.
- اطلاعاتی در مورد توانایی یک فعالیت برای پاسخ دادن به هدفی که با فیلتر مطابقت دارد، نسبت به سایر فعالیتهایی که میتوانند به هدف نیز پاسخ دهند، ارائه میکند. هنگامی که یک هدف میتواند توسط چندین فعالیت با اولویتهای مختلف مدیریت شود، Android فقط آنهایی را با مقادیر اولویت بالاتر به عنوان اهداف بالقوه برای هدف در نظر میگیرد.
ترتیب اجرای گیرندههای پخش برای دریافت پیامهای پخش را کنترل میکند، به طوری که گیرندههایی که دارای مقادیر اولویت بالاتر هستند، قبل از آنهایی که مقادیر کمتری دارند فراخوانی میشوند. این سفارش فقط برای پیام های همزمان اعمال می شود. برای پیامهای ناهمزمان نادیده گرفته میشود.
فقط در صورتی از این ویژگی استفاده کنید که نیاز به تحمیل ترتیب خاصی برای دریافت پخشها دارید یا میخواهید Android را مجبور کنید یک فعالیت را بر فعالیتهای دیگر ترجیح دهد.
مقدار یک عدد صحیح است، مانند
100
. اعداد بالاتر اولویت بیشتری دارند. مقدار پیش فرض0
است.در شرایط خاص اولویت درخواستی نادیده گرفته می شود و مقدار آن به
0
محدود می شود. این زمانی اتفاق می افتد که:- یک برنامه غیرمجاز هر گونه اولویت > 0 را درخواست می کند.
- یک برنامه ممتاز اولویت > 0 را برای
ACTION_VIEW
،ACTION_SEND
،ACTION_SENDTO
یاACTION_SEND_MULTIPLE
درخواست میکند.
برای اطلاعات بیشتر،
setPriority()
را ببینید. -
android:order
ترتیب پردازش فیلتر هنگام تطابق چندین فیلتر.
order
باpriority
از این جهت متفاوت است کهpriority
در بین برنامه ها اعمال می شود، در حالی کهorder
چندین فیلتر منطبق را در یک برنامه ابهام می کند.وقتی چندین فیلتر می توانند مطابقت داشته باشند، به جای آن از یک هدف جهت دار استفاده کنید.
مقدار یک عدد صحیح است، مانند
100
. ابتدا اعداد بالاتر مطابقت داده می شوند. مقدار پیش فرض0
است.این ویژگی در سطح 28 API معرفی شد.
-
android:autoVerify
- آیا Android باید تأیید کند که فایل JSON پیوندهای دارایی دیجیتال از میزبان مشخص شده با این برنامه مطابقت دارد یا خیر.
برای اطلاعات بیشتر، به تأیید پیوندهای برنامه Android مراجعه کنید.
مقدار پیش فرض
false
است.این ویژگی در سطح 23 API معرفی شد.
-
- معرفی شده در:
- API سطح 1
- همچنین ببینید:
-
<action>
<category>
<data>