Intent Filter: какво е, как работи и се използва в разработката

Какво е Intent Filter?

Intent Filter е конфигурационен елемент на Android приложението, който уведомява системата за възможността на компонента да обработва определени типове неявни намерения. За разлика от явните Intent, които указват конкретен клас, неявните Intent съдържат само описание на необходимото действие, а системата сама намира подходящия компонент въз основа на регистрираните филтри.

Филтрите се декларират вътре в компонента — Activity, Service или BroadcastReceiver — във файла AndroidManifest.xml. Всеки филтър може да съдържа няколко елемента action, category и data. Компонентът може да има неограничен брой Intent Filter, като всеки от тях описва отделен сценарий за обработка.

Роля в архитектурата на Android

Intent Filter реализира принципа на слабата свързаност между компоненти на приложения. Приложение А не е задължено да знае за съществуването на приложение Б — то просто изпраща Intent с описание на действието, а системата го маршрутизира въз основа на филтрите. Този механизъм е в основата на Share Sheet, избора на браузър и обработката на deep link.

Видове Intent: явни и неявни

Явните Intent указват конкретен клас компонент за стартиране. Те се използват за вътрешна навигация в рамките на едно приложение, когато разработчикът знае точно кое Activity трябва да се отвори. Неявните Intent съдържат само описание на действието, а компонентът се определя динамично от системата.

Intent Filter работи изключително с неявни Intent. Ако в Intent е указан конкретен клас, системата игнорира всички филтри и стартира посочения компонент директно. Филтрите се проверяват само при разрешаване на неявни извиквания, което ги прави ключов елемент на междуприложното взаимодействие.

Сравнение на явни и неявни Intent

Структура на Intent Filter в манифеста

Всеки Intent Filter се състои от три групи елементи — action, category и data — комбинацията от които определя кои Intent ще получава компонентът. Филтърът се счита за преминат, ако Intent съответства на поне един елемент от всяка група.

Action описва изпълняваното действие — преглед, редактиране, изпращане. Category добавя допълнителен контекст на обработка — например възможност за стартиране от браузър. Data определя формата на обработваната информация чрез URI или MIME тип.

Елементи на тага intent-filter

Пример за Intent Filter за Activity, което отваря връзки към профили на потребители. Филтърът включва и трите групи елементи за точно маршрутизиране.

<activity android:name=".ProfileActivity">
    <intent-filter>
        <action
            android:name="android.intent.action.VIEW" />
        <category
            android:name="android.intent.category.DEFAULT" />
        <category
            android:name="android.intent.category.BROWSABLE" />
        <data
            android:scheme="myapp"
            android:host="profile" />
    </intent-filter>
</activity>

Обърнете внимание на задължителното посочване на category DEFAULT — без нея системата няма да предава неявни Intent на компонента. Категорията BROWSABLE се добавя, ако връзката трябва да се обработва от браузър.

Intent Filter за deep link

Deep link на Android се настройва чрез Intent Filter с action VIEW и таг data, съдържащ схема, host и път. При преминаване към връзка от вида myapp://profile/42 системата намира Activity с подходящ филтър и го стартира с предаденото URI. Важно е правилно да се настроят pathPrefix, pathPattern или path за точно съпоставяне.

От Android 6 (API 23) нататък се поддържат App Links — верифицирани deep link чрез HTTPS. За App Links се използва същият Intent Filter, но с допълнително удостоверяване на домейна чрез Digital Asset Links. След удостоверяване системата автоматично отваря приложението без диалог за избор.

Data таг за URL

Пример за филтър за App Link с удостоверяване чрез HTTPS връзка. В този случай схемата винаги е https, а host съответства на домейна, посочен в Digital Asset Links.

<intent-filter android:autoVerify="true">
    <action
        android:name="android.intent.action.VIEW" />
    <category
        android:name="android.intent.category.DEFAULT" />
    <category
        android:name="android.intent.category.BROWSABLE" />
    <data
        android:scheme="https"
        android:host="example.com"
        android:pathPrefix="/profile" />
</intent-filter>

Атрибутът autoVerify указва на системата да провери Digital Asset Links при инсталиране на приложението. Ако удостоверяването е успешно, приложението автоматично става обработвач по подразбиране за посочения домейн и пътища.

Обработка на Intent в компоненти на приложението

След като системата избере компонент за обработка на Intent, разработчикът трябва да извлече данните от входящото намерение вътре в целевия компонент. За Activity се използва методът getIntent() в onCreate(), за BroadcastReceiver — методът onReceive(), където Intent се предава като параметър.

Извличането на данни включва получаване на action за определяне на типа операция, data за URI и extra-параметри за допълнителна информация. Всеки от тези елементи може да липсва, затова е задължителна проверка за null преди използване.

Код за обработка в Activity

Пример за обработка на входящ deep link в Activity на Kotlin. Кодът извлича URI от Intent и въз основа на host и пътя взема решение за навигация.

class ProfileActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val uri = intent?.data
        if (uri?.host == "profile") {
            val userId = uri.lastPathSegment
            loadProfile(userId)
        }
    }
}

Препоръчва се използването на safe call оператор за проверка на intent и data за null, тъй като активността може да бъде стартирана без входящ deep link. Също така трябва да проверявате host и pathSegment за null преди използването им в навигацията.

Приоритет и разрешаване на конфликти

Ако няколко приложения са регистрирали Intent Filter, подходящ за един и същ неявен Intent, системата показва на потребителя диалог за избор. Потребителят може да избере приложение за еднократна употреба или да зададе обработвач по подразбиране. От Android 10 диалогът за избор се показва само при първото извикване, след което системата запомня избора на потребителя.

За управление на приоритета се използва атрибутът android:priority в тага intent-filter. Колкото по-висока е стойността, толкова по-голям приоритет има компонентът при разрешаване на конфликти. Приоритетът обаче не работи за филтри от различни приложения — в този случай винаги се показва диалог за избор, ако никое приложение не е зададено по подразбиране.

Диалог за избор на приложение

Разработчикът може програмно да извика диалога за избор чрез Intent.createChooser(), като предаде целевия Intent и заглавие. Това е полезно, когато приложението иска изрично да предложи на потребителя да избере обработвач, дори ако е зададено приложение по подразбиране. Например при изпращане на изображения в социални мрежи чрез ACTION_SEND, createChooser гарантира показване на диалога независимо от настройките по подразбиране.

Типични грешки при настройка на Intent Filter

Една от най-честите грешки е липсата на категория DEFAULT в Intent Filter. Разработчиците копират конфигурацията от примери, но забравят да добавят тази категория, в резултат на което Activity не получава неявни Intent. Системата просто не вижда филтъра за неявни извиквания, въпреки че явните Intent продължават да работят.

Втората често срещана грешка е неправилното посочване на scheme в тага data без пълно URI. Ако е посочена само схемата, но не и host, филтърът ще приема всички връзки с тази схема от произволен източник, което може да доведе до нежелани извиквания от непроверени източници. Препоръчва се винаги да посочвате поне scheme и host.

Третата грешка е липсата на проверка на intent.data за null в кода на Activity. Ако Activity се стартира не чрез deep link, а по стандартния начин от лаунчъра, Intent не съдържа URI. Достъпът до intent.data без проверка причинява NullPointerException и срив на приложението. Винаги използвайте intent?.data?.toString() с оператор safe call.