문 목록 구문

명령문 목록은 잘 알려진 위치에 있는 JSON으로 인코딩된 파일 또는 스니펫입니다.

명세서 목록의 위치

이 목록이 저장되어야 하는 위치를 알아보려면 명령문 목록 만들기를 참고하세요.

문법

명령문 목록 또는 스니펫은 JSON 객체로 하나 이상의 웹사이트 또는 앱 문의 JSON 배열로 구성됩니다. 이러한 문은 순서와 관계없이 사용할 수 있습니다. 일반적인 구문은 다음과 같습니다.

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]
relation
타겟에 관해 선언되는 관계를 설명하는 하나 이상의 문자열 배열. 정의된 관계 문자열 목록을 참고하세요. 예: delegate_permission/common.handle_all_urls
대상
이 문장이 적용되는 타겟 애셋입니다. 사용 가능한 대상 유형은 다음과 같습니다.

문 목록 예

다음은 웹사이트와 앱에 대한 진술이 포함된 웹사이트 명세서 목록의 예입니다. http://example.digitalassetlinks.org/.well-known/assetlinks.json

수십 개 이상의 문으로 확장

경우에 따라 주 구성원이 서로 다른 대상에 대해 여러 가지 다른 문을 만들고자 하거나 다른 주 구성원의 문을 동일한 대상 집합으로 발행해야 할 수도 있습니다. 예를 들어 한 웹사이트가 국가별 여러 최상위 도메인에 있을 수 있으며 모든 웹사이트가 동일한 모바일 앱에 대해 설명하는 것이 좋습니다.

이러한 상황에서는 include 문이 도움이 될 수 있습니다. 이 메커니즘을 사용하면 다양한 주 구성원에서 하나의 중앙 위치로 포인터를 설정할 수 있습니다. 이 포인터는 모든 주 구성원의 문을 정의합니다.

예를 들어 중앙 위치를 `https://example.com/includedstatements.json`으로 지정할 수 있습니다. 이 파일은 위 예시와 동일한 콘텐츠를 포함하도록 구성할 수 있습니다.

웹사이트에서 include 파일로 포인터를 설정하려면 `https://example.com/.well-known/assetlinks.json` 을 다음으로 변경합니다.

[{
  "include": "https://example.com/includedstatements.json"
}]

Android 앱에서 include 파일로 포인터를 설정하려면 `res/values/strings.xml` 을 다음과 같이 변경합니다.

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

추가 정보

사양 문서에서 명세서 목록 형식과 기본 개념에 관한 자세한 설명을 확인할 수 있습니다.