import Crossroad

let customURLScheme: LinkSource = .customURLScheme(“pokedex”)
let universalLink: LinkSource = .universalLink(URL(string: “https://my-awesome-pokedex.com”)!)

do {
let router = try DefaultRouter(accepting: [customURLScheme, universalLink]) { registry in
registry.route(“/pokemons/:pokedexID”) { context in
let pokedexID: Int = try context.argument(named: “pokedexID”) // Parse ‘pokedexID’ from URL
if !Pokedex.isExist(pokedexID) { // Find the Pokémon by ID
throw PokedexError.pokemonIsNotExist(pokedexID) // If Pokémon is not found. Try next route definition.
}
presentPokedexDetailViewController(of: pokedexID)
}
registry.route(“/pokemons”) { context in
let type: Type? = context.queryParameters.type // If URL contains &type=fire, you can get Fire type.
presentPokedexListViewController(for: type)
}

// …
}
} catch {
// If route definitions have some problems, routers fail initialization and raise reasons.
fatalError(error.localizedDescription)
}

// Pikachu(No. 25) is exist! so you can open Pikachu’s page.
let canRespond25 = router.responds(to: URL(string: “pokedex://pokemons/25”)!) // true
// No. 9999 is missing. so you can’t open this page.
let canRespond9999 = router.responds(to: URL(string: “pokedex://pokemons/9999”)!) // false
// You can also open the pages via universal links.
let canRespondUniversalLink = router.responds(to: URL(string: “https://my-awesome-pokedex.com/pokemons/25”)!) // true

// Open Pikachu page
router.openIfPossible(URL(string: “pokedex://pokemons/25”)!)
// Open list of fire Pokémons page
router.openIfPossible(URL(string: “pokedex://pokemons?type=fire”)!)

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any]) -> Bool {
if router.responds(to: url, options: options) {
return router.openIfPossible(url, options: options)
}
return false
}

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
guard let context = URLContexts.first else {
return
}
router.openIfPossible(context.url, options: context.options)
}

class AppDelegate: NSObject, NSApplicationDelegate {
func applicationDidFinishLaunching(_ aNotification: Notification) {
let appleEventManager = NSAppleEventManager.shared()
appleEventManager.setEventHandler(self,
andSelector: #selector(handleURLEvent(event:replyEvent:)),
forEventClass: AEEventClass(kInternetEventClass),
andEventID: AEEventID(kAEGetURL))
}

@objc func handleURLEvent(event: NSAppleEventDescriptor?, replyEvent: NSAppleEventDescriptor?) {
guard let urlString = event?.paramDescriptor(forKeyword: AEKeyword(keyDirectObject))?.stringValue else { return }
guard let url = URL(string: urlString) else { return }
router.openIfPossible(context.url, options: [:])
}
}

// actual URL: pokedex://search/Pikachu
let keyword: String = try context.arguments(named: “keyword”) // Pikachu

// actual URL: pokedex://search/Pikachu?generation=1
let generation: Int? = context.queryParameters[“generation”] // 1
// or you can also get value using DynamicMemberLookup
let generation: Int? = context.queryParameters.generation // 1

// expected pattern: pokedex://search/:pokedexID
// actual URL: pokedex://search/25
let pokedexID: Int = try context.arguments(named: “keyword”) // 25

enum Type: String, Parsable {
case normal
case fire
case water
case grass
// ….
}

// matches: pokedex://pokemons?type=fire
let type: Type? = context.queryParameters.type // .fire

// matches: pokedex://pokemons?types=water,grass
let types: [Type]? = context.queryParameters.types // [.water, .grass]

struct User {
let name: String
}
extension User: Parsable {
init?(from string: String) {
self.name = string
}
}

let customURLScheme: LinkSource = .customURLScheme(“pokedex”)
let pokedexWeb: LinkSource = .universalLink(URL(string: “https://my-awesome-pokedex.com”)!)
let anotherWeb: LinkSource = .universalLink(URL(string: “https://kanto.my-awesome-pokedex.com”)!)

let router = try DefaultRouter(accepting: [customURLScheme, pokedexWeb, anotherWeb]) { registry in
// Pokémon detail pages can be opened from all sources.
registry.route(“/pokemons/:pokedexID”) { context in
let pokedexID: Int = try context.argument(named: “pokedexID”) // Parse ‘pokedexID’ from URL
if !Pokedex.isExist(pokedexID) { // Find the Pokémon by ID
throw PokedexError.pokemonIsNotExist(pokedexID)
}
presentPokedexDetailViewController(of: pokedexID)
}

// Move related pages can be opened only from Custom URL Schemes
registry.group(accepting: [customURLScheme]) { group in
group.route(“/moves/:move_name”) { context in
let moveName: String = try context.argument(named: “move_name”)
presentMoveViewController(for: moveName)
}
group.route(“/pokemons/:pokedexID/move”) { context in
let pokedexID: Int = try context.argument(named: “pokedexID”)
presentPokemonMoveViewController(for: pokedexID)
}
}

// You can pass acceptPolicy for a specific page.
registry.route(“/regions”, accepting: .only(for: pokedexWeb)) { context in
presentRegionListViewController()
}
}

struct UserInfo {
let userID: Int64
}
let router = try Router<UserInfo>(accepting: customURLScheme) { registry in
registry.route(“pokedex://pokemons”) { context in
let userInfo: UserInfo = context.userInfo
let userID = userInfo.userID
}
// …
])
let userInfo = UserInfo(userID: User.current.id)
router.openIfPossible(url, userInfo: userInfo)

let parser = ContextParser()
let context = parser.parse(URL(string: “pokedex:/pokemons/25”)!,
with: “pokedex://pokemons/:id”)

use_frameworks!

pod ‘Crossroad’

github “giginet/Crossroad”