Feature/deeplink api

[castlele]

Deeplink api

Как начать использовать

Для корректной работы необходимо:

1. создать объект имплементирующий протокол DeeplinkType;
2. создать объект имплементирующий протокол DeeplinkMapper;
3. создать объект имплементирующий протокол DeeplinkHandler;
4. настроить TIDeeplinkService.

1. DeeplinkType

Сам по себе является пустым протоколом

enum ProjectDeeplink: String, DeeplinkType {
    case someScreen
    case someOtherScreen
}

2. DeeplinkMapper

Объект, соответствующий данному протоколу, должен отвечать за преобразование URL 'а в объект DeeplinkType

struct ProjectDeeplinkMapper: DeeplinkMapper {
    func map(url: URL) -> DeeplinkType? {
        let stringData = parse(url)
        return ProjectDeeplink(rawValue: host)
    }

    private func parse(_ url: URL) -> String {
        // parse url to some data
    }
}

3. DeeplinkHandler

Объект, отвечающий за управление диплинком. Если объект может обработать диплинк, то он выдает необходимый набор инструкций

extension MainFlow: DeeplinkHandler {
    func canHandle(deeplink: DeeplinkType) -> Bool {
        guard let _ = deeplink as? ProjectDeeplink else {
            return false
        }

        return true
    }

    func handle(deeplink: DeeplinkType) -> Operation? {
        guard let deeplink = deeplink as? ProjectDeeplink else {
            return nil
        }

        switch deeplink {
        case . someScreen:
            return BlockOperation { [weak self] in
                self?.openSomeView()
            }

        case . someOtherScreen:
            return BlockOperation { [weak self] in
                self?.openSomeOtherView()
            }
        }
    }
}

Существует также базовая реализация BaseNavigationStackDeeplinkHandler. Она старается найти обработчик диплинка в иерархии вью.

4. TIDeeplinkService

Синглтон класс для работы с диплинками. Для его работы необходимо произвести конфигурацию созданными объектами: DeeplinkMapper, DeeplinkHandler

let someMapper = ProjectDeeplinkMapper()
let someHandler = mainFlow
TIDeeplinksService.shared.configure(mapper: someMapper, handler: someHandler)

Теперь все готово к использованию сервиса

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
        TIDeeplinksService.shared.deferredHandle(url: url)
        TIDeeplinksService.shared.tryHandle()
        return true
}

[petropavel13]

давай лучше протоколом закроем, который будет предоставлять rootDeeplinkHandlerController (UIViewController)

[petropavel13]

я думаю, что нам хватит второго метода т.к. он возвращает optional
либо handler к которому мы обратились не может обработать deeplink (возвращает nil)
либо он сам найдёт внутри себя обработчика

[petropavel13]

а можем обойтись associatedType или generic вместо пустого протокола?

[petropavel13]

сервис надо создавать самостоятельно с generic аргументом deeplink type

[petropavel13]

параметром в init

[petropavel13]

уже есть реализация актуальней

[petropavel13]

один метод тут лишний

[petropavel13]

handlePendingDeeplinks

[petropavel13]

давай лучше и Mapper и Handler в init

[petropavel13]

также можно сразу проверить let handler

[petropavel13]

тут можно подписать в комменте к методу, что значит возвращаемый bool