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


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

আপনি শুরু করার আগে

আপনি যদি ইতিমধ্যে না থাকেন তবে আপনার আইওএস প্রকল্পে ফায়ারবেস যুক্ত করুন ।

ধাপ 1 : App Distribution টেস্টার API সক্ষম করুন

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

  2. ফায়ারবেস অ্যাপ পরীক্ষকগণ এপিআই এর অধীনে সক্ষম ক্লিক করুন।

পদক্ষেপ 2 : আপনার অ্যাপ্লিকেশনটিতে App Distribution যুক্ত করুন

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

    pod 'FirebaseAppDistribution'

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

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

    সুইফট 

    import FirebaseCore
import FirebaseAppDistribution

    উদ্দেশ্য-C 

    @import FirebaseCore;
@import FirebaseAppDistribution;

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

    সুইফট 

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

    উদ্দেশ্য-C 

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

  5. যদি সুইজলিং অক্ষম থাকে তবে আপনার অ্যাপ্লিকেশন বাস্তবায়নে App Distribution এসডিকে কোনও খোলা ইউআরএলগুলি পাস করুন application(_:open:options:) :

    সুইফট 

    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
}

    উদ্দেশ্য-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. অবশেষে, আপনার অ্যাপ্লিকেশনটি পুনরায় সংশোধন করুন।

পদক্ষেপ 3 : অ্যাপ্লিকেশন সতর্কতাগুলি কনফিগার করুন

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

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

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

  1. কোনও পরীক্ষক তাদের গুগল অ্যাকাউন্টের সাথে App Distribution সাইন ইন করার অনুরোধ জানিয়ে সতর্কতাগুলি সক্ষম করেছে কিনা তা পরীক্ষা করে।

  2. যদি পরীক্ষক এখনও সতর্কতাগুলি সক্ষম না করে থাকে তবে একটি প্রাক-বিল্ট কথোপকথন প্রদর্শন করে।

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

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

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

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

সুইফট

দ্রষ্টব্য: এই পণ্যটি ম্যাকোস, ম্যাক ক্যাটালিস্ট, টিভিওএস বা ওয়াচওএস লক্ষ্যগুলিতে উপলভ্য নয়। 
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)
})

উদ্দেশ্য-C

দ্রষ্টব্য: এই পণ্যটি ম্যাকোস, ম্যাক ক্যাটালিস্ট, টিভিওএস বা ওয়াচওএস লক্ষ্যগুলিতে উপলভ্য নয়। 
[[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 পরীক্ষক অ্যাকাউন্টে স্বাক্ষর করেছে কিনা তা যাচাই করে, যাতে আপনি কেবল নিজের সাইন-ইন ইউআই প্রদর্শনকারীদের জন্য প্রদর্শন করতে বেছে নিতে পারেন যারা এখনও সাইন ইন করেন নি। পরীক্ষক সাইন ইন করার পরে, আপনি তখন করতে পারেন পরীক্ষকের কোনও নতুন বিল্ডে অ্যাক্সেস আছে কিনা তা পরীক্ষা করতে checkForUpdate() কল করুন।

সুইফট

দ্রষ্টব্য: এই পণ্যটি ম্যাকোস, ম্যাক ক্যাটালিস্ট, টিভিওএস বা ওয়াচওএস লক্ষ্যগুলিতে উপলভ্য নয়। 
// 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
  })
}

উদ্দেশ্য-C

দ্রষ্টব্য: এই পণ্যটি ম্যাকোস, ম্যাক ক্যাটালিস্ট, টিভিওএস বা ওয়াচওএস লক্ষ্যগুলিতে উপলভ্য নয়। 
// 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 রেফারেন্স ডকুমেন্টেশন দেখুন।

পদক্ষেপ 4 : আপনার বাস্তবায়ন তৈরি এবং পরীক্ষা করুন

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

সাধারণ সমস্যাগুলির সাথে সহায়তার জন্য App Distribution সমস্যা সমাধানের গাইড দেখুন, যেমন:

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