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

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

https://example.page.link/WXYZ

C++ SDK هم برای Android و هم برای iOS کار می‌کند و برای هر platform.d به تنظیمات اضافی نیاز است

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

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

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

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

• Firebase C++ SDK را به پروژه C++ خود اضافه کنید.

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

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

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

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

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

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

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

قبل از اینکه بتوانید پیوندهای پویا ایجاد کنید، باید یک شی 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 را مقداردهی اولیه کنید :

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

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

برای ایجاد یک پیوند پویا، یک شی 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);

ایجاد یک لینک پویا کوتاه

برای ایجاد یک پیوند پویا کوتاه، یک پیوند طولانی ایجاد شده قبلی را به 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);

اگر برنامه شما دارای یک حلقه به روز رسانی است که به طور منظم اجرا می شود (مثلاً 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());
  }
}