שליחת הודעה לבודקים על גרסאות build חדשות

ערכות ה-SDK האופציונליות ל-iOS ול-Android מאפשרות להציג התראות בתוך האפליקציה לבוחנים שלכם כשגרסאות build חדשות של האפליקציה זמינות להתקנה. במדריך הזה מוסבר איך להשתמש בערכות ה-SDK ל-iOS ול-Android כדי ליצור התראות חדשות לגבי גרסאות build ולשנות את ההתאמה שלהן לבוחנים.Firebase App DistributionApp Distribution

לפני שמתחילים

אם עדיין לא הוספתם את Firebase לפרויקט iOS, אתם צריכים להוסיף אותו.

שלב 1: מפעילים את App Distribution Tester API

1. בוחרים את הפרויקט במסוף Google Cloud.

2. בקטע Firebase App Testers API, לוחצים על Enable (הפעלה).

שלב 2: מוסיפים את App Distribution לאפליקציה

1. פותחים את ה-Podfile שיצרתם לפרויקט (או מריצים את הפקודה pod init כדי ליצור אחד), ואז מוסיפים את השורה הבאה בתוך קטע היעד:

   pod 'FirebaseAppDistribution'

2. בספרייה של קובץ ה-Podfile, מריצים את הפקודה pod install ואז פותחים את הקובץ .xcworkspace שנוצר.

3. מייבאים את מודול Firebase ב-App struct או ב-UIApplicationDelegate:

   Swift

   import FirebaseCore
   import FirebaseAppDistribution
   

   Objective-C

   @import FirebaseCore;
   @import FirebaseAppDistribution;
   

4. מגדירים FirebaseApp מופע משותף בשיטה של delegate האפליקציה: application(_:didFinishLaunchingWithOptions:)

   Swift

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

   Objective-C

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

5. אם השבתתם את ה-swizzling, צריך להעביר את כל כתובות ה-URL שנפתחו אל App Distribution SDK בהטמעה של application(_:open:options:):

   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. לבסוף, קומפלו מחדש את האפליקציה.

שלב 3: הגדרת התראות בתוך האפליקציה

‫App Distribution SDK מספק שתי דרכים להגדרת התראות על גרסאות build באפליקציה עבור הבודקים: הגדרת התראות בסיסית, שכוללת תיבות דו-שיח מוכנות מראש לעדכון האפליקציה ולכניסה לחשבון שיוצגו לבודקים, והגדרת התראות מתקדמת, שמאפשרת לכם להתאים אישית את ממשק המשתמש. אם אתם חדשים בשימוש ב-App Distribution SDK, מומלץ להתחיל עם הגדרת התראות בסיסית.

הגדרה בסיסית

משתמשים ב-checkForUpdate כדי להציג תיבת דו-שיח מוכנה מראש להפעלת התראות לבודקים שעדיין לא הפעילו התראות, ואז בודקים אם גרסה חדשה זמינה. כשקוראים לשיטה, היא מבצעת את הרצף הבא:

1. בודק אם בודק הפעיל התראות על ידי בקשה ממנו להיכנס ל-App Distribution באמצעות חשבון Google.

2. אם הבודק עדיין לא הפעיל את ההתראות, מוצג לו דיאלוג מוכן מראש.

   הפעלת ההתראות היא תהליך חד-פעמי במכשיר הבדיקה, והיא נשמרת גם אחרי עדכונים של האפליקציה. ההתראות נשארות מופעלות במכשיר הבדיקה עד להסרת האפליקציה או עד לקריאה לשיטה signOutTester. מידע נוסף זמין במאמרי העזרה של השיטה (Swift או Objective-C).

3. בודקת אם יש גרסאות חדשות שזמינות למשתתפי הבדיקה להתקנה.

אפשר להפעיל את checkForUpdate() בכל שלב באפליקציה. לדוגמה, אפשר להציג לבודקים בקשה להתקין גרסאות חדשות שזמינות בהפעלה, על ידי הכללת checkForUpdate() ב-onAppear(perform:) של תצוגת השורש של האפליקציה.

בדוגמה הבאה נבדק אם הבודק הפעיל התראות ויש לו גישה לגרסת build חדשה. אם כן, מוצג דו-שיח כשהגרסה זמינה להתקנה:

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)
})

[[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
  })
}

// 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.

שלב 4: בנייה ובדיקה של ההטמעה

לבסוף, יוצרים את האפליקציה ומפיצים את הגרסה לבודקים באמצעות מסוף Firebase כדי לבדוק את ההטמעה.

בApp Distribution מדריך לפתרון בעיות אפשר למצוא עזרה בפתרון בעיות נפוצות, כמו:

• הבודק לא מקבל התראות באפליקציה
• הבודק מתבקש להיכנס ל-Google יותר מפעם אחת