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

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

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

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

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

  2. برای افزودن App Distribution به پیکربندی fastlane خود ، دستور زیر را از ریشه پروژه iOS خود اجرا کنید:

    fastlane add_plugin firebase_app_distribution

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

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

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

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

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

    مورد نیاز فقط اگر برنامه شما حاوی یک فایل فایربیس پیکربندی (نه GoogleService-Info.plist ): فایربیس شناسه برنامه برنامه شما. شما می توانید ID برنامه در فایربیس کنسول در پیدا کردن، صفحه تنظیمات عمومی .

    app: "1:1234567890:ios:0a1b2c3d4e5f67890"
    googleservice_info_plist_path

    مسیر را به خود GoogleService-Info.plist فایل، نسبت به مسیر کالا آرشیو. تنظیم کنید تا GoogleService-Info.plist به طور پیش فرض.

    فایل مورد استفاده قرار گرفتن فایربیس شناسه برنامه برنامه شما اگر app پارامتر نامشخص است.

    firebase_cli_token

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

    service_credentials_file

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

    ipa_path

    جایگزین apk_path (منسوخ شده). مسیر مطلق به پرونده IPA که می خواهید بارگذاری کنید. اگر نامشخص باشد ، 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 :ios do
    desc "My awesome app"
    lane :distribute do
        build_ios_app(...)
        # build_ios_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

در نهایت، به ساخت دسترس به تست، اجرا خط شما:

fastlane <lane>

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

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

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

مرحله 4 (اختیاری) مدیریت تسترهای توزیع

شما می توانید اضافه یا حذف آزمایشکنندگان از انتشار برنامه خود را با استفاده خود را Fastfile فایل یا به طور مستقیم در حال اجرا اقدامات از Fastlane. اقدامات در حال اجرا به طور مستقیم به ارزش مجموعه خود را نادیده گرفتن Fastfile .

هنگامی که یک آزمایش کننده به پروژه Firebase شما اضافه شد ، می توانید آنها را به نسخه های شخصی اضافه کنید. آزمایشکنندگان حذف شده دیگر به نسخه های پروژه شما دسترسی نخواهند داشت ، اما همچنان ممکن است دسترسی به نسخه های شما را برای یک بازه زمانی حفظ کنند.

استفاده از Fastfile

# Use lanes to add or remove testers from an app release.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end
# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

اقدامات fastlane را اجرا کنید

fastlane run firebase_app_distribution_add_testers emails:"foo@google.com,bar@google.com"

fastlane run firebase_app_distribution_remove_testers emails:"foo@google.com,bar@google.com"

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

firebase_app_distribution_add_testers و firebase_app_distribution_remove_testers وظایف نیز استدلال زیر را قبول:

  • project_name : تعداد پروژه Firebase خود.
  • service_credentials_file : مسیر به گوگل فایل اعتبار خدمات خود را.
  • firebase_cli_token : تایید رمز برای فایربیس CLI.

service_credentials_file و firebase_cli_token از همین استدلالها با عمل آپلود هستند.