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

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

שימוש במעבדת בדיקות Firebase עם Jenkins CI

סעיף זה מתאר כיצד להשתמש ב-Test Lab עם Jenkins CI .

דרישות

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

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

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

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

התקן והגדר את Jenkins

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

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

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

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

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

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

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

צור פרויקט של ג'נקינס

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

כדי ליצור פרויקט של ג'נקינס

  1. נווט אל לוח המחוונים של Jenkins בשרת שלך. לשם כך, דפדף אל http://<servername>:8080 , כאשר <servername> הוא שם המחשב שבו התקנת את Jenkins.
  2. בלוח המחוונים של Jenkins, לחץ על פריט חדש .
  3. הקלד שם לפרויקט שלך בשדה שם פריט :
    • בחר פרויקט Freestyle כדי ליצור פרויקט המשתמש בתצורת בנייה אחת.
    • בחר בנה פרויקט מרובה תצורה כדי ליצור פרויקט שפועל על מספר תצורות בנייה שונות. אם אתה מתכנן לבנות את האפליקציה שלך עם מגוון תצורות בנייה (מספר מקומות, מספר רמות API של אנדרואיד וכו'), אז פרויקט ריבוי תצורה הוא הבחירה הטובה ביותר.
  4. לחץ על שמור .

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

הוסף בקרת גרסאות ושלבי בניית Gradle

סעיף זה מתאר כיצד לשלב את Jenkins עם מערכות בקרת גרסאות כגון GitHub, וכיצד להוסיף שלבי בנייה של Gradle לבניית חבילות APK מקוד מקור.

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

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

כדי ללמוד על קביעת תצורה של רכיבים ב-Jenkins, ראה הגדרת בנייה אוטומטית .

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

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

  1. הוסף שלב בנייה כדי להפעיל את הפקודות הבאות בספרייה הראשית עבור היישום שלך:

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

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

    <AppFolder>/app/build/outputs/apk
    

הוסף את שלבי הבנייה של מעבדת הבדיקה לג'נקינס

כעת אתה מוכן להוסיף שלב בנייה לג'נקינס כדי להפעיל את Test Lab באמצעות שורת הפקודה gcloud.

כדי להוסיף שלב בניית gcloud

  1. מהעמוד הראשי של הפרויקט שלך, לחץ על הגדר .
  2. בדף תצורת הפרויקט , גלול מטה למקטע Build ולאחר מכן בחר Execute shell מתפריט הוסף שלב בנייה .

  3. בחלון הפקודה של Jenkins Execute shell , הזן את הפרטים הבאים, תוך החלפת <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 .

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

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