הפץ מהדורות של חבילות אפליקציות לבודקים - Codelab

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

image10.png

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

מה תלמד

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

מה אתה צריך

  • 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, לחץ האפליקציה Add.

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

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

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

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

הוסף את התוסף App Distribution Gradle

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

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

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

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

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

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

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

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

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

לדוגמה:

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 לבנות האפליקציה שלך חבילות קובץ:
    $ ./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
    

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

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

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

  1. במכשיר הבדיקה שלך, היכנס לחשבון הדוא"ל של הבוחן ופתח את ההזמנה מ- Firebase.

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

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

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

7. מזל טוב!

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

הצעדים הבאים