קודם כדאי לקרוא את המאמר בדיקת האפליקציה באתר developer.android.com. חשוב לזכור שיש כמה הבדלים באופן שבו נעשה שימוש בבדיקות של מכשירי המדידה בבדיקת הפלטפורמה.
לסיכום, בדיקת מכשור מספקת סביבה מיוחדת לביצוע בדיקות, שמופעל באמצעות הפקודה am instrument. בתהליך הזה, תהליך האפליקציה המטורגט מופעל מחדש ומאותחם עם הקשר בסיסי של האפליקציה, וחווט מכשור מופעל בתוך המכונה הווירטואלית של תהליך האפליקציה. קוד הבדיקה מתחיל לפעול בשרשור המדידה הזה, ומקבל מופע של Instrumentation שמספק גישה להקשר של האפליקציה ולממשקי ה-API כדי לבצע פעולות על תהליך האפליקציה שנבדק.
מושגים מרכזיים
- צריך להצהיר על מכשיר למדידת ביצועים בחבילת אפליקציה, באמצעות תג
<instrumentation>שמוקן בתוך התג<manifest>של המניפסט של חבילת האפליקציה. - מבחינה טכנית, מניפסט של חבילת אפליקציה יכול להכיל כמה תגי
<instrumentation>, אבל בדרך כלל לא משתמשים בו בצורה הזו. - כל
<instrumentation>חייב להכיל:- מאפיין
android:name: זה צריך להיות השם של תת-סוג שלInstrumentationשמופיע באפליקציית הבדיקה, בדרך כלל הכלי להרצת הבדיקות שבו נעשה שימוש. לדוגמה:android.support.test.runner.AndroidJUnitRunner - צריך להגדיר מאפיין
android:targetPackage. הערך צריך להיות מוגדר לחבילת האפליקציה שנבדקת.
- מאפיין
סיכום השלבים
אלה יעדים נפוצים לבדיקות אטומות של שירותי מסגרת:
frameworks/base/core/tests/coretests frameworks/base/services/tests/servicestestsאם אתם מוסיפים מודול חדש לגמרי למדידה של הרכיב, תוכלו לעיין במאמר
לפי המוסכמה הקיימת, אם מוסיפים בדיקות לאחד מהמיקומים שלמעלה. אם מגדירים מודול בדיקה חדש, צריך לפעול לפי ההוראות להגדרה של
AndroidManifest.xmlו-Android.mkבאחד מהמיקומים שלמעלה.לדוגמה, frameworks/base/core/tests/coretests/. שימו לב שהשורות האלה מתקינות אפליקציות נוספות:
<option name="test-file-name" value="FrameworksCoreTests.apk" /> <option name="test-file-name" value="BstatsTestApp.apk" />חשוב לא לשכוח לסמן את הבדיקה בתור
@SmallTest, @MediumTestאו@LargeTestיצירת מודול הבדיקה באמצעות m, למשל:
m FrameworksCoreTestsמריצים את הבדיקות:
הפתרון הפשוט ביותר הוא להשתמש ב-Atest באופן הבא:
atest FrameworksCoreTestsלבדיקה מורכבת יותר, אפשר להשתמש בערכת הבדיקה של Trade Federation:
m tradefed-all tradefed.sh run template/local_min --template:map test=FrameworksCoreTestsאם אתם לא משתמשים ב-Tradefed, עליכם להתקין את הבדיקות ולהריץ אותן באופן ידני:
- מתקינים את קובץ ה-APK שנוצר:
adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apkמריצים את הבדיקות עם אפשרויות שונות:
כל הבדיקות ב-APK
adb shell am instrument -w com.android.frameworks.coretests\ /android.support.test.runner.AndroidJUnitRunnerכל הבדיקות בחבילת Java ספציפית
adb shell am instrument -w -e package android.animation \ com.android.frameworks.coretests\ /android.support.test.runner.AndroidJUnitRunnerכל הבדיקות בכיתה ספציפית
adb shell am instrument -w -e class \ android.animation.AnimatorSetEventsTest \ com.android.frameworks.coretests\ /android.support.test.runner.AndroidJUnitRunnerשיטת בדיקה ספציפית
adb shell am instrument -w -e class \ android.animation.AnimatorSetEventsTest#testCancel \ com.android.frameworks.coretests\ /android.support.test.runner.AndroidJUnitRunner
הבדיקה יכולה לבצע טענת נכוֹנוּת (assertion) מפורשת על אישור או על כישלון באמצעות ממשקי ה-API של JUnit. בנוסף, כל חריגה שלא תתפס תגרום גם לכישלון פונקציונלי.
כדי לשדר מדדי ביצועים, קוד הבדיקה יכול להפעיל את Instrumentation#sendStatus כדי לשלוח רשימה של צמדי מפתח/ערך. חשוב לזכור:
- המדדים יכולים להיות מספרים שלמים או מספרים עשרוניים
- ערכים לא מספריים יידחו
- קובץ ה-APK לבדיקה יכול לכלול בדיקות פונקציונליות או בדיקות מדדים, אבל כרגע אין תמיכה בשילוב של שתיהן