Tạo liên kết động trong ứng dụng Flutter

Bạn có thể tạo Liên kết động ngắn hoặc dài bằng API Trình tạo liên kết động Firebase. API này chấp nhận Liên kết động dài hoặc đối tượng chứa tham số Liên kết động và trả về các URL như ví dụ sau:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

Thiết lập Firebase và SDK liên kết động

Trước khi có thể tạo Liên kết động trong ứng dụng Android của mình, bạn phải bao gồm SDK Firebase. Nếu ứng dụng của bạn được thiết lập để nhận Liên kết động thì bạn đã hoàn thành các bước này và có thể bỏ qua phần này.

1. Cài đặt và khởi chạy SDK Firebase cho Flutter nếu bạn chưa làm như vậy.

2. Từ thư mục gốc của dự án Flutter của bạn, hãy chạy lệnh sau để cài đặt plugin Dynamic Links:

   flutter pub add firebase_dynamic_links
   

3. Nếu bạn đang xây dựng một ứng dụng Android, hãy mở trang Cài đặt dự án của bảng điều khiển Firebase và đảm bảo bạn đã chỉ định khóa ký SHA-1 của mình. Nếu bạn sử dụng Liên kết ứng dụng, hãy chỉ định khóa SHA-256 của bạn.

4. Trong bảng điều khiển Firebase, hãy mở phần Liên kết động .

   1. Nếu bạn chưa thiết lập miền cho Liên kết động của mình, hãy nhấp vào nút Bắt đầu và làm theo lời nhắc.

      Nếu bạn đã có miền Liên kết động, hãy lưu ý đến nó. Bạn cần cung cấp miền Liên kết động khi tạo Liên kết động theo chương trình.

   2. Khuyến nghị : Từ menu "Thêm" (⋮), hãy chỉ định các mẫu URL được phép trong liên kết sâu và liên kết dự phòng của bạn. Bằng cách đó, bạn ngăn chặn các bên trái phép tạo Liên kết động chuyển hướng từ miền của bạn đến các trang web mà bạn không kiểm soát.

      Xem Cho phép các mẫu URL cụ thể .

Tạo Liên kết động từ các tham số

Để tạo Liên kết động, hãy tạo một đối tượng DynamicLinkParameters mới và chuyển nó tới buildLink() hoặc buildShortLink() .

Ví dụ tối thiểu sau đây tạo một Liên kết động dài tới https://www.example.com/ mở bằng com.example.app.android trên Android và ứng dụng com.example.app.ios trên iOS:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);

Để tạo một Liên kết động ngắn, hãy chuyển đối tượng DynamicLinkParameters tới buildShortLink() . Xây dựng liên kết ngắn yêu cầu cuộc gọi mạng. Ví dụ:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

Theo mặc định, Liên kết động ngắn được tạo với các hậu tố chỉ dài một vài ký tự. Mặc dù điều này làm cho các liên kết nhỏ gọn hơn nhưng nó cũng gây ra khả năng ai đó có thể đoán được một liên kết ngắn hợp lệ. Thông thường, sẽ không có hại gì nếu ai đó làm như vậy vì liên kết dẫn đến thông tin công khai.

Tuy nhiên, nếu các liên kết ngắn của bạn dẫn đến thông tin cụ thể của người dùng, bạn nên tạo các liên kết dài hơn với hậu tố 17 ký tự để khiến rất khó có ai đó có thể đoán được Liên kết động hợp lệ. Để làm như vậy, hãy chuyển ShortDynamicLinkType.unguessable cho phương thức buildShortLink() :

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

Tham số liên kết động

Bạn có thể sử dụng API Trình tạo liên kết động để tạo Liên kết động với bất kỳ thông số được hỗ trợ nào. Xem tài liệu tham khảo API .

Ví dụ sau đây tạo Liên kết động với một số bộ tham số phổ biến:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(
    packageName: "com.example.app.android",
    minimumVersion: 30,
  ),
  iosParameters: const IOSParameters(
    bundleId: "com.example.app.ios",
    appStoreId: "123456789",
    minimumVersion: "1.0.1",
  ),
  googleAnalyticsParameters: const GoogleAnalyticsParameters(
    source: "twitter",
    medium: "social",
    campaign: "example-promo",
  ),
  socialMetaTagParameters: SocialMetaTagParameters(
    title: "Example of a Dynamic Link",
    imageUrl: Uri.parse("https://example.com/image.png"),
  ),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

Bạn có thể đặt tham số Liên kết động bằng các phương pháp sau:

https://example.com/link
https://example.page.link