החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

TestDevice.MicrodroidBuilder

public static class TestDevice.MicrodroidBuilder
extends Object

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

ה-builder שמשמש ליצירת Microdroid TestDevice.

סיכום

שיטות ציבוריות
`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)` הפעלת מכשיר בדיקה של Micrdroid במכשיר הבדיקה הנתון.
`TestDevice.MicrodroidBuilder`	`cpuAffinity(String affinity)` ההגדרה קובעת באילו מעבדים של המארח המעבדים הווירטואליים יכולים לפעול.
`TestDevice.MicrodroidBuilder`	`cpuTopology(String cpuTopology)` הגדרת תצורת הטופולוגיה של המעבד.
`TestDevice.MicrodroidBuilder`	`debugLevel(String debugLevel)` הגדרת רמת ניפוי הבאגים.
`TestDevice.MicrodroidBuilder`	`dumpDt(String dumpDt)` הגדרת הנתיב שבו יתבצע דמפ של blob של פירוט מבנה המכשיר.
`static TestDevice.MicrodroidBuilder`	`fromDevicePath(String apkPath, String configPath)` יצירת ה-build של Microdroid עבור apkPath שצוין וקובץ התצורה של מטען הייעודי ב-APK.
`static TestDevice.MicrodroidBuilder`	`fromFile(File apkFile, String configPath)` יצירת ה-build של Microdroid לחבילת ה-APK ולקובץ התצורה של עומס העבודה ב-APK.
`TestDevice.MicrodroidBuilder`	`gki(String version)` השיטה הזו הוצאה משימוש. להשתמש ב-`os(String)`.
`TestDevice.MicrodroidBuilder`	`hugePages(boolean hintHugePages)` הגדרה של האפשרות להציע לליבה להשתמש ב-hugepages שקופים.
`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)` הגדרת שם למכונה הווירטואלית הזו.
`TestDevice.MicrodroidBuilder`	`numCpus(int num)` הגדרת מספר יחידות ה-vCPU במכונה הווירטואלית.
`TestDevice.MicrodroidBuilder`	`os(String os)` נעשה שימוש בגרסה שאינה ברירת המחדל של Microdroid OS.
`TestDevice.MicrodroidBuilder`	`protectedVm(boolean isProtectedVm)` הגדרה של הגנה על המכונה הווירטואלית או לא.
`TestDevice.MicrodroidBuilder`	`setAdbConnectTimeoutMs(long timeoutMs)` הגדרת זמן הקצאת הזמן לתפוגה של adb connect ל-microdroid TestDevice במיליסקונד.

שיטות ציבוריות

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. אחרת, משתמשים ב-NativeDevice.pushFile(File, String).

פרמטרים
`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)

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

פרמטרים
`device`	`TestDevice`

החזרות
`ITestDevice`

זריקות
`DeviceNotAvailableException`

cpuAffinity

public TestDevice.MicrodroidBuilder cpuAffinity (String affinity)

ההגדרה קובעת באילו מעבדים של המארח המעבדים הווירטואליים יכולים לפעול. הפורמט הוא רשימה מופרדת בפסיקים של מעבדים או טווחי מעבדים שבהם רוצים להריץ מעבדי 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)

הגדרת הנתיב שבו יתבצע דמפ של blob של פירוט מבנה המכשיר.

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

פרמטרים
`dumpDt`	`String`

החזרות
`TestDevice.MicrodroidBuilder`

fromDevicePath

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

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

פרמטרים
`apkPath`	`String`
`configPath`	`String`

החזרות
`TestDevice.MicrodroidBuilder`

fromFile

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

יצירת ה-build של Microdroid לחבילת ה-APK ולקובץ התצורה של עומס העבודה בקובץ ה-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)

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

פרמטרים
`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)

הגדרת שם למכונה הווירטואלית הזו.

פרמטרים
`name`	`String`

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

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

הגדרת מספר יחידות ה-vCPU במכונה הווירטואלית. ברירת המחדל היא 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)

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

פרמטרים
`isProtectedVm`	`boolean`

החזרות
`TestDevice.MicrodroidBuilder`

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

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

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

החזרות
`TestDevice.MicrodroidBuilder`