הודע לבודקים על בנייה חדשה

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

לפני שאתה מתחיל

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

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

  1. בחר את הפרויקט שלך ב- Google Cloud Console .

  2. תחת Firebase App Testers API , לחץ על הפעל .

שלב 2 : הוסף הפצת אפליקציות לאפליקציה שלך

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

    pod 'FirebaseAppDistribution'

  2. בספריה של ה-podfile שלך, הפעל את pod install ולאחר מכן פתח את קובץ ה-. .xcworkspace שנוצר.

  3. קודד את מזהה Google app שלך ( נדרש רק עבור iOS גרסאות 9 ו-10 ):

    קודד את מזהה Google app שלך

    הוסף את סכימת ה- appdistribution-<encoded-google-app-id> על-ידי הכללת קטע ה- Info.plist file שלך (עיין בתיעוד של Apple לקבלת הוראות כיצד להוסיף את סכימת ה-URL ב-Xcode):

    <key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>appdistribution-<encoded-google-app-id></string>
        </array>
    </dict>
</array>

    לאחר מכן, קודד את מזהה Google app שלך על ידי החלפת נקודתיים (:) במקפים (-). שים לב שמזהה Google app שלך נמצא GoogleService-Info.plist שלך. לדוגמה, אם מזהה Google app שלך הוא:

    7:77777777777:ios:123456789

    מזהה Google app המקודד שלך הוא:

    7-77777777777-ios-123456789

  4. ייבא את מודול Firebase במבנה App שלך או ב- UIApplicationDelegate :

    מָהִיר

    import FirebaseCore

    Objective-C

    @import FirebaseCore;

  5. הגדר מופע משותף של FirebaseApp , בדרך כלל בשיטת האתחול של App או בשיטת application(_:didFinishLaunchingWithOptions:) של האפליקציה שלך:

    מָהִיר

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

    Objective-C

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

  6. לבסוף, הידור מחדש את האפליקציה שלך.

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

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

תצורה בסיסית

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

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

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

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

  3. בודק גירסה חדשה זמינה עבור הבוחן להתקין.

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

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

מָהִיר

הערה: מוצר זה אינו זמין ביעדי 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 שלו, כך שתוכל לבחור להציג את ממשק הכניסה שלך רק עבור בודקים שעדיין לא התחברו. לאחר שהבודק נכנס לחשבון, תוכל לאחר מכן קרא checkForUpdate() כדי לבדוק אם לבודק יש גישה למבנה חדש.

מָהִיר

הערה: מוצר זה אינו זמין ביעדי 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 .

שלב 4 : בנה ובדוק את היישום שלך

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

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

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