다음을 통해 공유


Android에서 앱 연결

이 가이드에서는 Android 6.0이 앱 연결을 지원하는 방법을 설명합니다. 앱 연결은 모바일 앱에서 웹 사이트의 URL에 응답할 수 있도록 하는 기술입니다. 앱 연결에 대한 정보, Android 6.0 애플리케이션에서 앱 연결을 구현하는 방법 및 도메인의 모바일 앱에 권한을 부여하도록 웹 사이트를 구성하는 방법을 설명합니다.

앱 연결 개요

모바일 애플리케이션은 더 이상 사일로에 살지 않습니다. 대부분의 경우 웹 사이트와 함께 비즈니스의 중요한 구성 요소입니다. 비즈니스를 수행하기 위해서는 모바일 애플리케이션을 시작하고 모바일 앱에 관련 콘텐츠를 표시하는 웹 사이트의 링크와 함께 웹 서비스 및 모바일 애플리케이션을 원활하게 연결하는 것이 좋습니다. 앱 연결(딥 링크라고도 함)은 모바일 디바이스가 URI에 응답하고 해당 URI에 대응하는 모바일 애플리케이션을 시작할 수 있도록 하는 기술 중 하나입니다.

Android는 의도 시스템을 통해 앱 연결을 처리합니다. 사용자가 모바일 브라우저에서 링크를 클릭하면 모바일 브라우저에서 Android가 등록된 애플리케이션에 위임할 의도를 디스패치합니다. 예를 들어, 요리 웹 사이트의 링크를 클릭하면 해당 웹 사이트와 연결된 모바일 앱이 열리고 사용자에게 특정 조리법이 표시됩니다. 해당 의도를 처리하기 위해 등록된 애플리케이션이 두 개 이상 있는 경우, Android는 의도를 처리할 애플리케이션을 선택하기 위해 해당 애플리케이션을 사용자에게 확인하는 명확성 대화 상자를 발생시킵니다. 예를 들면 다음과 같습니다.

Example screenshot of a disambiguation dialog

Android 6.0은 자동 연결 처리를 통해 이를 개선합니다. Android에서 애플리케이션을 URI의 기본 처리기로 자동으로 등록할 수 있습니다. 앱이 자동으로 시작되고 관련 활동으로 직접 이동합니다. Android 6.0에서 URI 클릭을 처리하는 방법은 다음 조건에 따라 달라집니다.

  1. 기존 앱이 이미 URI 와 연결되어 있습니다. 사용자가 기존 앱을 URI와 이미 연결했을 수 있습니다. 이 경우 Android는 해당 애플리케이션을 계속 사용합니다.
  2. URI와 연결된 기존 앱은 없지만 지원 앱이 설치됩니다 . 이 시나리오에서는 사용자가 기존 앱을 지정하지 않았으므로 Android는 설치된 지원 애플리케이션을 사용하여 요청을 처리합니다.
  3. 기존 앱은 URI와 연결되어 있지 않지만 많은 지원 앱이 설치됩니다 . URI를 지원하는 여러 애플리케이션이 있기 때문에 명확성 대화 상자가 표시되고 사용자가 URI를 처리할 앱을 선택해야 합니다.

사용자에게 URI를 지원하는 앱이 설치되어 있지 않은 경우 나중에 설치하면 Android가 URI와 연결된 웹 사이트와의 연결을 확인한 후 URI에 대한 기본 처리기로 해당 애플리케이션을 설정합니다.

이 가이드에서는 Android 6.0 애플리케이션을 구성하는 방법과 Android 6.0에서 앱 연결을 지원하기 위해 디지털 자산 링크 파일을 만들어 게시하는 방법을 설명합니다.

요구 사항

이 가이드를 사용하기 위해서는 Android 6.0(API 수준 23) 이상을 대상으로 하는 Xamarin.Android 6.1 및 애플리케이션이 필요합니다.

Xamarin 구성 요소 저장소의 Rivets NuGet 패키지를 사용하면 이전 버전의 Android에서 앱 연결을 사용할 수 있습니다. Rivets 패키지는 Android 6.0의 앱 연결과 호환되지 않으며 Android 6.0 앱 연결을 지원하지 않습니다.

Android 6.0에서 앱 연결 구성

Android 6.0에서 앱 연결을 설정하려면 다음 두 가지 주요 단계를 수행해야 합니다.

  1. 웹 사이트 URI 에 대한 하나 이상의 의도 필터를 추가하면 의도 필터가 Android에서 모바일 브라우저에서 URL 클릭을 처리하는 방법을 안내합니다.
  2. 웹 사이트에 디지털 자산 링크 JSON 파일 게시 – 웹 사이트에 업로드되고 Android에서 모바일 앱과 웹 사이트의 do기본 간의 관계를 확인하는 데 사용되는 파일입니다. 이 파일이 없으면 Android에서 앱을 URI의 기본 처리기로 설치할 수 없으므로 사용자가 수동으로 설치해야 합니다.

의도 필터 구성

웹 사이트의 URI(또는 사용 가능한 URI 세트)를 Android 애플리케이션의 작업에 매핑하는 의도 필터를 구성해야 합니다. Xamarin.Android에서 이 관계는 IntentFilterAttribute로 작업을 표시하여 설정됩니다. 의도 필터는 다음 정보를 선언해야 합니다.

  • Intent.ActionView – 정보 보기 요청에 응답하도록 의도 필터를 등록합니다.
  • Categories– 의도 필터는 웹 URI를 제대로 처리할 수 있도록 Intent.CategoryBrowsable Intent.CategoryDefault를 모두 등록해야 합니다.
  • DataScheme – 의도 필터는 선언 http 및/또는 https. 유일하게 유효한 두 가지 스키마입니다.
  • DataHost– URI가 시작되는 기본.
  • DataPathPrefix – 웹 사이트의 리소스에 대한 선택적 경로입니다.
  • AutoVerify – 이 특성은 autoVerify Android에 애플리케이션과 웹 사이트 간의 관계를 확인하도록 지시합니다. 여기에 대해서는 아래에서 자세히 설명합니다.

다음 예제에서는 IntentFilterAttribute를 사용하여 https://www.recipe-app.com/recipeshttp://www.recipe-app.com/recipes의 링크를 처리하는 방법을 보여 줍니다.

[IntentFilter(new [] { Intent.ActionView },
              Categories = new[] { Intent.CategoryBrowsable, Intent.CategoryDefault },
              DataScheme = "http",
              DataHost = "recipe-app.com",
              DataPathPrefix = "/recipe",
              AutoVerify=true)]
public class RecipeActivity : Activity
{
    // Code for the activity omitted
}

Android는 애플리케이션을 URI에 대한 기본 처리기로 등록하기 전에 웹 사이트의 디지털 자산 파일에 대해 의도 필터로 식별된 모든 호스트를 확인합니다. Android에서 앱을 기본 처리기로 설정하려면 먼저 모든 의도 필터가 확인 과정을 통과해야 합니다.

Android 6.0 앱 연결을 사용하려면 애플리케이션을 URI에 대한 기본 처리기로 설정하기 전에 Android에서 애플리케이션과 웹 사이트 간 연결을 확인해야 합니다. 이 확인 과정은 애플리케이션을 처음 설치할 때 수행됩니다. 디지털 자산 링크 파일은 해당 웹 도메인에서 호스트되는 JSON 파일입니다.

참고 항목

특성은 android:autoVerify 의도 필터에 의해 설정되어야 합니다. 그렇지 않으면 Android에서 확인을 수행하지 않습니다.

이 파일은 https://domain/.well-known/assetlinks.json 위치에 도메인의 웹 마스터가 배치합니다.

디지털 자산 파일에는 Android에서 연결을 확인하는 데 필요한 메타데이터가 포함되어 있습니다. assetlinks.json 파일에는 다음과 같은 키-값 쌍이 있습니다.

  • namespace – Android 애플리케이션의 네임스페이스입니다.
  • package_name – Android 애플리케이션의 패키지 이름(애플리케이션 매니페스트에 선언됨)입니다.
  • sha256_cert_fingerprints – 서명된 애플리케이션의 SHA256 지문입니다. 애플리케이션의 SHA256 지문을 가져오는 방법에 대한 자세한 내용은 키 저장소 서명 찾기 가이드를 참조하세요.

다음 코드 조각은 단일 애플리케이션이 있는 assetlinks.json의 예입니다.

[
   {
      "relation": [
         "delegate_permission/common.handle_all_urls"
      ],
      "target": {
         "namespace": "android_app",
         "package_name": "com.example",
         "sha256_cert_fingerprints": [
            "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"
         ]
      }
   }
]

애플리케이션의 여러 버전 또는 빌드를 지원하는 SHA256 지문을 둘 이상 등록할 수 있습니다. 다음 assetlinks.json 파일은 여러 애플리케이션을 등록하는 예제입니다.

[
   {
      "relation": [
         "delegate_permission/common.handle_all_urls"
      ],
      "target": {
         "namespace": "android_app",
         "package_name": "example.com.puppies.app",
         "sha256_cert_fingerprints": [
            "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"
         ]
      }
   },
   {
      "relation": [
         "delegate_permission/common.handle_all_urls"
      ],
      "target": {
         "namespace": "android_app",
         "package_name": "example.com.monkeys.app",
         "sha256_cert_fingerprints": [
            "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"
         ]
      }
   }
]

Google Digital Asset Links 웹 사이트에서는 디지털 자산 파일을 만들고 테스트하는 데 도움이 될 수 있는 온라인 도구를 제공합니다.

앱 연결을 구현한 후 다양한 부분을 테스트하여 예상 대로 작동하는지 확인해야 합니다.

다음 예제와 같이 Google의 디지털 자산 링크 API를 사용하여 디지털 자산 파일이 올바르게 형식 지정되고 호스트되는지 확인할 수 있습니다.

https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=
  https://<WEB SITE ADDRESS>:&relation=delegate_permission/common.handle_all_urls

의도 필터가 제대로 구성되어 있고 앱이 URI에 대한 기본 처리기로 설정되었는지 확인하려면 두 가지 테스트를 수행할 수 있습니다.

  1. 디지털 자산 파일이 위에서 설명한 대로 제대로 호스트됩니다. 첫 번째 테스트는 Android가 모바일 애플리케이션으로 리디렉션하는 의도를 디스패치합니다. Android 애플리케이션이 시작되고 URL에 대해 등록된 작업을 표시합니다. 명령 프롬프트에서 다음을 입력합니다.

    $ adb shell am start -a android.intent.action.VIEW \
        -c android.intent.category.BROWSABLE \
        -d "http://<domain1>/recipe/scalloped-potato"
    
  2. 지정된 디바이스에 설치된 애플리케이션에 대한 정책을 처리하는 기존 링크를 표시합니다. 다음 명령은 다음 정보를 사용하여 디바이스의 각 사용자에 대한 링크 정책 목록을 덤프합니다. 명령 프롬프트에서 다음 명령을 입력합니다.

    $ adb shell dumpsys package domain-preferred-apps
    
    • Package – 애플리케이션의 패키지 이름입니다.
    • Domain– 웹 링크가 애플리케이션에서 처리되는 do기본s(공백으로 구분)입니다.
    • Status– 앱의 현재 링크 처리 상태. always 값은 애플리케이션이 android:autoVerify=true를 선언하고 시스템 확인을 통과했음을 의미합니다. 그 다음에는 Android 시스템의 기본 설정 레코드를 나타내는 16진수가 나옵니다.

    예시:

    $ adb shell dumpsys package domain-preferred-apps
    
    App linkages for user 0:
    Package: com.android.vending
    Domains: play.google.com market.android.com
    Status: always : 200000002
    

요약

이 가이드에서는 Android 6.0에서 앱 연결이 작동하는 방식에 대해 설명했습니다. 그런 다음, 앱 연결을 지원하고 응답하도록 Android 6.0 애플리케이션을 구성하는 방법을 살펴보았습니다. Android 애플리케이션에서 앱 연결을 테스트하는 방법에 대해서도 설명합니다.