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

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

image10.png

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

מה תלמד

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

מה אתה צריך

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

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

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

    image8.png
  3. (אופציונלי) כאשר תתבקש, הפעל את Google Analytics.
  4. השלם את השלבים הנותרים ולאחר מכן לחץ על צור פרויקט .

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

  1. במסוף Firebase, לחץ על הוסף אפליקציה .

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

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

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

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

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

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

  1. בקובץ Gradle ברמת הפרויקט ( android/build.gradle ), הוסף את הפלאגין App Distribution Gradle ואת מאגר Maven של גוגל.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            mavenCentral()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. בקובץ Gradle ברמת האפליקציה ( android/app/build.gradle ), הוסף את הפלאגין App Distribution:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. אם אתה מאחורי פרוקסי ארגוני או חומת אש, הוסף את מאפיין מערכת Java הבא שמאפשר להפצת אפליקציות להעלות את ההפצות שלך ל-Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

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

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

  1. הפעל את הפקודה הבאה בשורש פרויקט האנדרואיד שלך:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. כאשר הפקודה מדפיסה קישור אימות, פתח אותו בדפדפן. כשתתבקש, היכנס לחשבון Google שלך ​​והעניק הרשאה לגשת לפרויקט Firebase שלך. הפקודה Gradle מדפיסה אסימון רענון, שבו הפלאגין App Distribution משתמש כדי לאמת עם Firebase.
  3. הגדר את משתנה הסביבה FIREBASE_TOKEN לאסימון מהשלב הקודם:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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

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

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

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

לדוגמה:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

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

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

  1. הפעל את משימת bundle Variant Gradle כדי לבנות את קובץ ה-App Bundle שלך:
    $ ./gradlew :base:bundleRelease
    
  2. אתר את החבילה בספריית הבנייה של האפליקציה שלך (מיקום ברירת המחדל הוא 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.

    image6.png
  2. היכנס עם חשבון Google שלך ​​וקבל את ההזמנה לבדוק את המהדורה המופצת. כאופציה, אתה יכול גם להוריד את Firebase App Tester , שמונע הוספת מהדורות שהורדו לתיקיית Downloads של המכשיר שלך. הוא גם מציג מידע נוסף על מהדורות, כגון התקדמות ההורדה וגרסת השחרור.

    image9.png
  3. הקש על הורד במהדורה כדי להתקין אותה מחנות Play.
  4. כאשר תתבקש, השלם את השלבים הנותרים כדי לאפשר שיתוף אפליקציות פנימי (ההוראות מוצגות במכשיר הבדיקה שלך ויש להשלים רק פעם אחת).

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

7. מזל טוב!

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

הצעדים הבאים