برنامه های Android را با استفاده از Gradle به آزمایش کنندگان توزیع کنید

با استفاده از افزونه App Distribution Gradle می توانید App Distribution را در روند ساخت Android خود ادغام کنید. این پلاگین به شما اجازه تست خود را و یادداشت انتشار در برنامه مشخص خود را build.gradle فایل، به شما اجازه پیکربندی توزیع انواع ساخت های مختلف و انواع برنامه شما.

این راهنما نحوه توزیع APK به آزمایش کنندگان با استفاده از افزونه App Distribution Gradle را توصیف می کند.

قبل از اینکه شروع کنی

اگر شما در حال حاضر، اضافه فایربیس به پروژه آندروید خود را .

اگر از محصولات Firebase دیگری استفاده نمی کنید ، فقط باید یک پروژه ایجاد کنید و برنامه خود را ثبت کنید. با این حال ، اگر تصمیم دارید در آینده از محصولات اضافی استفاده کنید ، مطمئن شوید که تمام مراحل را در صفحه پیوند داده شده در بالا انجام دهید.

مرحله 1. پروژه Android خود را تنظیم کنید

  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.1.3'
        }
    }
    
  2. در سطح برنامه فایل Gradle خود را (معمولا android/app/build.gradle )، شامل پلاگین توزیع برنامه زیر این افزونه آندروید:

    apply plugin: 'com.android.application'
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: 'com.google.firebase.appdistribution'
    // ...
    
  3. اگر شما پشت یک پراکسی شرکت یا فایروال هستید، اضافه کردن زیر جاوا اموال سیستم را قادر می سازد توزیع برنامه برای آپلود توزیع خود را به فایربیس:

    -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 برنامه شما. فقط درصورتی که افزونه Google Services Gradle را نصب نکنید ، مورد نیاز است. شما می توانید ID برنامه در پیدا google-services.json فایل یا در کنسول فایربیس در صفحه تنظیمات عمومی . ارزش خود را 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

گروه های تستر می خواهید به توزیع می سازد به (نگاه کنید به مدیریت آزمایشکنندگان ). گروهها با استفاده از نام مستعار گروه ، که شما می توانید در زبانه آزمایشکنندگان در کنسول توزیع فایربیس برنامه پیدا کنید.

شما می توانید گروه ها را به عنوان یک لیست مستعار از گروه با کاما جدا کنید:

groups="qa-team, android-testers"

یا می توانید مسیر پرونده ای را که شامل لیستی از اسم مستعار گروه با ویرگول است مشخص کنید:

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

stacktrace را به استثنای کاربر چاپ می کند. این برای رفع اشکال مشکلات مفید است.

مرحله 4. برنامه خود را بین آزمایش کنندگان توزیع کنید

در نهایت، برای بسته بندی برنامه آزمون خود و دعوت تست، ساخت اهداف assemble BUILD-VARIANT و appDistributionUpload BUILD-VARIANT با Gradle لفاف بسته بندی پروژه خود را، که در آن BUILD-VARIANT اختیاری عطر و طعم محصول و ساخت نوع شما در مرحله قبل پیکربندی شده است. برای کسب اطلاعات بیشتر در مورد طعم کالا، و پیکربندی انواع ساخت .

به عنوان مثال، برای توزیع برنامه های خود را با استفاده از 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"

هنگامی که ساخت خود را توزیع کردید ، به مدت 150 روز (پنج ماه) در داشبورد برنامه توزیع کنسول Firebase در دسترس قرار می گیرد. وقتی ساخت 30 روز از انقضا می گذرد ، یک اعلان انقضا هم در کنسول و هم در لیست ساخت تستر شما روی دستگاه آزمایش آنها ظاهر می شود.

آزمایشکنندگان که دعوت نشده است برای تست برنامه دریافت ایمیل دعوت نامه برای شروع، و تست های موجود اطلاعیه ها ایمیل دریافت خواهید کرد که ساخت جدید آماده به آزمون است (خواندن مجموعه تستر تا راهنمای برای دستورالعمل در مورد چگونگی نصب برنامه آزمون). شما می توانید وضعیت هر آزمایش کننده را بررسی کنید-آیا دعوت نامه را پذیرفته اند و آیا برنامه را بارگیری کرده اند-در کنسول Firebase.

گام بعدی

مشاهده codelab برنامه بسته نرم افزاری آندروید به یاد بگیرند که چگونه برای توزیع برنامه منتشر گام بسته نرم افزاری به گام.