این راهنما نحوه توزیع ساختهای AAB را برای آزمایشکنندگان با استفاده از fastlane ، یک پلتفرم منبع باز که ساخت و انتشار برنامههای iOS و Android را خودکار میکند، توضیح میدهد. از دستورالعمل های ساده تعریف شده در Fastfile
پیروی می کند. پس از راه اندازی fastlane و Fastfile
خود، می توانید App Distribution با پیکربندی fastlane خود ادغام کنید.
App Distribution با سرویس اشتراکگذاری برنامه داخلی Google Play ادغام میشود تا AABهایی را که آپلود میکنید پردازش کند و APKهایی را که برای پیکربندیهای دستگاه آزمایشکنندگان شما بهینهسازی شدهاند ارائه میدهد. توزیع AAB به شما امکان می دهد کارهای زیر را انجام دهید:
فایلهای APK بهینهسازی شده (که توسط Google Play ارائه میشود) را اجرا کنید که برای دستگاههای آزمایشکنندگان شما بهینهسازی شدهاند.
مشکلات مربوط به دستگاه را کشف و اشکال زدایی کنید.
ویژگیهای بسته نرمافزار مانند Play Feature Delivery و Play Asset Delivery را آزمایش کنید.
حجم دانلودها را برای آزمایش کنندگان خود کاهش دهید.
مجوزهای مورد نیاز
برای آپلود AABها در App Distribution ، باید برنامه Firebase خود را به یک برنامه در Google Play پیوند دهید . برای انجام این اقدامات باید سطح دسترسی لازم را داشته باشید.
اگر دسترسی Firebase لازم را ندارید، میتوانید از مالک پروژه Firebase بخواهید که از طریق تنظیمات IAM کنسول Firebase نقش قابل اجرا را به شما اختصاص دهد. اگر در مورد دسترسی به پروژه Firebase خود، از جمله پیدا کردن یا اختصاص مالک، سؤالی دارید ، سؤالات متداول "مجوزها و دسترسی به پروژه های Firebase" را مرور کنید.
جدول زیر برای پیوند یک برنامه Firebase به یک برنامه در Google Play و همچنین آپلود AAB ها کاربرد دارد.
اکشن در کنسول Firebase | مجوز IAM مورد نیاز است | نقش(های) IAM که به طور پیش فرض شامل مجوزهای مورد نیاز است | نقش(های) مورد نیاز اضافی |
---|---|---|---|
یک برنامه Firebase را به یک برنامه در Google Play پیوند دهید | firebase.playLinks.update | یکی از نقش های زیر: | دسترسی به حساب توسعه دهنده Google Play به عنوان Admin |
AAB ها را در App Distribution آپلود کنید | firebaseappdistro.releases.update | یکی از نقش های زیر: | –– |
قبل از شروع
اگر قبلاً این کار را نکردهاید، Firebase را به پروژه Android خود اضافه کنید . در پایان این گردش کار، یک برنامه Android Firebase در پروژه Firebase خود خواهید داشت.
اگر از محصولات Firebase دیگری استفاده نمی کنید، فقط باید یک پروژه ایجاد کنید و برنامه خود را ثبت کنید. اگر تصمیم به استفاده از محصولات اضافی دارید، مطمئن شوید که تمام مراحل افزودن Firebase به پروژه Android خود را کامل کرده اید.
برای ایجاد پیوند Firebase به Google Play و آپلود AAB، مطمئن شوید که برنامه شما شرایط زیر را دارد:
برنامه در Google Play و برنامه Firebase Android هر دو با استفاده از یک نام بسته ثبت شده اند.
برنامه در Google Play در داشبورد برنامه راهاندازی میشود و در یکی از مسیرهای Google Play (تست داخلی، آزمایش بسته، آزمایش باز یا تولید) توزیع میشود.
بررسی اپلیکیشن در گوگل پلی کامل شد و اپلیکیشن منتشر شد. اگر ستون وضعیت برنامه یکی از وضعیتهای زیر را نمایش دهد، برنامه شما منتشر میشود: آزمایش داخلی (نه آزمایش داخلی پیشنویس)، آزمایش بسته، آزمایش باز یا تولید.
برنامه Firebase Android خود را به حساب توسعه دهنده Google Play خود پیوند دهید:
در کنسول Firebase ، به قسمت خود بروید
در کارت Google Play ، روی پیوند کلیک کنید.
اگر قبلاً پیوندهایی به Google Play دارید، به جای آن روی Manage کلیک کنید.دستورالعملهای روی صفحه را دنبال کنید تا ادغام App Distribution را فعال کنید و برنامههای Firebase Android را انتخاب کنید تا به Google Play پیوند داده شوند.
درباره پیوند دادن به Google Play بیشتر بیاموزید.
مرحله 1. راه اندازی fastlane
برای افزودن App Distribution به پیکربندی fastlane خود، دستور زیر را از ریشه پروژه اندروید خود اجرا کنید:
fastlane add_plugin firebase_app_distribution
اگر فرمان گزینه ای را از شما می خواهد،
Option 3: RubyGems.org
را انتخاب کنید.
مرحله 2. با Firebase احراز هویت
قبل از اینکه بتوانید از افزونه fastlane استفاده کنید، ابتدا باید با پروژه Firebase خود به یکی از روش های زیر احراز هویت کنید. بهطور پیشفرض، اگر از روش احراز هویت دیگری استفاده نشود، افزونه fastlane به دنبال اعتبار از Firebase CLI میگردد.
احراز هویت با یک حساب سرویس به شما این امکان را می دهد که به طور انعطاف پذیر از افزونه با سیستم یکپارچه سازی پیوسته (CI) خود استفاده کنید. دو روش برای ارائه اعتبار حساب خدمات وجود دارد:
- فایل کلید حساب سرویس خود را به اکشن
firebase_app_distribution
منتقل کنید. اگر از قبل فایل کلید حساب سرویس خود را در محیط ساخت خود داشته باشید، ممکن است این روش را راحت بیابید. - متغیر محیطی
GOOGLE_APPLICATION_CREDENTIALS
را تنظیم کنید تا به فایل کلید حساب سرویس شما اشاره کند. اگر قبلاً Application Default Credentials (ADC) را برای سرویس Google دیگری (مثلاً Google Cloud ) پیکربندی کردهاید، ممکن است این روش را ترجیح دهید.
- در کنسول Google Cloud ، پروژه خود را انتخاب کرده و یک حساب سرویس جدید ایجاد کنید.
- نقش مدیر Firebase App Distribution را اضافه کنید.
- یک کلید json خصوصی ایجاد کنید و کلید را به مکانی که برای محیط ساخت شما قابل دسترسی است منتقل کنید. مطمئن شوید که این فایل را در جایی امن نگه دارید ، زیرا به سرپرست اجازه دسترسی به App Distribution را در پروژه Firebase شما می دهد.
- اگر برنامه خود را بعد از 20 سپتامبر 2019 ایجاد کرده اید، از این مرحله رد شوید: در کنسول Google APIs، Firebase App Distribution API را فعال کنید. هنگامی که از شما خواسته شد، پروژه ای را با همان نام پروژه Firebase خود انتخاب کنید.
اطلاعات حساب سرویس خود را ارائه یا پیدا کنید:
- برای ارسال کلید حساب سرویس خود به اقدام
firebase_app_distribution
خط خود، پارامترservice_credentials_file
را با مسیر فایل JSON کلید خصوصی خود تنظیم کنید. برای تعیین مکان اعتبار خود با ADC، متغیر محیطی
GOOGLE_APPLICATION_CREDENTIALS
روی مسیر فایل JSON کلید خصوصی تنظیم کنید. به عنوان مثال:export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
برای اطلاعات بیشتر در مورد احراز هویت با ADC، ارائه اعتبارنامه به برنامه خود را بخوانید.
- برای ارسال کلید حساب سرویس خود به اقدام
برای اطلاع از نحوه احراز هویت پروژه ، به ورود با Firebase CLI مراجعه کنید.
مرحله 3. Fastfile خود را راه اندازی کنید و برنامه خود را توزیع کنید
- در یک مسیر
./fastlane/Fastfile
، یک بلوکfirebase_app_distribution
اضافه کنید. برای پیکربندی توزیع از پارامترهای زیر استفاده کنید:پارامترهای firebase_app_distribution app
مورد نیاز : شناسه برنامه Firebase برنامه شما. میتوانید شناسه برنامه را در کنسول Firebase ، در صفحه تنظیمات عمومی پیدا کنید.
app: "1:1234567890:android:0a1b2c3d4e5f67890"
firebase_cli_token
نشانه تازهسازی که هنگام احراز هویت محیط CI خود با Firebase CLI چاپ میشود (برای اطلاعات بیشتر، استفاده از CLI با سیستمهای CI را بخوانید).
service_credentials_file
مسیر فایل json حساب سرویس گوگل شما. برای نحوه احراز هویت با استفاده از اعتبار حساب سرویس به بالا مراجعه کنید.
android_artifact_type
نوع فایل اندروید (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"
test_devices
test_devices_file
انواع توزیع زیر بخشی از ویژگی آزمایش کننده خودکار بتا هستند.
دستگاههای آزمایشی که میخواهید ساختها را در آنها توزیع کنید (به تستهای خودکار مراجعه کنید).
میتوانید دستگاههای آزمایشی را بهعنوان فهرستی از دستگاههای آزمایشی جدا شده با نقطه ویرگول مشخص کنید:
test_devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"
یا، میتوانید مسیر یک فایل متنی ساده حاوی فهرستی از دستگاههای آزمایشی جدا شده با نقطه ویرگول را مشخص کنید:
test_devices_file: "/path/to/test-devices.txt"
test_username
نام کاربری برای ورود خودکار که در طول تست های خودکار استفاده می شود.
test_password
test_password_file
رمز عبور برای ورود خودکار که در طول آزمایشات خودکار استفاده می شود.
یا می توانید مسیر یک فایل متنی ساده حاوی رمز عبور را مشخص کنید:
test_password_file: "/path/to/test-password.txt"
test_username_resource
نام منبع برای فیلد نام کاربری برای ورود خودکار برای استفاده در آزمایشهای خودکار .
test_password_resource
نام منبع برای فیلد رمز عبور برای ورود خودکار که در طول تست های خودکار استفاده می شود.
test_non_blocking
تست های خودکار را به صورت ناهمزمان اجرا کنید. برای دریافت نتایج تست خودکار به کنسول Firebase مراجعه کنید.
debug
یک پرچم بولی میتوانید این را روی
true
تنظیم کنید تا خروجی اشکال زدایی کامل چاپ شود.
platform :android do desc "My awesome app" lane :distribute do build_android_app(task: "bundle", ...) # build_android_app is a built-in fastlane action. release = 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!", android_artifact_type: "AAB" ) end end
برای در دسترس قرار دادن بیلد برای آزمایشکنندگان، خط خود را اجرا کنید:
fastlane <lane>
مقدار بازگشتی عمل یک هش است که نسخه آپلود شده را نشان می دهد. این هش با استفاده از lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE]
نیز در دسترس است. برای اطلاعات بیشتر در مورد فیلدهای موجود در این هش، به مستندات REST API مراجعه کنید.
افزونه fastlane لینک های زیر را پس از آپلود انتشار خروجی می دهد. این پیوندها به شما کمک میکنند فایلهای باینری را مدیریت کنید و اطمینان حاصل کنید که آزمایشکنندگان و سایر توسعهدهندگان نسخه مناسبی دارند:
- پیوندی به کنسول Firebase که یک نسخه را نمایش میدهد. می توانید این پیوند را با سایر توسعه دهندگان در سازمان خود به اشتراک بگذارید.
- پیوندی به نسخه در تجربه آزمایشکننده (برنامه بومی Android) که به آزمایشکنندگان اجازه میدهد یادداشتهای انتشار را مشاهده کرده و برنامه را روی دستگاه خود نصب کنند. آزمایشکننده برای استفاده از پیوند نیاز به دسترسی به انتشار دارد.
- پیوند امضا شده ای که مستقیماً برنامه باینری (فایل APK یا AAB) را دانلود و نصب می کند. لینک بعد از یک ساعت منقضی می شود.
پس از توزیع ساخت، به مدت 150 روز در داشبورد App Distribution کنسول Firebase در دسترس است. وقتی ساخت 30 روز از انقضا میگذرد، یک اخطار انقضا در کنسول و در لیست ساختهای آزمایشکننده در دستگاه آزمایشیشان ظاهر میشود.
آزمایشکنندگانی که قبلاً برای آزمایش برنامه دعوت نشدهاند، دعوتنامههای ایمیلی را برای شروع دریافت میکنند. آزمایشکنندگان موجود، اعلانهای ایمیلی مبنی بر آماده بودن ساخت جدید برای آزمایش دریافت میکنند. برای آشنایی با نحوه نصب برنامه آزمایشی، به راهنمای تنظیم تستر مراجعه کنید. میتوانید وضعیت هر آزمایشکننده را کنترل کنید تا مشخص کنید آیا دعوتنامه را قبول کردهاند یا خیر و آیا برنامه را در کنسول Firebase دانلود کردهاند یا خیر.
(اختیاری) برای افزایش خودکار شماره ساخت خود هر بار که نسخه جدیدی در App Distribution ایجاد می کنید، می توانید از عمل firebase_app_distribution_get_latest_release
و، به عنوان مثال، افزونه increment_version_code
fastlane استفاده کنید. کد زیر نمونه ای از نحوه افزایش خودکار شماره ساخت خود را ارائه می دهد:
lane :increment_version do
latest_release = firebase_app_distribution_get_latest_release(
app: "<your Firebase app ID>"
)
increment_version_code({ version_code: latest_release[:buildVersion].to_i + 1 })
end
برای کسب اطلاعات بیشتر در مورد اقدام firebase_app_distribution_get_latest_release
، به دریافت اطلاعات درباره آخرین نسخه برنامه خود مراجعه کنید.
مرحله 4 (اختیاری). مدیریت تسترها برای توزیع
میتوانید با استفاده از فایل Fastfile
یا با اجرای مستقیم اقدامات fastlane، آزمایشکنندگان را از پروژه یا گروه خود اضافه و حذف کنید. اجرای اقدامات مستقیماً مقادیر تنظیم شده در Fastfile
شما را لغو می کند.
هنگامی که یک آزمایشکننده به پروژه Firebase شما اضافه شد، میتوانید آنها را به نسخههای جداگانه اضافه کنید. آزمایشکنندگانی که از پروژه Firebase شما حذف شدهاند، دیگر به نسخههای موجود در پروژه شما دسترسی ندارند، اما ممکن است برای مدتی به نسخههای شما دسترسی داشته باشند.
اگر تعداد آزمایشکنندههای زیادی دارید، باید از گروهها استفاده کنید.
از Fastfile
استفاده کنید
# Use lanes to add or remove testers from a project. lane(:add_testers) do firebase_app_distribution_add_testers( emails: "foo@google.com,bar@google.com" # or file: "/path/to/testers.txt" group_alias: "qa-team" # (Optional) add testers to this group ) end lane(:remove_testers) do firebase_app_distribution_remove_testers( emails: "foo@google.com,bar@google.com" # or file: "/path/to/testers.txt" group_alias: "qa-team" # (Optional) remove testers from this group only ) end
# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers
اقدامات fastlane را اجرا کنید
fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"
همچنین میتوانید آزمایشکنندهها را با استفاده از --file="/path/to/testers.txt
به جای --emails
مشخص کنید.
وظایف firebase_app_distribution_add_testers
و firebase_app_distribution_remove_testers
آرگومان های زیر را نیز می پذیرند:
-
project_name
: شماره پروژه Firebase شما. -
group_alias
(اختیاری): اگر مشخص شده باشد، آزمایش کننده ها به گروه مشخص شده اضافه می شوند (یا از آنها حذف می شوند). -
service_credentials_file
: مسیر فایل اعتبار سرویس Google شما. -
firebase_cli_token
: رمز تأیید برای Firebase CLI.
service_credentials_file
و firebase_cli_token
همان آرگومانهایی هستند که در عمل آپلود استفاده میشوند.
مرحله 5 (اختیاری). درباره آخرین نسخه برنامه خود اطلاعاتی دریافت کنید
میتوانید از کنش firebase_app_distribution_get_latest_release
برای واکشی اطلاعات درباره آخرین نسخه برنامهتان در App Distribution، از جمله اطلاعات نسخه برنامه، یادداشتهای انتشار و زمان ایجاد، استفاده کنید. موارد استفاده شامل افزایش خودکار نسخه و حمل یادداشتهای انتشار نسخه قبلی است.
مقدار بازگشتی اکشن یک هش است که آخرین نسخه را نشان می دهد. این هش با استفاده از lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE]
نیز در دسترس است. برای اطلاعات بیشتر در مورد فیلدهای موجود در این هش، به مستندات REST API مراجعه کنید.
پارامترها
پارامترهای firebase_app_distribution_get_latest_release | |
---|---|
app | مورد نیاز : شناسه برنامه Firebase برنامه شما. میتوانید شناسه برنامه را در کنسول Firebase ، در صفحه تنظیمات عمومی پیدا کنید. app: "1:1234567890:android:0a1b2c3d4e5f67890" |
firebase_cli_token | نشانه تازهسازی که هنگام احراز هویت محیط CI خود با Firebase CLI چاپ میشود (برای اطلاعات بیشتر، استفاده از CLI با سیستمهای CI را بخوانید). |
service_credentials_file | مسیر فایل json حساب سرویس گوگل شما. برای نحوه احراز هویت با استفاده از اعتبار حساب سرویس به بالا مراجعه کنید. |
debug | یک پرچم بولی میتوانید این را روی |
مراحل بعدی
بازخورد درونبرنامهای را پیادهسازی کنید تا آزمایشکنندگان بتوانند بازخورد درباره برنامه شما (از جمله تصاویر صفحه) ارسال کنند.
با نحوه نمایش هشدارهای درونبرنامهای به آزمایشکنندگان خود، هنگامی که ساختهای جدید برنامهتان برای نصب در دسترس هستند، آشنا شوید.
بهترین روشها را برای توزیع برنامههای Android به آزمایشکنندگان QA با استفاده از CI/CD بیاموزید.