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

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

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

אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט iOS.

שלב 1: הפעלת App Distribution Tester API

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

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

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

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

   pod 'FirebaseAppDistribution'

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

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

   Swift

   import FirebaseCore
   import FirebaseAppDistribution
   

   Objective-C

   @import FirebaseCore;
   @import FirebaseAppDistribution;
   

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

   Swift

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

   Objective-C

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

5. אם החלפת השמות מושבתת, מעבירים את כתובות ה-URL הפתוחות ל-SDK של App Distribution בהטמעה של 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: מגדירים התראות בתוך האפליקציה

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

הגדרה בסיסית

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

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

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

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

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

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

בדוגמה הבאה בודקים אם למבצע הבדיקה יש התראות וגישה ל-build חדש, ואם כן, מוצגת תיבת דו-שיח כשה-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: יוצרים ובודקים את ההטמעה

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

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

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