আইওএস-এ ডায়নামিক লিঙ্ক তৈরি করুন

আপনি Firebase Dynamic Links Builder API দিয়ে ছোট বা দীর্ঘ ডায়নামিক লিঙ্ক তৈরি করতে পারেন। এই এপিআই হয় একটি দীর্ঘ ডায়নামিক লিঙ্ক বা ডায়নামিক লিঙ্ক প্যারামিটার সমন্বিত একটি বস্তু গ্রহণ করে এবং নিম্নলিখিত উদাহরণগুলির মতো URL প্রদান করে:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

পূর্বশর্ত

আপনি শুরু করার আগে, আপনার iOS প্রকল্পে Firebase যোগ করতে ভুলবেন না।

Firebase এবং Dynamic Links SDK সেট আপ করুন

ফায়ারবেস নির্ভরতা ইনস্টল এবং পরিচালনা করতে সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন।

1. Xcode-এ, আপনার অ্যাপ প্রকল্প খোলার সাথে, ফাইল > প্যাকেজ যোগ করুন- এ নেভিগেট করুন।
2. অনুরোধ করা হলে, Firebase Apple প্ল্যাটফর্ম SDK সংগ্রহস্থল যোগ করুন:

  https://github.com/firebase/firebase-ios-sdk

3. ডায়নামিক লিঙ্ক লাইব্রেরি চয়ন করুন।
4. ডায়নামিক লিঙ্কগুলির সাথে একটি সর্বোত্তম অভিজ্ঞতার জন্য, আমরা আপনার Firebase প্রকল্পে Google Analytics সক্ষম করার এবং আপনার অ্যাপে Google Analytics-এর জন্য Firebase SDK যোগ করার পরামর্শ দিই। আপনি IDFA সংগ্রহ ছাড়াই অথবা IDFA সংগ্রহের মাধ্যমে লাইব্রেরি নির্বাচন করতে পারেন।
5. শেষ হয়ে গেলে, Xcode স্বয়ংক্রিয়ভাবে পটভূমিতে আপনার নির্ভরতাগুলি সমাধান এবং ডাউনলোড করা শুরু করবে।

এখন, কিছু কনফিগারেশন পদক্ষেপ সম্পাদন করুন:

1. Firebase কনসোলে, ডায়নামিক লিঙ্ক বিভাগ খুলুন।

2. আপনি যদি ইতিমধ্যে পরিষেবার শর্তাদি গ্রহণ না করে থাকেন এবং আপনার ডায়নামিক লিঙ্কগুলির জন্য একটি URI উপসর্গ সেট করেন, অনুরোধ করা হলে তা করুন৷

   আপনার যদি ইতিমধ্যেই একটি ডায়নামিক লিঙ্কস ইউআরআই উপসর্গ থাকে তবে এটির একটি নোট নিন। আপনি যখন প্রোগ্রাম্যাটিকভাবে ডায়নামিক লিঙ্ক তৈরি করেন তখন আপনাকে এটি প্রদান করতে হবে।

   

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

4. নিশ্চিত করুন যে আপনার অ্যাপের অ্যাপ স্টোর আইডি এবং আপনার অ্যাপ আইডি উপসর্গ আপনার অ্যাপের সেটিংসে নির্দিষ্ট করা আছে। আপনার অ্যাপের সেটিংস দেখতে ও সম্পাদনা করতে, আপনার Firebase প্রকল্পের সেটিংস পৃষ্ঠায় যান এবং আপনার iOS অ্যাপ নির্বাচন করুন।

   আপনার ডায়নামিক লিঙ্ক ডোমেনে হোস্ট করা apple-app-site-association ফাইলটি খুলে আপনার Firebase প্রকল্পটি আপনার iOS অ্যাপে ডায়নামিক লিঙ্ক ব্যবহার করার জন্য সঠিকভাবে কনফিগার করা হয়েছে কিনা তা নিশ্চিত করুন। Firebase apple-app-site-association ফাইলটি ডোমেনের রুট এবং .well-known সাবডিরেক্টরি থেকে পরিবেশন করবে। উদাহরণ স্বরূপ:

       https://example.com/apple-app-site-association
       https://example.com/.well-known/apple-app-site-association
       

   আপনার অ্যাপ সংযুক্ত থাকলে, apple-app-site-association ফাইলে আপনার অ্যাপের অ্যাপ আইডি প্রিফিক্স এবং বান্ডেল আইডির একটি রেফারেন্স রয়েছে। উদাহরণ স্বরূপ:

   {"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["/*"]}]}}

   details প্রপার্টি খালি থাকলে, আপনি আপনার অ্যাপ আইডি প্রিফিক্স নির্দিষ্ট করেছেন তা দুবার চেক করুন। মনে রাখবেন আপনার অ্যাপ আইডি প্রিফিক্স আপনার টিম আইডির মতো নাও হতে পারে।

আপনার অ্যাপে Firebase যোগ করুন

1. আপনার UIApplicationDelegate এ FirebaseCore মডিউল আমদানি করুন, সেইসাথে আপনার অ্যাপ প্রতিনিধি যে কোনো Firebase মডিউল ব্যবহার করেন। উদাহরণস্বরূপ, ক্লাউড ফায়ারস্টোর এবং প্রমাণীকরণ ব্যবহার করতে:

   সুইফটইউআই

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   সুইফট

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   উদ্দেশ্য গ

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. আপনার অ্যাপ প্রতিনিধির application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে একটি FirebaseApp শেয়ার করা উদাহরণ কনফিগার করুন:

   সুইফটইউআই

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   সুইফট

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   উদ্দেশ্য গ

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. আপনি যদি SwiftUI ব্যবহার করেন, তাহলে আপনাকে অবশ্যই একটি অ্যাপ্লিকেশন ডেলিগেট তৈরি করতে হবে এবং UIApplicationDelegateAdaptor বা NSApplicationDelegateAdaptor এর মাধ্যমে আপনার App স্ট্রাকটে এটি সংযুক্ত করতে হবে। আপনাকে অবশ্যই অ্যাপ ডেলিগেট সুইজলিং অক্ষম করতে হবে। আরও তথ্যের জন্য, SwiftUI নির্দেশাবলী দেখুন।

   সুইফটইউআই

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

ফায়ারবেস কনসোল ব্যবহার করুন

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

iOS বিল্ডার API ব্যবহার করুন

আপনি পরামিতি থেকে ডায়নামিক লিঙ্ক তৈরি করতে বা দীর্ঘ ডায়নামিক লিঙ্ক ছোট করতে iOS বিল্ডার API ব্যবহার করতে পারেন।

প্যারামিটার থেকে একটি ডায়নামিক লিঙ্ক তৈরি করুন

একটি ডাইনামিক লিংক তৈরি করতে, একটি নতুন DynamicLinkComponents অবজেক্ট তৈরি করুন এবং বস্তুর সংশ্লিষ্ট বৈশিষ্ট্যগুলি সেট করে ডায়নামিক লিঙ্ক প্যারামিটারগুলি নির্দিষ্ট করুন৷ তারপরে, অবজেক্টের url প্রপার্টি থেকে লং লিঙ্কটি পান বা shorten() কল করে ছোট লিঙ্কটি পান।

নিম্নলিখিত ন্যূনতম উদাহরণটি https://www.example.com/my-page এ একটি দীর্ঘ ডায়নামিক লিঙ্ক তৈরি করে যা iOS-এ আপনার iOS অ্যাপ এবং Android-এ com.example.android অ্যাপের সাথে খোলে:

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPrefix: dynamicLinksDomainURIPRefix)
linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                               domainURIPrefix:dynamicLinksDomainURIPrefix];
linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];

NSLog(@"The long URL is: %@", linkBuilder.url);

একটি সংক্ষিপ্ত ডায়নামিক লিঙ্ক তৈরি করতে, একইভাবে একটি DynamicLinkComponents তৈরি করুন এবং তারপরে shorten() কল করুন।

একটি সংক্ষিপ্ত লিঙ্ক তৈরি করার জন্য একটি নেটওয়ার্ক কলের প্রয়োজন, তাই সরাসরি লিঙ্কটি ফেরত দেওয়ার পরিবর্তে, shorten() একটি সম্পূর্ণ হ্যান্ডলার গ্রহণ করে, যা অনুরোধটি সম্পূর্ণ হলে বলা হয়। উদাহরণ স্বরূপ:

linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

ডিফল্টরূপে, সংক্ষিপ্ত ডায়নামিক লিঙ্কগুলি 17-অক্ষরের লিঙ্ক প্রত্যয়গুলির সাথে তৈরি করা হয় যা এটিকে অত্যন্ত অসম্ভাব্য করে তোলে যে কেউ একটি বৈধ ডায়নামিক লিঙ্ক অনুমান করতে পারে। যদি, আপনার ব্যবহারের ক্ষেত্রে, কেউ সফলভাবে একটি সংক্ষিপ্ত লিঙ্ক অনুমান করার ক্ষেত্রে কোন ক্ষতি না হয়, তাহলে আপনি এমন প্রত্যয় তৈরি করতে পছন্দ করতে পারেন যেগুলি শুধুমাত্র অনন্য হওয়ার জন্য প্রয়োজন, যা আপনি dynamicLinkComponentsOptions বৈশিষ্ট্য সেট করে করতে পারেন:

linkBuilder.options = DynamicLinkComponentsOptions()
linkBuilder.options.pathLength = .short
linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

linkBuilder.dynamicLinkComponentsOptions = [[FIRDynamicLinkComponentsOptions alloc] init];
linkBuilder.dynamicLinkComponentsOptions.pathLength = FIRShortDynamicLinkPathLengthShort;
[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

ডায়নামিক লিঙ্ক প্যারামিটার

আপনি সমর্থিত প্যারামিটারগুলির সাথে ডায়নামিক লিঙ্ক তৈরি করতে ডায়নামিক লিঙ্ক বিল্ডার API ব্যবহার করতে পারেন। বিস্তারিত জানার জন্য API রেফারেন্স দেখুন।

নিম্নলিখিত উদাহরণটি বেশ কয়েকটি সাধারণ প্যারামিটার সেট সহ একটি ডায়নামিক লিঙ্ক তৈরি করে:

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPRefix: dynamicLinksDomainURIPrefix)

linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.iOSParameters.appStoreID = "123456789"
linkBuilder.iOSParameters.minimumAppVersion = "1.2.3"

linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")
linkBuilder.androidParameters.minimumVersion = 123

linkBuilder.analyticsParameters = DynamicLinkGoogleAnalyticsParameters(source: "orkut",
                                                                       medium: "social",
                                                                       campaign: "example-promo")

linkBuilder.iTunesConnectParameters = DynamicLinkItunesConnectAnalyticsParameters()
linkBuilder.iTunesConnectParameters.providerToken = "123456"
linkBuilder.iTunesConnectParameters.campaignToken = "example-promo"

linkBuilder.socialMetaTagParameters = DynamicLinkSocialMetaTagParameters()
linkBuilder.socialMetaTagParameters.title = "Example of a Dynamic Link"
linkBuilder.socialMetaTagParameters.descriptionText = "This link works whether the app is installed or not!"
linkBuilder.socialMetaTagParameters.imageURL = "https://www.example.com/my-image.jpg"

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                         domainURIPrefix:dynamicLinksDomainURIPrefix];

linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.iOSParameters.appStoreID = @"123456789";
linkBuilder.iOSParameters.minimumAppVersion = @"1.2.3";

linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];
linkBuilder.androidParameters.minimumVersion = 123;

linkBuilder.analyticsParameters = [[FIRDynamicLinkGoogleAnalyticsParameters alloc]
                                   initWithSource:@"orkut"
                                           medium:@"social"
                                         campaign:@"example-promo"];

linkBuilder.iTunesConnectParameters = [[FIRDynamicLinkItunesConnectAnalyticsParameters alloc] init];
linkBuilder.iTunesConnectParameters.providerToken = @"123456";
linkBuilder.iTunesConnectParameters.campaignToken = @"example-promo";

linkBuilder.socialMetaTagParameters = [[FIRDynamicLinkSocialMetaTagParameters alloc] init];
linkBuilder.socialMetaTagParameters.title = @"Example of a Dynamic Link";
linkBuilder.socialMetaTagParameters.descriptionText = @"This link works whether the app is installed or not!";
linkBuilder.socialMetaTagParameters.imageURL = @"https://www.example.com/my-image.jpg";

NSLog(@"The long URL is: %@", linkBuilder.url);

আপনি নিম্নলিখিত বস্তু এবং বৈশিষ্ট্যগুলির সাথে ডায়নামিক লিঙ্ক প্যারামিটার সেট করতে পারেন:

https://example.com/link
https://example.page.link

একটি দীর্ঘ ডায়নামিক লিঙ্ক ছোট করুন

একটি দীর্ঘ ডায়নামিক লিঙ্ক সংক্ষিপ্ত করতে, যদি আপনি একটি সংক্ষিপ্ত প্রত্যয় সহ একটি লিঙ্ক তৈরি করতে চান তবে একটি DynamicLinkComponentsOptions অবজেক্ট সহ shortenURL(url:options:) এ দীর্ঘ ডায়নামিক লিঙ্কটি পাস করুন:

DynamicLinkComponents.shortenURL(url: longLinkUrl, options: nil) { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

[FIRDynamicLinkComponents shortenURL:longLinkUrl
                             options:nil
                          completion:^(NSURL * _Nullable shortURL,
                                       NSArray<NSString *> * _Nullable warnings,
                                       NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];

ডায়নামিক লিঙ্কের জন্য একটি কাস্টম URL স্কিম নির্দিষ্ট করা

ডিফল্টরূপে, ডায়নামিক লিঙ্কগুলি আপনার অ্যাপ্লিকেশন খোলার জন্য প্রয়োজনীয় URL স্কিম হিসাবে আপনার অ্যাপের বান্ডেল শনাক্তকারী ব্যবহার করে। আপনার বাস্তবায়নকে সহজ রাখতে আমরা এই ডিফল্ট মানটির সাথে থাকার পরামর্শ দিই।

যাইহোক, ডেভেলপাররা যারা ইতিমধ্যেই অন্য উদ্দেশ্যে একটি কাস্টম URL স্কিম ব্যবহার করছেন তারা তাদের ডায়নামিক লিঙ্কগুলির জন্যও এই একই কাস্টম URL স্কিমটি ব্যবহার করতে চাইতে পারেন৷ আপনি যদি এই পরিস্থিতিতে থাকেন, আপনি এই পদক্ষেপগুলি অনুসরণ করে আপনার Firebase ডায়নামিক লিঙ্কগুলির জন্য একটি ভিন্ন URL স্কিম নির্দিষ্ট করতে পারেন:

1. আপনার অ্যাপ সেট-আপ করার সময়, আপনার FirebaseApp শেয়ার করা ইন্সট্যান্স কনফিগার করার আগে আপনার অ্যাপ্লিকেশন দ্বারা ব্যবহৃত ডিফল্ট URL স্কিমটি নির্দিষ্ট করে নিন:

   সুইফট

   দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac ক্যাটালিস্ট, tvOS, বা watchOS লক্ষ্যে উপলব্ধ নয়৷

   func application(_ application: UIApplication,
                    didFinishLaunchingWithOptions launchOptions: [UIApplication
                      .LaunchOptionsKey: Any]?) -> Bool {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     FirebaseOptions.defaultOptions()?.deepLinkURLScheme = customURLScheme
     FirebaseApp.configure()
   
     return true
   }
   

   উদ্দেশ্য গ

   দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac ক্যাটালিস্ট, tvOS, বা watchOS লক্ষ্যে উপলব্ধ নয়৷

   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     [FIROptions defaultOptions].deepLinkURLScheme = CUSTOM_URL_SCHEME;
     [FIRApp configure];
   
     return YES;
   }

2. আপনি যখনই কোনো ডায়নামিক লিঙ্ক তৈরি করেন, আপনাকে আপনার অ্যাপ ব্যবহার করে কাস্টম URL স্কিমটি নির্দিষ্ট করতে হবে। আপনি Firebase কনসোলের মাধ্যমে, বিল্ডার API-এ customScheme সেট করে, আপনার URL-এ ius প্যারামিটার নির্দিষ্ট করে বা REST API-এ iosCustomScheme প্যারামিটার পাঠাতে পারেন।

পরবর্তী পদক্ষেপ

এখন যেহেতু আপনি ডায়নামিক লিঙ্ক তৈরি করেছেন, আপনাকে ডায়নামিক লিঙ্কগুলি পেতে আপনার অ্যাপ সেট আপ করতে হবে এবং কোনও ব্যবহারকারী সেগুলি খোলার পরে আপনার অ্যাপের সঠিক জায়গায় ব্যবহারকারীদের পাঠাতে হবে।

আপনার অ্যাপে ডায়নামিক লিঙ্ক পেতে, iOS , Android , C++ এবং Unity- এর ডকুমেন্টেশন দেখুন।