התחלת בדיקות עם מערכות אינטגרציה רציפה (CI)

אפשר להשתמש ב-Firebase Test Lab במהלך פיתוח האפליקציה באמצעות כל של מערכת האינטגרציה (CI). מערכות אינטגרציה רציפה (CI) מאפשרות לכם לבנות ולבדוק את האפליקציה בכל פעם שאתם בודקים עדכונים בקוד המקור של האפליקציה.

שימוש ב-Firebase Test Lab עם Jenkins CI

בקטע הזה מוסבר איך להשתמש ב-Test Lab עם Jenkins CI.

דרישות

כדי להשתמש ב-Firebase Test Lab עם Jenkins, צריך להשלים את את השלבים הבאים:

  1. הגדרת gcloud. פועלים לפי ההוראות שמפורטות שימוש ב-Firebase Test Lab משורת הפקודה של gcloud כדי ליצור פרויקט Firebase ולהגדיר את ה-SDK המקומי של Google Cloud הסביבה.

  2. יוצרים ומאשרים חשבון שירות. חשבונות שירות לא כפופים לבדיקות ספאם או הנחיות captcha, שעלולות לחסום את החיבור ב-CI לבנות. ליצור חשבון שירות עם תפקיד עריכה בחשבון מסוף Google Cloud ואז להפעיל אותו (מידע נוסף זמין במסמכי התיעוד של gcloud auth enabled-service-account). כדי ללמוד איך עושים את זה).

  3. מפעילים את ממשקי ה-API הנדרשים. אחרי שמתחברים באמצעות חשבון השירות: בדף API Library ב-Google Developers Console, מפעילים את Google Cloud Testing API ואת Cloud Tool Results API. שפת תרגום להפעיל את ממשקי ה-API האלה, מקלידים את שמות ממשקי ה-API האלה בתיבת החיפוש לאחר מכן לוחצים על Enable API בדף הסקירה הכללית של ה-API.

התקנה והגדרה של Jenkins

אפשר להתקין ולהגדיר את Jenkins CI ב-Linux או ב-Windows. פרטים מסוימים של המדריך הזה ספציפי להתקנה ולהפעלה של Jenkins CI ב-Linux, כולל שימוש בלוכסנים (/) בנתיבי קבצים.

כדי להוריד ולהתקין את Jenkins במחשב עם Linux או Windows, פועלים לפי ההוראות ההוראות עבור התקנת Jenkins. אחרי כשמתקינים את Jenkins, פועלים לפי ההוראות הפעלה וגישה ל-Jenkins כדי להשלים את ההגדרה ולגשת ללוח הבקרה של Jenkins.

קביעת הגדרות אבטחה גלובליות

אימות משתמשים ובקרת גישה לא מוגדרים ב-Jenkins כשמתקינים אותו בפעם הראשונה. לפני שמשתמשים ב-Jenkins עם Firebase Test Lab, צריך להגדיר הגדרות אבטחה גלובליות לאכיפת בקרת גישה ואימות משתמשים.

כדי לקבוע הגדרות אבטחה גלובליות

  1. עוברים ללוח הבקרה של Jenkins בשרת. כדי לעשות זאת, עוברים אל http://<servername>:8080, כאשר <servername> הוא שם המחשב שבו התקנתם את Jenkins.
  2. במרכז הבקרה של Jenkins, לוחצים על Manage Jenkins ואז לוחצים על הגדרת אבטחה גלובלית
  3. בדף הגדרת אבטחה גלובלית, לוחצים על הפעלת אבטחה. ולאחר מכן לוחצים על Save.

למידע נוסף על קביעת הגדרות אבטחה ל-Jenkins: אבטחה מהירה ופשוטה, הגדרת אבטחה רגילה, וגם אבטחת Jenkins.

יצירת פרויקט ב-Jenkins

בשלב הבא, יוצרים פרויקט להרצת בדיקת אינטגרציה רציפה (CI) של האפליקציה עם Firebase Test Lab.

יצירת פרויקט ב-Jenkins

  1. עוברים ללוח הבקרה של Jenkins בשרת. כדי לעשות זאת, עוברים אל http://<servername>:8080, כאשר <servername> הוא השם של המחשב שבו התקנתם את Jenkins.
  2. במרכז הבקרה של Jenkins, לוחצים על New Item.
  3. מקלידים שם לפרויקט בשדה Item name (שם הפריט):
    • כדי ליצור פרויקט שמבוסס על build אחד, בוחרים באפשרות Freestyle project הגדרה אישית.
    • בוחרים באפשרות Build multi-configuration project כדי ליצור פרויקט שפועל במספר הגדרות build שונות. אם אתם מתכננים ליצור לאפליקציה בעזרת מגוון תצורות build (מספר לוקאלים, רמות API מרובות של Android וכו'), אז פרויקט רב-הגדרות הבחירה הטובה ביותר.
  4. לוחצים על שמירה.

אחרי יצירת הפרויקט, דפדפן האינטרנט מציג את הדף הראשי של פרויקט.

הוספה של בקרת גרסאות ושלבי build של Gradle

בקטע הזה נסביר איך לשלב את Jenkins עם מערכות לבקרת גרסאות כמו GitHub, ואיך מוסיפים שלבי build של Gradle כדי לפתח חבילות APK מקוד המקור.

שילוב עם GitHub ומערכות אחרות לבקרת גרסאות

אם אתם משתמשים ב-GitHub או במערכת אחרת לבקרת גרסאות כדי לנהל את קוד המקור אפשר להגדיר ל-Jenkins להריץ גרסאות build אוטומטיות ולהריץ בדיקות בכל פעם שעדכונים לאפליקציה שלך מתבצעים. אפשר גם להגדיר שימוש ב-Jenkins להרצת גרסאות build מדי פעם.

למידע נוסף על הגדרת גרסאות build ב-Jenkins: הגדרה של גרסאות build אוטומטיות

הוספת שלבי ה-build של Gradle כדי לבנות מחדש חבילות APK

אם אתם משתמשים במערכת לניהול גרסאות כדי לנהל את קוד המקור של האפליקציה, עליכם לכלול שלב build ב-Gradle כדי ליצור קובצי APK בינאריים חדשים בכל פעם ש-Jenkins מוריד את קוד המקור ממערכת בקרת הגרסאות.

  1. כדי להריץ את הפקודות הבאות בספרייה הראשית, צריך להוסיף שלב build יישום: 

    ./gradlew :app:assembleDebug
./gradlew :app:assembleDebugAndroidTest

  2. יש להוסיף שלב build כדי להשתמש בחבילות ה-APK שנוצרו על ידי Gradle במהלך הבדיקה עם Test Lab. אפשר להשתמש בנתיב הזה בתור <local_server_path> בדוגמת סקריפט המעטפת שמסופקת בהמשך, כאשר <AppFolder> היא תיקיית הפרויקט של Android Studio app: 

    <AppFolder>/app/build/outputs/apk

הוספת Test Lab שלבי build ל-Jenkins

עכשיו אתם מוכנים להוסיף שלב build ל-Jenkins כדי להריץ את Test Lab באמצעות של שורת הפקודה gcloud.

כדי להוסיף שלב build של gcloud

  1. בדף הראשי של הפרויקט, לוחצים על Configure (הגדרה).

  2. בדף Project configuration, גוללים למטה לקטע Build. ובוחרים באפשרות Execute Shell בתפריט Add build Step.

  3. בחלון Jenkins Execute hellעסק מזינים את הפקודה הבאה: מחליפים את <local_server_path> בנתיב לאפליקציה לדוגמה ב- השרת, <app_APK> עבור ה-APK של האפליקציה, וגם <app_test_APK> בשביל ה-APK לבדיקה של האפליקציה: 

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
--test <local_server_path>/<app_test_apk>.apk

ניתוח של תוצאות הבדיקה

אחרי שבדיקת האפליקציה תושלם על ידי Test Lab, אפשר יהיה לבדוק את הבדיקה תוצאות במסוף Firebase או Google Cloud Storage קטגוריה ב- בפרויקט שלכם. אפשר גם להוסיף הפקודה gsutil פקודת המעטפת המוצגת למעלה כדי להעתיק את נתוני תוצאות הבדיקה למחשב המקומי שלכם. מידע נוסף זמין במאמר הבא: מנתח Firebase Test Lab תוצאות.

אינטגרציה רציפה (CI) עם מערכות CI אחרות

כדי ללמוד איך להשתמש ב-Firebase Test Lab עם מערכות CI אחרות, כדאי לעיין המסמכים שלהם: