התריע לבודקים לגבי מהדורות האפליקציה החדשות שלך עם Firebase App Distribution iOS SDK - Codelab

1. סקירה כללית

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

מה תלמד

• כיצד להשתמש בהפצת אפליקציות כדי להפיץ אפליקציה מוקדמת לבודקים חיים
• כיצד לשלב את ה-App Distribution iOS SDK באפליקציה שלך
• כיצד להתריע לבוחן כאשר יש מבנה חדש לפני שחרור מוכן להתקנה
• כיצד להתאים אישית את ה-SDK כך שיתאים לצרכי הבדיקה הייחודיים שלך

מה אתה צריך

• Xcode 12 (או יותר)
• CocoaPods 1.9.1 (או יותר)
• חשבון Apple Developer להפצה אד הוק
• מכשיר iOS פיזי לבדיקה. ( אפליקציית סימולטור iOS תעבוד עבור רוב מעבדת הקוד, אך סימולטורים לא יכולים להוריד גרסאות.)

איך תשתמש במדריך זה?

קרא אותו רק עד הסוף קראו אותו והשלימו את התרגילים

איך תדרג את החוויה שלך בבניית אפליקציות ל-iOS?

טִירוֹן ביניים בקיא

2. צור פרוייקט מסוף Firebase

הוסף פרויקט Firebase חדש

1. היכנס ל-Firebase.
2. במסוף Firebase, לחץ על הוסף פרויקט ולאחר מכן תן שם לפרויקט שלך "Firebase Codelab".

אינך צריך להפעיל את Google Analytics עבור הפרויקט הזה.

3. לחץ על צור פרויקט .

הוסף אפליקציה ל-Firebase

עקוב אחר התיעוד כדי לרשום את האפליקציה שלך ב-Firebase. השתמש ב-"com.google.firebase.codelab.AppDistribution.<your_name>" בתור מזהה החבילה של iOS.

כאשר תתבקש, הורד את קובץ GoogleService-Info.plist של הפרויקט שלך. תצטרך את זה מאוחר יותר.

3. קבל את הפרויקט לדוגמה

הורד את הקוד

התחל בשיבוט הפרויקט לדוגמה.

git clone [e-mail]:googlecodelabs/firebase-appdistribution-ios.git

אם לא התקנת git, אתה יכול גם להוריד את הפרויקט לדוגמה מדף GitHub שלו או על ידי לחיצה על הקישור הזה .

הורד תלות ופתח את הפרויקט ב-Xcode

1. פתח את ה- Podfile באותה ספרייה

cd firebase-appdistribution-ios/start
Open Podfile

2. הוסף את השורה הבאה ל-podfile שלך:

Podfile

pod 'Firebase/AppDistribution'

הפעל pod update בספריית הפרויקט ופתח את הפרויקט ב-Xcode.

pod install --repo-update
xed .

עדכן את מזהה החבילה כך שיתאים לאפליקציית Firebase שלך

בתפריט השמאלי, לחץ פעמיים על AppDistributionExample. לאחר מכן, אתר את הכרטיסייה כללי ושנה את מזהה החבילה כך שיתאים למזהה החבילה של אפליקציית Firebase שלך, אותו ניתן למצוא בהגדרות הפרויקט . זה צריך להיות "com.google.firebase.codelab.AppDistribution.<your_name>"

הוסף את Firebase לאפליקציה שלך

אתר את הקובץ GoogleService-Info.plist שהורדת קודם לכן במערכת הקבצים שלך וגרור אותו לשורש פרויקט Xcode. אתה יכול גם להוריד קובץ זה בכל עת מדף ההגדרות של הפרויקט שלך.

בקובץ AppDistributionExample/AppDelegate.swift ייבוא ​​Firebase בחלק העליון של הקובץ

AppDistributionExample/AppDelegate.swift

import Firebase

ובשיטת didFinishLaunchingWithOptions הוסף קריאה להגדרת Firebase.

AppDistributionExample/AppDelegate.swift

FirebaseApp.configure()

4. הגדר התראות בניה חדשה בתוך האפליקציה עם ה-App Distribution SDK

בשלב זה, תוסיף את Firebase App Distribution SDK לאפליקציה שלך ותציג התראות בתוך האפליקציה לבודקים שלך כאשר יישומים חדשים של האפליקציה שלך זמינים להתקנה. כדי לעשות זאת, ודא שהפעלת את Firebase App Testers API עבור פרויקט "Firebase Codelab" שלך (ב-Google Cloud Console). תצטרך להתחבר עם אותו חשבון ולבחור את הפרויקט הנכון מהתפריט הנפתח בחלק העליון.

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

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

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

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

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

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

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

בקובץ AppDistributionViewController.swift ייבוא ​​Firebase בחלק העליון של הקובץ

AppDistributionViewController.swift

import Firebase

פתח את AppDistributionExample/AppDistributionViewController.swift , והעתק שורות לשיטת viewDidAppear כך:

AppDistributionViewController.swift

 override func viewDidAppear(_ animated: Bool) {
    checkForUpdate()
 }

עכשיו בואו ליישם את שיטת checkForUpdate() .

AppDistributionViewController.swift

  private func checkForUpdate() {
    AppDistribution.appDistribution().checkForUpdate(completion: { [self] release, error in
      var uiAlert: UIAlertController

      if error != nil {
        uiAlert = UIAlertController(title: "Error", message: "Error Checking for update! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
      } else if release == nil {
        uiAlert = UIAlertController(title: "Check for Update", message: "No releases found!!", preferredStyle: .alert)
        uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default))
      } else {
        guard let release = release else { return }

        let title = "New Version Available"
        let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
        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.present(uiAlert, animated: true, completion: nil)
    })
  }

5. בנה והזמן בודקים להוריד את האפליקציה שלך

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

בנה את האפליקציה שלך

כאשר אתה מוכן להפיץ גרסה מוקדמת של האפליקציה שלך לבודקים, בחר "כל מכשיר iOS (arm64)" כיעד בנייה, ומוצר->ארכיון. לאחר יצירת הארכיון, בנה הפצה חתומה עם פרופיל הפצת פיתוח.

כאשר הבנייה מסתיימת, הוא שומר קובץ IPA וכמה קובצי יומן בתיקייה שציינת. אתה מפיץ את קובץ ה-IPA לבודקים שלך בשלבים הבאים.

אם אתה נתקל בבעיות בבניית האפליקציה שלך, עיין במסמכי העיצוב המשותף של אפל לקבלת שלבי פתרון בעיות.

הפץ את האפליקציה שלך לבודקים

כדי להפיץ את האפליקציה שלך לבודקים, העלה את קובץ ה-IPA באמצעות מסוף Firebase:

1. פתח את דף הפצת האפליקציות של מסוף Firebase. בחר את פרויקט Firebase שלך ​​כאשר תתבקש.
2. לחץ על התחל

3. בדף מהדורות, בחר את האפליקציה שברצונך להפיץ מהתפריט הנפתח.

4. גרור את קובץ ה-IPA של האפליקציה שלך למסוף כדי להעלות אותו.
5. בסיום ההעלאה, ציין את קבוצות הבודקים והבודקים הבודדים שברצונך לקבל את ה-build. (הוסף את האימייל שלך כדי לקבל את ההזמנה.) לאחר מכן, הוסף הערות שחרור עבור ה-build. ראה ניהול בודקים למידע נוסף על יצירת קבוצות בודקים.

6. לחץ על הפצה כדי להפוך את ה-build זמין לבודקים.

הערה: ברגע שתפיץ את ה-build שלך, הוא הופך זמין בלוח המחוונים של הפצת אפליקציות של מסוף Firebase למשך 150 ימים (חמישה חודשים). כאשר ה-build הוא 30 יום מתאריך התפוגה, הודעת תפוגה מופיעה הן במסוף והן ברשימת ה-builds של הבוחן שלך במכשיר הבדיקה שלו.

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

לבודקים יש 30 יום לקבל הזמנה לבדוק את האפליקציה לפני שתפוגה. כאשר הזמנה עוברת 5 ימים מתאריך התפוגה, הודעת תפוגה מופיעה במסוף Firebase ליד הבוחן בגרסה. ניתן לחדש הזמנה על ידי שליחתה מחדש באמצעות התפריט הנפתח בשורת הבוחן.

הוסף את עצמך כבוחן לגרסה

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

מכיוון שצירפת את כתובת האימייל שלך, תקבל אימייל מ-Firebase App Distribution המזמין אותך לבדוק את האפליקציה. עכשיו אתה הבוחן הראשון! המשך בקטע שלהלן כדי להתקין כבוחן במכשיר הבדיקה שלך.

רשום את מכשיר הבדיקה שלך

תחילה עליך לרשום את מכשיר הבדיקה שלך כדי להוריד ולבדוק מהדורת אד הוק.

1. במכשיר הבדיקה של iOS שלך, פתח את האימייל שנשלח מ-Firebase App Distribution והקש על הקישור התחל. הקפד לפתוח את הקישור בספארי.
2. באפליקציית האינטרנט של Firebase App Distribution Tester שמופיעה, היכנס עם חשבון Google שלך ​​והקש על קבל הזמנה.

כעת, תראה את הגרסה שהוזמנת אליה.

3. הקש על רשום מכשיר כדי לשתף את ה-UDID שלך עם Firebase כדי שתוכל לעדכן את פרופיל ההקצאה של האפליקציה שלך מאוחר יותר.

4. עקוב אחר ההוראות ועבור להגדרות כדי להוריד את הפרופיל ולשתף את ה-UDID שלך.

הערה: התקנת הפרופיל תיצור גם קישור להפצת אפליקציות במסך הבית שלך.

כעת, כאשר אתה חוזר להפצת אפליקציות, המהדורה מסומנת כעת כ"התקן רשום":

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

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

הצג מידע על הבוחן במסוף

בחזרה בתצוגת המפתח במסוף Firebase, הבוחן יופיע כ"מקובל" תחת המהדורה:

לאחר מכן תקבל גם אימייל כמפתח אם המכשיר שבו הם משתמשים לא כלול כבר בפרופיל ההקצאה. זה יודיע לך על ה-UDID החדש שאתה צריך להוסיף. יש לך גם אפשרות לייצא את כל ה-UDIDs כקובץ טקסט.

1. כדי לייצא את כל ה-UDIDs, פתח את הכרטיסייה בודקים וקבוצות.

2. לחץ על "ייצא Apple UDIDs."

הקובץ צריך להכיל את ה-UDID של מכשיר הבדיקה שלך.

Device ID            Device Name                            Device Platform
1234567890     [e-mail] - iPhone SE 2nd Gen        ios

הערה: כאשר בודקים מקבלים הזמנה לבדוק מבנה שאינו חתום עם פרופיל Enterprise, הם מתבקשים הרשאה לשתף איתך את מזהה המכשיר שלהם. אם הם מסכימים, App Distribution אוספת את ה-UDID מהמכשיר ומודיעה לך על ה-UDID בדוא"ל.

כאשר אתה מקבל אחת מהודעות הדוא"ל האלה, עדכן את פרופיל ההקצאה שלך ב-UDID והפיץ מבנה חדש לבודקים שלך על ידי ביצוע השלבים הבאים:

1. הוסף את המכשירים לפורטל המפתחים של Apple שלך.

• אפשרות 1: ייבא את ה-UDIDs של המכשיר כקובץ CSV. בכרטיסייה בודקים וקבוצות של לוח המחוונים של הפצת אפליקציות, בחר כל הבודקים, ולאחר מכן לחץ על ייצא Apple UDIDs כדי להוריד קובץ CSV. לאחר מכן, ייבא את הקובץ לחשבון המפתח שלך ב-Apple באמצעות האפשרות Register Multiple Devices. עיין בתיעוד של אפל למידע נוסף. שים לב שחשבון המפתח שלך ב-Apple עשוי לאפשר לך לייבא רק מספר מוגבל של מכשירים בשנה.
• אפשרות 2: איסוף והזן את UDIDs בדוא"ל. בדף הוסף התקנים של פורטל המפתחים של Apple, רשום את ה-UDID החדש שצוין בדוא"ל שקיבלת.

2. הוסף את המכשירים הרשומים לפרופיל ההקצאה שלך.
3. הורד את פרופיל האספקה ​​והשתמש בו כדי לבנות מחדש את האפליקציה שלך. אם אתה בונה מחדש רק כדי לעדכן את המכשירים הרשומים, אל תעדכן את מספר ה-build או את הגרסה.
4. הפץ מחדש את האפליקציה שלך ממסוף Firebase או מ-CLI. אם כבר הפצת מבנה עם אותו מספר גירסה וגירסה, רק משתמשים של מכשירים שנרשמו לאחרונה יקבלו הודעות אימייל.

הורד את המהדורה ממכשיר הבדיקה

כעת במהדורה יש את ה-UDID של מכשיר הבדיקה, כך שמכשיר הבדיקה יכול להוריד ולהתקין את האפליקציה. הפצת אפליקציות שולחת אימייל לבודקים כאשר ה-UDID שלהם מתווסף למהדורה חדשה.

1. במכשיר הבדיקה, חזור לאפליקציית האינטרנט של App Distribution Tester באמצעות הקישור במייל, או הסמל במסך הבית של המכשיר.

כאשר אתה מנווט לאפליקציית UDID codelab, אתה יכול לראות שהמהדורה מוכנה להורדה.

2. אם אתה משתמש במכשיר פיזי, לחץ על הורד ולאחר מכן התקן והפעל את האפליקציה!
3. כשהאפליקציה תתחיל, היא תבקש ממך להפעיל התראות בנייה חדשה. בחר "הפעל"

4. לאחר מכן הוא יבקש ממך להיכנס. לחץ על "המשך.

5. היכנס עם חשבון הבוחן שלך.

6. אתה תוחזר לאפליקציה. לא תצטרך להתחבר או לקבל התראות בפעם הבאה שתפעיל את האפליקציה.

הערה: הורדות מהדורה פועלות רק במכשירים פיזיים. אם אתה משתמש בסימולטור, ההורדה לא תעבוד, אבל אתה עדיין יכול לוודא שההגדרה עבדה על ידי אימות שכפתור "הורד" מופיע בלקוח האינטרנט של App Distribution.

הפיצו עדכון לבודקים שלכם

1. עדכן את מספר ה-build שלך ל-"2".

2. בחר "כל מכשיר iOS (arm64)" כיעד בנייה, ומוצר->ארכיון. לאחר יצירת הארכיון, בנה הפצה חתומה עם פרופיל הפצת פיתוח.
3. כאשר הבנייה מסתיימת, הוא שומר קובץ IPA וכמה קובצי יומן בתיקייה שציינת. העלה את ה-IPA החדש הזה למסוף Firebase שלך, הוסף שוב את האימייל שלך כבוחן והפצ.

התראות בניית בדיקה

1. ודא שסגרת את האפליקציה אם היא הייתה פתוחה. הפעל מחדש את האפליקציה.
2. כאשר האפליקציה מופעלת מחדש, אתה אמור לקבל התראה "גרסה חדשה זמינה".

3. לחץ על "עדכן" כדי לקבל את הגרסה העדכנית ביותר.
4. לחץ על "התקן" במסך הבא.

5. מזל טוב! הצלחת לעדכן את האפליקציה שלך עם ההתראות המובנות.

6. התאם אישית את הכניסה של הבוחן

השיטות signInTester/signOutTester ו- isTesterSignedIn נותנות לך גמישות רבה יותר בהתאמה אישית של חווית הכניסה של הבוחן שלך, כך שהיא תוכל להתאים טוב יותר למראה והתחושה של האפליקציה שלך.

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

הבה נשבית את בדיקת העדכונים באופן אוטומטי ב- viewDidAppea r על ידי הערה על קריאת checkForUpdate() .

AppDistributionViewController.swift

 override func viewDidAppear(_ animated: Bool) {
    // checkForUpdate()
 }

במקום זאת, בואו נקרא checkForUpdate() ב- checkForUpdateButtonClicked( ).

 @objc func checkForUpdateButtonClicked() {
    checkForUpdate()
 }

כעת, הבה ניישם את השיטה signInOutButtonClicked() שלנו שתכניס את המשתמש אם הוא יצא מהחשבון, או תצא מהמשתמש אם הוא כבר מחובר.

AppDistributionViewController.swift

 @objc func signInOutButtonClicked() {
    if isTesterSignedIn() {
      AppDistribution.appDistribution().signOutTester()

      self.configureCheckForUpdateButton()
      self.configureSignInSignOutButton()
      self.configureSignInStatus()

    } else {
      AppDistribution.appDistribution().signInTester(completion: { error in
        if error == nil {
          self.configureCheckForUpdateButton()
          self.configureSignInSignOutButton()
          self.configureSignInStatus()
        } else {
          let uiAlert = UIAlertController(title: "Custom:Error", message: "Error during tester sign in! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
          uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default) {
            _ in
          })

          self.present(uiAlert, animated: true, completion: nil)
        }
      })
    }
  }

לבסוף בואו ליישם את שיטת isTesterSignedI n.

AppDistributionViewController.swift

 private func isTesterSignedIn() -> Bool {
    return AppDistribution.appDistribution().isTesterSignedIn
 }

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

7. מזל טוב!

בנית את התכונה "הצגת התראות בתוך האפליקציה" באפליקציה באמצעות Firebase App Distribution iOS SDK.

מה שכיסינו

• הפצת אפליקציות Firebase
• Firebase App Distribution New Alerts iOS SDK

הצעדים הבאים

• שימוש בתוסף Fastlane
• שימוש בכלי CLI

למד עוד

• Firebase.google.com
• איך טוויטר משתמש ב- iOS SDK חדש

יש שאלה?

• Stackoverflow 'firebase-app-distribution '
• קהילת Firebase רפה בערוץ #app-distribution

דווח על בעיות

• בעיות Github