구문 목록은 잘 알려진 위치의 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>
추가 정보
사양 문서에 명세서 목록 형식과 기본 개념에 대한 자세한 설명이 나와 있습니다.