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

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

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

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

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

مرحله 1. برنامه خود را بسازید

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

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

برای توزیع برنامه خود در آزمایش کنندگان ، فایل برنامه خود را با استفاده از Firebase CLI بارگذاری کنید:

  1. نصب و یا به روز رسانی به آخرین نسخه از فایربیس CLI (توصیه می کنیم دانلود باینری مستقل برای خاص CLI به سیستم عامل خود را). اطمینان حاصل کنید که به سیستم وارد شوید و آزمون که شما می توانید پروژه های خود را دسترسی داشته باشید.
  2. در صفحه توزیع برنامه از فایربیس کنسول، برنامه شما می خواهید برای توزیع را انتخاب کنید، سپس با کلیک آغاز شده است.
  3. اجرای appdistribution:distribute فرمان برای آپلود برنامه های خود و توزیع آن را به تست. برای پیکربندی توزیع از پارامترهای زیر استفاده کنید:

    appdistribution: توزیع گزینه ها
    --app

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

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    تازه کردن رمز که چاپ شده در هنگامی تأیید اعتبار شما محیط CI خود را با فایربیس CLI (خواندن با استفاده از CLI با سیستم CI برای اطلاعات بیشتر).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    یادداشت های منتشر شده برای این ساخت.

    شما می توانید یادداشت های انتشار را مستقیماً مشخص کنید:

    --release-notes "Text of release notes"

    یا ، مسیر یک فایل متنی ساده را مشخص کنید:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

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

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

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

    یا ، می توانید مسیر یک فایل متنی ساده حاوی یک لیست آدرس های ایمیل با کاما را مشخص کنید:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

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

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

    --groups "qa-team, trusted-testers"

    یا ، می توانید مسیر یک فایل متنی ساده حاوی فهرستی از نامهای گروه را با کاما جدا کنید:

    --groups-file "/path/to/groups.txt"
    --debug

    پرچمی که می توانید برای چاپ خروجی مشروح گزارش وارد کنید.

    مثلا:

    firebase appdistribution:distribute test.apk  \
        --app 1:1234567890:android:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    علاوه بر نسخه های توزیع، شما همچنین می توانید استفاده از appdistribution:testers:add و appdistribution:testers:remove به دعوت تست جدید یا حذف آزمایشکنندگان موجود از پروژه فایربیس خود را. هنگامی که یک آزمایش کننده به پروژه Firebase شما اضافه شد ، می توانید آنها را به نسخه های جداگانه اضافه کنید. هنگامی که یک آزمایش کننده را حذف می کنید ، دیگر به نسخه های موجود در پروژه شما دسترسی نخواهد داشت. توجه داشته باشید که آزمایشکنندگانی که اخیراً حذف شده اند همچنان می توانند دسترسی به نسخه های منتشرشده شما را برای یک بازه زمانی حفظ کنند.

    مثلا:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
    
    firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
    

    ایمیل های تست کننده باید با فاصله از هم جدا شوند. شما همچنین می توانید با استفاده از تست مشخص --file /path/to/testers.txt .

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

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

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