[iOS/Swift] 유니버셜 링크(Universal Link) 적용하기, 동적 링크 수신하기

유니버셜 링크(Univeral Link) 란?

 

 

iOS에서 딥링크*를 구현하는 방법 중 하나로 웹에서 앱을 호출하는 기능이 필요할 때 사용!

*딥링크(Deep Link) :  특정 주소나 값을 입력하면 앱이 실행되거나 앱 내 특정 페이지에 도달할 수 있도록 하는 링크

• URI 스킴 방식 : 앱에 URI 스킴(scheme) 값을 등록하여 딥링크 사용
• 앱링크(App Link) : Android 제공 - 도메인 주소를 이용한 딥링크 사용
• 유니버셜 링크 (Universal Link) : iOS 제공  - 도메인 주소를 이용한 딥링크 사용

*Dynamic Link : 파이어베이스에서 제공하는 딥링크의 일종

 

유니버셜 링크를 이용하면, 아래 그림과 같이

사용자가 링크 접근 시, 앱이 설치되어 있는 경우 앱으로 이동하고 없으면 앱을 설치할 수 있는 앱스토어로 이동하게 됩니다.

 

 

 

 

---

유니버셜 링크(Univeral Link) 활용

• QR code, NFC 인식 시 앱으로 연결
• 웹 광고 배너 클릭시 앱 이동을 통한 앱 홍보

---

유니버셜 링크(Univeral Link) 특징

• ip 및 http에선 동작하지 않음
• SSL 있는 백엔드 필요
• 허용 여부를 묻지 않음
• 지원 iOS 버전 : iOS 9 이상

---

유니버셜 링크(Univeral Link) Setting Process

1. 웹서버 작업 - Web Server에 AASA(apple-app-site-association) 파일 추가
2. 앱 작업 - Associated Domains  추가

---

 

 

HOW TO USE ?

1. Web Server에 AASA 파일 추가하기

Universal link를 사용하기 위해서는 소유한 도메인이 있어야 합니다.

따라서 도메인 정보가 포함된 JSON파일인 apple-app-site-association(AASA)파일을 웹서버에 업로드해야 합니다.

사용자가 앱 설치시, 이 파일에 등록된 도메인으로 apple-app-site-association 파일에 대한 요청을 보냅니다.

또, 사용자가 이미 앱을 설치했다면 앱을 바로 실행주는 링크의 도메인에서 호스팅 됩니다.

 

주의할 점!

✔️redirection 이 없어야 하고

✔️https 지원

✔️128KB보다 작아야 함

 

[ apple-app-site-association 파일 ]

파일명: apple-app-site-association (확장자 없음)

위치: .well-known 디렉터리 또는 root 디렉터리에 추가

 

[For iOS13 and later]

{
    applinks: {
        details: [
            {
                appIDs: ["<TEAM_DEVELOPER_ID>.<BUNDLE_IDENTIFIER>"],
                components: [
               		{
                	/: “*”
                    }
                ] 
            }
        ]
    }
}

[For iOS12 and earlier]

{
    "applinks": {
        "apps": [],
        "details": [{
            "appID": "<TEAM_DEVELOPER_ID>.<BUNDLE_IDENTIFIER>",
            "paths": ["*"]
            },
            {
            "appID": "<TEAM_DEVELOPER_ID>.<BUNDLE_IDENTIFIER>",
            "paths": ["/files"]
        }]
    }
}

 

[ apple-app-site-association 파일 내용 구성]

apps : 유니버셜 링크에서는 사용하지 않지만 빈 배열로라도 반드시 명시되어 있어야 함.

details : 웹사이트에서 핸들링되는 앱들의 목록입니다. 즉 한 웹사이트에서 유니버셜 링크를 사용하는 여러 앱 연동이 가능.

appId : 앱의 식별 값으로 팀 아이디와 번들 id를 사용. 형식:<TEAM_DEVELOPER_ID>.<BUNDLE_IDENTIFIER>

paths : 앱에서 지원하는 웹사이트 경로(*: 전 위치 가능)

 

*appId >>

*TEAM_DEVELOPER_ID 확인하기 >>

Apple Developer 사이트(https://developer.apple.com/) > Account > Certificates, IDs & Profiles > Identifiers

우측 상단에서 확인 가능

*BUNDLE_IDENTIFIER 확인하기 >>

연결할 앱 Xcode Project > Target > General > Identity

 

 

 

---

2. iOS 앱에 Capability - Associated Domains  추가

유니버셜 링크를 지원하려면, 먼저 앱에서 유니버셜 링크를 허용할 도메인을 추가해야 합니다.

추가한 도메인 주소를 통해 앱이 연결됩니다!

Project > Target > Signing&Capabilities> Associated Domains에 Domains 추가

applinks 형식 예시)

//applinks:your_dynamic_links_domain
applinks:example.com
applinks:*.example.com

이렇게 하면, 사용자가 앱 설치 시, 여기에 등록된 도메인의 해당 url의 .well-known/apple-app-site-association 경로에 가서 AASA 포맷을 확인하라고 파일에 대한 요청을 보내게 됩니다.

 

* 등록이 잘 됐는지 entitlements로 확인하기!

 

 

------------- 여기까지 설정하면 앱과 웹이 연결되어 서로의 정보를 알고 있음! -------------

* 테스트 방법 : 메모앱에서 설정한 도메인주소를 입력 후 클릭시 연결한 앱이 실행되면 연결 성공!👻

 

 

 

 

---

3. 앱에서 동적링크 URL handle 하기

유니버셜 링크로 들어오는 요청은 SceneDelegate의 scene:continueUserActivity 메서드에서 전달받은 NSUserActivity 객체를 사용해 처리할 수 있습니다.😊

 

*NSUserActivitys :

- 특정 시점의 앱 상태를 나타내는 표현

- user activity 객체를 생성하고, 이를 사용하여 앱 content보기, 문서 편집, 웹페이지 보기 또는 비디오 시청과 같이 사용자가 수행한 작업에 대한 정보를 캡쳐

 

전달된 userActivity의 path요소를 검출하여 실패하면 return false구문이 실행되고 앱은 전달된 activity를 핸들링하지 못하게 된다.

NSURLComponents * components = [NSURLComponents componentsWithURL:userActivity.webpageURL resolvingAgainstBaseURL:YES];
path = components.path;

 

[전체코드 - iOS13 and later]

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
	//전달된 userActivity의 값을 검증
	guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
    	let incomingURL = userActivity.webpageURL,
        let components = URLComponents(url: incomingURL, resolvingAgainstBaseURL: true),
        let path = components.path else {
                return
        }
        
    //도메인 주소의 쿼리값을 받음
 	let params = components.queryItems ?? [URLQueryItem]()
	print("path = \(incomingURL)")
	print("params = \(params)")
    
	// 검출한 path를 이용하여 어떤 computer를 보여주어야 하는지 결정
  if let computer = ItemHandler.sharedInstance.items.filter({ $0.path == components.path}).first {
    self.presentDetailViewController(computer)
    return true
  }
    
  // 보여주어야할 computer가 결정되지 못하면, application에 URL을 open하도록 요청하여 사파리 연결
  let webpageUrl = URL(string: "http://rw-universal-links-final.herokuapp.com")!
  application.openURL(webpageUrl)
    
}

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    for urlContext in URLContexts {
        let urlToOpen = urlContext.url
        // ...
    }
}

[For iOS9 and later]

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *))restorationHandler {
    NSURL *url = userActivity.webpageURL;
    // ...
}

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
    // ...
}

 

---

Reference Site

developer.apple.com/ios/universal-links/

Universal Links - Apple Developer

https://developer.apple.com/videos/play/wwdc2020/10098/

What's new in Universal Links - WWDC20 - Videos - Apple Developer