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

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

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

מה תלמד

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

מה אתה צריך

• גרסת Android Studio האחרונה.
• קוד לדוגמה.
• מכשיר בדיקה עם Android 4.4+ ושירותי Google Play 9.8 ואילך, או אמולטור עם שירותי Google Play 9.8 ואילך.
• אם משתמשים במכשיר, כבל חיבור.

2. קבל את הקוד לדוגמה

שכבו את מאגר GitHub משורת הפקודה.

$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git

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

3. ייבא את אפליקציית המתנע

מ-Android Studio, בחר את ספריית codelab-appdistribution-android/start ( ) מהורדת הקוד לדוגמה ( קובץ > פתח > .../codelab-appdistribution-android/start).

כעת אתה אמור לפתוח את פרויקט ההתחלה ב-Android Studio.

4. צור פרויקט של מסוף Firebase

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

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

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

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

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

רשום את האפליקציה שלך ב-Firebase . השתמש ב-"com.google.firebase.appdistributioncodelab" כשם החבילה.

הוסף קובץ google-services.json לאפליקציה שלך

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

1. לחץ על הורד את google-services.json כדי להשיג את קובץ התצורה של Firebase Android שלך.
2. העתק את הקובץ google-services.json לספריית app בפרויקט שלך.
3. לאחר הורדת הקובץ תוכל לדלג על השלבים הבאים המוצגים בקונסולה (הם כבר בוצעו עבורך בפרויקט build-android-start).

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

1. בתפריט השמאלי (Project Tab), ודא שאתה נמצא בתצוגת "Android" ואתר את הכרטיסייה "Gradle Scripts" ופתח את קובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle.kts ).
2. שנה את מאפיין applicationId כך שיתאים למזהה האפליקציה של אפליקציית Firebase שלך. זה צריך להיות "com.google.firebase.appdistributioncodelab"

סנכרן את הפרויקט שלך עם קבצי Gradle

כדי להבטיח שכל התלות זמינות לאפליקציה שלך, סנכרן את הפרויקט שלך עם קבצי Gradle, בחר קובץ > סנכרן פרויקט עם קבצי Gradle מסרגל הכלים של Android Studio.

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

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

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

SDK להפצת אפליקציות ל-Android מספקת שתי דרכים להגדרת התראות בנייה בתוך האפליקציה עבור הבודקים שלך:

• תצורת התראה בסיסית, שמגיעה עם תיבת דו-שיח בנויה מראש להצגה לבודקים.
• תצורת התראה מתקדמת, המאפשרת לך להתאים אישית את ממשק המשתמש שלך (UI).

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

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

הפעלת התראות היא תהליך חד פעמי במכשיר הבדיקה שנמשך לאורך כל העדכונים של האפליקציה שלך. ההתראות נשארות מופעלות במכשיר הבדיקה עד שהאפליקציה תוסר או עד שנקראת שיטת signOutTester .

2. בודק גירסה חדשה זמינה עבור הבוחן להתקין.
3. מציג התראה בנויה מראש המנחה את הבוחן להוריד את המהדורה האחרונה.
4. בודק את סוג הבנייה החדש לפני המשך העדכון:
5. אם המבנה החדש הוא App Bundle (AAB), מפנה את הבוחן לחנות Play כדי להשלים את תהליך העדכון.
6. אם ה-build החדש הוא APK, ה-SDK מוריד את ה-build החדש ברקע ומנחה את הבוחן להתקין את ה-build החדש עם סיום ההורדה. ה-SDK שולח הודעות על התקדמות הורדה למשתמש באמצעות NotificationManager. אתה יכול להוסיף מחוון התקדמות משלך על ידי צירוף מטפל onProgressUpdate למשימה updateIfNewReleaseAvailable .

אתה יכול לקרוא ל- updateIfNewReleaseAvailable() בכל נקודה באפליקציה שלך. לדוגמה, אתה יכול לקרוא updateIfNewReleaseAvailable() במהלך השיטה onResume() של ה-MainActivity:

פתח את MainActivity.kt , וצור את השיטה onResume() כך:

MainActivity.kt

override fun onResume() {
    super.onResume()
    checkForUpdate()
}

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

MainActivity.kt

   private fun checkForUpdate() {
        firebaseAppDistribution.updateIfNewReleaseAvailable()
            .addOnProgressListener { updateProgress ->
                // (Optional) Implement custom progress updates in addition to
                // automatic NotificationManager updates.
            }
            .addOnFailureListener { e ->
                if (e is FirebaseAppDistributionException) {
                    // Handle exception.
                }
            }
    }

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

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

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

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

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

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

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

3. לחץ על התחל

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

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

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

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

לקבל אתההזמנה

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

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

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

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

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

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

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

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

1. עדכן את versionName שלך ​​ל-"1.1" ואת versionCode ל-2 בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle).
2. בנה את ה-APK שלך באמצעות התהליך הרגיל שלך. עליך לחתום על ה-APK עם מפתח ניפוי הבאגים או מפתח חתימת האפליקציה שלך.
3. העלה את ה-APK החדש הזה למסוף Firebase שלך, הוסף שוב את האימייל שלך כבוחן ולחץ על הפצ .

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

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

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

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

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

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

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

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

MainActivity.kt

override fun onResume() {
        super.onResume()
        //checkForupdate()
    }

במקום זאת, checkForUpdate() כבר נוסף ב-OnClickListener של updatebutton.

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

MainActivity.kt

    private fun signIn() {
        if (isTesterSignedIn()) {
            firebaseAppDistribution.signOutTester()
            configureUpdateButton()
            configureSigninButton()
        } else {
            firebaseAppDistribution.signInTester()
        }
    }

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

MainActivity.kt

    private fun isTesterSignedIn() : Boolean {
        return firebaseAppDistribution.isTesterSignedIn
    }

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

8. מזל טוב!

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

מה שכיסינו

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

הצעדים הבאים

• שימוש בתוסף Fastlane
• שימוש בכלי CLI
• שימוש בדרגה

למד עוד

• Firebase.google.com

יש שאלה?

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

דווח על בעיות

• בעיות Github