이 페이지는 Cloud Translation API를 통해 번역되었습니다.

앱 링크 확인

앱의 인텐트 필터 중 하나 이상에 android:autoVerify="true"가 있는 경우 Android 6.0 (API 수준 23) 이상을 실행하는 기기에 앱을 설치하면 시스템에서 앱의 인텐트 필터에 있는 URL과 연결된 호스트를 자동으로 확인합니다. Android 12 이상에서는 확인 프로세스를 수동으로 호출하여 확인 로직을 테스트할 수도 있습니다.

자동 인증

시스템의 자동 인증에는 다음이 포함됩니다.

시스템에서 다음 중 하나가 포함된 모든 인텐트 필터를 검사합니다.
- 작업: android.intent.action.VIEW
- 카테고리: android.intent.category.BROWSABLE 및 android.intent.category.DEFAULT
- 데이터 스키마: http 또는 https
Android는 위의 인텐트 필터에 있는 각 고유 호스트 이름별로 디지털 애셋 링크에 대응하는 웹사이트를 https:///.well-known/assetlinks.json에서 쿼리합니다.

앱과 연결된 웹사이트의 목록을 확인하고 호스팅되는 JSON 파일의 유효성을 확인하고 나면 기기에 앱을 설치합니다. 비동기 인증 프로세스가 완료될 때까지 20초 이상 기다립니다. 다음 명령어를 사용하여 시스템에서 앱이 인증되었는지, 올바른 링크 처리 정책이 설정되었는지 확인합니다.

adb shell am start -a android.intent.action.VIEW \
    -c android.intent.category.BROWSABLE \
    -d "http://domain.name:optional_port"

수동 확인

Android 12부터 기기에 설치된 앱의 도메인 확인을 수동으로 호출할 수 있습니다. 앱의 Android 12 타겟팅 여부와 관계없이 이 프로세스를 실행할 수 있습니다.

인터넷 연결

도메인 확인을 실행하려면 테스트 기기가 인터넷에 연결되어 있어야 합니다.

업데이트된 도메인 확인 프로세스 지원

앱이 Android 12 이상을 타겟팅하는 경우 시스템은 업데이트된 도메인 확인 프로세스를 자동으로 사용합니다.

자동으로 사용하지 않으면 업데이트된 확인 프로세스를 수동으로 사용 설정하면 됩니다. 이렇게 하려면 터미널 창에서 다음 명령어를 실행하세요.

adb shell am compat enable 175408749 PACKAGE_NAME

기기에서 Android App Links 상태 재설정

기기에서 수동으로 도메인 확인을 호출하기 전에 테스트 기기에서 Android App Links 상태를 재설정해야 합니다. 이렇게 하려면 터미널 창에서 다음 명령어를 실행하세요.

adb shell pm set-app-links --package PACKAGE_NAME 0 all

이 명령어는 사용자가 도메인의 기본 앱을 선택하기 전 기기의 상태와 같은 상태로 기기를 설정합니다.

도메인 확인 프로세스 호출

기기에서 Android App Links 상태를 재설정하면 확인 자체를 실행할 수 있습니다. 이렇게 하려면 터미널 창에서 다음 명령어를 실행하세요.

adb shell pm verify-app-links --re-verify PACKAGE_NAME

확인 결과 검토

확인 에이전트가 요청을 완료하도록 잠시 기다린 후 확인 결과를 검토합니다. 이렇게 하려면 다음 명령어를 실행하세요.

adb shell pm get-app-links PACKAGE_NAME

이 명령어 결과는 다음과 같습니다.

com.example.pkg:
    ID: 01234567-89ab-cdef-0123-456789abcdef
    Signatures: [***]
    Domain verification state:
      example.com: verified
      sub.example.com: legacy_failure
      example.net: verified
      example.org: 1026

확인을 통과한 도메인의 도메인 확인 상태는 verified입니다. 그 외 다른 상태는 도메인 확인을 실행할 수 없음을 나타냅니다. 특히 none 상태는 확인 에이전트가 아직 확인 프로세스를 완료하지 않았을 수 있음을 나타냅니다.

다음 목록은 주어진 도메인의 도메인 확인에서 반환할 수 있는 가능한 반환 값을 보여줍니다.

none

이 도메인에는 기록된 것이 없습니다. 확인 에이전트가 도메인 확인 관련 요청을 완료하도록 몇 분 정도 더 기다린 후 다시 도메인 확인 프로세스를 호출합니다.

verified

선언하는 앱의 도메인이 성공적으로 확인되었습니다.

approved

일반적으로 셸 명령어를 실행하여 도메인이 강제 승인되었습니다.

denied

일반적으로 셸 명령어를 실행하여 도메인이 강제 거부되었습니다.

migrated

시스템이 기존 도메인 확인을 사용한 이전 프로세스의 결과를 유지했습니다.

restored

사용자가 데이터 복원을 실행한 후 도메인이 승인되었습니다. 도메인이 이전에 확인된 것으로 추정됩니다.

legacy_failure

기존 인증 도구에서 도메인이 거부되었습니다. 구체적인 실패 이유는 알 수 없습니다.

system_configured

도메인이 기기 설정에서 자동으로 승인되었습니다.

1024 이상의 오류 코드

기기의 인증 도구와 관련된 맞춤 오류 코드입니다.

네트워크 연결을 설정했는지 다시 확인한 후 도메인 확인 프로세스를 다시 호출합니다.

사용자에게 앱을 도메인과 연결하라고 요청

앱이 도메인 승인을 받는 또 다른 방법은 사용자에게 앱을 도메인과 연결하라고 요청하는 것입니다.

앱이 도메인 승인을 이미 받았는지 확인

사용자에게 메시지를 표시하기 전에 앱이 <intent-filter> 요소에서 정의한 도메인의 기본 핸들러인지 확인합니다. 다음 메서드 중 하나를 사용하여 승인 상태를 쿼리할 수 있습니다.

DomainVerificationManager API(런타임 시)
명령줄 프로그램(테스트 중에)

DomainVerificationManager

다음 코드 스니펫은 DomainVerificationManager API 사용 방법을 보여줍니다.

Kotlin

val context: Context = TODO("Your activity or fragment's Context")
val manager = context.getSystemService(DomainVerificationManager::class.java)
val userState = manager.getDomainVerificationUserState(context.packageName)

// Domains that have passed Android App Links verification.
val verifiedDomains = userState?.hostToStateMap
    ?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_VERIFIED }

// Domains that haven't passed Android App Links verification but that the user
// has associated with an app.
val selectedDomains = userState?.hostToStateMap
    ?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_SELECTED }

// All other domains.
val unapprovedDomains = userState?.hostToStateMap
    ?.filterValues { it == DomainVerificationUserState.DOMAIN_STATE_NONE }

자바

Context context = TODO("Your activity or fragment's Context");
DomainVerificationManager manager =
        context.getSystemService(DomainVerificationManager.class);
DomainVerificationUserState userState =
        manager.getDomainVerificationUserState(context.getPackageName());

Map<String, Integer> hostToStateMap = userState.getHostToStateMap();
List<String> verifiedDomains = new ArrayList<>();
List<String> selectedDomains = new ArrayList<>();
List<String> unapprovedDomains = new ArrayList<>();
for (String key : hostToStateMap.keySet()) {
    Integer stateValue = hostToStateMap.get(key);
    if (stateValue == DomainVerificationUserState.DOMAIN_STATE_VERIFIED) {
        // Domain has passed Android App Links verification.
        verifiedDomains.add(key);
    } else if (stateValue == DomainVerificationUserState.DOMAIN_STATE_SELECTED) {
        // Domain hasn't passed Android App Links verification, but the user has
        // associated it with an app.
        selectedDomains.add(key);
    } else {
        // All other domains.
        unapprovedDomains.add(key);
    }
}

명령줄 프로그램

개발하는 동안 앱을 테스트할 때 다음 명령어를 실행하여 조직에서 소유한 도메인의 확인 상태를 쿼리할 수 있습니다.

adb shell pm get-app-links --user cur PACKAGE_NAME

다음 출력 예에서 앱은 'example.org' 도메인 확인에 실패했지만 사용자 0은 시스템 설정에서 수동으로 앱을 승인했고 이 도메인에서 확인된 다른 패키지는 없습니다.

com.example.pkg:
ID: ***
Signatures: [***]
Domain verification state:
  example.com: verified
  example.net: verified
  example.org: 1026
User 0:
  Verification link handling allowed: true
  Selection state:
    Enabled:
      example.org
    Disabled:
      example.com
      example.net

셸 명령어를 사용하여 사용자가 특정 도메인과 연결된 앱을 선택하는 프로세스를 시뮬레이션할 수도 있습니다. 이러한 명령어에 관한 자세한 설명은 adb shell pm 출력에서 확인할 수 있습니다.

요청 컨텍스트 제공

도메인 승인을 요청하기 전에 사용자에게 컨텍스트를 제공합니다. 예를 들어 앱이 특정 도메인의 기본 핸들러여야 하는 이유를 사용자에게 설명하는 스플래시 화면이나 대화상자, 유사한 UI 요소를 사용자에게 표시할 수 있습니다.

요청하기

사용자가 앱에서 요청하는 작업을 파악하면 요청을 실행합니다. 다음 코드 스니펫과 같이 ACTION_APP_OPEN_BY_DEFAULT_SETTINGS 인텐트 작업과 타겟 앱의 package:com.example.pkg와 일치하는 데이터 문자열이 포함된 인텐트를 호출합니다.

Kotlin

val context: Context = TODO("Your activity or fragment's Context")
val intent = Intent(Settings.ACTION_APP_OPEN_BY_DEFAULT_SETTINGS,
    Uri.parse("package:${context.packageName}"))
context.startActivity(intent)

자바

Context context = TODO("Your activity or fragment's Context");
Intent intent = new Intent(Settings.ACTION_APP_OPEN_BY_DEFAULT_SETTINGS,
    Uri.parse("package:" + context.getPackageName()));
context.startActivity(intent);

인텐트가 호출되면 사용자에게 기본적으로 열기라는 설정 화면이 표시됩니다. 이 화면에는 그림 1과 같이 지원되는 링크 열기라는 라디오 버튼이 있습니다.

사용자가 지원되는 링크 열기를 사용 설정하면 이 앱에서 열리는 링크 섹션 아래에 일련의 체크박스가 표시됩니다. 여기에서 사용자는 앱과 연결하려는 도메인을 선택할 수 있고 그림 2와 같이 링크 추가를 선택하여 도메인을 추가할 수도 있습니다. 나중에 사용자가 추가한 도메인 내에서 링크를 선택하면 링크가 앱에서 자동으로 열립니다.

라디오 버튼을 사용 설정하면 하단의 섹션에 체크박스와 '링크 추가' 버튼이 포함됩니다.

그림 1. 사용자가 기본적으로 앱에서 열리는 링크를 선택할 수 있는 시스템 설정 화면

각 체크박스는 추가할 수 있는 도메인을 나타냅니다. 대화상자의 버튼은 '취소'와 '추가'입니다.

그림 2. 사용자가 앱과 연결할 추가 도메인을 선택할 수 있는 대화상자

앱에서 앱이 확인할 수 없는 도메인 열기

앱의 기본 기능은 처리된 도메인을 확인하는 기능 없이 링크를 타사로 여는 것일 수 있습니다. 이 경우 사용자가 웹 링크를 선택할 때 자사 앱과 타사 앱 중에서 선택할 수 없다고 사용자에게 설명합니다. 사용자는 도메인을 타사 앱과 수동으로 연결해야 합니다.

또한 사용자가 원한다면 자사 앱에서 링크를 열 수 있는 대화상자나 트램펄린 활동을 도입하여 프록시 역할을 하도록 하는 것이 좋습니다. 이러한 대화상자나 트램펄린 활동을 설정하기 전에 앱의 웹 인텐트 필터와 일치하는 자사 앱에 관한 패키지 공개 상태를 보유하도록 앱을 설정합니다.

앱 링크 확인 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

자동 인증

수동 확인

인터넷 연결

업데이트된 도메인 확인 프로세스 지원

기기에서 Android App Links 상태 재설정

도메인 확인 프로세스 호출

확인 결과 검토

사용자에게 앱을 도메인과 연결하라고 요청

앱이 도메인 승인을 이미 받았는지 확인

DomainVerificationManager

Kotlin

자바

명령줄 프로그램

요청 컨텍스트 제공

요청하기

Kotlin

자바

앱에서 앱이 확인할 수 없는 도메인 열기

앱 링크 확인