Khắc phục sự cố về đường liên kết đến ứng dụng

Hướng dẫn này mô tả các vấn đề thường gặp và cách khắc phục. Bạn cũng có thể sử dụng các công cụ khắc phục sự cố trong trang Đường liên kết sâu của Play Console hoặc Trợ lý về đường liên kết trong ứng dụng của Android Studio. Để biết thêm thông tin, hãy xem bài viết Công cụ cho nhà phát triển Đường liên kết trong ứng dụng.

  • Vấn đề: Bạn nhấp vào một đường liên kết lẽ ra phải mở ứng dụng của bạn, nhưng đường liên kết đó lại mở trong một trình duyệt web hoặc cho thấy hộp thoại phân định.
  • Giải pháp:
    • Kiểm tra assetlinks.json: Đảm bảo tệp này là tệp JSON hợp lệ, có thể truy cập tại https://<your-domain>/.well-known/assetlinks.json và được phân phát qua HTTPS mà không có lệnh chuyển hướng. Sử dụng trình xác thực trực tuyến.
    • Xác minh vân tay số SHA-256: Kiểm tra kỹ để đảm bảo sha256_cert_fingerprints trong assetlinks.json hoàn toàn khớp với vân tay số của khoá ký cho bản phát hành ứng dụng (sử dụng vân tay số trên Play Console nếu bạn dùng tính năng Ký ứng dụng của Play). Chữ ký phải là chữ in hoa.
    • Xác minh autoVerify: Đảm bảo rằng <intent-filter> trong AndroidManifest.xml có android:autoVerify="true".
    • Kiểm tra lệnh chuyển hướng phía máy chủ: Lệnh chuyển hướng từ http đến https hoặc từ một miền không có www đến www có thể khiến quá trình xác minh không thành công.
    • Buộc xác minh lại: Chạy các lệnh ADB trong hướng dẫn Kiểm thử Đường liên kết trong ứng dụng để nhận được kết quả xác minh mới.

Các quy tắc linh động trên Android 15 trở lên không cập nhật

  • Vấn đề: Bạn đã cập nhật các quy tắc trong tệp assetlinks.json, nhưng ứng dụng không xử lý các đường liên kết mới.
  • Giải pháp:
    • Buộc xác minh lại: Cách đáng tin cậy nhất để kiểm thử các thay đổi là buộc tìm nạp lại bằng adb shell pm verify-app-links --re-verify. <your-package-name>.
    • Kiểm tra lỗi chính tả: Xem xét kỹ các mẫu so khớp trong quy tắc để tìm lỗi cú pháp.
    • Kiểm tra các quy tắc bộ lọc tệp kê khai: xem xét các quy tắc bộ lọc ý định trong tệp kê khai ứng dụng để đảm bảo rằng đường dẫn liên kết không bị lọc. Nếu đường liên kết đang bị lọc, hãy giảm bớt hạn chế đối với bộ lọc ý định trong tệp kê khai ứng dụng.

Khắc phục các lỗi thường gặp khi triển khai

Nếu bạn không xác minh được Đường liên kết đến ứng dụng Android, hãy kiểm tra các lỗi thường gặp sau đây. Phần này sử dụng example.com làm tên miền giữ chỗ; khi thực hiện các bước kiểm tra này, hãy thay thế example.com bằng tên miền thực tế của máy chủ.

Thiết lập bộ lọc ý định không chính xác
Kiểm tra xem bạn có đưa một URL mà ứng dụng của bạn không sở hữu vào phần tử <intent-filter> hay không.
Cấu hình máy chủ không chính xác

Kiểm tra cấu hình JSON của máy chủ và đảm bảo giá trị SHA chính xác.

Ngoài ra, hãy kiểm tra để đảm bảo rằng example.com. (có dấu chấm ở cuối) phân phát cùng nội dung với example.com.

Lệnh chuyển hướng phía máy chủ

Hệ thống sẽ không xác minh bất kỳ Đường liên kết trong ứng dụng Android nào cho ứng dụng của bạn nếu bạn thiết lập một lệnh chuyển hướng như sau:

  • http://example.com đến https://example.com
  • example.com đến www.example.com

Hành vi này giúp bảo vệ tính bảo mật của ứng dụng.

Độ ổn định của máy chủ

Kiểm tra xem ứng dụng khách có thể kết nối với máy chủ của bạn hay không.

Đường liên kết không xác minh được

Để thử nghiệm, bạn có thể cố ý thêm các đường liên kết không xác minh được. Xin lưu ý rằng trên Android 11 trở xuống, những đường liên kết này khiến hệ thống không xác minh tất cả Đường liên kết đến ứng dụng Android cho ứng dụng của bạn.

Chữ ký không chính xác trong tệp assetlinks.json

Xác minh rằng chữ ký của bạn là chính xác và khớp với chữ ký dùng để ký ứng dụng. Một số lỗi thường gặp:

  • Ký ứng dụng bằng chứng chỉ gỡ lỗi và chỉ có chữ ký phát hành trong assetlinks.json.
  • Có chữ ký viết thường trong assetlinks.json. Chữ ký phải viết hoa.
  • Nếu bạn đang sử dụng Tính năng ký ứng dụng của Play, hãy đảm bảo rằng bạn đang sử dụng chữ ký mà Google dùng để ký từng bản phát hành của bạn. Bạn có thể xác minh những thông tin chi tiết này, bao gồm cả một đoạn mã JSON hoàn chỉnh, bằng cách làm theo hướng dẫn về khai báo mối liên kết với trang web.