문 목록 구문

구문 목록은 잘 알려진 위치의 JSON 인코딩 파일 또는 스니펫입니다.

명세서 목록의 위치

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

문법

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

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

예시 문 목록

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

수십 개의 명세서로 확장

주 구성원이 다른 대상에 대해 서로 다른 여러 문을 작성해야 할 수도 있고, 동일한 대상 집합에 다른 주 구성원의 문을 실행해야 할 수도 있습니다. 예를 들어 웹사이트는 여러 국가별 최상위 도메인에서 사용할 수 있으며 모든 도메인에서 동일한 모바일 앱에 관한 설명을 제공하고자 할 수 있습니다.

이러한 경우 include 구문을 사용하면 도움이 됩니다. 이 메커니즘을 사용하면 여러 주 구성원의 포인터를 하나의 중앙 위치에 설정하여 모든 주 구성원에 대한 문을 정의할 수 있습니다.

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

웹사이트에서 포함 파일로 연결되는 포인터를 설정하려면 다음과 같이 'https://example.com/.well-known/assetlinks.json'을 변경하세요.

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

Android 앱에서 포함 파일로 연결되는 포인터를 설정하려면 다음과 같이 'res/values/strings.xml'을 변경하세요.

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

추가 정보

사양 문서에 명세서 목록 형식과 기본 개념에 대한 자세한 설명이 나와 있습니다.