C++ দিয়ে ডায়নামিক লিঙ্ক তৈরি করুন

Firebase Dynamic Links API ব্যবহার করে আপনি ছোট বা লম্বা Dynamic Links তৈরি করতে পারেন। লিঙ্ক তৈরি করতে API-তে বেশ কিছু ঐচ্ছিক প্যারামিটার স্ট্রাকচার লাগে। পূর্বে তৈরি করা লম্বা লিঙ্ক থেকেও ছোট লিঙ্ক তৈরি করা যেতে পারে। Firebase Dynamic Links নিম্নলিখিত URL তৈরি করে:

https://example.page.link/WXYZ

C++ SDK অ্যান্ড্রয়েড এবং iOS উভয়ের জন্যই কাজ করে, প্রতিটি প্ল্যাটফর্মের জন্য কিছু অতিরিক্ত সেটআপ প্রয়োজন।d

শুরু করার আগে

Firebase Dynamic Links ব্যবহার করার আগে, আপনাকে যা করতে হবে:

  • আপনার C++ প্রকল্পটি নিবন্ধন করুন এবং Firebase ব্যবহারের জন্য এটি কনফিগার করুন।

    যদি আপনার C++ প্রকল্পটি ইতিমধ্যেই Firebase ব্যবহার করে, তাহলে এটি ইতিমধ্যেই Firebase-এর জন্য নিবন্ধিত এবং কনফিগার করা আছে।

  • আপনার C++ প্রজেক্টে Firebase C++ SDK যোগ করুন।

মনে রাখবেন যে আপনার C++ প্রজেক্টে Firebase যোগ করার ক্ষেত্রে Firebase কনসোল এবং আপনার খোলা C++ প্রজেক্ট উভয় ক্ষেত্রেই কাজ জড়িত (উদাহরণস্বরূপ, আপনি কনসোল থেকে Firebase কনফিগারেশন ফাইল ডাউনলোড করেন, তারপর সেগুলিকে আপনার C++ প্রজেক্টে স্থানান্তর করেন)।

অ্যান্ড্রয়েড

  1. Firebase কনসোলে, Dynamic Links বিভাগটি খুলুন।

  2. যদি আপনি ইতিমধ্যেই পরিষেবার শর্তাবলী গ্রহণ না করে থাকেন এবং আপনার Dynamic Links এর জন্য একটি URI প্রিফিক্স সেট না করে থাকেন, তাহলে অনুরোধ করা হলে তা করুন।

    যদি আপনার ইতিমধ্যেই একটি Dynamic Links URI প্রিফিক্স থাকে, তাহলে এটি লক্ষ্য করুন। প্রোগ্রাম্যাটিকভাবে Dynamic Links তৈরি করার সময় আপনাকে একটি Dynamic Links URI প্রিফিক্স প্রদান করতে হবে।

  3. প্রস্তাবিত : আপনার ডিপ লিঙ্ক এবং ফলব্যাক লিঙ্কগুলিতে অনুমোদিত URL প্যাটার্নগুলি নির্দিষ্ট করুন। এটি করার মাধ্যমে, আপনি অননুমোদিত পক্ষগুলিকে Dynamic Links তৈরি করতে বাধা দেবেন যা আপনার ডোমেন থেকে আপনার নিয়ন্ত্রণে নেই এমন সাইটগুলিতে পুনঃনির্দেশিত করে। নির্দিষ্ট URL প্যাটার্নগুলিকে অনুমতি দিন দেখুন।

আইওএস

  1. Firebase কনসোলে, Dynamic Links বিভাগটি খুলুন।

  2. যদি আপনি ইতিমধ্যেই পরিষেবার শর্তাবলী গ্রহণ না করে থাকেন এবং আপনার Dynamic Links এর জন্য একটি URI প্রিফিক্স সেট না করে থাকেন, তাহলে অনুরোধ করা হলে তা করুন।

    যদি আপনার ইতিমধ্যেই একটি Dynamic Links URI প্রিফিক্স থাকে, তাহলে এটি লক্ষ্য করুন। প্রোগ্রাম্যাটিকভাবে Dynamic Links তৈরি করার সময় আপনাকে একটি Dynamic Links ডোমেইন প্রদান করতে হবে।

  3. Firebase Dynamic Links C++ ক্লায়েন্ট লাইব্রেরি iOS-এ লিঙ্ক প্রক্রিয়া করার জন্য কাস্টম URL স্কিম ব্যবহার করে। Dynamic Links গ্রহণ সমর্থন করার জন্য আপনাকে অবশ্যই আপনার অ্যাপে কাস্টম URL স্কিম যোগ করতে হবে:
    1. আপনার প্রোজেক্ট কনফিগারেশন খুলতে, বাম দিকের ট্রি ভিউতে প্রোজেক্টের নামের উপর ডাবল-ক্লিক করুন। TARGETS বিভাগ থেকে আপনার অ্যাপটি নির্বাচন করুন, তারপর তথ্য ট্যাব নির্বাচন করুন এবং URL প্রকার বিভাগটি প্রসারিত করুন।
    2. + বোতামে ক্লিক করুন এবং আপনার বিপরীত ক্লায়েন্ট আইডির জন্য একটি URL স্কিম যোগ করুন। এই মানটি খুঁজে পেতে, GoogleService-Info.plist কনফিগারেশন ফাইলটি খুলুন এবং REVERSED_CLIENT_ID কীটি সন্ধান করুন। সেই কীটির মানটি অনুলিপি করুন এবং কনফিগারেশন পৃষ্ঠার URL স্কিম বাক্সে পেস্ট করুন। অন্যান্য ক্ষেত্রগুলি ফাঁকা রাখুন।
    3. + বোতামে ক্লিক করুন এবং দ্বিতীয় একটি URL স্কিম যোগ করুন। এটি আপনার অ্যাপের বান্ডেল আইডির মতোই। উদাহরণস্বরূপ, যদি আপনার বান্ডেল আইডি com.example.ios হয়, তাহলে URL Schemes বাক্সে সেই মানটি টাইপ করুন। আপনি আপনার অ্যাপের বান্ডেল আইডিটি প্রোজেক্ট কনফিগারেশনের General ট্যাবে ( Identity > Bundle Identifier ) খুঁজে পেতে পারেন।

Firebase কনসোল ব্যবহার করুন

যদি আপনি একটি একক Dynamic Link তৈরি করতে চান, হয় পরীক্ষার উদ্দেশ্যে, অথবা আপনার মার্কেটিং টিমের জন্য সহজেই এমন একটি লিঙ্ক তৈরি করতে চান যা সোশ্যাল মিডিয়া পোস্টের মতো কিছুতে ব্যবহার করা যেতে পারে, তাহলে সবচেয়ে সহজ উপায় হল Firebase কনসোলে গিয়ে ধাপে ধাপে ফর্ম অনুসরণ করে ম্যানুয়ালি একটি তৈরি করা।

কাস্টম ডোমেন

goo.gl অথবা page.link সাবডোমেনের পরিবর্তে আপনার নিজস্ব ডোমেন ব্যবহার করে আপনি আপনার Dynamic Link এর ব্র্যান্ডিংয়ের উপর আরও বেশি নিয়ন্ত্রণ রাখতে পারেন। আপনার প্রকল্পের জন্য একটি কাস্টম ডোমেন সেট আপ করতে এই নির্দেশাবলী অনুসরণ করুন।

Firebase Dynamic Links API ব্যবহার করা

অ্যাপ তৈরি করুন এবং আরম্ভ করুন

Dynamic Links তৈরি করার আগে, আপনাকে একটি firebase::App অবজেক্ট তৈরি এবং ইনিশিয়ালাইজ করতে হবে।

firebase::App এর জন্য হেডার ফাইলটি অন্তর্ভুক্ত করুন :

#include "firebase/app.h"

পরবর্তী অংশটি আপনার প্ল্যাটফর্মের উপর নির্ভর করে পরিবর্তিত হয়:

অ্যান্ড্রয়েড

firebase::App তৈরি করুন, JNI পরিবেশ এবং জাভা অ্যাক্টিভিটির একটি jobject রেফারেন্স আর্গুমেন্ট হিসেবে দিন:

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

আইওএস

firebase::App তৈরি করুন :

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

Dynamic Links লাইব্রেরি আরম্ভ করুন

একটি Dynamic Link তৈরি করার আগে, আপনাকে প্রথমে Dynamic Links লাইব্রেরিটি আরম্ভ করতে হবে:

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

প্যারামিটার থেকে একটি দীর্ঘ Dynamic Link তৈরি করা হচ্ছে

একটি 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 ঐচ্ছিকভাবে PathLength সাথে একটি অতিরিক্ত DynamicLinkOptions কনফিগারেশন প্যারামিটার নেয়; এটি আপনাকে লিঙ্কটি কীভাবে তৈরি করা উচিত তা নিয়ন্ত্রণ করতে দেয়। একটি ছোট লিঙ্ক তৈরি করার জন্য 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());
  }
}