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

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

מדריך זה מתאר כיצד להפיץ חבילות APK לבודקים באמצעות התוסף App Distribution Gradle.

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

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

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

שלב 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="APK"
                    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 של האפליקציה שלך. נדרש רק אם אין לך את הפלאגין Gradle Services של Google מותקן. אתה יכול למצוא את האפליקציה מזהה את 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

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

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

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

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

./gradlew assembleRelease appDistributionUploadRelease

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

export FIREBASE_TOKEN=1/a1b2c3d4e5f67890
./gradlew --stop // Only needed for environment variable changes
./gradlew assembleRelease appDistributionUploadRelease

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

./gradlew bundleDebug appDistributionUploadDebug
    -PappDistribution-artifactType="APK"

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

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

השלב הבא

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