앱 링크의 인텐트 필터 추가

앱 링크는 HTTP 또는 HTTPS 스키마를 사용하고 Android에서 웹사이트와 연결된 것으로 확인된 딥 링크입니다. 앱 링크를 처리하도록 등록하려면 다음 단계를 따르세요.

  1. 웹사이트 도메인 또는 URL을 지정하는 인텐트 필터를 앱 매니페스트에 하나 이상 추가합니다.
  2. 인텐트 필터 요소에 autoVerify="true"attribute를 추가합니다. 이렇게 하면 시스템이 웹사이트의 assetlinks.json 구성에 대해 스키마와 호스트 도메인을 확인하려고 시도해야 함을 알립니다.
  3. 웹사이트 연결을 선언합니다.

다음은 스키마와 호스트, autoVerify="true이 포함된 앱 링크 선언의 예입니다.

<activity
    android:name=".MainActivity"
    android:exported="true"
    ...>
    <!-- Make sure you explicitly set android:autoVerify to "true". -->
    <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" />

        <!-- If a user clicks on a link that uses the "http" scheme, your
             app should be able to delegate that traffic to "https". -->
        <!-- Do not include other schemes, as this will prevent verification. -->
        <data android:scheme="http" />
        <data android:scheme="https" />

        <!-- Include one or more domains that should be verified. -->
        <data android:host="www.example.com" />
        <data android:host="*.example.com" />
    </intent-filter>
</activity>

코드에 관한 핵심 사항

  • AutoVerify: android:autoVerify="true 속성은 앱 링크에 필요합니다. 앱과 <data> 태그에 지정된 스키마 및 도메인 간의 연결을 확인하도록 시스템에 신호를 보냅니다. 확인 가능한 모든 인텐트 필터에 autoVerify="true을 추가하는 것이 좋습니다.
  • 데이터 요소: 각 앱 링크 인텐트 필터에는 확인 가능한 웹사이트 도메인과 일치하는 스키마와 호스트 형식을 지정하는 하나 이상의 <data> 요소가 포함되어야 합니다.
  • 스키마: 인텐트 필터에는 http 및 https 스키마 모두에 대한 <data> 요소가 포함되어야 합니다.

  • 호스트: 하나 이상의 호스트와 일치하도록 <data> 요소를 추가할 수 있습니다. 와일드 카드 (*)를 사용하여 여러 하위 도메인 (예: *.example.com)을 일치시킵니다. 시스템은 웹사이트의 assetlinks.json 파일에 대해 각 호스트를 확인하려고 시도합니다. 경로 수준 라우팅은 assetlinks.json 파일에서 처리해야 합니다 (아래 권장사항 섹션 참고).

  • 여러 호스트: 호스트 도메인을 여러 개 선언하면 Android 12 이상의 시스템에서 각 도메인을 확인하려고 시도합니다. 호스트가 인증되면 앱이 인증된 호스트의 링크에 대한 기본 핸들러가 됩니다. Android 11 이하에서는 호스트 하나라도 확인할 수 없으면 확인이 실패합니다.

  • 여러 인텐트 필터: 고유한 URL (예: 스키마와 호스트의 특정 조합)을 선언하려는 경우 별도의 필터를 만드는 것이 중요합니다. 동일한 인텐트 필터의 여러 <data> 요소가 결합된 속성의 모든 변형을 설명하기 위해 함께 병합되기 때문입니다.

매니페스트 필터 규칙 관련 고려사항

Android 15 이상에서 동적 앱 링크와 함께 사용할 필터를 설정하는 경우 서버 측 assetlinks.json 파일에 선언된 동적 규칙이 앱 매니페스트에 정적으로 선언된 URL 규칙의 범위를 확장할 수 없다는 점을 기억해야 합니다.

따라서 다음 방법을 사용하는 것이 좋습니다.

  • 앱 매니페스트에서 스키마와 도메인만 선언하는 등 가능한 가장 광범위한 범위를 설정합니다.
  • 경로 수준 라우팅과 같은 추가 개선을 위해 서버 측 assetlinks.json 규칙을 사용합니다.

이 이상적인 구성을 사용하면 앱 매니페스트에 설정한 광범위한 범위 내에 포함된다는 것을 알고 필요에 따라 assetlinks.json 파일에 새 앱 링크 경로를 동적으로 추가할 수 있습니다.

여러 호스트에서 앱 링크 지원

시스템은 해당 인텐트 필터의 웹 도메인에서 호스팅되는 디지털 애셋 링크 파일에 대해 앱의 URL 인텐트 필터의 데이터 요소에서 지정한 호스트를 확인할 수 있어야 합니다. 인증이 실패하면 시스템은 기본적으로 표준 동작을 사용하여 인텐트를 해결합니다(앱 콘텐츠의 딥 링크 만들기의 설명 참고). 하지만 앱은 앱의 다른 인텐트 필터에 정의된 URL 패턴 중 어느 것에 대해서도 기본 핸들러로 인증될 수 있습니다.

예를 들어 다음 인텐트 필터가 사용된 앱은 assetlinks.json 파일이 https://www.example.com/.well-known/assetlinks.json에서 발견되고 https://www.example.net/.well-known/assetlinks.json에서는 발견되지 않는 경우 https://www.example.com에 대해서만 인증을 통과합니다.

<application>

  <activity android:name=”MainActivity”>
    <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="http" />
      <data android:scheme="https" />
      <data android:host="www.example.com" />
    </intent-filter>
  </activity>
  <activity android:name="SecondActivity">
    <intent-filter>
      <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" />
     <data android:host="www.example.net" />
    </intent-filter>
  </activity>

</application>

여러 하위 도메인에서 앱 링크 지원

디지털 애셋 링크 프로토콜은 인텐트 필터에 있는 하위 도메인을 별도의 고유 호스트로 취급합니다. 따라서 인텐트 필터에 서로 다른 하위 도메인을 가진 여러 호스트가 나열된 경우에는 각 도메인별로 유효한 assetlinks.json을 게시해야 합니다. 예를 들어 다음 인텐트 필터는 허용되는 인텐트 URL 호스트로 www.example.com과 mobile.example.com을 포함합니다. 따라서 유효한 assetlinks.json을 https://www.example.com/.well-known/assetlinks.json 및 https://mobile.example.com/.well-known/assetlinks.json 양쪽에 게시해야 합니다.

<application>
  <activity android:name="MainActivity">
    <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" />
      <data android:scheme="https" />
      <data android:host="www.example.com" />
      <data android:host="mobile.example.com" />
    </intent-filter>
  </activity>
</application>

또는 와일드 카드 (예: *.example.com)를 사용하여 호스트 이름을 선언하는 경우 루트 호스트 이름 (example.com)에 assetlinks.json 파일을 게시해야 합니다. 예를 들어 다음 인텐트 필터가 사용된 앱은 assetlinks.json 파일이 https://example.com/.well-known/assetlinks.json에 게시된 경우 example.com의 모든 하위 이름 (예: foo.example.com)과 관련된 인증을 통과합니다.

<application>
  <activity android:name="MainActivity">
    <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" />
      <data android:host="*.example.com" />
    </intent-filter>
  </activity>
</application>

동일한 도메인에 연결된 앱이 여러 개 있는지 확인

각각 같은 도메인과 연결된 앱을 여러 개 게시하면 각각 성공적으로 확인될 수 있습니다. 그러나 앱의 라이트 및 전체 버전과 마찬가지로 앱이 똑같은 도메인 호스트 및 경로를 확인할 수 있다면 가장 최근에 설치된 앱만 도메인의 웹 인텐트를 확인할 수 있습니다.

이러한 경우 필요한 패키지 공개 상태가 있다면 사용자 기기에서 충돌 가능성이 있는 앱을 확인합니다. 그런 다음 앱에서 queryIntentActivities 호출의 결과가 포함된 맞춤 선택기 대화상자를 표시합니다. 사용자는 대화상자에 표시되는 일치하는 앱 목록에서 선호하는 앱을 선택할 수 있습니다.