'동적링크'에 해당되는 글 4건

• 마지막으로 동적링크 만드는 방법을 알아보도록 한다.

https://firebase.google.com/docs/dynamic-links/create-manually?hl=ko

• 위의 매개변수를 추가하여 만들어진 동적 링크 URL은 다음과 같다.

https://appname.page.link/?link=https://com.company.appname/testlink?param=XXXXXX&ibi=com.company.appname&isi=4212345678&efr=1&ius=com.company.appname

• 도메인 정보

https://appname.page.link/

• 앱에서 열리는 링크이다. 붉은 색 링크가 앱에서 실제 수신하여 사용할 링크 정보이다.

?link=https://com.company.appname/testlink?param=XXXXXX

• ibi는 앱의 번들 아이디를 할당하여 앱을 여는데 사용된다.

&ibi=com.company.appname

• isi는 앱이 설치되지 않았을 경우 스토어 다운로드 페이지를 여는데 필요한 App Store ID 이다.

&isi=4212345678

• efr은 동적링크 클릭 시 미리보기 페이지가 호출되는데 '1'로 설정할 경우 미리보기 페이지를 건너뛰고 바로 앱 호출 또는 스토어 페이지로 이동 시킨다. (Firebase 설정에서 미리보기 건너뛰기를 체크해도 적용이 안되는 경우 이 매개변수를 사용하여 해결할 수 있다)

&efr=1

• ius는 앱의 번들 ID와 다른 값으로 정의하여 앱의 커스텀 URL 스킴으로 사용한다.
• 여기서는 커스텀 스킴을 기본 값인 앱의 번들아이디로 사용하였다.

&ius=com.company.appname

• 이상으로 firebase dynamic link(동적링크) 사용방법을 마친다.

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (1/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (2/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (3/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (4/4)

2022.07.21 - [iOS/Tips] - 유니버셜 링크(Universal Links) 문제점 해결

• 이제 기본적인 설정 및 테스트를 완료하였으므로 구현 코드를 보자

// 수신되는 링크 포맷
// com.company.appname://google/link/?deep_link_id=https://com.company.appname/testlink?param=XXXXXX ... &match_message=Link is uniquely matched for this device.
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    if let dynamicLink = DynamicLinks.dynamicLinks().dynamicLink(fromCustomSchemeURL: url)
    {
        self.handleIncomingDynamicLink(dynamicLink)
        return true
    }

    return true
}

// 수신되는 링크 포맷
// https://appname.page.link/?link=https://com.company.appname/testlink?param=XXXXXX ...
func application(_ application: UIApplication,
                   continue userActivity: NSUserActivity,
                   restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool
{
    if let incomingURL = userActivity.webpageURL {
        print("Incoming : \(incomingURL)")
 		
        let linkHandled = DynamicLinks.dynamicLinks().handleUniversalLink(incomingURL) { (dynamicLink, error) in
            guard error == nil else {
                print("Found an error! \(error!.localizedDescription)")
                return
            }
            if let dynamicLink = dynamicLink {
                self.handleIncomingDynamicLink(dynamicLink)
            }
        }

        if linkHandled
        {
            return true
        }
        else
        {
            if incomingURL.host == "appname.page.link" {
                guard let components = URLComponents(url: incomingURL, resolvingAgainstBaseURL: true),
                      let queryItems = components.queryItems else { return false }
                if let link = queryItems.first(where: { $0.name == "link" })?.value {
                    print("link = \(link)")
					// https://com.company.appname/testlink?param%3D12 ...
                    return true
                }
            }
        }
    }

    return false
}

// 수신되는 링크 포맷 
// https://com.company.appname/testlink?param=@#$%@#$%^#$%^
func handleIncomingDynamicLink(_ dynamicLink: DynamicLink) {
    guard let url = dynamicLink.url else {
        print("The dynamic link object has not url.")
        return
    }
    print("url : \(url.absoluteString)")

    guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
          let queryItems = components.queryItems else { return }
    if let param = queryItems.first(where: { $0.name == "param" })?.value {
        print("param = \(param)")
    }
}

• 상황에 따라 호출되는 포맷이 다르므로 주의하도록 한다.

• 앱이 설치되어 있고 웹링크를 통해 호출된 경우 :

https://appname.page.link/?link=https://com.company.appname/testlink?param=XXXXXX ...

• 앱이 설치되어 있지 않아 스토어에서 설치된 후 실행된 경우 :

com.company.appname://google/link/?deep_link_id=https://com.company.appname/testlink?param=XXXXXX ... &match_message=Link is uniquely matched for this device.

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (1/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (2/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (3/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (4/4)

2022.07.21 - [iOS/Tips] - 유니버셜 링크(Universal Links) 문제점 해결

이제 기본 설정이 완료 됬으므로 정상적으로 설정이 됬는지 체크해 본다.

• 사파리에서 AASA파일에 접근하여 정상적으로 생성되었는지 확인한다.  (App ID Prefix, Bundle ID 등을 확인)
• 생성된 도메인의 aasa파일 접근이 웹브라우저에서 가능한지 사파리 주소창에 입력하여 테스트 해 본다.

https://YourDomainName.page.link/apple-app-site-association

아래와 같이 설정한 내용이 aasa파일에 등록되어 출력된다면 성공.

{"applinks":{"apps":[],"details":[{"appID":"6ZU18XYZJ.com.company.appName","paths":["NOT /_/*","/*"]}]}}

• Xcode 프로젝트에서 Associated Domains 추가

applinks:YourDomainName.page.link

• Custom URL scheme 설정한다.

• URL scheme을 번들 아이디로 설정한다. (권장사항)
• 설정된 내용 확인한다.

URL Schemes 에 번들아이디를 넣어 주도록 한다.

• 이제 앱을 빌드하여 폰에 설치 한다.

• 아래 주소를 아이폰 메모장에 입력하고 클릭했을 때 앱이 실행되는지 테스트 한다.

• 다음 링크를 클릭했을 때 다음과 같은 페이지가 출력된다.

• 위의 타이틀 이름은 프로젝트 설정의 ‘공개용 이름’이 사용되며 
• 중간 이미지는 링크 설정에서 미리보기 이미지 URL이 사용된다.

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (1/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (2/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (3/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (4/4)

2022.07.21 - [iOS/Tips] - 유니버셜 링크(Universal Links) 문제점 해결

Google Firebase 의 dynamic link는 iOS의 Universal link 기능을 기반으로 기능이 확장된 형태를 갖는다.
처음 Universal link 적용 시 웹서버 구축등 어려움을 격는 분들은 Firebase의 dynamic link 사용을 권장한다.
Firebase의 dynamic link사용 시 웹서버, 도메인 설정 및 AASA파일 작성 및 업로드 등이 자동화 되어있어 좀더 편리하다.
그럼 순서대로 사용방법을 알아 보자.

• 프로젝트에 Podfile에 추가

• Pod 인스톨 한다.

pod install

• GoogleService-Info.plist 는 다운로드 하여 프로젝트에 추가해 준다.

• Firebase 프로젝트 설정에서 App Store ID, Team ID를 설정한다.

• Firebase Console 에서 동적 링크 섹션을 연다.

• 구글에서 지원해주는 도메인으로 선택한다. yourdomain.page.link 선택
• 원하는 도메인 이름을 입력한다.

• 여기서는 구글지원 도메인 page.link를 사용했다.

• 단축 URL 링크 설정 에서 원하는 이름을 입력한다.

ex) https://YourDomainName.page.link/testLink

• 동적 링크 설정

딥 링크 URL
https://com.companyname.appname/testLink?param=1234
동적 링크 이름
My appname Deep Link

• 연결할 iOS 프로젝트를 선택한다.

• 안드로이드 앱이 있다면 아래 선택

• 앱 미리보기 페이지 건너뛰기 체크. (테스트가 끝나면 체크하도록 하자)

• 마지막으로 저장 버튼을 누른다.

• 세부 정보를 클릭하면 다음과 같다.

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (1/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (2/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (3/4)

2021.06.17 - [iOS/Tips] - Firebase dynamic link (다이나믹 링크) (4/4)

2022.07.21 - [iOS/Tips] - 유니버셜 링크(Universal Links) 문제점 해결