- 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>
- description:
- Określa typy intencji, na które może odpowiedzieć aktywność, usługa lub odbiornik. Filtr intencji deklaruje możliwości komponentu nadrzędnego: możliwości działania lub usługi oraz rodzaje transmisji, które może obsłużyć odbiornik.
Otwiera komponent na potrzeby odbierania zamiarów reklamowanego typu i odfiltrowuje te, które nie są istotne dla danego komponentu. Większość zawartości filtra jest opisana przez jego podelementy
<action>
,<category>
i<data>
.Bardziej szczegółowe informacje o filtrach znajdziesz w sekcji 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, gdy ten komponent jest przedstawiany użytkownikowi jako komponent z możliwością opisaną przez filtr.
Ten atrybut jest ustawiany jako odwołanie do rysowalnego zasobu zawierającego definicję obrazu. Wartością domyślną jest ikona ustawiona przez atrybut
icon
komponentu nadrzędnego. Jeśli element nadrzędny nie określi ikony, domyślnie przyjęta zostanie ikona ustawiona przez element<application>
.Więcej informacji o ikonach filtra intencji znajdziesz w sekcji Ikony i etykiety w omówieniu w pliku manifestu aplikacji.
android:label
- Czytelna dla użytkownika etykieta komponentu nadrzędnego. Ta etykieta, a nie etykieta ustawiona przez komponent nadrzędny, jest używana, gdy komponent jest przedstawiany użytkownikowi jako komponent z możliwością opisaną przez filtr.
Etykieta jest ustawiona jako odwołanie do zasobu w postaci ciągu znaków, dzięki czemu można ją zlokalizować tak samo jak inne ciągi w interfejsie. Dla wygody podczas programowania aplikacji możesz ją jednak także ustawić jako nieprzetworzony ciąg znaków.
Wartością domyślną jest etykieta ustawiona przez komponent nadrzędny. Jeśli element nadrzędny nie określa etykiety, domyślną jest etykieta ustawiona przez atrybut
label
elementu<application>
.Więcej informacji o etykietach filtra intencji znajdziesz w sekcji Ikony i etykiety w omówieniu w pliku manifestu aplikacji.
android:priority
- Priorytet nadawany komponentowi nadrzędnemu w odniesieniu do obsługi intencji o typie opisanym w filtrze. Ten atrybut odnosi się zarówno do działań, jak i odbiorów.
- Podaje informacje o tym, jak aktywność może reagować na intencję pasującą do filtra w porównaniu z innymi działaniami, które również mogą odpowiadać na intencję. Jeśli intencja może być obsługiwana przez wiele działań o różnych priorytetach, Android traktuje jako potencjalne cele tylko te o wyższych priorytetach.
Steruje kolejnością wykonywania komunikatów w celu odbierania komunikatów – te z wyższymi wartościami priorytetu są wywoływane przed tymi o niższych wartościach. To postanowienie odnosi się tylko do wiadomości synchronicznych. Jest ignorowana w przypadku wiadomości asynchronicznych.
Użyj tego atrybutu tylko wtedy, gdy musisz nałożyć konkretną kolejność, w jakiej będą odbierane komunikaty, lub chcesz wymusić na Androidzie preferowanie jednej z aktywności.
Wartość jest liczbą całkowitą, np.
100
. Wyższe numery mają 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ń żąda priorytetu > 0.
- Aplikacja z podwyższonymi uprawnieniami żąda priorytetu > 0 dla elementów
ACTION_VIEW
,ACTION_SEND
,ACTION_SENDTO
lubACTION_SEND_MULTIPLE
.
Więcej informacji:
setPriority()
. android:order
Kolejność przetwarzania filtra w przypadku spełnienia wielu filtrów.
order
różni się odpriority
tym, żepriority
ma zastosowanie do wszystkich aplikacji, aorder
ujednolica wiele filtrów pasujących do jednej aplikacji.Jeśli pasuje wiele filtrów, użyj intencji kierowanej.
Wartość jest liczbą całkowitą, np.
100
. Większe liczby są dopasowywane jako pierwsze. Wartością domyślną jest0
.Ten atrybut został wprowadzony na poziomie API 28.
android:autoVerify
- Wskazuje, czy Android musi sprawdzić, czy plik JSON protokołu Digital Asset Links z określonego 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 na poziomie API 23.
- wprowadzone w:
- Poziom interfejsu API 1
- zobacz też:
<action>
<category>
<data>
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-04-02 UTC.
[]
[]