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


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

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

যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার iOS প্রকল্পে Firebase যোগ করুন

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

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

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

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

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

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

  3. আপনার App স্ট্রাকটে বা 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. যদি সুইজলিং অক্ষম করা হয়, আপনার অ্যাপ্লিকেশন বাস্তবায়নে যেকোনও খোলা ইউআরএল App Distribution SDK-তে পাস করুন 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
    }
    
    - (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 SDK আপনার পরীক্ষকদের জন্য অ্যাপ-মধ্যস্থ বিল্ড অ্যালার্ট সেট আপ করার দুটি উপায় প্রদান করে: একটি মৌলিক সতর্কতা কনফিগারেশন, যা পরীক্ষকদের কাছে প্রদর্শনের জন্য পূর্ব-নির্মিত অ্যাপ আপডেট এবং সাইন-ইন ডায়ালগগুলির সাথে আসে এবং একটি উন্নত সতর্কতা কনফিগারেশন, যা অনুমতি দেয় আপনি আপনার নিজের ব্যবহারকারী ইন্টারফেস কাস্টমাইজ করতে. আপনি যদি App Distribution SDK-এ নতুন হন তাহলে আমরা প্রথমে প্রাথমিক সতর্কতা কনফিগারেশন ব্যবহার করার পরামর্শ দিই।

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

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

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

  2. যদি পরীক্ষক এখনও সতর্কতা সক্রিয় না করে থাকে, একটি পূর্ব-নির্মিত সংলাপ প্রদর্শন করে।

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

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

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

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

দ্রষ্টব্য: এই পণ্যটি macOS, Mac ক্যাটালিস্ট, 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 ক্যাটালিস্ট, 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 ক্যাটালিস্ট, 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 ক্যাটালিস্ট, 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 রেফারেন্স ডকুমেন্টেশন দেখুন।

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

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

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

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