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

این راهنما برای توزیع APK می سازد به تست با استفاده از از Fastlane ، پلت فرم منبع باز است که خودکار ساخت و انتشار برنامه های iOS و آندروید. این زیر دستورالعمل ساده تعریف شده در یک Fastfile . پس از تنظیم از Fastlane و خود را Fastfile ، شما می توانید توزیع نرم افزار با تنظیمات از Fastlane را در اختیار.

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

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

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

مرحله 1. fastlane را تنظیم کنید

  1. نصب و راه اندازی از Fastlane .

  2. برای افزودن توزیع برنامه به پیکربندی fastlane ، دستور زیر را از ریشه پروژه Android خود اجرا کنید:

    fastlane add_plugin firebase_app_distribution

    اگر فرمان دهید شما را با یک گزینه را انتخاب کنید Option 3: RubyGems.org .

مرحله 2. با Firebase احراز هویت شوید

قبل از استفاده از افزونه Fastlane ، ابتدا باید با پروژه Firebase خود احراز هویت کنید. برای دستیابی به این هدف سه راه وجود دارد:

مرحله 3. Fastfile خود را تنظیم کرده و برنامه خود را توزیع کنید

  1. در ./fastlane/Fastfile خط، اضافه کردن یک firebase_app_distribution بلوک. برای پیکربندی توزیع از پارامترهای زیر استفاده کنید:
    پارامترهای firebase_app_distribution
    app

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

    app: "1:1234567890:android:0a1b2c3d4e5f67890"
    firebase_cli_token

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

    service_credentials_file

    مسیر ورود به حساب سرویس سرویس Google json. بالا برای چگونه برای دیدن تأیید هویت با استفاده از اعتبار حساب خدمات .

    android_artifact_type

    نوع فایل Android را تعیین می کند (APK یا AAB).

    android_artifact_path

    جایگزین apk_path (منسوخ شده). مسیر مطلق به فایل APK یا AAB که می خواهید بارگذاری کنید. در صورت مشخص نشدن ، fastlane محل قرارگیری فایل را از خطی که فایل در آن ایجاد شده است تعیین می کند.

    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

    یک پرچم بولی شما می توانید این را به مجموعه ای true به چاپ طولانی اشکال زدایی خروجی.

    به عنوان مثال:

    platform :android do
        desc "My awesome app"
        lane :distribute do
            build_android_app(...)
            # build_android_app is a built-in fastlane action.
            firebase_app_distribution(
                app: "1:123456789:android:abcd1234",
                testers: "tester1@company.com, tester2@company.com",
                release_notes: "Lots of amazing new features to test out!"
            )
        end
    end

  2. در نهایت، به ساخت دسترس به تست، اجرا خط شما:
    fastlane <lane>

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

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