ایجاد لینک های پویا با ++C

شما می‌توانید با استفاده از API Firebase Dynamic Links Dynamic Links کوتاه یا بلند ایجاد کنید. این API چندین ساختار پارامتر اختیاری برای ساخت لینک‌ها دریافت می‌کند. لینک‌های کوتاه همچنین می‌توانند از یک لینک بلند که قبلاً ایجاد شده است، ایجاد شوند. Firebase Dynamic Links URL ای مانند زیر تولید می‌کنند:

https://example.page.link/WXYZ

کیت توسعه نرم‌افزار C++ برای اندروید و iOS کار می‌کند، البته برای هر پلتفرم به تنظیمات اضافی نیاز است.

قبل از اینکه شروع کنی

قبل از اینکه بتوانید Firebase Dynamic Links استفاده کنید، باید:

• پروژه ++C خود را ثبت کنید و آن را برای استفاده از Firebase پیکربندی کنید.

  اگر پروژه ++C شما از قبل از Firebase استفاده می‌کند، پس از قبل برای Firebase ثبت و پیکربندی شده است.

• کیت توسعه نرم‌افزاری Firebase C++ را به پروژه C++ خود اضافه کنید.

توجه داشته باشید که اضافه کردن Firebase به پروژه C++ شما شامل وظایفی هم در کنسول Firebase و هم در پروژه C++ باز شما می‌شود (برای مثال، شما فایل‌های پیکربندی Firebase را از کنسول دانلود می‌کنید، سپس آنها را به پروژه C++ خود منتقل می‌کنید).

استفاده از کنسول Firebase

اگر می‌خواهید یک Dynamic Link ایجاد کنید، چه برای اهداف آزمایشی و چه برای اینکه تیم بازاریابی شما به راحتی لینکی ایجاد کند که بتوان از آن در چیزی مانند یک پست در رسانه‌های اجتماعی استفاده کرد، ساده‌ترین راه این است که به کنسول Firebase مراجعه کنید و با دنبال کردن فرم گام به گام، یکی را به صورت دستی ایجاد کنید.

دامنه‌های سفارشی

شما می‌توانید با استفاده از دامنه خودتان به جای زیر دامنه goo.gl یا page.link ، کنترل بیشتری بر روی برندسازی Dynamic Link خود داشته باشید. برای تنظیم یک دامنه سفارشی برای پروژه خود، این دستورالعمل‌ها را دنبال کنید.

استفاده از API Firebase Dynamic Links

ایجاد و مقداردهی اولیه برنامه

قبل از اینکه بتوانید Dynamic Links ایجاد کنید، باید یک شیء firebase::App ایجاد و مقداردهی اولیه کنید.

فایل هدر مربوط به firebase::App اضافه کنید:

#include "firebase/app.h"

بخش بعدی بسته به پلتفرم شما متفاوت است:

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

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

مقداردهی اولیه کتابخانه Dynamic Links

قبل از ایجاد یک Dynamic Link ، ابتدا باید کتابخانه Dynamic Links را مقداردهی اولیه کنید :

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

ایجاد یک Dynamic Link طولانی از پارامترها

برای ایجاد یک پیوند پویا، یک شیء DynamicLinkComponents ایجاد کنید، هر یک از اعضای اختیاری را برای پیکربندی اضافی تنظیم کنید و آن را به dynamic_links::GetShortLink یا dynamic_links::GetLongLink ارسال کنید.

مثال مینیمال زیر یک لینک پویای طولانی به https://www.example.com/ ایجاد می‌کند که با برنامه اندروید شما به نام com.example.android.package_name و برنامه iOS شما به نام com.example.ios باز می‌شود:

firebase::dynamic_links::IOSParameters ios_parameters("com.example.ios");

firebase::dynamic_links::AndroidParameters android_parameters(
    "com.example.android.package_name");

firebase::dynamic_links::DynamicLinkComponents components(
    "https://www.example.com/", "example.page.link");
components.android_parameters = &android_parameters;
components.ios_parameters = &ios_parameters;

firebase::dynamic_links::GeneratedDynamicLink long_link =
    firebase::dynamic_links::GetLongLink(components);

ایجاد یک Dynamic Link کوتاه

برای ایجاد یک لینک پویای کوتاه، یک لینک بلند که قبلاً ایجاد شده است را به GetShortLink ارسال کنید یا DynamicLinkComponents را به همان روش بالا بسازید.

GetShortLink به صورت اختیاری یک پارامتر پیکربندی DynamicLinkOptions اضافی با PathLength می‌گیرد؛ این به شما امکان می‌دهد نحوه تولید لینک را کنترل کنید. تولید یک لینک کوتاه نیاز به یک درخواست شبکه به backend Firebase دارد، بنابراین GetShortLink ناهمزمان است و یک Future<GeneratedLink> برمی‌گرداند.

برای مثال:

firebase::dynamic_links::DynamicLinkOptions short_link_options;
short_link_options.path_length = firebase::dynamic_links::kPathLengthShort;

firebase::Future<firebase::dynamic_links::GeneratedDynamicLink> result =
    firebase::dynamic_links::GetShortLink(components, short_link_options);

اگر برنامه شما یک حلقه به‌روزرسانی دارد که مرتباً اجرا می‌شود (مثلاً 30 یا 60 بار در ثانیه)، می‌توانید نتایج را یک بار در هر به‌روزرسانی بررسی کنید:

if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::dynamic_links::kErrorCodeSuccess) {
    firebase::dynamic_links::GeneratedDynamicLink link = *result.result();
    printf("Create short link succeeded: %s\n", link.url.c_str());
  } else {
    printf("Created short link failed with error '%s'\n",
           result.error_message());
  }
}