הפץ אפליקציות אנדרואיד לבודקים באמצעות Gradle

אתה יכול לשלב את הפצת אפליקציות בתהליך הבנייה שלך באנדרואיד באמצעות הפלאגין App Distribution Gradle. התוסף מאפשר לך לציין בודקים והערות שחרור שלך באפליקצית build.gradle קובץ, ומאפשרים לך להגדיר הפצות עבור סוגים שונים לבנות והגירסות של האפליקציה שלך.

מדריך זה מתאר כיצד להפיץ חבילות של Android App Bundles (AABs) לבודקים באמצעות הפלאגין App Distribution Gradle.

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

על הפצת חבילות אנדרואיד App Bundles

הפצת אפליקציות משתלבת עם שירות שיתוף האפליקציות הפנימי של Google Play כדי לעבד את ה-AABs שאתה מעלה ולהגיש חבילות APK המותאמות לתצורות המכשירים של הבודקים שלך. כאשר אתה מפיץ AABs, אתה יכול:

  • הפעל חבילות APK מותאמות (מוגשות על ידי Google Play) המותאמות למכשירים של הבודקים שלך.
  • חשוף וניפוי באגים של בעיות ספציפיות למכשיר.
  • חבילת היישומים לבדוק תכונות כמו משלוח Feature Play ו- Play הצגת הנכס
  • צמצם את גודל ההורדות עבור הבודקים שלך.

לפני שאתה מתחיל

  1. אם לא עשית זאת עדיין, להוסיף Firebase לפרויקט Android שלך . בסוף זרימת העבודה הזו, תהיה לך אפליקציית Firebase Android בפרויקט Firebase שלך.

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

  2. כדי ליצור קישור Firebase ל-Google Play ולהעלות AABs, ודא שהאפליקציה שלך עומדת בדרישות הבאות:

    • האפליקציה ב-Google Play ואפליקציית Firebase Android רשומות שניהם באותו שם חבילה.

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

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

  3. קשר את אפליקציית Firebase Android שלך לחשבון המפתח שלך ב-Google Play:

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

    2. על הכרטיס של Google Play, לחץ על קשר.
      אם כבר יש לך קישורים אל Google Play, לחץ על ניהול במקום.

    3. עקוב אחר ההוראות שעל המסך כדי להפעיל את שילוב הפצת האפליקציות ובחר אילו אפליקציות Firebase Android לקשר ל-Google Play.

    למידע נוסף על מקשר אל Google Play .

שלב 1. הגדר את פרויקט האנדרואיד שלך

  1. בשנת ברמת הקובץ פרויקט Gradle שלך (בדרך כלל android/build.gradle ), להוסיף את תוסף חלוקת היישומים כתלות buildscript:

    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.2.0'
        }
    }
    
  2. בקובץ Gradle ברמת היישום שלך (בדרך כלל android/app/build.gradle ), כוללים את תוסף חלוקת היישומים מתחת תוסף אנדרואיד:

    apply plugin: 'com.android.application'
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: 'com.google.firebase.appdistribution'
    // ...
    
  3. אם אתה עובד מאחורי פרוקסי או חומת אש ארגונית, להוסיף את הדברים הבאים רכוש מערכת ג'אווה המאפשר הפצה ליישום להעלות הפצות שלך Firebase:

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

שלב 2. אימות באמצעות Firebase

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

שלב 3. הגדר את מאפייני ההפצה שלך

  1. בשינה שלך app/build.gradle הקובץ, חלוק יישומים להגדיר על ידי הוספה לפחות אחת firebaseAppDistribution סעיף. לדוגמא, כדי להפיץ את release לבנות כדי בודקים:

    android {
    
        // ...
    
        buildTypes {
            release {
                firebaseAppDistribution {
                    artifactType="AAB"
                    releaseNotesFile="/path/to/releasenotes.txt"
                    testers="ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }
    
        // ...
    }
    
  2. חלוקת היישומים ניתן להגדיר עבור סוגים לבנות וטעמים המוצר . לדוגמה, כדי להפיץ debug ו release בונה "דמו" ו "מלא" טעמים המוצר:

    android {
    
        // ...
    
        buildTypes {
            debug {...}
            release {...}
        }
    
        flavorDimensions "version"
        productFlavors {
          demo {
              dimension "version"
              firebaseAppDistribution {
                  releaseNotes="Release notes for demo version"
                  testers="demo@testers.com"
              }
          }
          full {
              dimension "version"
              firebaseAppDistribution {
                  releaseNotes="Release notes for full version"
                  testers="full@testers.com"
              }
          }
        }
    
        // ...
    }
    
  3. השתמש בפרמטרים הבאים כדי להגדיר את ההפצה:

פרמטרי בניית הפצת אפליקציות
appId

מזהה האפליקציה של האפליקציה שלך ב-Firebase. נדרש רק אם התוסף של Google Services Gradle לא מותקן אצלך. אתה יכול למצוא את האפליקציה מזהה את google-services.json הקובץ או במסוף Firebase על דף ההגדרות הכלליות . השווי ב שלך build.gradle הקובץ עוקף את תפוקת הערך מן google-services תוסף.

appId="1:1234567890:android:321abc456def7890"
serviceCredentialsFile

הנתיב לקובץ JSON המפתח הפרטי של חשבון השירות שלך. נדרש רק אם אתה משתמש באימות חשבון שירות.

artifactType

מציין את סוג הקובץ של האפליקציה שלך. ניתן להגדיר כ "AAB" או "APK" .

apkPath

פרמטר זה הוצא כעת משימוש. השתמש artifactPath במקום.

artifactPath

נתיב מוחלט לקובץ APK או AAB שברצונך להעלות.

releaseNotes או releaseNotesFile

הערות גרסה עבור המבנה הזה.

אתה יכול לציין את הערות השחרור ישירות או את הנתיב לקובץ טקסט רגיל.

testers או testersFile

כתובות הדוא"ל של הבודקים שאליהם ברצונך להפיץ לבנות.

אתה יכול לציין את הבודקים כרשימה מופרדת בפסיקים של כתובות דוא"ל:

testers="ali@example.com, bri@example.com, cal@example.com"

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

testersFile="/path/to/testers.txt"
groups או groupsFile

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

אתה יכול לציין את הקבוצות כרשימה מופרדת בפסיקים של כינויים של קבוצות:

groups="qa-team, android-testers"

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

groupsFile="/path/to/tester-groups.txt"
stacktrace

מדפיס את ה-stacktrace עבור חריגים של משתמשים. זה מועיל בעת איתור באגים.

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

  1. לבסוף, כדי לארוז אפליקצית לבדיקה ומזמין בודקים, לבנות את מטרות BUILD-VARIANT ו appDistributionUpload BUILD-VARIANT עם עטיפת Gradle של הפרויקט שלך, איפה BUILD-VARIANT הוא טעם המוצר האופציונלי לבנות הסוג שקבע בשלב הקודם. לקבלת מידע נוסף על טעמים המוצר, לראות גרסאות לבנות Configure .

    לדוגמה, כדי להפיץ את האפליקציה באמצעות release גרסה לבנות, להפעיל את הפקודה הבאה:

    ./gradlew bundleRelease appDistributionUploadRelease
    

    לחלופין, אם אתה מאומת באמצעות שלך לחשבון Google ולא לספק אישורים בקובץ לבנות Gradle שלך, כולל את FIREBASE_TOKEN משתנית:

    export FIREBASE_TOKEN=1/a1b2c3d4e5f67890
    ./gradlew --stop // Only needed for environment variable changes
    ./gradlew bundleRelease appDistributionUploadRelease
    
  2. אתה יכול גם לעקוף את ערכי הקבועים שלך build.gradle הקובץ על ידי העברת ארגומנטים משורת הפקודה בצורה של -PappDistribution-<property-name>=<property-value> . לדוגמה:

    • כדי להעלות בניית ניפוי באגים להפצת אפליקציות:

      ./gradlew bundleDebug appDistributionUploadDebug
          -PappDistribution-artifactType="AAB"
      
    • כדי להזמין בודקים נוספים או להסיר בודקים קיימים מפרויקט Firebase שלך:

      ./gradlew appDistributionAddTesters
          --projectNumber=<project_number>
          --emails="anothertester@email.com, moretesters@email.com"
      ./gradlew appDistributionRemoveTesters
          --projectNumber=<project_number>
          --emails="anothertester@email.com, moretesters@email.com"
      

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

    ניתן גם לציין בודקים באמצעות --file="/path/to/testers.txt" במקום --emails .

    appDistributionAddTesters ו appDistributionRemoveTesters המשימות גם לקבל את הטיעונים הבאים:

    • projectNumber : מספר הפרוייקט Firebase שלך.

    • serviceCredentialsFile : נתיב קובץ אישורי שירות Google שלך. זהו אותו ארגומנט המשמש את פעולת ההעלאה.

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

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

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

השלב הבא

בקר codelab את חבילת היישומים Android ללמוד איך להפיץ את האפליקציה צעד משחרר צרור אחר צעד.