במדריך הזה נסביר איך להפיץ גרסאות build למבדקים באופן אוטומטי באמצעות התכונה App Distribution Automated Tester במסוף Firebase. התכונה Automated Tester מספקת כלי קל לשימוש לבדיקת האפליקציה, שזמין תמיד.
לפני שמתחילים
אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט Android.
אם אתם לא משתמשים במוצרים אחרים של Firebase, עליכם רק ליצור פרויקט ולרשום את האפליקציה. עם זאת, אם תחליטו להשתמש במוצרים נוספים בעתיד, חשוב לבצע את כל השלבים שמפורטים במאמר הוספת Firebase באמצעות מסוף Firebase.
כשתהיו מוכנים להפיץ גרסה של האפליקציה לבדיקה לפני ההשקה, תוכלו ליצור את קובץ ה-APK באמצעות התהליך הרגיל. עליכם לחתום על קובץ ה-APK באמצעות מפתח ניפוי הבאגים או מפתח החתימה על האפליקציה.
הפצת האפליקציה ל-Automated Tester באמצעות מסוף Firebase
כדי להפיץ את האפליקציה ל-Automated Tester, מעלים את קובץ ה-APK באמצעות מסוף Firebase:
- פותחים את הדף App Distribution במסוף Firebase. בוחרים את פרויקט Firebase כשמוצגת הנחיה.
- בדף Releases, בוחרים את האפליקציה שרוצים להפיץ מהתפריט הנפתח.
- גוררים את קובץ ה-APK של האפליקציה למסוף כדי להעלות אותו.
- בסיום ההעלאה, בוחרים באפשרות Automated Tester (בודק אוטומטי) בסרגל החיפוש Add testers or groups (הוספת בודקים או קבוצות).
- כדי להתאים אישית את הבדיקה האוטומטית, לוחצים על סמל Edit ובוחרים את ההתאמות האישיות בתיבת הדו-שיח Customize your automated test.
- (אופציונלי) בתיבת הדו-שיח device configuration, בוחרים את רמת ה-API, את כיוון המכשיר ואת האזור הגיאוגרפי שמתאימים למפרטי הבדיקה.
- (אופציונלי) לוחצים על התפריט הנפתח פרטי כניסה כדי ליצור שם משתמש וסיסמה מותאמים אישית שאפשר להשתמש בהם במהלך הבדיקה, אם האפליקציה דורשת פרטי כניסה.
- לוחצים על Distribute. אפשר גם להוסיף הערה אופציונלית לגרסה של האפליקציה.
הפצת האפליקציה ל-Automated Tester באמצעות ה-CLI של Firebase
מריצים את הפקודה appdistribution:distribute כדי להעלות את האפליקציה ולהפיץ אותה לבודקים. כדי להגדיר את ההפצה לתכונה 'בודק אוטומטי', משתמשים בפרמטרים הבאים:
| appdistribution:distribute options | |
|---|---|
--test-devices או
--test-devices-file
|
מכשירי הבדיקה שבהם רוצים להפיץ גרסאות build לתכונה 'בודק אוטומטי'. אפשר לציין את המכשירים לבדיקה כרשימה של מכשירים לבדיקה מופרדים בנקודה-פסיק: --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. |
למידע נוסף על תחילת העבודה עם Firebase CLI ועל דרכים שונות להגדרת הפצת האפליקציות, אפשר לעיין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות Firebase CLI.
הפצת האפליקציה ל-Automated Tester באמצעות Gradle
אפשר להגדיר את App Distribution על ידי הוספת קטע firebaseAppDistribution אחד לפחות, ולהשתמש בפרמטרים הבאים כדי להגדיר את ההפצה לתכונה 'בודק אוטומטי':
| App Distribution פרמטרים של build | |
|---|---|
testDevices או
testDevicesFile
|
מכשירי הבדיקה שבהם רוצים להפיץ גרסאות build באמצעות בדיקות אוטומטיות. אפשר לציין את מכשירי הבדיקה כרשימה של מפרטי המכשירים המופרדים בנקודה-פסיק. testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"
לחלופין, אפשר לציין את הנתיב לקובץ שמכיל רשימה של מפרטי המכשיר המופרדים בנקודה-פסיק: testDevicesFile="/path/to/testDevices.txt"
|
testUsername
|
שם המשתמש להתחברות אוטומטית לשימוש במהלך הבדיקות האוטומטיות. |
testUsernameResource
|
שם המשאב של שדה שם המשתמש להתחברות אוטומטית, שישמש במהלך הבדיקות האוטומטיות. |
testPassword או
testPasswordFile
|
הסיסמה להתחברות אוטומטית לשימוש במהלך הבדיקות האוטומטיות. לחלופין, אפשר לציין את הנתיב לקובץ טקסט פשוט שמכיל סיסמה: testPasswordFile="/path/to/testPassword.txt" |
testPasswordResource
|
שם המשאב של שדה הסיסמה לכניסה אוטומטית, לשימוש במהלך בדיקות אוטומטיות. |
testNonBlocking |
להריץ בדיקות אוטומטיות באופן אסינכרוני. תוצאות הבדיקה האוטומטית מוצגות במסוף של FireBase. |
מידע נוסף על תחילת העבודה עם Gradle ועל דרכים שונות להגדרת ההפצה זמין במאמר הפצת אפליקציות ל-Android למפתחים באמצעות Gradle.
הפצת האפליקציה ל-Automated Tester באמצעות fastlane
בנתיב ./fastlane/Fastfile, מוסיפים בלוק firebase_app_distribution. כדי להגדיר את ההפצה לתכונה 'בודק אוטומטי', משתמשים בפרמטרים הבאים:
| הפרמטרים של firebase_app_distribution | |
|---|---|
test_devices או
test_devices_file
|
מכשירי הבדיקה שבהם רוצים להפיץ גרסאות build לתכונה 'בודק אוטומטי'. אפשר לציין את המכשירים לבדיקה כרשימה של מכשירים לבדיקה מופרדים בנקודה-פסיק: 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. |
מידע נוסף על תחילת העבודה עם fastlane ועל דרכים שונות להגדרת הפצת האפליקציות זמין במאמר הפצת אפליקציות ל-Android לבודקים באמצעות fastlane.
סטטוסים של סריקה אוטומטית של בדיקות
כדי לעזור לכם לפרש את תוצאות הבדיקה, בכרטיסייה תוצאות הבדיקה האוטומטית מוצגות בעיות בבדיקה, צילומי מסך של האפליקציה וסרטון של הסריקה של הבדיקה לכל מכשיר. הסטטוס של הבדיקה מופיע בדף תוצאות הבדיקה:
| סטטוס הסריקה | תיאור |
|---|---|
| בהמתנה | הבדיקה האוטומטית עדיין פועלת והתוצאות יהיו זמינות בקרוב. |
| עבר בתאריך | הבדיקה האוטומטית סרקה את האפליקציה שלך בהצלחה ולא נמצאו קריסות. |
| נכשל | הבדיקה האוטומטית נכשלה כי האפליקציה קרסה במהלך הבדיקה. |
| אין תוצאה חד-משמעית | הבדיקה האוטומטית נכשלה בגלל שגיאות בתשתית. |