안드로이드 앱 링크

Overview

Branch를 사용하면 Android 앱 링크가 크게 향상되고 간단하게 활성화할 수 있습니다. 그뿐만 아니라 완전한 어트리뷰션을 제공받고 Android 앱 링크가 실패하는 에지 케이스(edge case)를 서포트 받을 수 있으며 유저가 앱을 설치하지 않은 경우에는 딥링크(Deep Link) 허용도 가능합니다. Android 앱 링크는 안드로이드 6 이상에서만 작동합니다. 나머지는 Branch가 해결해드립니다!

Setup

1. 서명 인증서 핑거프린트 생성하기

  1. Start by generating a SHA256 fingerprint of your app's signing certificate.
    a. Navigate to your keystore file. This is the file that you use to build the debug and production version of your APK file before deploying it.
    b. Run this command to generate the fingerprint: keytool -list -v -keystore xxxx-example-my-release-key.keystore
    c. You'll see a value like
    14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
    와 같은 값이 나타납니다. 해당 내용을 복사하십시오.
  2. 다음을 수행하여 Branch 대시보드에서 앱 링크(App Links)를 활성화합니다.
    가. Branch 대시보드의 Configuration 페이지로 이동합니다.
    나. Enable App Links안드로이드 섹션에서 SHA256 Cert Fingerprints 체크박스를 전환합니다.
    다. 복사된 핑거프린트 값을 나타나는 SHA256 Cert Fingerprints 필드에 붙여 넣습니다. 테스트를 위해 디버그 및 프로덕션 핑거프린트를 모두 삽입할 수 있습니다. 간단히 쉼표로 구분하면 됩니다.
    라. 아래로 스크롤하여 Save를 클릭합니다.
  3. Now, add your Intent Filter to Manifest by going to the Link Domain section on the Configuration page.
    a. Copy your domain name.
    b. Choose the Activity you want to open up when a link is clicked. This is typically your SplashActivity or a BaseActivity that all other activities inherit from (and likely the same one you selected in the SDK integration guide.
    c. Inside your AndroidManifest.xml, locate where the selected Activity is defined.
    d. Within the Activity definition, insert the intent filter provided below (making sure that xxxx matches the subdomain prefix you've been assigned or selected for yourself). Add this as its own separate intent filter.
    e. If you use a custom domain or subdomain for your Branch links, you should also add an entry for:
<data android:scheme="https" android:host="mycustomdomainorsubdomain" />
<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="xxxx.app.link" />
    <data android:scheme="https" android:host="xxxx-alternate.app.link" />
    <data android:scheme="https" android:host="xxxx.test-app.link" />
    <data android:scheme="https" android:host="xxxx-alternate.test-app.link" />
</intent-filter>

🚧

도메인 유효성 검증

도메인 유효성 검증
시스템은 URL Intent Filter의 데이터 요소에 지정된 모든 호스트를 각 웹 도메인에서 호스트 되는 Digital Asset Links 파일에 대비하여 확인할 수 있어야 합니다. 검증에 실패하면 앱은 앱 Intent Filter에 정의된 URL 패턴에 대한 기본 핸들러로 확인되지 않습니다. Google의 Statement List Asset Generator을 사용하여 기존 명세 파일을 테스트할 수 있습니다.

2. APK SHA256 핑거프린트 가져오기

  1. Run: keytool -printcert -jarfile my_app.apk on your APK file.

이 페이지가 도움이 되었습니까?