Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

הפץ אפליקציות אנדרואיד לבודקים באמצעות 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. הפץ את האפליקציה שלך לבודקים

  1. לבסוף, כדי לארוז אפליקצית לבדיקה ומזמין בודקים, לבנות את מטרות 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
    
  2. אתה יכול גם לעקוף את ערכי הקבועים שלך build.gradle הקובץ על ידי העברת ארגומנטים משורת הפקודה בצורה של -PappDistribution-<property-name>=<property-value> . לדוגמה:

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

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

      ./gradlew bundleDebug appDistributionAddTesters
          --emails="anothertester@email.com, moretesters@email.com"
       ./gradlew appDistributionRemoveTesters
           --emails="anothertester@email.com, moretesters@email.com"
      

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

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

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

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

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

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

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

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

השלב הבא

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