Để hỗ trợ liên kết sâu trên iOS, bạn cần cung cấp tệp apple-app-site-association (AASA) trên trang web của mình. Tệp AASA là tệp JSON chứa thông tin về lược đồ URL được ứng dụng của bạn hỗ trợ. Khi người dùng nhấp vào liên kết khớp với một trong các lược đồ URL trong tệp AASA, ứng dụng sẽ mở thay vì trình duyệt.

Tại sao nó quan trọng ?

Apple muốn đảm bảo rằng liên kết bạn sử dụng để mở ứng dụng của mình thực sự là liên kết do bạn sở hữu và bạn không cố mở ứng dụng của mình bằng liên kết từ các ứng dụng khác, chẳng hạn như liên kết Facebook hoặc Instagram

Làm thế nào các tập tin sẽ trông như thế nào?

tệp này sẽ chứa các cài đặt có liên quan đến ứng dụng của bạn và cấu trúc của tệp sẽ giống như thế này

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "YourAppID",
        "paths": ["*"]
      }
    ]
  }
}

appID : Được tạo bằng cách kết hợp ID nhóm* của ứng dụng của bạn (hoặc Tiền tố ứng dụng Apple) và Mã định danh gói**. Trong ví dụ trên, 3XXXXX9M83 là ID nhóm và io.branch-labs.Branchster là ID nhóm.

đường dẫn: Mảng chuỗi xác định đường dẫn nào được bao gồm hoặc loại trừ khỏi liên kết.

• Không biết ID nhóm của bạn là gì? Truy cập https://developer.apple.com/account và truy xuất nó từ phần Tư cách thành viên.

Nếu bạn đang sử dụng FastAPI để phục vụ trang web của mình, bạn có thể dễ dàng phục vụ tệp AASA bằng cách tạo một điểm cuối mới trong API của mình.

from fastapi import FastAPI, File, UploadFile
app = FastAPI()

@app.get("/apple-app-site-association")
async def apple_app_site_association():
    return File("path/to/apple-app-site-association.json", filename="apple-app-site-association.json")

Bạn cũng có thể cung cấp tệp AASA bằng cách tải nó lên máy chủ của mình.

@app.post("/apple-app-site-association")
async def apple_app_site_association(file: UploadFile):
    return File(file.file, filename="apple-app-site-association.json")

Đừng phạm sai lầm ngu ngốc

Điều quan trọng cần lưu ý là tệp AASA phải được cung cấp qua kết nối an toàn (HTTPS) và vị trí của nó phải có thể truy cập được đối với tất cả các máy khách. Điều quan trọng nữa là đảm bảo rằng tệp có thể truy cập được với loại nội dung chính xác.

Đang kiểm tra tệp của bạn

Bạn có thể xác thực rằng tệp bạn đã tải lên được phân phối chính xác bằng cách sử dụng trình xác thực liên kết của Apple

chỉ cần đặt url đầy đủ của bạn vào thư mục gốc của api nhanh

không có — /apple-app-site-association

liên kết sẽ giống như vậy -

mydomain.com

Nếu bạn đã làm đúng mọi thứ, bạn sẽ thấy như sau:

Nhớ!

phục vụ tệp apple-app-site-association bằng FastAPI thật dễ dàng. Bạn chỉ cần tạo một điểm cuối mới trong API của mình để phân phối tệp và đảm bảo rằng nó được phân phát qua kết nối an toàn và có thể truy cập được đối với tất cả khách hàng. Bạn có thể cung cấp tệp bằng cách cung cấp đường dẫn của tệp hoặc tải tệp lên máy chủ của mình.

Chúc Shilo may mắn!