הפצת גרסאות App Bundle לבודקים - Codelab

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

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

מה תלמד

• כיצד לקשר את אפליקציית Firebase שלך ​​ל-Google Play
• כיצד לארוז ולבנות את האפליקציה שלך כ-App Bundle
• כיצד ליצור מהדורה ולשתף אותה עם בודקים חיים
• כיצד להוריד ולבדוק מהדורות חדשות כבוחן

מה אתה צריך

• גרסת Android Studio האחרונה
• קובץ חבילה חתום שיצרת מ-Android Studio
• חשבון מפתח ב-Google Play שאתה הבעלים או המנהל שלו
• האפליקציה שלך ב-Google Play מוגדרת במרכז השליטה של ​​אפליקציית Google Play , ויש לה את הסטטוס הבא:
  • האפליקציה מופצת לאחד ממסלולי Google Play (בדיקות פנימיות, בדיקות סגורות, בדיקות פתוחות או הפקה).
  • סקירת האפליקציה ב-Google Play הושלמה והאפליקציה פורסמה. האפליקציה שלך מתפרסמת אם עמודת סטטוס האפליקציה מציגה את אחד מהסטטוסים הבאים: בדיקה פנימית (לא טיוטה בדיקה פנימית), בדיקה סגורה, בדיקה פתוחה או הפקה.
• כתובת אימייל שבה תוכל להשתמש כבוחן כדי לקבל הזמנות לבנייה חדשה מ-Firebase

2. צור פרויקט Firebase

1. היכנס ל- Firebase .
2. במסוף Firebase, לחץ על הוסף פרויקט ולאחר מכן תן שם לפרויקט שלך "AppBundlesCodelab". זכור את מזהה הפרויקט עבור פרויקט Firebase שלך. אם לא תערוך את מזהה הפרויקט, Firebase מקצה באופן אוטומטי מזהה ייחודי לפרויקט שלך.
   
   
3. (אופציונלי) כאשר תתבקש, הפעל את Google Analytics.
4. השלם את השלבים הנותרים ולאחר מכן לחץ על צור פרויקט .

הוסף את חבילת האפליקציות שלך לפרויקט

1. במסוף Firebase, לחץ על הוסף אפליקציה .
   
   
2. בעת רישום האפליקציה שלך, הקפד להשתמש באותו שם חבילה כמו האפליקציה שהועלתה לחשבון המפתח שלך ב-Google Play. לבסוף, לחץ על הרשמה אפליקציה .
3. השלם את השלבים הנותרים כדי להוסיף את קובץ התצורה של האפליקציה שלך Firebase ( google-services.json ) לאפליקציה שלך. שים לב שעבור Android, להפצת אפליקציות אין Firebase SDK להוספה לאפליקציה שלך.
4. לחץ על המשך למסוף .

קישור לגוגל פליי

1. במסוף Firebase, עבור אל הגדרות הפרויקט שלך.
   
   
2. בכרטיסייה אינטגרציות , לחץ על קישור בכרטיס Google Play .
3. עקוב אחר ההוראות שעל המסך כדי להפעיל את שילוב הפצת האפליקציות, ולאחר מכן בחר את אפליקציית Firebase החדשה שנוצרה כדי לקשר ל-Google Play.

כעת, לאחר שהשלמת את השלבים האלה, אפליקציית Firebase שלך ​​תקושר לאפליקציה שלך בחשבון המפתח שלך ב-Google Play כל עוד שמות החבילות של האפליקציות תואמות.

3. הוסף הפצת אפליקציות לפרויקט שלך

הוסף את הפלאגין App Distribution Gradle

כעת, תשתמש ב-Android Studio כדי להוסיף הפצת אפליקציות והפלאגין Gradle שלה לאפליקציה שלך.

1. בקובץ Gradle ברמת הפרויקט ( android/build.gradle.kts ), הוסף את הפלאגין App Distribution Gradle לגוש plugins .

   plugins {
        //...
   
        // Add the App Distribution Gradle plugin
        id("com.google.firebase.appdistribution") version "4.0.0" apply false
   }
   

2. בקובץ ההגדרות Gradle ברמת הפרויקט ( android/settings.gradle.kts ), הוסף את מאגר Maven של גוגל לבלוק pluginManagement .

    pluginManagement {
        // Check that you have Google's Maven repository (if not, add it).
        repositories {
            google()
            mavenCentral()
        }
    }
   

3. בקובץ Gradle ברמת האפליקציה ( android/app/build.gradle.kts ), הוסף את הפלאגין App Distribution לגוש plugins .

   plugins {
        //...
   
        // Add the App Distribution plugin
        id("com.google.firebase.appdistribution")
   }
   

4. אם אתה מאחורי פרוקסי ארגוני או חומת אש, הוסף את מאפיין מערכת Java הבא שמאפשר להפצת אפליקציות להעלות את ההפצות שלך ל-Firebase:

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

אמת את פרויקט Firebase שלך

לפני שתוכל להשתמש בתוסף Gradle, תצטרך לאמת את פרויקט Firebase שלך. עבור מעבדת קוד זה, תיכנס לחשבון Google שלך ​​באמצעות Firebase CLI .

הפעל את הפקודה הבאה בשורש פרויקט האנדרואיד שלך:

~/your-android-project$ firebase login

תיעוד ההפניה מכיל פרטים נוספים.

4. הגדר את מאפייני החבילה שלך ב-Android Studio

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

ב- app/build.gradle.kts שלך, הוסף קטע firebaseAppDistribution וכלול את הפרמטרים הבאים:

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

לדוגמה:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

כאופציה, אתה יכול גם לעקוף את הערכים שהוגדרו ב- build.gradle.kts שלך על ידי העברת ארגומנטים של שורת הפקודה בצורה של -PappDistribution- property-name = property-value .

5. בנה והפצת מהדורה

1. הפעל את משימת bundle Variant Gradle כדי לבנות את קובץ ה-App Bundle שלך:

   $ ./gradlew :base:bundleRelease
   

2. אתר את החבילה בספריית ה-build של האפליקציה שלך (מיקום ברירת המחדל הוא app/build/outputs/bundle/release ).
3. כדי להפיץ את המהדורה, בנה את היעדים bundleRelease ו- appDistributionUploadRelease עם מעטפת Gradle של הפרויקט שלך. כלול את אסימון Firebase (זה שקיבלת בשלב 3: הוסף הפצת אפליקציות לאפליקציה שלך).

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

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

6. הורד ובדוק את הגרסה שלך

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

1. במכשיר הבדיקה שלך, היכנס לחשבון הדוא"ל של הבוחן ופתח את ההזמנה מ-Firebase.
   
   
2. היכנס עם חשבון Google שלך ​​וקבל את ההזמנה לבדוק את המהדורה המופצת. כאופציה, תוכל גם להוריד את Firebase App Tester , שמונע הוספת מהדורות שהורדת לתיקיית Downloads של המכשיר שלך. הוא גם מציג מידע נוסף על מהדורות, כגון התקדמות ההורדה וגרסת השחרור.
   
   
3. הקש על הורד במהדורה כדי להתקין אותה מחנות Play.
4. כשתתבקש, השלם את השלבים הנותרים כדי לאפשר שיתוף אפליקציות פנימי (ההוראות מוצגות במכשיר הבדיקה שלך ויש להשלים רק פעם אחת).

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

7. מזל טוב!

זה עתה השתמשת ב-Firebase App Distribution כדי להעלות חבילת אפליקציות ולהפיץ מהדורה לבודקים.

הצעדים הבאים

• עבור אל תיעוד הפצת האפליקציות כדי ללמוד עוד על איך לנהל בודקים עבור הגרסה שלך.
• ראה בנייה ובדיקה של Android App Bundle לקבלת מידע על כלים אחרים שבהם אתה יכול להשתמש כדי לפרוס את האפליקציה שלך.