במדריך הזה מוסבר איך להפיץ באופן אוטומטי גרסאות build לבודקים באמצעות App Distribution תכונה של בודק אוטומטי במסוף Firebase. התכונה Automated Tester מספקת כלי קל לשימוש לבדיקת האפליקציה, שזמין תמיד.
לפני שמתחילים
אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט Android.
אם אתם לא משתמשים במוצרים אחרים של Firebase, עליכם רק ליצור פרויקט ולרשום את האפליקציה. עם זאת, אם תחליטו להשתמש במוצרים נוספים בעתיד, חשוב לבצע את כל השלבים המפורטים במאמר הוספת Firebase באמצעות מסוף Firebase.
כשתהיו מוכנים להפיץ לבודקים גרסת טרום-השקה של האפליקציה, לבנות את ה-APK באמצעות התהליך הרגיל. עליכם לחתום על קובץ ה-APK באמצעות מפתח ניפוי הבאגים או מפתח החתימה על האפליקציה.
הפצת האפליקציה לבודקים אוטומטיים באמצעות מסוף Firebase
כדי להפיץ את האפליקציה לבודקים אוטומטיים, צריך להעלות את קובץ ה-APK באמצעות המסוף של Firebase:
- פותחים את הדף App Distribution במסוף Firebase. כשתוצג הבקשה, בוחרים את פרויקט Firebase הרצוי.
- בדף Releases, בוחרים את האפליקציה שרוצים להפיץ מהתפריט הנפתח.
- גוררים את קובץ ה-APK של האפליקציה למסוף כדי להעלות אותו.
- בסיום ההעלאה, בוחרים באפשרות Automated Tester (בודק אוטומטי) בסרגל החיפוש Add testers or groups (הוספת בודקים או קבוצות).
- כדי להתאים אישית את הבדיקה האוטומטית, לוחצים על סמל Edit ובוחרים את ההתאמות האישיות בתיבת הדו-שיח Customize your automated test.
- (אופציונלי) בתיבת הדו-שיח device configuration בוחרים את רמת ה-API, לכיוון המכשיר והלוקאל שעומד בדרישות של מפרטי הבדיקה.
- (אופציונלי) לוחצים על התפריט הנפתח פרטי כניסה כדי ליצור שם משתמש וסיסמה שבהם ניתן להשתמש במהלך הבדיקה אם האפליקציה מחייבת פרטי הכניסה.
- לוחצים על הפצה. אפשר גם להוסיף הערה אופציונלית לגרסה של האפליקציה.
הפצת האפליקציה ל-Automated Tester באמצעות ה-CLI של Firebase
מריצים את הפקודה appdistribution:distribute כדי להעלות את האפליקציה.
להפיץ אותו לבודקים. כדי להגדיר את ההפצה לתכונה 'בודק אוטומטי', משתמשים בפרמטרים הבאים:
| appהפצה:אפשרויות הפצה | |
|---|---|
--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. |
כדי לקבל מידע נוסף על תחילת העבודה עם ה-CLI של Firebase ודרכים שונות להגדרת ההפצה שלכם, אפשר לעיין במאמר בנושא הפצת אפליקציות ל-Android לבודקים באמצעות ה-CLI של Firebase.
הפצת האפליקציה ל-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.
סטטוסים של סריקה אוטומטית של בדיקות
כדי לעזור לכם לפרש את תוצאות הבדיקה, בכרטיסייה תוצאות הבדיקה האוטומטית מוצגות בעיות בבדיקה, צילומי מסך של האפליקציה וסרטון של הסריקה של הבדיקה לכל מכשיר. הסטטוס של הבדיקה מופיע בדף תוצאות הבדיקה:
| סטטוס הסריקה | תיאור |
|---|---|
| בהמתנה | הבדיקה האוטומטית עדיין פועלת והתוצאות יהיו זמינות בקרוב. |
| עבר בתאריך | במסגרת הבדיקה האוטומטית, האפליקציה נסרקה בהצלחה ולא נמצאו קריסות. |
| נכשל | הבדיקה האוטומטית נכשלה כי האפליקציה קרסה במהלך הבדיקה. |
| אין תוצאה חד-משמעית | הבדיקה האוטומטית נכשלה בגלל שגיאות בתשתית. |