নতুন বিল্ড সম্পর্কে পরীক্ষকদের বিজ্ঞপ্তি পাঠানো


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

শুরু করার আগে

এখনও যোগ না করে থাকলে, আপনার iOS প্রোজেক্টে Firebase যোগ করুন।

ধাপ ১: App Distribution Tester API চালু করুন

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

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

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

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

    pod 'FirebaseAppDistribution'

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

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

    Swift

    import FirebaseCore
import FirebaseAppDistribution

    Objective-C

    @import FirebaseCore;
@import FirebaseAppDistribution;

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

    Swift

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

    Objective-C

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

  5. সুইজলিং বন্ধ করা থাকলে, application(_:open:options:)-এর ইমপ্লিমেন্টেশনে App Distribution SDK-তে খোলা যেকোনও URL পাস করুন:

    Swift

    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
}

    Objective-C

    - (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. কোনও টেস্টার তার Google অ্যাকাউন্ট দিয়ে App Distribution-এ সাইন-ইন করার জন্য প্রম্পট করে সতর্কতা চালু করেছেন কিনা তা চেক করে।

  2. টেস্টার এখনও অ্যালার্ট চালু না করে থাকলে, আগে থেকে তৈরি করা ডায়ালগ দেখায়।

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

  3. টেস্টারের ইনস্টল করার জন্য নতুন উপলভ্য বিল্ড চেক করে।

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

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

Swift

মনে রাখবেন: এই প্রোডাক্ট 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)
})

Objective-C

মনে রাখবেন: এই প্রোডাক্ট 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()-এ কল করে চেক করতে পারেন যে পরীক্ষকের কাছে নতুন বিল্ডের অ্যাক্সেস আছে কিনা।

Swift

মনে রাখবেন: এই প্রোডাক্ট 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
  })
}

Objective-C

মনে রাখবেন: এই প্রোডাক্ট 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() সহ অতিরিক্ত পদ্ধতি সম্পর্কে তথ্যের জন্য, App Distribution রেফারেন্স ডকুমেন্টেশন দেখুন Swift এবং Objective-C-এর জন্য।

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

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

সাধারণ সমস্যার ক্ষেত্রে সাহায্য পেতে App Distribution সমস্যার সমাধান সংক্রান্ত গাইড দেখুন, যেমন:

  • টেস্টার অ্যাপ-মধ্যস্থ সতর্কতা পাচ্ছেন না
  • টেস্টারকে একাধিকবার Google-এ সাইন-ইন করার জন্য প্রম্পট করা হচ্ছে