Nhận đường liên kết động bằng C++

Để nhận Firebase Dynamic Linksbạn đã tạo, bạn phải đưa SDK Dynamic Links vào ứng dụng và tạo đối tượng firebase::dynamic_links::Listener triển khai hàm ảo OnDynamicLinkReceived.

SDK C++ hoạt động cho cả Android và iOS, với một số chế độ thiết lập bổ sung cần thiết cho từng nền tảng.

Trước khi bắt đầu

Để có thể sử dụng Firebase Dynamic Links, bạn cần:

  • Đăng ký dự án C++ và định cấu hình dự án đó để sử dụng Firebase.

    Nếu dự án C++ của bạn đã sử dụng Firebase, thì dự án đó đã được đăng ký và định cấu hình cho Firebase.

  • Thêm SDK Firebase C++ vào dự án C++.

Xin lưu ý rằng việc thêm Firebase vào dự án C++ liên quan đến các tác vụ trong cả bảng điều khiển Firebase và trong dự án C++ đang mở (ví dụ: bạn tải các tệp cấu hình Firebase xuống từ bảng điều khiển, sau đó di chuyển các tệp đó vào dự án C++).

Thêm lược đồ URL tuỳ chỉnh (chỉ dành cho iOS)

Thư viện ứng dụng C++ Firebase Dynamic Links sử dụng lược đồ URL tuỳ chỉnh trên iOS để xử lý các đường liên kết. Bạn phải thêm giao thức URL tuỳ chỉnh vào ứng dụng để hỗ trợ nhận Dynamic Links.

  1. Để mở cấu hình dự án, hãy nhấp đúp vào tên dự án trong chế độ xem cây ở bên trái.

  2. Chọn ứng dụng của bạn trong mục TARGETS (MỤC TIÊU), sau đó chọn thẻ Info (Thông tin), rồi mở rộng mục URL Types (Loại URL).

  3. Nhấp vào nút +, sau đó thêm giao thức URL cho mã ứng dụng khách đảo ngược. Cách tìm giá trị này:

    1. Mở tệp cấu hình GoogleService-Info.plist, sau đó tìm khoá REVERSED_CLIENT_ID.

    2. Sao chép giá trị của khoá đó, sau đó dán vào hộp URL Schemes (Lược đồ URL) trên trang cấu hình.

    3. Để trống các trường khác.

  4. Nhấp vào nút +, sau đó thêm một giao thức URL thứ hai. Mã này giống với mã nhận dạng gói của ứng dụng.

    Ví dụ: nếu mã nhận dạng gói của bạn là com.example.ios, hãy nhập giá trị đó vào hộp URL Schemes (Lược đồ URL).

    Bạn có thể tìm thấy mã nhận dạng gói của ứng dụng trong thẻ General (Chung) của cấu hình dự án (Identity > Bundle Identifier (Giá trị nhận dạng > Mã nhận dạng gói)).

Nhận Dynamic Link

Tạo và khởi chạy ứng dụng

Trước khi có thể kiểm tra Dynamic Links đã nhận được, bạn cần tạo và khởi chạy đối tượng firebase::App.

Thêm tệp tiêu đề cho firebase::App:

#include "firebase/app.h"

Phần tiếp theo sẽ khác nhau tuỳ theo nền tảng của bạn:

Android

Tạo firebase::App, truyền môi trường JNI và tham chiếu jobject đến Hoạt động Java làm đối số:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

iOS

Tạo firebase::App:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

Triển khai Trình nghe để kiểm tra Dynamic Links

Để kiểm tra Dynamic Link đã nhận được, hãy triển khai và sử dụng lớp firebase::dynamic_links::Listener.

Thêm tệp tiêu đề để nhận Dynamic Links:

#include "firebase/dynamic_links.h"

Khởi chạy thư viện Dynamic Links:

::firebase::dynamic_links::Initialize(app, null);

Tạo một đối tượng triển khai firebase::dynamic_links::Listener và cung cấp đối tượng đó cho thư viện Dynamic Links bằng SetListener() hoặc truyền đối tượng đó dưới dạng đối số thứ hai đến Khởi chạy.

Để nhận Dynamic Links, lớp Trình nghe của bạn phải triển khai hàm ảo OnDynamicLinkReceived. Bằng cách ghi đè phương thức này, bạn có thể nhận được một đường liên kết sâu, nếu nhận được.

class Listener : public firebase::dynamic_links::Listener {
 public:
  // Called on the client when a dynamic link arrives.
  void OnDynamicLinkReceived(
      const firebase::dynamic_links::DynamicLink* dynamic_link) override {
    printf("Received link: %s", dynamic_link->url.c_str());
  }
};