As instruções são hospedadas em uma lista de instruções codificada em JSON em um local conhecido em um principal, conforme definido pela especificação Asset Links. Uma lista de instruções tem uma ou mais instruções, e um principal só pode ter uma lista de instruções.
Sintaxe da lista de instruções
Consulte a sintaxe da lista de instruções.
Local da lista de extratos
A lista de instruções está hospedada em um local conhecido que depende do tipo de principal (o site ou app que faz as declarações).
Listas de instruções do site
Em um site, uma lista de instruções é um arquivo de texto localizado no seguinte endereço:
scheme://domain/.well-known/assetlinks.json
Observe o ponto no nome da pasta .well-known.
Qualquer resposta do servidor além de HTTP 200 é tratada como um erro e resulta em
uma lista de instruções vazia. Para HTTPS, qualquer conexão sem uma cadeia de certificados que
possa ser verificada com a lista raiz confiável também resultará em uma lista de instruções vazia.
Exemplo
Veja um exemplo de lista de instruções em um site: http://example.digitalassetlinks.org/.well-known/assetlinks.json
Listas de instruções do app Android
Em um app Android, a lista de instruções é um snippet JSON com a mesma sintaxe de um arquivo de instrução de site, mas incorporada no arquivo strings.xml e referenciado no manifesto, conforme mostrado a seguir.
No AndroidManifest.xml:
<manifest>
<application>
...
<meta-data android:name="asset_statements" android:resource="@string/asset_statements" />
...
</application>
</manifest>
Em res/values/strings.xml:
<resources>
...
<string name="asset_statements">
... statement list ...
</string>
</resources>
Exemplo
Veja um exemplo de snippet res/values/strings.xml para um app Android compatível com o compartilhamento de local (um recurso para Android não compatível no momento):
<resources>
...
<string name="asset_statements">
[{
\"relation\": [\"delegate_permission/common.share_location\"],
\"target\": {
\"namespace\": \"web\",
\"site\": \"https://example.com\"
}
}]
</string>
</resources>
Correspondência de uma meta
Toda instrução é sobre um destino. Ao consumir uma instrução, você precisa corresponder o destino de uma declaração a alguma entidade real. Se o destino da instrução corresponder à entidade, a instrução será aplicada. Estas são as regras para determinar se um destino corresponde a uma determinada entidade:
Segmentações do site
Em um site, o esquema, o host e a porta precisam ser exatamente iguais. As portas padrão para HTTP e HTTPS (80 e 443, respectivamente) são assumidas implicitamente. Se o destino de uma instrução descreve http://www.example.com:80, o site http://www.example.com é considerado uma correspondência.
Exemplo
Considerando a instrução a seguir
"target": {
"namespace": "web",
"site": "https://www.google.com"
}
Os seguintes URIs IRÃO corresponder:
- https://www.google.com/
- https://www.google.com:443/
- https://www.google.com/foo
- https://www.google.com/foo?bar
- https://www.google.com/foo#bar
- https://user@password:www.google.com/
Os URLs a seguir NÃO vão corresponder:
- http://www.google.com/ (esquema incorreto)
- https://google.com/ (o nome do host não corresponde)
- https://www.google.com:444/ (A porta não corresponde)
Destinos de apps
Para um app, o hash do certificado e o nome do pacote do destino precisam corresponder exatamente ao aplicativo.