הפץ אפליקציות אנדרואיד לבודקים באמצעות 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="1:1234567890:android:321abc456def7890"

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

testersFile="/path/to/testers.txt"

groups="qa-team, android-testers"

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

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