Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

התחל לבדוק עם מערכות CI

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

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

סעיף זה מתאר כיצד להשתמש מבחן מעבדה עם ג'נקינס CI .

דרישות

לפני שתוכל להשתמש במעבדת הבדיקות של Firebase עם ג'נקינס, עליך להשלים את השלבים הבאים:

  1. הגדר את gcloud. בצע את ההוראות מ שימוש Firebase Test Lab מן gcloud Command Line ליצור פרויקט Firebase ולהגדיר בסביבת ענן SDK Google המקומי שלך.

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

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

התקן והתקן את ג'נקינס

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שילוב עם GitHub ומערכות בקרת עדכונים אחרות

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

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

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

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

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

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

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

    <AppFolder>/app/build/outputs/apk
    

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

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

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

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

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

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

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

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

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