מדריך Selendroid למתחילים עם דוגמה

האם פיתחת פעם יישום אנדרואיד ופרסמת אותו ב- Google Play? מה תעשה אם תקבל סקירת משתמשים כמו -

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

מהו סלנדרואיד?

Selendroid היא מסגרת אוטומציה של בדיקות ליישומים ניידים מרובי סוגים: יָלִיד ו היברידי אפליקציית אנדרואיד ו נייד אינטרנט.

אתה יכול לכתוב את הבדיקות באמצעות ממשקי API של לקוח Selenium 2. מכיוון שסלנדרואיד עדיין עושה שימוש חוזר בתשתית הסלניום הקיימת לרשת

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

מדוע אנו זקוקים ל- Selendroid?

Selendroid הוא כלי בדיקה נהדר. אבל אתה עדיין יכול להטיל ספק בתועלתו.

חלק זה יציג את התכונות החשובות של Selendroid כדי לענות על השאלה מדוע אתה צריך את Selendroid.

  • אתה יכול לבדוק את היישום הנבדק באמצעות Selendroid ללא כל שינוי באפליקציה. אתה רק צריך את הקובץ הבינארי ( APK ) מותקן במחשב. על מנת להתקין את הקובץ הבינארי במכשיר, יש לחתום על אפליקציית הבדיקה והאפליקציה לנייד באותו מפתח שלט
  • אפליקציית הבדיקה Selendroid יכולה לתקשר עם מספר מכשירים או סימולטורים בו זמנית. זה יתרון גדול של Selendroid. אז אתה יכול לבדוק את האפליקציה שלך עם מכשירי Android שונים כדי לבדוק את התאימות.
  • Selendroid יכול לדמות פעולות משתמש-אנוש באפליקציה, כגון מגע, החלקה, גרירה ושחרור במכשירים
  • באפשרותך לשנות את התקני החומרה (חבר ונתק) במהלך הבדיקה מבלי להפעיל מחדש או לעצור את הבדיקה. Selendroid מזהה את המכשירים החדשים באופן אוטומטי
  • בהתאם לגרסת ה- API של Android, Selendroid תומך גם בממשק ה- API החדש של Android (מ- API 10 ל- API 19)
  • ל- Selendroid יש גם כלי מפקח מובנה שיעזור לך לזהות את רכיב ממשק המשתמש ביישום הנבדק. למשל לחצן המזהה, שדה הטקסט, תצוגת הטקסט ...

אדריכלות סלנדרואיד

Selendroid מבוסס על מסגרת מכשור אנדרואיד . בדיקות Selendroid נכתבות על בסיס ה- API של לקוח מנהלי התקנים של Selenium Web, כך שהוא תומך בשילוב מלא עם מסגרות סלניום נוכחיות.

האיור הבא מתאר את הארכיטקטורה של Selendroid

Selendroid מכיל 4 מרכיבים עיקריים:

  • לקוח מנהל התקן אינטרנט - ספריית הלקוחות של Java המבוססת על סלניום. יש להתקין ספרייה זו במחשב (המשמש לפיתוח מקרי הבדיקה)
  • Selendroid-Server - השרת המופעל נמצא באפליקציה הנבדקת במכשיר אנדרואיד או סימולטור. זהו המרכיבים העיקריים של ארכיטקטורת Selendroid
  • אפליקציית דרייבר אנדרואיד - מנהל התקן מובנה של אנדרואיד, אפליקציית Web View לבדיקת האינטרנט הסלולרי.
  • Selendroid-עצמאי - רכיב זה משמש להתקנת שרת Selendroid והיישום הנבדק (AUT)

תחילת העבודה עם Selendroid

אתה כבר יודע את החשיבות של Selendroid. עכשיו בואו נלכלך את הידיים עם סלנדרואיד.

יש לבצע 3 שלבים לפני הבדיקה הראשונה עם Selendroid

הגדרת סביבת Selendroid

Selendroid יכול לעבוד על Windows, Linux ו- Mac OS. במדריך זה נתקין את Selendroid במערכת ההפעלה Windows.

לפני השימוש ב- Selendroid, עליך להתקין תחילה את החבילה הבאה

  • Java SDK (מינימום 1.6)

    עליך לקבל את הסכם הרישיון ולהוריד את תוכנית ההתקנה של java (בחר x64 או x86 בסיס במערכת ההפעלה שלך)

    הורד והתקן את Java SDK כתוכנה רגילה

  • הגרסה האחרונה של אנדרואיד SDK
  • המחשב שלך חייב להכיל לפחות מכשיר וירטואלי אחד של Android (AVD) או מכשיר אנדרואיד אמיתי המחובר למחשב האישי.
  • Selendroid עצמאי עם תלות , לקוח Selendroid , ו לקוח סלניום
  • ליקוי חמה תוֹכנָה
  • הגדר את JAVA_HOME ו- ANDROID_HOME

    שלב 1) בחלון, לחץ לחיצה ימנית על מחשב -> נכסים -> הגדרת מערכת מתקדמת

    שלב 2) תצוגת חלון מאפייני מערכת, בחר בכרטיסייה מתקדם -> משתני סביבה

    שלב 3) תצוגת חלון הסביבה, לחץ על חדש -> הזן משתנה ANDROID_HOME כדלקמן

    ערך המשתנה הוא הנתיב ל- android-sdks שכבר התקנת.

    מצא את משתנה המערכת נתיב -> לַעֲרוֹך -> הוסף את השורה הבאה אחרי השורה הנוכחית

    בדומה ל- ANDROID_HOME, הוסף משתנה חדש JAVA_HOME עם ערך כמפורט להלן

    הערך הוא הנתיב להתקנת Java JDK שלך

    שלב 4) הפעל מחדש את המחשב האישי שלך -> בוצע

כיצד להפעיל את Selendroid

שלב 1) קבלת יישום בבדיקה

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

לאחר השלמת ההורדה, העתק את ה- APK הזה ואת האמור לעיל צנצנת עצמאית Selendroid קובץ לתיקייה עם השם ' גורו 99 '

שלב 2) הפעל את Selendroid

פתח את הטרמינל ב- Windows ונווט אל התיקיה שגורו 99 שנוצר בשלב 1.

הפעל את הפקודה הבאה

הפלט יוצג כדלקמן

לאחר הפעלת פקודה זו, שרת HTTP עצמאי של Selendroid מתחיל! מספר יציאת ברירת המחדל של שרת זה הוא 4444. כל מכשיר החומרה, כמו גם מכשיר וירטואלי של Android, ייסרקו ויזוהו באופן אוטומטי. Selendroid יזהה את גרסת היעד של Android וגודל מסך המכשיר.

כדי לבדוק את גרסת היעד של Android וכן את פרטי המכשיר, תוכל להפעיל את כתובת האתר הבאה בדפדפן:

http: // localhost: 4444/wd/hub/status .

פקודה בסיסית של Selendroid

חלק זה מציג בפניך כמה שורות פקודה בסיסיות של Selendroid-Standalone. תוכל להשתמש בהם כדי להגדיר את סביבת הבדיקות של Selendroid

  1. הגדרת יציאת Selendroid

    יציאת ברירת המחדל של Selendroid היא 4444. אך תוכל לשנות ליציאה אחרת על ידי הוספת פרמטר לפקודה להפעלת Selendroid.

    פרמטר: -יציאה [מספר יציאה]

    לדוגמה:

    בפקודה למעלה, 5555 הוא הנמל החדש.

אז כתובת האתר לבדיקת גרסת היעד של Android משתנה ל: http: // localhost: 5555/wd/hub/status

  1. ציין את מיקום האפליקציה הנבדקת (קובץ APK בינארי). Selendroid לעתים קרובות דרש את הנתיב המוחלט לקובץ זה

    פרמטר: -אפ [נתיב קובץ]

    לדוגמה:

    בפקודה למעלה, Selendroid מוצא אוטומטית את בסיס הקבצים הבינארי ב- 'C: Guru99App.apk' כדי לקבל את המידע של היישום הנבדק.

    בדוק את כתובת האתר http: // localhost: 4444/wd/hub/status , תראה מידע זה

  2. שנה את היציאה שבה Selendroid משתמש כדי לתקשר עם שרת המכשור. Selendroid משתמש ביציאה 8080 כברירת מחדל

    פרמטרים: -selendroidServerPort [מספר יציאה]

    דוגמא

    הנמל כעת שונה ל 9000

  3. שנה את הזמן הקצוב להפעלת אמולטורים. היחידה היא מילי שניות.

    פרמטר: -timeoutEmulatorStart

    כברירת מחדל, Selendroid יחכה 300,000 אלפיות השנייה עד שהאמולטור יתחיל. אתה יכול לשנות את הזמן הקצוב החדש (200,000 אלפיות השנייה) על ידי פקודה

    לאחר זמן זה פג תוקפו, אם לא ניתן להפעיל את האמולטור, ה- Selendroid יזרק את שגיאת החריגה (אירעה שגיאה בעת חיפוש התקנים/אמולטורים) ואז יפסיק לפעול

  4. כאשר תפעיל את הפקודה Selendroid במסוף, תראה יומן מודפס על המסך. אתה יכול לשנות את סוג היומן שאתה רואה על ידי הוספת הפרמטר הבא

    פרמטר: -logLevel [ סוג של יומן ]

    ערכי רמת היומן הם ERROR, WARNING, INFO, DEBUG ו- VERBOSE. ברירת מחדל: שגיאה.

    לדוגמה, הגדר את Selendroid להדפיס את יומן האזהרה בלבד, תוכל להשתמש בפקודה זו

    Selendroid מדפיסים רק את יומן האזהרה

התחל את הבדיקה הראשונה שלך עם Selendroid

חלק זה הוא מדריך צעד אחר צעד ליצירת סקריפט הבדיקה הראשון שלך באמצעות Selendroid

נניח שיש לנו יישום אנדרואיד תחת שם הבדיקה Guru99App. היישום כולל שדה טקסט ושם לחצן 'הצג טקסט'.

הורד את ה- APK כאן

עלינו לבצע את הפעולות הבאות מקרה מבחן באמצעות Selendroid

מקרי מבחן

מַצָב

תפוקה צפויה:

  1. הפעל את היישום
  2. הזן טקסט ' מבחן גורו 99 'לשדה הטקסט
  3. לחץ על כפתור 'הצג טקסט'

הבינארי של היישום הנבדק זמין

מכשיר מחובר למחשב

הטקסט 'הצג טקסט כאן' משתנה לטקסט

איזה משתמש הזן בשדה טקסט

שלב 1) צור פרויקט Java ב- Eclipse

שלב 2) הוסף סלניום וקובץ סלנדרואיד בסביבות ליקוי חמה

לחץ לחיצה ימנית על פרויקט Guru99Test -> בנה שביל -> הוסף ארכיון חיצוני

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

יש להוסיף 3 קבצי צנצנות

  • selendroid-client-0.10.0.jar: ספריית לקוחות Java של Selendroid
  • selendroid-standalone-0.11.0-with-dependencies: ספריית שרתים עצמאית של Selendroid
  • selenium-java-2.40.0.jar: ספריית מנהלי ההתקנים של סלניום

בחר הכל -> בחר פתח כדי להוסיף קובץ jar לפרויקט

שלב 3) לאחר הוספת הספרייה לעיל, ספריות אלה יתווספו לספריות ההתייחסות של פרויקט הבדיקה. בודק יכול להשתמש בממשקי ה- API של אותן ספריות כדי לפתח את תוכנית הבדיקה

צור חבילה 'com.guru.test' והוסף קובץ ג'אווה 'Guru99Test.java' כמו למטה

קליק ימני Guru99Test -> חָדָשׁ -> חֲבִילָה

הקלד com.guru.test לשדה שם בתיבת הדו -שיח חבילת ג'אווה חדשה à סיום

הליקוי ייצור תיקיות רשימה ותיקיות משנה כאלה במבנה קוד המקור

שלב 4) להתקין TestNG עבור ליקוי חמה


ב- Eclipse, עזרה -> התקן תוכנה חדשה, בתיבת הדו -שיח התקנה, לחץ על הוסף והזן את הדברים הבאים

לחץ על אישור -> הבא להתקנת TestNG

שלב 5) העתק את ה- Guru99App.apk לתיקייה של אפליקציית הבדיקה

שלב 6) קבל את מזהה האפליקציה הנבדקת.

נניח שיש לנו שם קובץ APK Guru99App.apk. בצע את הצעד המתואר בסעיף הקודם, בצע את הפקודה במסוף

פתח את הקישור הבא בדפדפן

http: // localhost: 4444/wd/hub/status .

פרטי המכשיר מוצגים, העתק את ערך appId 'com.on2vhfapp: 1.0'

שלב 7) פתח את הקובץ Guru99Test.java (בקוד לדוגמא) ושנה כדלקמן

כדי ליצור פגישת בדיקה חדשה עם Selendroid, עליך לספק את מזהה האפליקציה בפורמט: com.on2vhfapp: 1.0 . מזהה האפליקציה הזה מזוהה בשלב 6. אם לא תגדיר את מזהה האפליקציה התואם את מכשיר ה- Android, הפעלת הבדיקה תטיל שגיאה ולא תתחיל.

לאחר אתחול המכשיר שנמצא, Selendroid יוצר שרת selendroid מותאם ומתקין עליו את שרת Selendroid.

Selendroid מתקין גם את היישום הנבדק ומפעיל את שרת selendroid במכשיר

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

שלב 8) התחל את מפגש הבדיקה החדש

הפעל את שרת Selendroid באמצעות הפקודה הבאה במסוף כמו שלב 6

לאחר שהשרת Selendroid התחיל, פתח את פרויקט הבדיקה לדוגמה Guru99test on Eclipse, הגדר נקודת שבירה בשורה 77 בקובץ Guru99Test.java בלחיצה כפולה לשורה 77 -> נקודה תוצג כמו להלן

התחל מפגש בדיקה בלחיצה ימנית על פרוייקט Guru99Test -> איתור באגים בשם -> בדיקות מִבְחָן.

מפגש בדיקה יתחיל כמו להלן

שלב 9) קבל את רכיב ה- ID של GUI ביישום הנבדק

לאחר הפעלת הבדיקה בהצלחה, פתח את הדפדפן, נווט אל כתובת האתר http: // localhost: 4444/מפקח

תראה שהיישום הנבדק מופעל כמו להלן

השתמש בריחוף עכבר לכל רכיב ממשק משתמש של AUT (לחצן, TextField, תווית טקסט), המזהה של כל רכיב יסומן בחלונית הימנית

לאחר שלב זה, תוכל לקבל את המזהה של כל רכיב ממשק משתמש מעל

  • לחצן הצג מזהה טקסט: ' btnShow '
  • מזהה שדה טקסט: ' edtText '
  • מזהה טקסט תווית: ' txtView '

תעודות זהות אלה ישמשו בשלב הבא

שלב 10) היכנס לתוכנית הבדיקה כמו להלן

תוכנית בדיקה באמצעות Selendroid כוללת 3 חלקים

בדיקת התקנה:

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

הקוד כולל את ההערות להסבר כל הצהרה. | _+_ |

בצע בדיקה

להלן הקוד לביצוע בדיקה. הקוד כולל את ההערות

להלן שוב שלבי הבדיקה

  1. הזן את הטקסט 'שלום גורו'
  2. לחץ על הצג לחצן טקסט
  3. חכה רגע
  4. ודא שהאפליקציה מציגה את הטקסט כשמשתמש נכנס לשדה טקסט (למשל הצג את הטקסט 'שלום גורו')
package com.guru.test; import io.selendroid.SelendroidCapabilities; import io.selendroid.SelendroidConfiguration; import io.selendroid.SelendroidDriver; import io.selendroid.SelendroidLauncher; import io.selendroid.device.DeviceTargetPlatform; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.testng.Assert; import org.testng.annotations.AfterSuite; import org.testng.annotations.BeforeSuite; import org.testng.annotations.Test; /** * @author Guru99 Test App using Selendroid * Application under test: Guru99App * */ public class Guru99Test { //Declare web driver variable private WebDriver driver; /** * Setup the environment before testing * @throws Exception */ @BeforeSuite public void setUp() throws Exception { //Start selendroid-standalone during test SelendroidConfiguration config = new SelendroidConfiguration(); // Add the selendroid-test-app to the standalone server config.addSupportedApp('Guru99App.apk'); //start the standalone server SelendroidLauncher selendroidServer = new SelendroidLauncher(config); selendroidServer.launchSelendroid(); // Create the selendroid capabilities SelendroidCapabilities capa = new SelendroidCapabilities(); // Specify to use selendroid's test app capa.setAut('com.on2vhfapp:1.0'); // Specify to use the Android device API 19 capa.setPlatformVersion(DeviceTargetPlatform.ANDROID19); // Don't request simulator, use real device capa.setEmulator(false); //capa.wait(10000000); // Create instance of Selendroid Driver driver = new SelendroidDriver(capa); } 

סיים את הבדיקה

הקוד הבא ישלים את הבדיקה על ידי עצירת מנהל ההתקן של Selendroid. | _+_ |

תוכל לראות את הפירוט בקוד לדוגמא הכלול במאמר זה.

שלב 10) חבר מכשיר אנדרואיד למחשב באמצעות כבל USB. נקודות שצריך לשים לב אליהן -

  • אנא וודא שהמכשיר אינו מוגדר נעילת מסך.
  • יש לחבר התקנים באמצעות USB למחשב שבו selendroid עצמאי הרכיב פועל.
  • המכשיר צריך להתקין לפחות גרסת Android 10 של גירסת היעד

שלב 11) הפעל את אפליקציית הבדיקה: לחץ לחיצה ימנית על Guru99test -> רץ כמו -> מבחן TestNG

שלב 10) הסקריפט מתחיל לפעול כדלקמן

שלב 12) לאחר ביצוע הבדיקה, TestNG יוצר אוטומטית את דוח הבדיקה כדלקמן

עבודה טובה, סיימת את הבדיקה עכשיו.

סיכום

סיכום

  • Selendroid הוא כלי רב עוצמה לבדיקת אפליקציה מקומית של אנדרואיד, האפליקציה ההיברידית כמו גם אפליקציית האינטרנט.
  • ניתן להשתמש בו במכשירים אמיתיים כמו גם בסימולטור.
  • הוא גם מאפשר לך להריץ בדיקות במקביל על ידי הפעלת בדיקה במכשירים מרובים.
  • חבילת Selendroid כולה מורכבת מארבעה מרכיבים:
    • לקוח מנהל התקן אינטרנט,
    • שרת selendroid,
    • אפליקציית נהג אנדרואיד
    • Selendroid- לעמוד לבד
  • כדי להשתמש ב- Selendroid עליך להתקין Java JDK, Android SDK ו- Eclipse.