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

برنامه های 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.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. اگر شما پشت یک پراکسی شرکت یا فایروال هستید، اضافه کردن زیر جاوا اموال سیستم را قادر می سازد توزیع برنامه برای آپلود توزیع خود را به فایربیس:

    -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. برنامه خود را بین آزمایش کنندگان توزیع کنید

  1. در نهایت، برای بسته بندی برنامه آزمون خود و دعوت تست، ساخت اهداف 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
    
  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 : مسیر به گوگل فایل اعتبار خدمات خود را. این همان استدلالی است که توسط عمل بارگذاری استفاده می شود.

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

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

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

گام بعدی

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