- składnia:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > ... </intent-filter>
- zawarte w:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- musi zawierać:
<action>
- może zawierać:
<category>
<data>
<uri-relative-filter-group>
- description:
- Określa typy intencji, na które może odpowiadać odbiorca aktywności, usługi lub transmisji. Filtr intencji określa możliwości swojego komponentu nadrzędnego: jakie działania może wykonywać aktywność lub usługa oraz jakie typy transmisji może odbierać odbiornik.
Otwiera ona komponent na działanie intencje o reklamowanym typie, odfiltrowując te, które nie są dla niego istotne. Większość elementów filtra jest opisana przez jego podelementy:
Więcej informacji o filtrach znajdziesz w artykule Intencje i filtry intencji oraz w sekcji Filtry intencji w omówieniu pliku manifestu aplikacji.
- atrybuty:
android:icon
- Ikona reprezentująca nadrzędną aktywność, usługę lub odbiornik transmisji, gdy komponent jest przedstawiany użytkownikowi jako posiadający możliwości opisane przez filtr.
Ten atrybut jest ustawiany jako odwołanie do zasobów do rysowania zawierających definicję obrazu. Wartość domyślna to ikona ustawiona przez atrybut
icon
komponentu nadrzędnego. Jeśli jednostka nadrzędna nie określa ikony, domyślnie jest używana ikona ustawiona w elemencie<application>
.Więcej informacji o ikonach filtra intencji znajdziesz w sekcji Ikony i etykiety w omówieniu pliku manifestu aplikacji.
android:label
- Etykieta komponentu nadrzędnego zrozumiała dla użytkownika. Ta etykieta, a nie ta ustawiona przez komponent nadrzędny, jest używana, gdy komponent jest prezentowany użytkownikowi jako element o możliwościach opisanych przez filtr.
Etykieta jest ustawiana jako odwołanie do zasobu ciągu znaków, aby można ją było zlokalizować tak jak inne ciągi znaków w interfejsie użytkownika. Jednak na potrzeby wygody podczas tworzenia aplikacji można go też ustawić jako ciąg znaków.
Wartość domyślna to etykieta ustawiona przez komponent nadrzędny. Jeśli rodzic nie określa etykiety, domyślnie jest używana etykieta ustawiona w atrybucie elementu
<application>
.label
Więcej informacji o etykietach filtra intencji znajdziesz w sekcji Ikony i etykiety w omówieniu pliku manifestu aplikacji.
android:priority
- Priorytet nadany komponentowi nadrzędnemu w odniesieniu do obsługi intencji typu opisanego przez filtr. Ten atrybut ma znaczenie zarówno w przypadku aktywności, jak i odbiorników transmisji.
- Zawiera on informacje o tym, jak dana aktywność reaguje na intencję pasującą do filtra w porównaniu z innymi aktywnościami, które również mogą odpowiadać tej intencji. Gdy intencję może obsłużyć wiele aktywności o różnych priorytetach, Android jako potencjalne docelowe traktuje tylko te o wyższych wartościach priorytetu.
Określa on kolejność, w jakiej odbiorniki transmisji są wywoływane do odbierania wiadomości. Odbiorniki o większych wartościach priorytetu są wywoływane przed odbiornikami o mniejszych wartościach. Kolejność ma zastosowanie tylko do wiadomości synchronicznych. Jest on ignorowany w przypadku wiadomości asynchronicznych.
Używaj tego atrybutu tylko wtedy, gdy chcesz narzucić określony porządek odbierania transmisji lub chcesz zmusić Androida do preferowania jednej aktywności nad innymi.
Wartość jest liczbą całkowitą, np.
100
. Im wyższa liczba, tym wyższy priorytet. Wartością domyślną jest0
.W pewnych okolicznościach żądany priorytet jest ignorowany, a wartość jest ograniczona do
0
. Dzieje się tak, gdy:- Aplikacja bez uprawnień prosi o dowolny priorytet >0.
- Aplikacja z przywilejami prosi o priorytet >0 w przypadku
ACTION_VIEW
,ACTION_SEND
,ACTION_SENDTO
lubACTION_SEND_MULTIPLE
.
Więcej informacji znajdziesz w artykule
setPriority()
. android:order
Kolejność, w jakiej filtr jest przetwarzany, gdy pasuje więcej niż 1 filtr.
order
różni się odpriority
tym, żepriority
ma zastosowanie w różnych aplikacjach, aorder
rozstrzyga niejednoznaczność w przypadku wielu pasujących filtrów w jednej aplikacji.Jeśli dopasowanie może być spełnione przez wiele filtrów, użyj zamiast tego kierowanego zamiaru.
Wartość jest liczbą całkowitą, np.
100
. Dopasowania z wyższymi wartościami są sprawdzane jako pierwsze. Wartością domyślną jest0
.Ten atrybut został wprowadzony na poziomie interfejsu API 28.
android:autoVerify
- Czy Android musi zweryfikować, czy plik JSON protokołu Digital Asset Links z wybranego hosta pasuje do tej aplikacji.
Więcej informacji znajdziesz w artykule Weryfikowanie linków aplikacji na Androida.
Wartość domyślna to
false
.Ten atrybut został wprowadzony w poziomie interfejsu API 23.
- wprowadzona w:
- Poziom API 1
- Zobacz też:
<action>
<category>
<data>
<uri-relative-filter-group>
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-12-21 UTC.
[null,null,["Ostatnia aktualizacja: 2024-12-21 UTC."],[],[]]