필터

안드로이드 앱이 열리지 않는 문제 해결 가이드

안드로이드 앱 열기는 다음 3가지 요소를 통해 설정됩니다.

  1. Branch 링크
  2. 앱의 안드로이드 매니페스트 파일
  3. 대시보드의 App Link settings->Link settings->Android redirects

Step 1: Follow the Android SDK Guide

본 사이트의 안내에 따라 안드로이드 SDK를 설정하십시오. 아래 문제 해결 단계를 따라 진행합니다.

  1. Dashboard -> Link settings -> Android redirects에서 안드로이드 앱의 패키지 이름과 URL을 작성합니다.
  2. 론처 액티비티(Launcher Activity)의 인텐트 필터에 Branch 링크를 추가하십시오.
  3. You can copy the exact same code and replace the xxxx with your Branch link domain. If you do not what your domain is, please refer to Step 2.

2단계: Branch 키 검증

대시보드에 표시된 것과 같은 Branch 키를 통해 생성된 링크로 테스트 중입니까?
만약 그렇다면 테스트 대시보드에서 생성된 링크로 테스트를 해야 하며 그 반대의 경우도 마찬가지입니다. 라이브 키로 Branch를 초기화 중이라면 라이브 대시보드에서 생성된 링크로 테스트해야 합니다. 기본값일 때 라이브 링크에는 app.link 서브도메인이 있고 테스트 링크에는 test-app.link 서브도메인이 있습니다. 커스텀 도메인을 등록하는 경우 해당 커스텀 도메인을 가진 링크로 테스트해야 합니다.

3단계: 설정 검증

다음 사항을 확인하십시오.

  1. The package name on the Manifest file matches exactly with what is configured on the Configuration -> General page.
  2. Dashboard -> Configuration -> General -> Android -> URI Scheme 에서 URI scheme 섹션에 설정된 것과 정확하게 같은 scheme을 지닌 인텐트 필터를 사용하는 액티비티가 있습니다. 보통 앱의 스플래시 액티비티를 말합니다.
  3. The URI scheme host in the Manifest file matches the Branch link. We recommend "host=open", but if you have $deeplink_path with something other than "open," the link will fail to open the app.

4단계: 플랫폼 동작 검증

Clicking the Branch link from different apps such as Facebook, Twitter, etc. can produce different redirection behaviors. Please make sure you go through the expected behaviors of the various known platforms as mentioned in our documentation.

5단계: 고급 Branch 링크 검증

검증은 링크 동작에 따라 다를 수 있으며 고급 유스 케이스에만 가능합니다.

If you are using the $android_deeplink_path Branch link property, instead of using the custom key-value Branch link property, you would need to make sure you have set the URI scheme path in the Manifest file to handle that incoming URI scheme. Branch will append the value in $android_deeplink_path to your app's URI scheme so ensure that there is a corresponding intent filter.