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

۱. مرور کلی

تصویر10.png

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

آنچه یاد خواهید گرفت

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

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

  • آخرین نسخه اندروید استودیو
  • یک فایل بسته امضا شده که از اندروید استودیو تولید کرده‌اید
  • یک حساب توسعه‌دهنده گوگل پلی که شما مالک یا مدیر آن هستید
  • برنامه شما در گوگل پلی در داشبورد برنامه گوگل پلی تنظیم شده است و وضعیت زیر را دارد:
    • برنامه در یکی از مسیرهای گوگل پلی (تست داخلی، تست بسته، تست باز یا تولید) توزیع می‌شود.
    • بررسی برنامه در گوگل پلی کامل شده و برنامه منتشر شده است. اگر ستون وضعیت برنامه یکی از وضعیت‌های زیر را نشان دهد، برنامه شما منتشر شده است: تست داخلی (نه تست داخلی پیش‌نویس)، تست بسته، تست باز یا تولید.
  • آدرس ایمیلی که می‌توانید به عنوان یک آزمایش‌کننده برای دریافت دعوت‌نامه‌های ساخت جدید از Firebase از آن استفاده کنید

۲. یک پروژه فایربیس ایجاد کنید

  1. با استفاده از حساب گوگل خود وارد کنسول فایربیس شوید.
  2. برای ایجاد یک پروژه جدید، روی دکمه کلیک کنید و سپس نام پروژه را وارد کنید (برای مثال، App Bundles Codelab ).
  3. روی ادامه کلیک کنید.
  4. در صورت درخواست، شرایط Firebase را مرور و قبول کنید و سپس روی ادامه کلیک کنید.
  5. (اختیاری) دستیار هوش مصنوعی را در کنسول Firebase (با نام "Gemini در Firebase") فعال کنید.
  6. برای این codelab، به گوگل آنالیتیکس نیاز ندارید ، بنابراین گزینه گوگل آنالیتیکس را غیرفعال کنید .
  7. روی ایجاد پروژه کلیک کنید، منتظر بمانید تا پروژه شما آماده شود و سپس روی ادامه کلیک کنید.
  8. روی ادامه کلیک کنید.
  9. در صورت درخواست، شرایط Firebase را مرور و قبول کنید و سپس روی ادامه کلیک کنید.
  10. برای این codelab، به گوگل آنالیتیکس نیاز ندارید ، بنابراین گزینه گوگل آنالیتیکس را غیرفعال کنید .
  11. روی ایجاد پروژه کلیک کنید، منتظر بمانید تا پروژه شما آماده شود و سپس روی ادامه کلیک کنید.

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

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

    تصویر5.png
  2. هنگام ثبت برنامه خود، مطمئن شوید که از همان نام بسته‌ای که برای برنامه در حساب توسعه‌دهنده گوگل پلی خود آپلود کرده‌اید، استفاده می‌کنید. در نهایت، روی ثبت برنامه کلیک کنید.
  3. مراحل باقی‌مانده را برای افزودن فایل پیکربندی Firebase برنامه خود ( google-services.json ) به برنامه خود انجام دهید. توجه داشته باشید که برای اندروید، App Distribution کیت توسعه نرم‌افزار Firebase برای افزودن به برنامه شما ندارد.
  4. برای کنسول کردن، روی ادامه کلیک کنید.
  1. در کنسول فایربیس، به تنظیمات پروژه خود بروید.

    تصویر2.png
  2. در تب «یکپارچه‌سازی‌ها» ، روی پیوند (Link) در کارت گوگل پلی کلیک کنید.
  3. دستورالعمل‌های روی صفحه را دنبال کنید تا ادغام توزیع برنامه فعال شود، سپس برنامه Firebase تازه ایجاد شده خود را برای پیوند به Google Play انتخاب کنید.

اکنون که این مراحل را انجام داده‌اید، برنامه Firebase شما تا زمانی که نام بسته‌های برنامه‌ها مطابقت داشته باشد، به برنامه شما در حساب توسعه‌دهنده Google Play شما مرتبط خواهد شد.

۳. توزیع برنامه را به پروژه خود اضافه کنید

افزونه Gradle توزیع برنامه را اضافه کنید

اکنون، از اندروید استودیو برای اضافه کردن توزیع برنامه و افزونه Gradle آن به برنامه خود استفاده خواهید کرد.

  1. در فایل Gradle سطح پروژه خود ( android/build.gradle.kts )، افزونه App Distribution Gradle را به بلوک plugins اضافه کنید. 
    plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
  2. در فایل Settings Gradle در سطح پروژه ( android/settings.gradle.kts )، مخزن Maven گوگل را به بلوک pluginManagement اضافه کنید. 
     pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }
  3. در فایل Gradle سطح برنامه خود ( android/app/build.gradle.kts )، افزونه App Distribution را به بلوک plugins اضافه کنید. 
    plugins {
     //...

     // Add the App Distribution plugin
     id("com.google.firebase.appdistribution")
}
  4. اگر پشت یک پروکسی یا فایروال شرکتی هستید، ویژگی سیستم جاوای زیر را اضافه کنید که به App Distribution اجازه می‌دهد توزیع‌های شما را در Firebase آپلود کند: 
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password

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

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

دستور زیر را در ریشه پروژه اندروید خود اجرا کنید:

~/your-android-project$ firebase login

مستندات مرجع شامل جزئیات بیشتری است.

۴. ویژگی‌های بسته نرم‌افزاری خود را در اندروید استودیو پیکربندی کنید

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

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

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

برای مثال:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

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

۵. یک نسخه بسازید و توزیع کنید

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

./gradlew --stop // Only needed for environment variable changes

./gradlew bundleRelease appDistributionUploadRelease

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

۶. نسخه خود را دانلود و آزمایش کنید

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

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

    تصویر6.png
  2. با حساب گوگل خود وارد شوید و دعوتنامه را برای آزمایش نسخه توزیع‌شده بپذیرید. به عنوان یک گزینه، می‌توانید Firebase App Tester را نیز دانلود کنید که از اضافه شدن نسخه‌های دانلود شده به پوشه Downloads دستگاه شما جلوگیری می‌کند. همچنین اطلاعات اضافی در مورد نسخه‌ها، مانند پیشرفت دانلود و نسخه منتشر شده را نمایش می‌دهد.

    تصویر9.png
  3. برای نصب آن از فروشگاه پلی، روی دانلود در نسخه منتشر شده ضربه بزنید.
  4. وقتی از شما خواسته شد، مراحل باقی‌مانده را برای فعال کردن اشتراک‌گذاری داخلی برنامه انجام دهید (دستورالعمل‌ها روی دستگاه آزمایشی شما نمایش داده می‌شوند و فقط باید یک بار تکمیل شوند).

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

۷. تبریک می‌گویم!

شما همین الان از Firebase App Distribution برای آپلود یک بسته نرم‌افزاری و توزیع نسخه‌ای برای آزمایش‌کنندگان استفاده کردید.

مراحل بعدی