نسخه های بسته نرم افزاری برنامه را به آزمایش کنندگان توزیع کنید - Codelab

image10.png

در این Codelab ، شما می آموزید که چگونه نسخه های Bundle برنامه Android را با استفاده از Firebase App Distribution و افزونه Gradle آن به آزمایش کنندگان توزیع کنید. برنامه توزیع یک مرکز اصلی برای مدیریت نسخه های پیش از انتشار برنامه و آزمایشگرانی است که برای هر نسخه از آنها دعوت می کنید.

آنچه خواهید آموخت

  • چگونه پروژه Firebase خود را به حساب Google Play خود متصل کنیم
  • چگونه می توان یک برنامه را بین Firebase و Google Play پیوند داد
  • نحوه بسته بندی و ساخت برنامه خود به عنوان بسته نرم افزاری برنامه
  • نحوه ایجاد نسخه منتشر شده و اشتراک آن با آزمایش کنندگان زنده
  • چگونه می توان نسخه های جدید را به عنوان تست کننده بارگیری و تست کرد

آنچه شما نیاز دارید

  • Android Studio v4.0 +
  • یک فایل بسته امضا شده که از Android Studio ایجاد کرده اید
  • یک حساب Google Play که مدیر یا مالک آن هستید
  • برنامه ای در حساب برنامه نویس Google Play شما که در یک مسیر داخلی ، بسته ، تولید یا آزمایش آزمایشی منتشر شده است
  • آدرس ایمیلی که می توانید به عنوان تست کننده برای دریافت دعوت نامه های ساخت جدید از Firebase استفاده کنید
  1. ورود به فایربیس .
  2. در فایربیس کنسول، کلیک کنید اضافه کردن پروژه، سپس نام پروژه خود را "AppBundlesCodelab." شناسه پروژه را برای پروژه Firebase خود به خاطر بسپارید. اگر شناسه پروژه را ویرایش نکنید ، Firebase به طور خودکار یک شناسه منحصر به فرد برای پروژه شما اختصاص می دهد.

image8.png

  1. در صورت درخواست ، Google Analytics را فعال کنید.
  2. مراحل باقی مانده، سپس کلیک کنید ایجاد پروژه.

بسته برنامه خود را به پروژه اضافه کنید

  1. در فایربیس کنسول، روی Add کلیک کنید برنامه.

image5.png

  1. هنگام ثبت برنامه ، حتماً از نام بسته مشابه برنامه بارگذاری شده در حساب برنامه نویس Google Play خود استفاده کنید. در نهایت، کلیک برنامه ثبت نام.
  2. تکمیل مراحل باقیمانده برای اضافه کردن google-services.json فایل و فایربیس SDK برای برنامه شما.
  3. روی ادامه کلیک کنید به کنسول.

به Google Play و Google Analytics متصل شوید

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

image2.png

  1. در تب یکپارچگی، روی Connect کلیک کنید بر روی یکپارچه سازی بازی گوگل.
  2. در نهایت، کلیک توزیع نرم افزار در بخش انتشار و مانیتور. سپس بر روی دکمه شروع به کار.

اکنون که این مراحل را به پایان رسانده اید ، تا زمانی که نام بسته های برنامه ها با یکدیگر مطابقت داشته باشند ، برنامه Firebase شما در حساب Google Play شما به برنامه شما پیوند می یابد.

افزونه App Distribution Gradle را اضافه کنید

اکنون ، از Android Studio برای افزودن برنامه توزیع و پلاگین Gradle آن به عنوان وابستگی های buildscript به برنامه خود استفاده خواهید کرد.

  1. در سطح پروژه فایل Gradle خود را ( android/build.gradle )، اضافه کردن توزیع نرم افزار پلاگین Gradle و مخزن Maven را گوگل است.
    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.2`
        }
    }
    
  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
    

پروژه Firebase خود را تأیید کنید

قبل از استفاده از افزونه Gradle ، باید پروژه Firebase خود را احراز هویت کنید. برای این Codelab ، با استفاده از عملکرد ورود پلاگین وارد حساب Google خود می شوید.

  1. فرمان زیر را اجرا در ریشه ی پروژه خود قرار دهید:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. وقتی دستور پیوند تأیید اعتبار را چاپ کرد ، آن را در یک مرورگر باز کنید. در صورت درخواست ، وارد حساب Google خود شوید و اجازه دسترسی به پروژه Firebase خود را بدهید. دستور Gradle یک نشانه تازه سازی را چاپ می کند ، که پلاگین App Distribution برای تأیید اعتبار با Firebase از آن استفاده می کند.
  3. تنظیم متغیر محیطی FIREBASE_TOKEN به نشانه را از مرحله قبل:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

در این مرحله ، شما خود را به عنوان یک تست کننده برای ساختی که بعداً توزیع می کنید اضافه می کنید. هنگامی که نسخه ساخت را توزیع می کنید ، آزمایش کنندگان از Firebase اعلان های ایمیل دریافت می کنند و از آنها برای آزمایش ساخت جدید دعوت می کند.

در خود app/build.gradle ، اضافه کردن یک firebaseAppDistribution بخش و شامل پارامترهای زیر است:

  • appID : برنامه شما فایربیس شناسه برنامه. شما می توانید آن را در پیدا تب General از تنظیمات پروژه خود را.
  • artifactType : نوع فایل برنامه شما ( AAB ).
  • testers : آدرس ایمیل تست شما. برای این Codelab ، ایمیل خود را اضافه کنید تا بتوانید پس از توزیع ، نسخه ساخت خود را آزمایش کنید.

مثلا:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

به عنوان یک گزینه، شما همچنین می توانید مقادیر را در خود لغو build.gradle با عبور آرگومان های خط فرمان در قالب -PappDistribution- property-name = property-value .

  1. اجرای bundle Variant کار Gradle برای ساخت برنامه خود را بسته نرم افزاری فایل:
    $ ./gradlew :base:bundleRelease
    
  2. تعیین محل بسته نرم افزاری در ساخت شاخه در برنامه های شما (در محل پیش فرض است app/build/outputs/bundle/release ).
  3. برای توزیع از انتشار، ساخت اهداف bundleRelease و appDistributionUploadRelease با این نتیجه Gradle پروژه خود را. رمز Firebase را اضافه کنید (موردی که در مرحله 3 دریافت کرده اید: توزیع برنامه را به برنامه خود اضافه کنید).
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

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

در این بخش ، برای بارگیری نسخه منتشر شده از توزیع شده ، به عنوان تست کننده تنظیم می شوید. به عنوان یک تست کننده ، باید دستگاه آزمایشی خود را تأیید کنید و اشتراک برنامه داخلی را در برنامه فروشگاه Google Play فعال کنید.

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

image6.png

  1. با حساب Google خود وارد سیستم شوید و دعوتنامه آزمایش نسخه آزمایشی را بپذیرید. به عنوان یک گزینه، شما همچنین می توانید فایربیس برنامه تستر، که مانع از انتشار از به دستگاه خود را اضافه دانلود دانلود Downloads پوشه. همچنین اطلاعات اضافی درباره نسخه ها ، مانند پیشرفت بارگیری و نسخه منتشر شده را نشان می دهد.

image9.png

  1. دانلود ضربه بزنید در انتشار آن را نصب کنید از فروشگاه بازی.
  2. در صورت درخواست ، مراحل باقیمانده را برای فعال کردن اشتراک داخلی برنامه انجام دهید (دستورالعمل ها در دستگاه آزمایشی شما نمایش داده می شوند و فقط یک بار باید تکمیل شوند).

پس از اتمام بارگیری ، نسخه شما به طور خودکار به عنوان میانبر در صفحه اصلی دستگاه ظاهر می شود.

شما فقط از Firebase App Distribution برای بارگذاری بسته نرم افزاری و توزیع نسخه برای آزمایش کنندگان استفاده کرده اید.

مراحل بعدی