TestDevice.MicrodroidBuilder

public static class TestDevice.MicrodroidBuilder
extends Object

java.lang.Object
   ↳ com.android.tradefed.device.TestDevice.MicrodroidBuilder


כלי לבנייה שמשמש ליצירת Microdroid TestDevice.

סיכום

‫methods ציבוריים

TestDevice.MicrodroidBuilder addAssignableDevice(String sysfsNode)

הוספת מכשיר להקצאה ל-microdroid.

TestDevice.MicrodroidBuilder addBootFile(File localFile, String remoteFileName)

הוספת קובץ לאתחול שיועבר אל ERROR(/#TEST_ROOT).

TestDevice.MicrodroidBuilder addExtraIdsigPath(String extraIdsigPath)

הוספת קובץ idsig נוסף לרשימה.

TestDevice.MicrodroidBuilder addTestDeviceOption(String optionName, String valueText)

הגדרת TestDeviceOptions ל-TestDevice של microdroid.

ITestDevice build(TestDevice device)

מפעיל TestDevice של Micrdroid ב-TestDevice הנתון.

TestDevice.MicrodroidBuilder cpuAffinity(String affinity)

הגדרה של מעבדי המארח שבהם המעבדים הווירטואליים יכולים לפעול.

TestDevice.MicrodroidBuilder cpuTopology(String cpuTopology)

הגדרת טופולוגיית המעבד.

TestDevice.MicrodroidBuilder debugLevel(String debugLevel)

הגדרת רמת הניפוי באגים.

TestDevice.MicrodroidBuilder dumpDt(String dumpDt)

מגדיר את הנתיב שבו יתבצע ה-dump של ה-blob של פירוט מבנה המכשיר (DT).

TestDevice.MicrodroidBuilder enableEarlycon(boolean enableEarlycon)

ההגדרה הזו מאפשרת להציג את יומני earlycon עבור מכונת ה-VM הזו.

TestDevice.MicrodroidBuilder forceStartAdbd(boolean forceStartAdbd)

מבצע קריאה בכוח ל-`vm start-adbd` בין `vm run` ל-`adb forward`

הערה: ברמות API ישנות יותר (לפני SDK 36) הפונקציה הזו לא מבצעת פעולה.

static TestDevice.MicrodroidBuilder fromDevicePath(String apkPath, String configPath)

יוצר Microdroid builder עבור apkPath וקובץ התצורה של מטען הייעודי (payload) ב-APK.

static TestDevice.MicrodroidBuilder fromDevicePathWithPayloadBinaryName(String apkPath, String payloadBinaryName)

יוצר Microdroid builder עבור apkPath הנתון ושם הבינארי של המטען הייעודי (payload) ב-APK.

static TestDevice.MicrodroidBuilder fromFile(File apkFile, String configPath)

יוצר כלי ליצירת Microdroid עבור קובץ ה-APK הנתון וקובץ התצורה של מטען הייעודי (payload) ב-APK.

TestDevice.MicrodroidBuilder gki(String version)

השיטה הזו הוצאה משימוש. להשתמש ב-os(String).

TestDevice.MicrodroidBuilder hugePages(boolean hintHugePages)

ההגדרה קובעת אם להציע לליבה להשתמש בדפים גדולים שקופים.

TestDevice.MicrodroidBuilder instanceIdFile(String instanceIdPath)

מגדירה את הנתיב של instance_id.

TestDevice.MicrodroidBuilder instanceImgFile(String instanceImgPath)

מגדיר את נתיב הקובץ instance.img.

TestDevice.MicrodroidBuilder memoryMib(int memoryMib)

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

TestDevice.MicrodroidBuilder name(String name)

מגדיר את השם של מכונת ה-VM.

TestDevice.MicrodroidBuilder numCpus(int num)

הגדרת מספר המעבדים הווירטואליים במכונה הווירטואלית.

TestDevice.MicrodroidBuilder os(String os)

נעשה שימוש בווריאנט לא מוגדר כברירת מחדל של Microdroid OS.

TestDevice.MicrodroidBuilder protectedVm(boolean isProtectedVm)

קובעת אם מכונת ה-VM תהיה מוגנת או לא.

TestDevice.MicrodroidBuilder ramdump(boolean useRamdump)

ההגדרה הזו קובעת אם להשבית את ליבת הקראש עבור ramdump.

TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs(long timeoutMs)

הגדרת הזמן הקצוב לתפוגה של adb connect ל-TestDevice ב-microdroid באלפיות השנייה.

‫methods ציבוריים

addAssignableDevice

public TestDevice.MicrodroidBuilder addAssignableDevice (String sysfsNode)

הוספת מכשיר להקצאה ל-microdroid.

פרמטרים
sysfsNode String: הנתיב לצומת sysfs להקצאה

החזרות
TestDevice.MicrodroidBuilder ה-builder של microdroid.

addBootFile

public TestDevice.MicrodroidBuilder addBootFile (File localFile, 
                String remoteFileName)

הוספת קובץ לאתחול שיועבר אל ERROR(/#TEST_ROOT).

כדאי להשתמש בשיטה הזו אם נדרש קובץ כדי להפעיל את microdroid. אחרת, משתמשים ב-TestDevice.pushFile.

פרמטרים
localFile File: הקובץ המקומי במארח

remoteFileName String: שם הקובץ המרוחק במכשיר

החזרות
TestDevice.MicrodroidBuilder ה-builder של microdroid.

addExtraIdsigPath

public TestDevice.MicrodroidBuilder addExtraIdsigPath (String extraIdsigPath)

הוספת קובץ idsig נוסף לרשימה.

פרמטרים
extraIdsigPath String

החזרות
TestDevice.MicrodroidBuilder

addTestDeviceOption

public TestDevice.MicrodroidBuilder addTestDeviceOption (String optionName, 
                String valueText)

הגדרת TestDeviceOptions ל-TestDevice של microdroid.

פרמטרים
optionName String: השם של TestDeviceOption שרוצים להגדיר

valueText String: הערך

החזרות
TestDevice.MicrodroidBuilder ה-builder של microdroid.

לבנות גרסת build

public ITestDevice build (TestDevice device)

מפעיל TestDevice של Micrdroid ב-TestDevice הנתון.

פרמטרים
device TestDevice

החזרות
ITestDevice

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

cpuAffinity

public TestDevice.MicrodroidBuilder cpuAffinity (String affinity)

ההגדרה קובעת באילו מעבדים (CPU) של המארח יכולים לפעול המעבדים הווירטואליים (vCPU). הפורמט הוא רשימה מופרדת בפסיקים של מעבדים או טווחי מעבדים להפעלת מעבדי vCPU. לדוגמה, '0,1-3, 5' כדי לבחור במעבדים 0, 1, 2, 3 ו-5 של המארח. או רשימה מופרדת באמצעות נקודתיים של הקצאות של vCPU להקצאות של CPU במארח. לדוגמה: ‎"0=0:1=1:2=2"‎ כדי למפות vCPU 0 ל-CPU במארח 0, וכן הלאה.

התכונה נתמכת רק ב-Android T.

פרמטרים
affinity String

החזרות
TestDevice.MicrodroidBuilder

cpuTopology

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

הגדרת טופולוגיית המעבד. ערכים נתמכים: one_cpu ו-match_host.

פרמטרים
cpuTopology String

החזרות
TestDevice.MicrodroidBuilder

debugLevel

public TestDevice.MicrodroidBuilder debugLevel (String debugLevel)

הגדרת רמת הניפוי באגים.

הערכים הנתמכים: none ו-full. ב-Android T יש גם תמיכה בערך app_only.

פרמטרים
debugLevel String

החזרות
TestDevice.MicrodroidBuilder

dumpDt

public TestDevice.MicrodroidBuilder dumpDt (String dumpDt)

מגדיר את הנתיב שבו יתבצע ה-dump של ה-blob של פירוט מבנה המכשיר (DT).

ערכים נתמכים: null ו-'path'.

פרמטרים
dumpDt String

החזרות
TestDevice.MicrodroidBuilder

enableEarlycon

public TestDevice.MicrodroidBuilder enableEarlycon (boolean enableEarlycon)

ההגדרה הזו מאפשרת להציג את יומני earlycon עבור מכונת ה-VM הזו.

הערה: ברמות API ישנות יותר (לפני SDK 36) הפונקציה הזו לא מבצעת פעולה.

פרמטרים
enableEarlycon boolean

החזרות
TestDevice.MicrodroidBuilder ה-builder של Microdroid.

forceStartAdbd

public TestDevice.MicrodroidBuilder forceStartAdbd (boolean forceStartAdbd)

מבצע קריאה בכוח ל-`vm start-adbd` בין `vm run` ל-`adb forward`

הערה: ברמות API ישנות יותר (לפני SDK 36) הפונקציה הזו לא מבצעת פעולה.

פרמטרים
forceStartAdbd boolean

החזרות
TestDevice.MicrodroidBuilder ה-builder של microdroid.

fromDevicePath

public static TestDevice.MicrodroidBuilder fromDevicePath (String apkPath, 
                String configPath)

יוצר Microdroid builder עבור apkPath וקובץ התצורה של מטען הייעודי (payload) ב-APK.

פרמטרים
apkPath String

configPath String

החזרות
TestDevice.MicrodroidBuilder

fromDevicePathWithPayloadBinaryName

public static TestDevice.MicrodroidBuilder fromDevicePathWithPayloadBinaryName (String apkPath, 
                String payloadBinaryName)

יוצר Microdroid builder עבור apkPath הנתון ושם הבינארי של המטען הייעודי (payload) ב-APK.

פרמטרים
apkPath String

payloadBinaryName String

החזרות
TestDevice.MicrodroidBuilder

fromFile

public static TestDevice.MicrodroidBuilder fromFile (File apkFile, 
                String configPath)

יוצר כלי ליצירת Microdroid עבור קובץ ה-APK הנתון וקובץ התצורה של מטען הייעודי (payload) ב-APK.

פרמטרים
apkFile File

configPath String

החזרות
TestDevice.MicrodroidBuilder

gki

public TestDevice.MicrodroidBuilder gki (String version)

השיטה הזו הוצאה משימוש.
אפשר להשתמש ב-os(String).

שימוש בקרנל GKI במקום בקרנל microdroid

פרמטרים
version String: גרסת ה-GKI לשימוש

החזרות
TestDevice.MicrodroidBuilder

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

ההגדרה קובעת אם להציע לליבה להשתמש בדפים גדולים שקופים.

פרמטרים
hintHugePages boolean

החזרות
TestDevice.MicrodroidBuilder ה-builder של Microdroid.

instanceIdFile

public TestDevice.MicrodroidBuilder instanceIdFile (String instanceIdPath)

מגדירה את הנתיב של instance_id.

פרמטרים
instanceIdPath String: : הנתיב ל-instanceId

החזרות
TestDevice.MicrodroidBuilder

instanceImgFile

public TestDevice.MicrodroidBuilder instanceImgFile (String instanceImgPath)

מגדיר את נתיב הקובץ instance.img.

פרמטרים
instanceImgPath String

החזרות
TestDevice.MicrodroidBuilder

memoryMib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

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

פרמטרים
memoryMib int

החזרות
TestDevice.MicrodroidBuilder

שם

public TestDevice.MicrodroidBuilder name (String name)

מגדיר את השם של מכונת ה-VM.

פרמטרים
name String

החזרות
TestDevice.MicrodroidBuilder ה-builder של Microdroid.

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

הגדרת מספר המעבדים הווירטואליים במכונה הווירטואלית. ברירת המחדל היא 1.

התכונה נתמכת רק ב-Android T.

פרמטרים
num int

החזרות
TestDevice.MicrodroidBuilder

os

public TestDevice.MicrodroidBuilder os (String os)

נעשה שימוש בווריאנט לא מוגדר כברירת מחדל של Microdroid OS.

פרמטרים
os String: גרסת מערכת ההפעלה של Microdroid שבה ייעשה שימוש

החזרות
TestDevice.MicrodroidBuilder

protectedVm

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

קובעת אם מכונת ה-VM תהיה מוגנת או לא.

פרמטרים
isProtectedVm boolean

החזרות
TestDevice.MicrodroidBuilder

ramdump

public TestDevice.MicrodroidBuilder ramdump (boolean useRamdump)

ההגדרה הזו קובעת אם להשבית את ליבת הקראש עבור ramdump.

פרמטרים
useRamdump boolean

החזרות
TestDevice.MicrodroidBuilder ה-builder של microdroid.

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

הגדרת הזמן הקצוב לתפוגה של adb connect ל-TestDevice ב-microdroid באלפיות השנייה.

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

פרמטרים
timeoutMs long: פסק הזמן באלפיות השנייה

החזרות
TestDevice.MicrodroidBuilder