تلقي الروابط الديناميكية مع C++

لتلقّي Firebase Dynamic Links الذي أنشأته، يجب تضمين حزمة تطوير البرامج (SDK) لـ Dynamic Links في تطبيقك وإنشاء عنصر firebase::dynamic_links::Listener ينفّذ الدالة الافتراضية OnDynamicLinkReceived.

تعمل حزمة تطوير البرامج (SDK) للغة C++‎ مع كل من Android وiOS، مع بعض الإعدادات الإضافية المطلوبة لكل نظام أساسي.

قبل البدء

قبل أن تتمكّن من استخدام Firebase Dynamic Links، عليك تنفيذ ما يلي:

  • سجِّل مشروع C++‎ الخاص بك وأعدَّه لاستخدام Firebase.

    إذا كان مشروعك المكتوب بلغة C++‎ يستخدم Firebase، يعني ذلك أنّه سبق تسجيله وإعداده لاستخدام Firebase.

  • أضِف حزمة تطوير البرامج (SDK) الخاصة بـ Firebase C++ إلى مشروعك بلغة C++‎.

يُرجى العِلم أنّ إضافة Firebase إلى مشروع C++‎ تتضمّن مهامًا في كلّ من وحدة تحكّم Firebase ومشروع C++‎ المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase من وحدة التحكّم، ثم نقلها إلى مشروع C++‎).

إضافة مخطّطات عناوين URL مخصّصة (لنظام التشغيل iOS فقط)

تستخدم مكتبة عميل Firebase Dynamic Links C++‎ مخطّطات عناوين URL مخصّصة على نظام التشغيل iOS لمعالجة الروابط. يجب إضافة مخطّطات عناوين URL مخصّصة إلى تطبيقك لإتاحة تلقّي Dynamic Links.

  1. لفتح إعدادات مشروعك، انقر مرّتين على اسم المشروع في العرض التدرّجي للحساب على اليمين.

  2. اختَر تطبيقك من قسم TARGETS (الأهداف)، ثم اختَر علامة التبويب Info (المعلومات)، ثم وسِّع قسم URL Types (أنواع عناوين URL).

  3. انقر على الزر +، ثم أضِف مخطّط URL لمعرّف العميل المعكوس. للعثور على هذه القيمة:

    1. افتح ملف الإعداد GoogleService-Info.plist، ثم ابحث عن المفتاح REVERSED_CLIENT_ID.

    2. انسخ قيمة هذا المفتاح، ثم الصقها في مربّع مخطّطات عناوين URL في صفحة الإعدادات.

    3. اترك الحقول الأخرى فارغة.

  4. انقر على الزر +، ثم أضِف مخطّط URL ثانيًا. هذا هو نفسه رقم تعريف حزمة تطبيقك.

    على سبيل المثال، إذا كان معرّف الحزمة هو com.example.ios، اكتب هذه القيمة في مربّع مخطّطات عناوين URL.

    يمكنك العثور على معرّف حزمة تطبيقك في علامة التبويب عام ضمن إعدادات المشروع (الهوية > معرّف الحزمة).

جارٍ تلقّي Dynamic Link

إنشاء التطبيق وإعداده

قبل أن تتمكّن من التحقّق من تلقّي Dynamic Links، عليك إنشاء عنصر firebase::App وإعداده.

أدرِج ملف العنوان لـ firebase::App:

#include "firebase/app.h"

يختلف الجزء التالي حسب النظام الأساسي:

Android

أنشئ firebase::App، مع تمرير بيئة JNI ومرجع jobject إلى نشاط Java كوسيطات:

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

iOS

أنشئ firebase::App:

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

تنفيذ Listener للتحقّق من Dynamic Links

للتحقّق من تلقّي Dynamic Link، يمكنك تنفيذ الفئة firebase::dynamic_links::Listener واستخدامها.

يُرجى تضمين ملف العنوان لتلقّي Dynamic Links: 

#include "firebase/dynamic_links.h"

ابدأ مكتبة Dynamic Links: 

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

أنشِئ عنصرًا ينفّذ firebase::dynamic_links::Listener، وأضِفه إلى مكتبة Dynamic Links باستخدام SetListener()، أو مرِّره كوسيطة ثانية إلى Initialize.

لتلقّي Dynamic Links، يجب أن تنفّذ فئة Listener الدالة الافتراضية OnDynamicLinkReceived. من خلال تجاوز الطريقة، يمكنك تلقّي رابط عميق، إذا تم تلقّي رابط.