Создавайте пользовательские классы DeepLinkMatcher

Если предоставленных сопоставителей недостаточно для ваших задач, вы можете создать свои собственные, расширив класс DeepLinkMatcher .

При расширении DeepLinkMatcher<T, R> необходимо указать два аргумента типа: тип ключа навигации назначения ( T : Any ) и тип результата сопоставления ( R : DeepLinkMatcher.MatchResult<T> ). Если вашему сопоставителю не требуется пользовательское ранжирование результатов или дополнительные метаданные, используйте DeepLinkMatcher.MatchResult<T> в качестве второго аргумента типа.

Например, вот базовая реализация TelDeepLinkMatcher , которая поддерживает URI tel (например, tel:5550100 ). Поскольку URI tel являются непрозрачными, UriDeepLinkMatcher их не поддерживает:

class TelDeepLinkMatcher : DeepLinkMatcher<DialerKey, DeepLinkMatcher.MatchResult<DialerKey>>() {
    override fun matchRequest(request: DeepLinkRequest): MatchResult<DialerKey>? {
        val uri = request.uri ?: return null
        if (uri.scheme != "tel") return null

        // Note: schemeSpecificPart is only available on Android
        val phoneNumber = uri.schemeSpecificPart ?: return null
        return MatchResult(DialerKey(phoneNumber = phoneNumber))
    }
}
CustomMatchersSnippets.kt

Классы Rank custom MatchResult

Если существует эффективный способ сравнения результатов поиска, полученных с помощью вашего пользовательского сопоставителя, вам следует расширить класс DeepLinkMatcher.MatchResult и переопределить метод compareTo для ранжирования результатов.

При создании пользовательского подкласса MatchResult обновите объявление класса вашего сопоставителя, указав этот подкласс в качестве второго параметра типа R (например, class TelDeepLinkMatcher : DeepLinkMatcher<DialerKey, TelMatchResult>() ). Это позволит вызывающим абонентам получать доступ к вашим пользовательским свойствам результата без неконтролируемого приведения типов.

Например, для поддержки сопоставления с использованием подстановочных символов в TelDeepLinkMatcher можно реализовать TelMatchResult , чтобы гарантировать, что точные совпадения будут иметь более высокий приоритет, чем совпадения с использованием подстановочных символов. Если сопоставитель обернут в withBackStack , распакуйте WrappedMatchResult перед сравнением, чтобы приоритет оценивался относительно базового результата сопоставления:

class TelMatchResult(
    key: DialerKey,
    val isExactMatch: Boolean,
    val patternLength: Int
) : DeepLinkMatcher.MatchResult<DialerKey>(key) {
    override fun compareTo(other: DeepLinkMatcher.MatchResult<DialerKey>): Int {
        // Unwrap if the other result is wrapped in a BackStackMatchResult or custom WrappedMatchResult
        val target = if (other is WrappedMatchResult<*>) other.matchResult else other
        if (target !is TelMatchResult) {
            // Determine precedence relative to other MatchResult types (e.g. UriMatchResult)
            return 1
        }

        // An exact match wins over a wildcard/prefix match
        if (isExactMatch && !target.isExactMatch) return 1
        if (!isExactMatch && target.isExactMatch) return -1

        // The more specific (longer) pattern wins (e.g., tel:1800* versus tel:*)
        val lengthDiff = this.patternLength - target.patternLength
        if (lengthDiff != 0) {
            return lengthDiff
        }

        return 0
    }
}
CustomMatchersSnippets.kt