নতুন বিল্ড সম্পর্কে পরীক্ষকদের অবহিত করুন


ঐচ্ছিক Firebase App Distribution iOS এবং Android SDK-গুলো আপনার অ্যাপের নতুন বিল্ড ইনস্টল করার জন্য উপলব্ধ হলে পরীক্ষকদের কাছে অ্যাপের মধ্যেই অ্যালার্ট প্রদর্শন করার সুযোগ দেয়। এই নির্দেশিকাটি ব্যাখ্যা করে যে, কীভাবে App Distribution iOS এবং Android SDK ব্যবহার করে আপনার পরীক্ষকদের জন্য নতুন বিল্ড অ্যালার্ট তৈরি এবং কাস্টমাইজ করতে হয়।

শুরু করার আগে

যদি আগে থেকে না করে থাকেন, তাহলে আপনার iOS প্রজেক্টে Firebase যোগ করুন ।

ধাপ ১ : App Distribution টেস্টার এপিআই সক্রিয় করুন

  1. Google Cloud কনসোলে আপনার প্রজেক্টটি নির্বাচন করুন।

  2. Firebase App Testers API-এর অধীনে, Enable-এ ক্লিক করুন।

ধাপ ২ : আপনার অ্যাপে App Distribution যোগ করুন

  1. প্রজেক্টের জন্য তৈরি করা Podfile-টি খুলুন (অথবা একটি তৈরি করতে pod init চালান), তারপর target সেকশনের ভিতরে নিম্নলিখিত লাইনটি যোগ করুন: 

    pod 'FirebaseAppDistribution'

  2. আপনার podfile-এর ডিরেক্টরিতে pod install চালান, তারপর তৈরি হওয়া .xcworkspace ফাইলটি খুলুন।

  3. আপনার App struct অথবা UIApplicationDelegate এ Firebase মডিউলটি ইম্পোর্ট করুন:

    সুইফট 

    import FirebaseCore
import FirebaseAppDistribution

    উদ্দেশ্য-সি 

    @import FirebaseCore;
@import FirebaseAppDistribution;

  4. আপনার অ্যাপ ডেলিগেটের application(_:didFinishLaunchingWithOptions:) মেথডে একটি FirebaseApp শেয়ার্ড ইনস্ট্যান্স কনফিগার করুন:

    সুইফট 

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

    উদ্দেশ্য-সি 

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

  5. যদি সুইজলিং নিষ্ক্রিয় করা থাকে, তাহলে আপনার application(_:open:options:) এর বাস্তবায়নে খোলা যেকোনো URL App Distribution SDK-তে পাঠান:

    সুইফট 

    func application(_ app: UIApplication, 
                 open url: URL,
                 options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
   if AppDistribution.appDistribution().application(application, open: url, options: options) {
      return true
   }

   // Handle other non-Firebase URLs here.

   return false
}

    উদ্দেশ্য-সি 

    - (BOOL)application:(UIApplication *)app 
            openURL:(NSURL *)url 
            options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
   if ([[FIRAppDistribution appDistribution] application:app openURL:url options:options]) {
      return YES;
   }

   // Handle other non-Firebase URLs here.

   return NO;
}

  6. অবশেষে, আপনার অ্যাপটি পুনরায় কম্পাইল করুন।

ধাপ ৩ : অ্যাপের মধ্যে অ্যালার্ট কনফিগার করুন

App Distribution SDK আপনার পরীক্ষকদের জন্য অ্যাপের মধ্যে বিল্ড অ্যালার্ট সেট আপ করার দুটি উপায় প্রদান করে: একটি বেসিক অ্যালার্ট কনফিগারেশন, যা পরীক্ষকদের দেখানোর জন্য আগে থেকে তৈরি অ্যাপ আপডেট এবং সাইন-ইন ডায়ালগ সহ আসে, এবং একটি অ্যাডভান্সড অ্যালার্ট কনফিগারেশন, যা আপনাকে আপনার নিজস্ব ইউজার ইন্টারফেস কাস্টমাইজ করার সুযোগ দেয়। আপনি যদি App Distribution SDK-তে নতুন হন, তবে আমরা প্রথমে বেসিক অ্যালার্ট কনফিগারেশনটি ব্যবহার করার পরামর্শ দিই।

মৌলিক কনফিগারেশন

যেসব পরীক্ষক এখনও অ্যালার্ট চালু করেননি, তাদের একটি পূর্ব-নির্মিত অ্যালার্ট চালু করার ডায়ালগ বক্স দেখানোর জন্য এবং তারপর একটি নতুন বিল্ড উপলব্ধ আছে কিনা তা পরীক্ষা করার জন্য checkForUpdate ব্যবহার করুন। কল করা হলে, এই মেথডটি নিম্নলিখিত ক্রমটি কার্যকর করে:

  1. কোনো পরীক্ষক অ্যালার্ট চালু করেছেন কিনা তা যাচাই করার জন্য, তাঁকে তাঁর গুগল অ্যাকাউন্ট দিয়ে App Distribution সাইন ইন করতে বলা হয়।

  2. যদি পরীক্ষক এখনও অ্যালার্ট চালু না করে থাকেন, তাহলে একটি পূর্ব-নির্মিত ডায়ালগ প্রদর্শিত হয়।

    টেস্ট ডিভাইসে অ্যালার্ট চালু করা একটি এককালীন প্রক্রিয়া এবং এটি আপনার অ্যাপের আপডেটের পরেও কার্যকর থাকে। টেস্ট ডিভাইসে অ্যালার্ট ততক্ষণ পর্যন্ত চালু থাকে যতক্ষণ না অ্যাপটি আনইনস্টল করা হয়, অথবা signOutTester মেথডটি কল করা হয়। আরও তথ্যের জন্য মেথডটির রেফারেন্স ডকুমেন্টেশন ( সুইফট বা অবজেক্টিভ-সি ) দেখুন।

  3. পরীক্ষকের ইনস্টল করার জন্য নতুন উপলব্ধ বিল্ডগুলি পরীক্ষা করা হয়।

আপনি আপনার অ্যাপের যেকোনো জায়গায় checkForUpdate() কল করতে পারেন। উদাহরণস্বরূপ, আপনার অ্যাপের রুট ভিউ-এর onAppear(perform:) অংশে checkForUpdate() অন্তর্ভুক্ত করে, আপনি অ্যাপ চালু হওয়ার সময়েই পরীক্ষকদের নতুন উপলব্ধ বিল্ড ইনস্টল করার জন্য অনুরোধ করতে পারেন।

নিম্নলিখিত উদাহরণটি যাচাই করে দেখে যে পরীক্ষক অ্যালার্ট সক্রিয় করেছেন কিনা এবং একটি নতুন বিল্ডে তার অ্যাক্সেস আছে কিনা, এবং যদি থাকে, তাহলে বিল্ডটি ইনস্টল করার জন্য উপলব্ধ হলে একটি ডায়ালগ প্রদর্শন করে:

সুইফট

দ্রষ্টব্য: এই পণ্যটি macOS, Mac Catalyst, tvOS বা watchOS-এ উপলব্ধ নয়। 
AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
  if error != nil {
      // Handle error
      return
  }

  guard let release = release else {
    return
  }

  // Customize your alerts here.
  let title = "New Version Available"
  let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
  let uialert = UIAlertController(title: title,message: message, preferredStyle: .alert)

  uialert.addAction(UIAlertAction(title: "Update", style: UIAlertAction.Style.default) {
    _ in
    UIApplication.shared.open(release.downloadURL)
  })
  uialert.addAction(UIAlertAction(title: "Cancel", style: UIAlertAction.Style.cancel) {
    _ in
  })

  // self should be a UIViewController.
  self.present(uialert, animated: true, completion: nil)
})

উদ্দেশ্য-সি

দ্রষ্টব্য: এই পণ্যটি macOS, Mac Catalyst, tvOS বা watchOS-এ উপলব্ধ নয়। 
[[FIRAppDistribution appDistribution]
  checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
                                 NSError *_Nullable error) {
  if (error) {
    // Handle error
    return;
  }

  if (release) {
    UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"New Version Available"
message:[NSString stringWithFormat:@"Version %@ (%@) is available.", release.displayVersion,
release.buildVersion] preferredStyle:UIAlertControllerStyleAlert];

    UIAlertAction *updateAction = [UIAlertAction actionWithTitle:@"Update"
style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) {
      [[UIApplication sharedApplication] openURL:release.downloadURL options:@{}
completionHandler:nil];
    }];
    UIAlertAction *cancelAction = [UIAlertAction actionWithTitle:@"Cancel"
style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {}];
    [alert addAction:updateAction];
    [alert addAction:cancelAction];
    [self presentViewController:alert animated:YES completion:nil];
  }
}];

উন্নত কনফিগারেশন

signInTester() এবং isTesterSignedIn মেথডগুলো আপনার টেস্টারের সাইন-ইন অভিজ্ঞতাকে কাস্টমাইজ করার ক্ষেত্রে আপনাকে আরও বেশি নমনীয়তা দেয়, যাতে এটি আপনার অ্যাপের লুক ও ফিল-এর সাথে আরও ভালোভাবে মিলে যায়।

নিম্নলিখিত উদাহরণটি পরীক্ষা করে দেখে যে পরীক্ষক তার Firebase App Distribution পরীক্ষক অ্যাকাউন্টে আগে থেকেই সাইন ইন করেছেন কিনা, যাতে আপনি শুধুমাত্র সেইসব পরীক্ষকদের জন্য আপনার সাইন-ইন UI প্রদর্শন করতে পারেন যারা এখনও সাইন ইন করেননি। পরীক্ষক সাইন ইন করার পরে, তিনি একটি নতুন বিল্ড অ্যাক্সেস করতে পারবেন কিনা তা পরীক্ষা করার জন্য আপনি checkForUpdate() কল করতে পারেন।

সুইফট

দ্রষ্টব্য: এই পণ্যটি macOS, Mac Catalyst, tvOS বা watchOS-এ উপলব্ধ নয়। 
// Sign in a tester without automatically checking for update
if (!AppDistribution.appDistribution().isTesterSignedIn) {
  AppDistribution.appDistribution().signInTester (completion: { error in
    // completion block for signInTester
     if (error != nil) {
       // handle failed sign in
      return
     }
    // handle successful sign in
  })
}

// Only check for update if tester is already signed in - do not prompt
if (AppDistribution.appDistribution().isTesterSignedIn) {
  AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
      // completion block for check for update
  })
}

উদ্দেশ্য-সি

দ্রষ্টব্য: এই পণ্যটি macOS, Mac Catalyst, tvOS বা watchOS-এ উপলব্ধ নয়। 
// Sign in a tester without automatically checking for update
if(![[FIRAppDistribution appDistribution] isTesterSignedIn]) {
  [[FIRAppDistribution appDistribution]
    signInTesterWithCompletion:^(NSError *_Nullable error) {
      // completion block for signInTester
     if (error) {
       // handle failed sign in
       return;
     }
      // handle successful sign in
  }];
}

// only check for update if tester is already signed in - do not prompt
if([[FIRAppDistribution appDistribution] isTesterSignedIn]) {
  [[FIRAppDistribution appDistribution]
        checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
                                       NSError *_Nullable error) {
     // completion block for check for update
  }];
}

signOutTester() সহ অতিরিক্ত মেথডগুলোর তথ্যের জন্য, Swift এবং Objective-C- এর App Distribution রেফারেন্স ডকুমেন্টেশন দেখুন।

ধাপ ৪ : আপনার ইমপ্লিমেন্টেশনটি তৈরি ও পরীক্ষা করুন।

অবশেষে, আপনার অ্যাপটি বিল্ড করুন এবং Firebase কনসোল ব্যবহার করে পরীক্ষকদের কাছে বিল্ডটি বিতরণ করে আপনার বাস্তবায়নটি পরীক্ষা করুন।

সাধারণ সমস্যা, যেমন—এর সমাধানে সাহায্যের জন্য App Distribution ট্রাবলশুটিং গাইডটি দেখুন:

  • পরীক্ষক অ্যাপের মধ্যে সতর্কতা পাচ্ছেন না
  • পরীক্ষককে একাধিকবার গুগলে সাইন ইন করতে বলা হচ্ছে।