ساختن «پیوندهای پویا» با C++‎

بااستفاده از «میانای برنامه‌سازی کاربردی» Firebase Dynamic Links می‌توانید Dynamic Links کوتاه یا بلند بسازید. «میانای برنامه‌سازی کاربردی» چند ساختار پارامتر اختیاری برای ساختن پیوندها می‌گیرد. پیوندهای کوتاه را می‌توان از پیوندهای بلند تولیدشده قبلی نیز ایجاد کرد. Firebase Dynamic Links نشانی وبی مانند نشانی زیر تولید می‌کند:

https://example.page.link/WXYZ

«کیت توسعه نرم‌افزار C++» هم برای Android و هم برای 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 خود داشته باشید. برای راه‌اندازی دامنه سفارشی برای پروژه‌تان، این دستورالعمل‌ها را دنبال کنید.

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

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

قبل‌از اینکه بتوانید 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/ ایجاد می‌کند که با برنامه Android 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 می‌گیرد؛ این کار به شما امکان می‌دهد نحوه تولید پیوند را کنترل کنید. تولید پیوند کوتاه نیازمند درخواست شبکه به پشتیبان 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);

اگر برنامه شما حلقه به‌روزرسانی دارد که به‌طور منظم اجرا می‌شود (مثلاً ۳۰ یا ۶۰ بار در ثانیه)، می‌توانید نتایج را یک‌بار در هر به‌روزرسانی بررسی کنید:

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());
  }
}