Trang này được dịch bởi Cloud Translation API.

Cú pháp danh sách câu lệnh

Danh sách câu lệnh là một tệp hoặc đoạn mã được mã hoá bằng JSON ở một vị trí nổi tiếng.

Vị trí của danh sách bảng sao kê

Hãy xem phần Tạo danh sách câu lệnh để tìm hiểu vị trí lưu trữ danh sách này.

Cú pháp

Danh sách câu lệnh hoặc đoạn mã bao gồm một mảng JSON gồm một hoặc nhiều câu lệnh trang web hoặc ứng dụng dưới dạng đối tượng JSON. Các câu lệnh này có thể theo thứ tự bất kỳ. Dưới đây là cú pháp chung:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]

quan hệ

Một mảng gồm một hoặc nhiều chuỗi mô tả mối quan hệ đang được khai báo về mục tiêu. Hãy xem danh sách các chuỗi quan hệ được xác định. Ví dụ: delegate_permission/common.handle_all_urls

mục tiêu

Thành phần mục tiêu áp dụng câu lệnh này. Các loại mục tiêu có sẵn:

Mục tiêu của trang web
```
"target": {
  "namespace": "web",
  "site": "site_root_url"
}
```
vùng chứa tên

Phải là web đối với các trang web.

trang web

URI của trang web là mục tiêu của câu lệnh, ở định dạng http[s]://<hostname>[:<port>], trong đó <hostname> đủ điều kiện và phải bỏ qua <port> khi sử dụng cổng 80 cho HTTP hoặc cổng 443 cho HTTPS. Mục tiêu trang web chỉ có thể là một miền gốc; bạn không thể giới hạn một thư mục con cụ thể; tất cả các thư mục trong thư mục gốc này sẽ khớp. Các miền con không được coi là khớp: tức là nếu tệp báo cáo được lưu trữ trên www.example.com thì www.puppies.example.com không được coi là một kết quả trùng khớp. Để biết các quy tắc và ví dụ về so khớp mục tiêu trên trang web, hãy xem tài liệu về mục tiêu. Ví dụ: http://www.example.com
Mục tiêu ứng dụng Android
```
"target": {
  "namespace": "android_app",
  "package_name": "fully_qualified_package_name",
  "sha256_cert_fingerprints": ["cert_fingerprint"]
}
```
vùng chứa tên

Phải là android_app đối với ứng dụng Android.

package_name (tên gói)

Tên gói đủ điều kiện của ứng dụng sẽ áp dụng câu lệnh này. Ví dụ: com.google.android.apps.maps

sha256_cert_fingerprints
Vân tay SHA265 viết hoa của chứng chỉ cho ứng dụng áp dụng câu lệnh này. Bạn có thể tính toán việc này bằng cách sử dụng openssl hoặc Java keytool như minh họa bên dưới:
- openssl x509 -in $CERTFILE -noout -fingerprint -sha256
- keytool -printcert -file $CERTFILE | grep SHA256
Ví dụ: ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"].
Nếu bạn đang sử dụng Tính năng ký ứng dụng của Play cho ứng dụng, thì vân tay số của chứng chỉ được tạo bằng cách chạy keytool hoặc openssl trên thiết bị thường không khớp với vân tay số trên thiết bị của người dùng. Bạn có thể xác minh xem mình có đang sử dụng Tính năng ký ứng dụng của Play cho ứng dụng trong tài khoản nhà phát triển trên Play Console hay không trong Release > Setup > App Integrity; nếu có thì bạn cũng sẽ tìm thấy đoạn mã JSON chính xác của Đường liên kết đến tài sản kỹ thuật số cho ứng dụng của mình trên cùng một trang.

Danh sách câu lệnh mẫu

Dưới đây là danh sách mẫu câu lệnh trang web chứa câu lệnh về cả trang web và ứng dụng: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Mở rộng quy mô lên hàng chục câu lệnh trở lên

Trong một số trường hợp, một giao diện người dùng chính có thể muốn đưa ra nhiều câu lệnh về các mục tiêu khác nhau hoặc có thể cần đưa ra các câu lệnh từ các mục tiêu chính khác nhau cho cùng một tập hợp mục tiêu. Ví dụ: một trang web có thể có sẵn trên nhiều Miền cấp cao nhất theo quốc gia và tất cả các miền đó có thể muốn đưa ra tuyên bố về cùng một ứng dụng dành cho thiết bị di động.

Trong những trường hợp này, bao gồm các câu lệnh có thể hữu ích. Bằng cách sử dụng cơ chế này, bạn có thể thiết lập con trỏ từ nhiều thành phần chính đến một vị trí trung tâm, giúp xác định các câu lệnh cho tất cả các thành phần chính.

Ví dụ: bạn có thể quyết định vị trí trung tâm sẽ là `https://example.com/included Statements.json`. Tệp này có thể được định cấu hình để chứa cùng nội dung như trong các ví dụ ở trên.

Để thiết lập con trỏ từ trang web đến tệp bao gồm, hãy thay đổi `https://example.com/.well-known/assetlinks.json` thành:

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

Để thiết lập con trỏ từ ứng dụng Android sang tệp bao gồm, hãy thay đổi `res/values/strings.xml` thành:

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

Thông tin khác

Có giải thích chi tiết hơn về định dạng danh sách câu lệnh và các khái niệm cơ bản trong tài liệu thông số kỹ thuật của chúng tôi.