[iOS Swift] Deeplink 사용하기

1. URL scheme 지정하기

2. 딥링크 지정하기

---

1. URL scheme 지정하기

• URL Scheme은 url이 시작되기 전 url 앞에 붙는 프리픽스 스트링 (예를 들어 https:// 가 있음)
• 앱이 설치되지 않은 경우 사용할 수 없음
• url이지만 사파리에서 동작하는 것이 아니라 내 앱에 지정된 동작을 수행하는데 사용함

(1) 앱에서 URL Scheme 등록하기

• Info.plist 파일에 URL scheme 등록
• Info.plist > URL Types 섹션

• Identifier와 사용자 정의 스킴을 입력해 줌
• Identifier는 번들 id와 동일

(2) Schene delegate 메소드 정의하기

• 앱에 딥링크 처리 요청하기 
  • 코드레벨에서 해당 코드 동작 시키면 됨
  • 혹은 사파리의 주소창에서 지정 스킴을 포함한 URL을 검색

let url = URL(string: "사용자지정스킴://path/")!
UIApplication.shared.open(url, options: [:], completionHandler: nil)

• 앱이 딥링크를 처리하라는 요청을 받으면 아래 함수를 호출함
  • SceneDelegate를 사용하는 경우 scene(_:openURLContexts:)
  • AppDelegate를 사용하는 경우 application(_:open:options:)

• 일반 URL인 경우 사파리로 해당 링크를 열고, 사용자 지정 스킴인 경우 앱에게 딥 링크 처리 요청

url 구조

    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        guard let url = URLContexts.first?.url else { return }
        
        let scheme = url.scheme
        
        let host: String?
        if  #available(iOS 16.0, *) {
            host = url.host()
        } else {
            host = url.host
        }
        
        let path: String
        if #available(iOS 16.0, *) {
            path = url.path()
        } else {
            path = url.path
        }
        
        let components = url.pathComponents
    }

• 왜 Set<>으로 URLContexts가 오는지 이유 못 찾음
• path와 host 프로퍼티는 deprecate 예정이라 (쓰는데 문제는 없음 아직까지는.) Percent encoding 옵션이 포함된 메소드를 사용해 path와 host를 얻을 수 있음. 이는 iOS 16 부터 지원
• pathComponents는 path를 /로 구분하여 String 배열로 반환함. 인덱스 0은 / 이다 (["/", "test", "10"] 두 번째, 인덱스로는 1번 부터 사용)

---

2. 딥링크 지정하기

    func scene(_ scene: UIScene, willContinueUserActivityWithType userActivityType: String) {
        guard userActivity?.activityType == NSUserActivityTypeBrowsingWeb,
              let urlToOpen = userActivity?.webpageURL else {
            return
        }
        handleURL(urlToOpen)
    }
    
    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        guard let url = URLContexts.first?.url else { return }
        handleURL(url)
    }

    func handleURL(_ url: URL) {
        guard url.scheme == "mycustomscheme" else { return }
        
        let host: String?
        if  #available(iOS 16.0, *) {
            host = url.host()
        } else {
            host = url.host
        }
        
        let components = url.pathComponents
        
        switch host {
        ....
        }
    }

• switch를 사용해서 host의 값에 따라 로직을 수행하도록 할 수 있음. host가 같고 path로 구분해야 하는 경우 url.pathComponents로 얻은 값을 사용할 수 있음

 

• 앱이 이미 실행된 경우 window의 rootViewController에 화면을 푸시

var router = AppCoordinator().strongRouter
guard let navigationController = router.viewController as? UINavigationController else { return }

• xCoordinator을 사용할 경우 router의 viewController로 확인할 수 있음

guard let navigationController = window?.rootViewController as? UINavigationController else { return }

 

---

참고 사이트

https://www.donnywals.com/handling-deeplinks-in-your-app/

https://ios-development.tistory.com/207