iNativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

תתי-מחלקות עקיפות ידועות IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, remoteAndroidDevice, AndroidVirtualDevice, TestDevice IManagedTestDevice מכשיר ITestDevice שמחזור החיים שלו מנוהל.  ITestDevice מספק API מהימן ברמה קצת יותר גבוהה ל-ddmlib IDevice.  LocalAndroidVirtualDevice המחלקה למכשירים וירטואליים מקומיים שפועלים ב-TrendFed host.  ManagedRemoteDevice מכשיר שפועל במכונה וירטואלית שאנחנו מנהלים מרחוק דרך מכונה של Tradeified בתוך המכונה הווירטואלית.  NativeDevice הטמעת ברירת מחדל של מכשירי Android בסטאק ITestDevice שלא במצב מלא.  NestedremoteDevice ייצוג של המכשיר שפועל ב-VM מרחוק של Cuttlefish.  RemoteAndroidDevice הטמעה של ITestDevice למכשיר Android בסטאק מלא שמחובר דרך adb Connect.  RemoteAndroidVirtualDevice הרחבת ההתנהגות של RemoteAndroidDevice למכשירי Android מסוג סטאק מלא שפועל ב-Google Compute Engine (Gce).  TestDevice הטמעה של ITestDevice למכשיר Android בסטאק מלא

---

מספק API מהימן ברמה קצת יותר גבוהה ל-ddmlib IDevice.

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

סיכום

קבועים
int	UNKNOWN_API_LEVEL ערך ברירת המחדל שאי אפשר לזהות את רמת ה-API

שיטות ציבוריות
abstract boolean	checkApiLevelAgainstNextRelease(int strictMinLevel) לבדוק אם תכונה מסוימת נתמכת כרגע בהינתן רמה מינימלית של תמיכה.
abstract void	clearLogcat() מחיקת כל נתוני ה-Logcat שהצטברו.
abstract void	deleteFile(String deviceFilePath) שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
abstract void	deleteFile(String deviceFilePath, int userId) שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
abstract boolean	deviceSoftRestarted(ProcessInfo prevSystemServerProcess) שיטה שעוזרת לבדוק אם המכשיר הופעל מחדש באמצעות השוואת השרת system_server הנוכחי ל-system_server הקודם ProcessInfo.
abstract boolean	deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit) שיטה של עוזרת לבדוק אם המכשיר הופעל מחדש מאז זמן UTC מאז תחילת התקופה של ההגדרה, מהמכשיר ומ-ERROR(/TimeUnit).
abstract boolean	disableAdbRoot() משבית את שורש adb.
abstract boolean	doesFileExist(String deviceFilePath) שיטה עוזרת לקבוע אם קובץ קיים במכשיר.
abstract boolean	enableAdbRoot() הפעלת השורש של adb.
abstract String	executeAdbCommand(long timeout, String... commandArgs) שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
abstract String	executeAdbCommand(String... commandArgs) שיטת עזרה שמבצעת פקודת adb כפקודת מערכת.
abstract String	executeAdbCommand(long timeout, envMap, String... commandArgs) שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
abstract CommandResult	executeFastbootCommand(long timeout, String... commandArgs) שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת.
abstract CommandResult	executeFastbootCommand(String... commandArgs) שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה של 2 דקות כברירת מחדל.
abstract CommandResult	executeLongFastbootCommand(String... commandArgs) שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת.
abstract CommandResult	executeLongFastbootCommand( envVarMap, String... commandArgs) שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) בהרצה ארוכה כפקודת מערכת עם משתני סביבה של המערכת.
abstract String	executeShellCommand(String command) שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור String.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
abstract void	executeShellCommand(String command, IShellOutputReceiver receiver) מפעיל את פקודת המעטפת הנתונה של adb, ומנסה שוב מספר פעמים אם הפקודה נכשלת.
abstract CommandResult	executeShellV2Command(String command) שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
abstract CommandResult	executeShellV2Command(String command, OutputStream pipeToOutput) שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, שמאוכלס כראוי בפלט סטטוס הפקודה וב-stderr.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput) שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
abstract CommandResult	executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit) מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
abstract CommandResult	executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
abstract CommandResult	fastbootWipePartition(String partition) שיטה לעזרה באיפוס המחיצה של המכשיר.
abstract int	getApiLevel() מאתרים את רמת ה-API של המכשיר.
abstract String	getBasebandVersion() שיטת הנוחות לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה.
abstract Integer	getBattery() מחזירה את רמת הטעינה הנוכחית של הסוללה של מכשיר או את הערך Null אם רמת הסוללה לא זמינה.
abstract boolean	getBooleanProperty(String name, boolean defaultValue) מחזירה ערך בוליאני של המאפיין הנתון.
abstract	getBootHistory() תכונת העזרה אוספת את המפה של היסטוריית האתחול עם זמן האתחול וסיבת האתחול.
abstract	getBootHistorySince(long utcEpochTime, TimeUnit timeUnit) שיטת העזרה אוספת את מפת היסטוריית האתחול עם זמן האתחול וסיבת האתחול מאז הזמן הנתון מאז תחילת השימוש במכשיר ויחידת הזמן שצוינה.
abstract String	getBootloaderVersion() שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה.
abstract String	getBuildAlias() מאחזרים את הכינוי של ה-build שהמכשיר פועל כרגע.
abstract String	getBuildFlavor() מאחזרים את גרסת ה-build של המכשיר.
abstract String	getBuildId() מאחזרים את גרסת ה-build שהמכשיר פועל כרגע.
abstract String	getBuildSigningKeys() פונקציה זו מחזירה את סוג המפתח המשמש לחתימה על תמונת המכשיר בדרך כלל, מכשירי Android חתומים על ידי מפתחות בדיקה (כמו ב-AOSP) או באמצעות מפתחות הפצה (שנשלטים על ידי יצרני מכשירים נפרדים)
abstract DeviceDescriptor	getCachedDeviceDescriptor() הפונקציה מחזירה ערך DeviceDescriptor שנשמר במטמון אם המכשיר מוקצה. אחרת, מחזירה את הערך הנוכחי של DeviceDescriptor.
abstract DeviceDescriptor	getCachedDeviceDescriptor(boolean shortDescriptor) הפונקציה מחזירה ערך DeviceDescriptor שנשמר במטמון אם המכשיר מוקצה. אחרת, מחזירה את הערך הנוכחי של DeviceDescriptor.
abstract String[]	getChildren(String deviceFilePath) לחלופין, אפשר להשתמש ב-IFileEntry שלא עובד לפעמים בגלל הרשאות.
abstract AbstractConnection	getConnection() הפונקציה מחזירה את החיבור שמשויך למכשיר.
abstract String	getDeviceClass() מקבלים את סיווג המכשיר.
abstract long	getDeviceDate() החזרת התאריך של המכשיר באלפיות השנייה מאז נקודת ההתחלה.
abstract DeviceDescriptor	getDeviceDescriptor() צריך להחזיר DeviceDescriptor מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את האובייקט של המכשיר.
abstract DeviceDescriptor	getDeviceDescriptor(boolean shortDescriptor) צריך להחזיר DeviceDescriptor מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את האובייקט של המכשיר.
abstract TestDeviceState	getDeviceState() מאתרים את מצב המכשיר.
abstract long	getDeviceTimeOffset(Date date) עוזר לקבל את הפרש הזמנים בין המכשיר לבין ERROR(/Date) נתון.
abstract InputStreamSource	getEmulatorOutput() מקבלים את הסטרימינג של האמולטור stdout ו-stderr
abstract long	getExternalStoreFreeSpace() שיטה שעוזרת לקבוע את נפח האחסון הפנוי באחסון החיצוני של המכשיר.
abstract String	getFastbootProductType() שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
abstract String	getFastbootProductVariant() שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
abstract String	getFastbootSerialNumber() מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot).
abstract String	getFastbootVariable(String variableName) מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר.
abstract IFileEntry	getFileEntry(String path) אחזור קובץ עזר לקובץ מרוחק במכשיר.
abstract IDevice	getIDevice() הפונקציה מחזירה הפניה ל-ddmlib IDevice המשויך.
abstract long	getIntProperty(String name, long defaultValue) מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר.
abstract long	getLastExpectedRebootTimeMillis() הפונקציה מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה, מאז EPOCH כפי שהוחזר על ידי System.currentTimeMillis().
abstract int	getLaunchApiLevel() מקבלים את רמת ה-API הראשונה שהושקה במכשיר.
abstract InputStreamSource	getLogcat() תופסת רצף snapshot של נתוני ה-Logcat.
abstract InputStreamSource	getLogcat(int maxBytes) תופס זרם של תמונת מצב של maxBytes נתוני ה-Logcat שתועדו.
abstract InputStreamSource	getLogcatDump() אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר.
abstract InputStreamSource	getLogcatSince(long date) יוצר זרם snapshot של נתוני Logcat שתועדו החל מהתאריך שצוין.
abstract String	getMountPoint(String mountName) מחזירה נקודת טעינה.
abstract ITestDevice.MountPointInfo	getMountPointInfo(String mountpoint) הפונקציה מחזירה ערך MountPointInfo שתואם לנתיב של נקודת הטעינה שצוין, או null אם לנתיב הזה לא נטען שום דבר או אם הוא לא מופיע ב- /proc/Loads כנקודת טעינה.
abstract	getMountPointInfo() החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר
abstract long	getPartitionFreeSpace(String partition) שיטה שעוזרת לקבוע את נפח האחסון הפנוי במחיצה במכשיר.
abstract ProcessInfo	getProcessByName(String processName) שיטת ה-Assistant מריצה את הפקודות pidof ו-stat ומחזירה אובייקט ProcessInfo עם PID ושעת ההתחלה של התהליך של התהליך הנתון.
abstract String	getProcessPid(String process) מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש.
abstract String	getProductType() שיטת נוחות לקבלת סוג המוצר של המכשיר הזה.
abstract String	getProductVariant() שיטה נוחות לקבלת וריאציית המוצר של המכשיר הזה.
abstract String	getProperty(String name) מאחזרים את ערך המאפיין הנתון מהמכשיר.
abstract ITestDevice.RecoveryMode	getRecoveryMode() משתמשים במצב השחזור הנוכחי של המכשיר.
abstract String	getSerialNumber() שיטת נוחות לקבלת המספר הסידורי של המכשיר הזה.
abstract	getTombstones() מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים.
abstract long	getTotalMemory() פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית
abstract boolean	getUseFastbootErase() בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.
abstract boolean	isAdbRoot()
abstract boolean	isAdbTcp()
abstract boolean	isAppEnumerationSupported() בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
abstract boolean	isBypassLowTargetSdkBlockSupported() בדיקה אם הפלטפורמה במכשיר תומכת בעקיפת חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות
abstract boolean	isDebugfsMounted() בודקים אם רכיבי ניפוי הבאגים טענו.
abstract boolean	isDeviceEncrypted() הפונקציה מחזירה אם המכשיר מוצפן.
abstract boolean	isDirectory(String deviceFilePath) פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false.
abstract boolean	isEncryptionSupported() הפונקציה מחזירה אם המכשיר תומך בהצפנה.
abstract boolean	isExecutable(String fullPath) הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False.
abstract boolean	isHeadless() פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך false.
abstract boolean	isRuntimePermissionSupported() בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בתחילת ההפעלה
abstract boolean	isStateBootloaderOrFastbootd() הפונקציה מחזירה את הערך True אם המכשיר נמצא ב-TestDeviceState#FASTBOOT או ב-TestDeviceState.FASTBOOTD.
abstract boolean	logAnrs(ITestLogger logger) איסוף ורישום של מקרי ANR מהמכשיר.
abstract void	logOnDevice(String tag, Log.LogLevel level, String format, Object... args) רישום הודעה ב-Logcat של המכשיר.
abstract void	mountDebugfs() טעינת ניפוי באגים.
abstract void	nonBlockingReboot() יוצר פקודה להפעלה מחדש של המכשיר וחוזרת אחרי שהפקודה הושלמה וכשהמכשיר כבר לא גלוי ל-adb.
abstract void	postBootSetup() יש לפעול לפי ההוראות להגדרת המכשיר כדי לבדוק אותו לאחר כל הפעלה.
default void	postInvocationTearDown() השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-postInvocationTearDown(Throwable).
abstract void	postInvocationTearDown(Throwable invocationException) שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה.
default void	preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes) שלבים נוספים להגדרה נדרשת ספציפית למכשיר שיבוצעו במכשיר לפני תהליך ההפעלה.
abstract boolean	pullDir(String deviceFilePath, File localDir) שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.
abstract boolean	pullDir(String deviceFilePath, File localDir, int userId) שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.
abstract File	pullFile(String remoteFilePath, int userId) אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File) מקומי זמני ומחזיר את File.
abstract File	pullFile(String remoteFilePath) אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File) מקומי זמני ומחזיר את File.
abstract boolean	pullFile(String remoteFilePath, File localFile) אחזור קובץ מהמכשיר.
abstract boolean	pullFile(String remoteFilePath, File localFile, int userId) אחזור קובץ מהמכשיר.
abstract String	pullFileContents(String remoteFilePath) אחזור קובץ מהמכשיר והחזרת התוכן שלו.
abstract File	pullFileFromExternal(String remoteFilePath) שיטת נוחות לאחזור קובץ מהאחסון החיצוני של המכשיר, לאחסון שלו ב-ERROR(/File) מקומי זמני ולהחזרת הפניה לאותו File.
abstract boolean	pushDir(File localDir, String deviceFilePath, int userId) דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.
abstract boolean	pushDir(File localDir, String deviceFilePath, excludedDirectories) דחיפת תוכן של ספריות באופן רקורסיבי למכשיר, ולא כולל ספריות מסוימות שמסוננות.
abstract boolean	pushDir(File localDir, String deviceFilePath) דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.
abstract boolean	pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) וריאנט של pushFile(File, String), עם אפשרות להעריך את הצורך בספק התוכן.
abstract boolean	pushFile(File localFile, String deviceFilePath) דחיפת קובץ למכשיר.
abstract boolean	pushFile(File localFile, String deviceFilePath, int userId) דחיפת קובץ למכשיר.
abstract boolean	pushString(String contents, String deviceFilePath) דחיפת קובץ שנוצר ממחרוזת למכשיר
abstract void	reboot() הפעלת המכשיר מחדש במצב adb.
abstract void	reboot(String reason) הפעלת המכשיר מחדש למצב adb עם reason שניתן כדי באופן רציף במהלך ההפעלה מחדש.
abstract void	rebootIntoBootloader() הפעלת המכשיר מחדש במצב תוכנת אתחול.
abstract void	rebootIntoFastbootd() הפעלת המכשיר מחדש במצב אתחול מהיר (fastbootd).
abstract void	rebootIntoRecovery() הפעלת המכשיר מחדש במצב adbrecovery.
abstract void	rebootIntoSideload(boolean autoReboot) הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור) הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
abstract void	rebootIntoSideload() הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור) הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
abstract void	rebootUntilOnline() חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
abstract void	rebootUntilOnline(String reason) חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
abstract void	rebootUserspace() מופעלת מחדש רק חלק של מרחב המשתמשים במכשיר.
abstract void	rebootUserspaceUntilOnline() חלופה ל-rebootUserspace() ()} שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
abstract void	remountSystemReadOnly() להגדיר את מחיצת המערכת במכשיר לקריאה בלבד.
abstract void	remountSystemWritable() הגדרת מחיצת המערכת במכשיר לניתנת לכתיבה.
abstract void	remountVendorReadOnly() מגדירים את מחיצת הספק במכשיר לקריאה בלבד.
abstract void	remountVendorWritable() מגדירים את מחיצת הספק במכשיר לניתנת לכתיבה.
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) שיטת נוחות לביצוע ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) עם אוזן אחד או יותר שמועבר כפרמטרים.
abstract boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners) מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר.
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners) זהה ל-ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), אבל מריץ את הבדיקה עבור המשתמש הנתון.
abstract boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) דומה ל-ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), אבל מריץ את הבדיקה עבור משתמש נתון.
abstract void	setDate(Date date) מגדיר את התאריך במכשיר הערה: הגדרת תאריך במכשיר מחייבת הרמה הבסיסית (root)
abstract void	setOptions(TestDeviceOptions options) הגדרת TestDeviceOptions של המכשיר
abstract boolean	setProperty(String propKey, String propValue) מגדיר את ערך המאפיין הנתון במכשיר.
abstract void	setRecovery(IDeviceRecovery recovery) הגדרת IDeviceRecovery לשימוש במכשיר הזה.
abstract void	setRecoveryMode(ITestDevice.RecoveryMode mode) הגדרת מצב השחזור הנוכחי לשימוש במכשיר.
abstract void	setUseFastbootErase(boolean useFastbootErase) הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר.
abstract void	startLogcat() התחלת הצילום של פלט Logcat מהמכשיר ברקע.
abstract void	stopEmulatorOutput() סוגרים את הפלט של האמולטור ומוחקים אותו.
abstract void	stopLogcat() הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו.
abstract String	switchToAdbTcp() העברת המכשיר למצב adb-over-tcp.
abstract boolean	switchToAdbUsb() העברת המכשיר למצב adb על גבי USB.
abstract boolean	syncFiles(File localFileDir, String deviceFilePath) סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר.
abstract boolean	unlockDevice() ביטול נעילת המכשיר אם המכשיר במצב מוצפן.
abstract void	unmountDebugfs() ניתוק של ניפוי באגים.
abstract boolean	waitForBootComplete(long timeOut) הפעולה תיחסם עד שתגדירו את התכונה הניסיונית להשלמת ההפעלה של המכשיר.
abstract boolean	waitForDeviceAvailable() בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
abstract boolean	waitForDeviceAvailable(long waitTime) בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
abstract boolean	waitForDeviceAvailableInRecoverPath(long waitTime) בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור.
abstract void	waitForDeviceBootloader() חסימה עד שניתן לראות את המכשיר באמצעות אתחול מהיר (fastboot).
abstract boolean	waitForDeviceInRecovery(long waitTime) חסימת המכשיר למצב 'שחזור adb' (שים לב לכך שהוא שונה מ- IDeviceRecovery).
abstract boolean	waitForDeviceInSideload(long waitTime) חסימה כדי שהמכשיר יהיה במצב 'adb offload'
abstract boolean	waitForDeviceNotAvailable(long waitTime) חסימות כדי שהמכשיר לא יהיה זמין, כלומר חסר ב-adb
abstract void	waitForDeviceOnline() חסימה עד שהמכשיר גלוי דרך adb.
abstract void	waitForDeviceOnline(long waitTime) חסימה עד שהמכשיר גלוי דרך adb.
abstract boolean	waitForDeviceShell(long waitTime) בהמתנה עד שהמכשיר יגיב לפקודת מעטפת בסיסית של adb.

קבועים

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

ערך ברירת המחדל שאי אפשר לזהות את רמת ה-API

ערך קבוע: -1 (0xffff)

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

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

פרמטרים
strictMinLevel	int: הרמה המינימלית המחמירה שתומכת בתכונה הזו.

החזרות
boolean	הערך הוא True אם הרמה נתמכת. אחרת, שקרית.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

ניקוי הרישום ביומן

public abstract void clearLogcat ()

מחיקת כל נתוני ה-Logcat שהצטברו.

האפשרות הזו שימושית במקרים שבהם רוצים לוודא ש-ITestDevice#getLogcat() יחזיר רק נתוני יומן שהופקו לאחר נקודה מסוימת (למשל, אחרי שדרוג של build חדש של מכשיר וכו').

DeleteFile

public abstract void deleteFile (String deviceFilePath)

שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.

פרמטרים
deviceFilePath	String: הנתיב המוחלט של הקובץ במכשיר.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

DeleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.

פרמטרים
deviceFilePath	String: הנתיב המוחלט של הקובץ במכשיר.
userId	int: מזהה המשתמש שממנו רוצים למחוק

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

המכשיר הופעל מחדש

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

שיטה שעוזרת לבדוק אם המכשיר הופעל מחדש באמצעות השוואת השרת system_server הנוכחי ל-system_server הקודם ProcessInfo. משתמשים ב-getProcessByName(String) ומקבלים ProcessInfo.

פרמטרים
prevSystemServerProcess	ProcessInfo: תהליך system_server הקודם ProcessInfo.

החזרות
boolean	true אם המכשיר הופעל מחדש

קליעות
RuntimeException	אם יש במכשיר סיבה להפעלה חריגה
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

מכשירSoftאתחול מאז

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

שיטה של עוזרת לבדוק אם המכשיר הופעל מחדש מאז זמן UTC מאז תחילת התקופה של ההגדרה, מהמכשיר ומ-ERROR(/TimeUnit). הפעלה מחדש עם יכולת שחזור מתייחסת להפעלה מחדש של system_server מחוץ להפעלה קשיחה של המכשיר (לדוגמה: נשלחה בקשה להפעלה מחדש). ניתן לקבל את ה-utcEpochTime של המכשיר הנוכחי ב-Miliseccond בשיטה getDeviceDate().

פרמטרים
utcEpochTime	long: זמן המכשיר בשנייה מאז תחילת התקופה.
timeUnit	TimeUnit: יחידת הזמן TimeUnit של utcEpochTime הנתון.

החזרות
boolean	true אם המכשיר הופעל מחדש

קליעות
RuntimeException	אם יש במכשיר סיבה להפעלה חריגה
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

השבתתAdbRoot

public abstract boolean disableAdbRoot ()

משבית את שורש adb.

השבתה של adb root עשויה לגרום לניתוק המכשיר מ-adb. השיטה הזו תיחסם עד שהמכשיר יהיה זמין.

החזרות
boolean	true אם הפעולה בוצעה בהצלחה.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

DoFileExist

public abstract boolean doesFileExist (String deviceFilePath)

שיטה עוזרת לקבוע אם קובץ קיים במכשיר.

פרמטרים
deviceFilePath	String: הנתיב המוחלט של הקובץ במכשיר לבדיקה

החזרות
boolean	true אם הקובץ קיים, אחרת false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הפעלתAdbRoot

public abstract boolean enableAdbRoot ()

הפעלת השורש של adb. אם ההגדרה Enable-root היא False, תופיע הודעה ביומן ותוחזר בלי להפעיל Root.

הפעלה של ברמה הבסיסית (root) עשויה לגרום לניתוק המכשיר מ-adb. השיטה הזו תיחסם עד שהמכשיר יהיה זמין.

החזרות
boolean	true אם הפעולה בוצעה בהצלחה.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

PerformanceAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.

ככל האפשר, מומלץ להשתמש ב-executeShellCommand(String) במקום זאת, כי השיטה הזו משפרת את זיהוי הכשלים והביצועים.

פרמטרים
timeout	long: הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L ללא זמן קצוב לתפוגה
commandArgs	String: פקודת ה-adb והארגומנטים להרצה

החזרות
String	את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

PerformanceAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

שיטת עזרה שמבצעת פקודת adb כפקודת מערכת.

ככל האפשר, מומלץ להשתמש ב-executeShellCommand(String) במקום זאת, כי השיטה הזו משפרת את זיהוי הכשלים והביצועים.

פרמטרים
commandArgs	String: פקודת ה-adb והארגומנטים להרצה

החזרות
String	את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

PerformanceAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.

ככל האפשר, מומלץ להשתמש ב-executeShellCommand(String) במקום זאת, כי השיטה הזו משפרת את זיהוי הכשלים והביצועים.

פרמטרים
timeout	long: הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L ללא זמן קצוב לתפוגה
envMap	: הסביבה להגדרה לפקודה
commandArgs	String: פקודת ה-adb והארגומנטים להרצה

החזרות
String	את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הפעלה מהירה אתחול פקודה

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת.

אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).

פרמטרים
timeout	long: הזמן באלפיות השנייה לפני שהתוקף של הפקודה פג
commandArgs	String: הפקודה 'אתחול מהיר' והארגומנטים להרצה

החזרות
CommandResult	התוצאה של הפקודה שמכילה את הפלט של הפקודה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הפעלה מהירה אתחול פקודה

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).

פרמטרים
commandArgs	String: הפקודה 'אתחול מהיר' והארגומנטים להרצה

החזרות
CommandResult	התוצאה של הפקודה שמכילה את הפלט של הפקודה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הפעלת לונגבאתחול מהיר

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת.

זהה ל-executeFastbootCommand(String), אבל הזמן הקצוב לתפוגה יהיה ארוך יותר.

פרמטרים
commandArgs	String: הפקודה 'אתחול מהיר' והארגומנטים להרצה

החזרות
CommandResult	התוצאה של הפקודה שמכילה את הפלט של הפקודה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הפעלת לונגבאתחול מהיר

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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

זהה ל-executeFastbootCommand(String), אבל הזמן הקצוב לתפוגה יהיה ארוך יותר.

פרמטרים
envVarMap	: משתני סביבת המערכת שבהם רצה פקודת האתחול המהיר
commandArgs	String: הפקודה 'אתחול מהיר' והארגומנטים להרצה

החזרות
CommandResult	התוצאה של הפקודה שמכילה את הפלט של הפקודה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

ביצועShellCommand

public abstract String executeShellCommand (String command)

שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור String.

פרמטרים
command	String: פקודת המעטפת adb להרצה

החזרות
String	הפלט של המעטפת

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

ביצועShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.

פרמטרים
command	String: פקודת המעטפת adb להרצה
receiver	IShellOutputReceiver: ה-IShellOutputReceiver שאליו צריך להפנות את פלט המעטפת.
maxTimeToOutputShellResponse	long: משך הזמן המקסימלי שבמהלכו הפקודה יכולה לא להפיק תשובה, כפי שמצוין ב-timeUnit.
timeUnit	TimeUnit: יחידה עבור maxTimeToOutputShellResponse
retryAttempts	int: מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת הפעלה של retryAttempts ללא הצלחה.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

למידע נוסף:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

ביצועShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.

פרמטרים
command	String: פקודת המעטפת adb להרצה
receiver	IShellOutputReceiver: ה-IShellOutputReceiver שאליו צריך להפנות את פלט המעטפת.
maxTimeoutForCommand	long: הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit
maxTimeToOutputShellResponse	long: משך הזמן המקסימלי שבמהלכו הפקודה יכולה לא להפיק תשובה, כפי שמצוין ב-timeUnit.
timeUnit	TimeUnit: יחידה עבור maxTimeToOutputShellResponse
retryAttempts	int: מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת retryAttempts ללא הצלחה.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

למידע נוסף:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

ביצועShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

מפעיל את פקודת המעטפת הנתונה של adb, ומנסה שוב מספר פעמים אם הפקודה נכשלת.

צורה פשוטה יותר של executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) עם ערכי ברירת מחדל.

פרמטרים
command	String: פקודת המעטפת adb להרצה
receiver	IShellOutputReceiver: ה-IShellOutputReceiver שאליו צריך להפנות את פלט המעטפת.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command)

שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.

פרמטרים
command	String: הפקודה שצריך להריץ.

החזרות
CommandResult	התוצאה בCommandResult.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, מאוכלסות כראוי בפלט של סטטוס הפקודה ו-stderr. stdout מופנה אל הסטרימינג שצוין.

פרמטרים
command	String: הפקודה שצריך להריץ.
pipeToOutput	OutputStream: ERROR(/OutputStream) כאשר פלט ה-std יופנה מחדש, או null.

החזרות
CommandResult	התוצאה בCommandResult.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.

פרמטרים
command	String: הפקודה שצריך להריץ.
pipeAsInput	File: ERROR(/File) שיועבר כקלט לפקודה, או שהוא null.

החזרות
CommandResult	התוצאה בCommandResult.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.

פרמטרים
command	String: פקודת המעטפת adb להרצה
maxTimeoutForCommand	long: הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit
timeUnit	TimeUnit: יחידה עבור maxTimeToOutputShellResponse
retryAttempts	int: מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת retryAttempts ללא הצלחה.

החזרות
CommandResult

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

למידע נוסף:

• executeShellV2Command(String)
• TimeUtil

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.

פרמטרים
command	String: פקודת המעטפת adb להרצה
maxTimeoutForCommand	long: הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit
timeUnit	TimeUnit: יחידה עבור maxTimeToOutputShellResponse

החזרות
CommandResult

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

למידע נוסף:

• executeShellV2Command(String)
• TimeUtil

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.

פרמטרים
command	String: פקודת המעטפת adb להרצה
pipeAsInput	File: ERROR(/File) שיועבר כקלט לפקודה, או שהוא null.
pipeToOutput	OutputStream: ERROR(/OutputStream) כאשר פלט ה-std יופנה מחדש, או null.
maxTimeoutForCommand	long: הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit
timeUnit	TimeUnit: יחידה עבור maxTimeToOutputShellResponse
retryAttempts	int: מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת retryAttempts ללא הצלחה.

החזרות
CommandResult

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

למידע נוסף:

• executeShellV2Command(String)
• TimeUtil

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.

פרמטרים
command	String: פקודת המעטפת adb להרצה
pipeAsInput	File: ERROR(/File) שיועבר כקלט לפקודה, או שהוא null.
pipeToOutput	OutputStream: ERROR(/OutputStream) כאשר פלט ה-std יופנה מחדש, או null.
pipeToError	OutputStream: ERROR(/OutputStream) שאליו תתבצע הפניה אוטומטית של שגיאת ה-std, או הערך null.
maxTimeoutForCommand	long: הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit
timeUnit	TimeUnit: יחידה עבור maxTimeToOutputShellResponse
retryAttempts	int: מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת retryAttempts ללא הצלחה.

החזרות
CommandResult

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

למידע נוסף:

• executeShellV2Command(String)
• TimeUtil

מחיצה לאתחול מהיר (fastbootWipePartition)

public abstract CommandResult fastbootWipePartition (String partition)

שיטה לעזרה באיפוס המחיצה של המכשיר.

אם הערך של getUseFastbootErase() הוא true, תתבצע מחיקה של אתחול מהיר כדי לאפס את המחיצה. לאחר מכן, המכשיר צריך ליצור מערכת קבצים בפעם הבאה שהמכשיר יופעל. אחרת, ייעשה שימוש בפורמט אתחול מהיר (fastboot) שיצור מערכת קבצים חדשה במכשיר.

אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).

פרמטרים
partition	String: המחיצה שרוצים לאפס

החזרות
CommandResult	התוצאה של הפקודה שמכילה את הפלט של הפקודה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getApiLevel"

public abstract int getApiLevel ()

מאתרים את רמת ה-API של המכשיר. ברירת המחדל היא UNKNOWN_API_LEVEL.

החזרות
int	מספר שלם שמציין את רמת ה-API של המכשיר

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

גרסת getBaseband

public abstract String getBasebandVersion ()

שיטת הנוחות לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה. כשמשיגים את גרסת הרדיו, היא ספציפית למכשיר, כך שיכול להיות שהיא לא תחזיר את המידע הנכון לכל המכשירים. השיטה הזו מסתמכת על הנכס gsm.version.baseband כדי להחזיר את פרטי הגרסה הנכונים. המידע הזה לא מדויק במכשירי CDMA מסוימים, ויכול להיות שהגרסה שמוחזרת כאן לא תואמת לגרסה שדווחה מהאתחול המהיר, ויכול להיות שלא תחזיר את הגרסה של רדיו CDMA. אמ;לק: השיטה הזו מדווחת על גרסה מדויקת רק אם המאפיין gsm.version.baseband זהה לגרסה שהוחזרה על ידי fastboot getvar version-baseband.

החזרות
String	גרסת פס הבסיס String או null אם לא ניתן לקבוע (לא ניתן לקרוא במכשיר את מחרוזת הרדיו או את מחרוזת הגרסה)

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הורדת הסוללה

public abstract Integer getBattery ()

מחזירה את רמת הטעינה הנוכחית של הסוללה של מכשיר או את הערך Null אם רמת הסוללה לא זמינה.

החזרות
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

מחזירה ערך בוליאני של המאפיין הנתון.

פרמטרים
name	String: שם הנכס
defaultValue	boolean: ערך ברירת המחדל שיוחזר אם הנכס ריק או לא קיים.

החזרות
boolean	true אם לנכס יש ערך "1", "y", "yes", "on" או "true", false אם לנכס יש ערך של "0", "n", "no", "off", "false" או defaultValue אחרת.

קליעות
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

תכונת העזרה אוספת את המפה של היסטוריית האתחול עם זמן האתחול וסיבת האתחול.

החזרות
	מפה של זמן האתחול (זמן UTC בשנייה מאז נקודת ההתחלה) וסיבת האתחול

קליעות
DeviceNotAvailableException

getBootHistoryHistory

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

פרמטרים
utcEpochTime	long: הזמן שמוגדר במכשיר מאז Epoch.
timeUnit	TimeUnit: יחידת הזמן TimeUnit.

החזרות
	מפה של זמן האתחול (זמן UTC בשנייה מאז נקודת ההתחלה) וסיבת האתחול

קליעות
DeviceNotAvailableException

גרסה getBootloaderVersion

public abstract String getBootloaderVersion ()

שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה.

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

החזרות
String	גרסת תוכנת האתחול String או null אם לא ניתן למצוא אותה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getBuildAlias

public abstract String getBuildAlias ()

מאחזרים את הכינוי של ה-build שהמכשיר פועל כרגע.

כינוי Build הוא בדרך כלל מחרוזת קריאה יותר מאשר מזהה ה-build (בדרך כלל מספר לגרסאות build של Nexus). לדוגמה, לגרסה הסופית של Android 4.2 יש את הכינוי JDQ39 ואת מזהה ה-build 573038

החזרות
String	כינוי ה-build או חזרה למזהה ה-build אם לא ניתן לאחזר אותו

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

מאחזרים את גרסת ה-build של המכשיר.

החזרות
String	טעם ה-build או אפס אם לא ניתן לאחזר אותו

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

מאחזרים את גרסת ה-build שהמכשיר פועל כרגע.

החזרות
String	מזהה ה-build או IBuildInfo#UNKNOWN_BUILD_ID אם לא ניתן לאחזר אותו

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

פונקציה זו מחזירה את סוג המפתח המשמש לחתימה על תמונת המכשיר

בדרך כלל, מכשירי Android חתומים על ידי מפתחות בדיקה (כמו ב-AOSP) או באמצעות מפתחות הפצה (שנשלטים על ידי יצרני מכשירים נפרדים)

החזרות
String	מפתח החתימה אם הוא נמצא. אחרת, הוא null.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

הפונקציה מחזירה ערך DeviceDescriptor שנשמר במטמון אם המכשיר מוקצה. אחרת, מחזירה את הערך הנוכחי של DeviceDescriptor.

החזרות
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

הפונקציה מחזירה ערך DeviceDescriptor שנשמר במטמון אם המכשיר מוקצה. אחרת, מחזירה את הערך הנוכחי של DeviceDescriptor.

פרמטרים
shortDescriptor	boolean: האם להגביל את התיאור למידע מינימלי בלבד

החזרות
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

לחלופין, אפשר להשתמש ב-IFileEntry שלא עובד לפעמים בגלל הרשאות.

פרמטרים
deviceFilePath	String: הוא הנתיב במכשיר שבו מבצעים את החיפוש

החזרות
String[]	מערך של מחרוזת שמכילה את כל הקובץ בנתיב במכשיר.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

הפונקציה מחזירה את החיבור שמשויך למכשיר.

החזרות
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

מקבלים את סיווג המכשיר.

החזרות
String	סיווג המכשיר String.

getDeviceDate

public abstract long getDeviceDate ()

החזרת התאריך של המכשיר באלפיות השנייה מאז נקודת ההתחלה.

החזרות
long	את התאריך של המכשיר בפורמט תקופה של זמן מערכת.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

צריך להחזיר DeviceDescriptor מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את האובייקט של המכשיר.

החזרות
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

צריך להחזיר DeviceDescriptor מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את האובייקט של המכשיר.

פרמטרים
shortDescriptor	boolean: האם להגביל את התיאור למידע מינימלי בלבד

החזרות
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

מאתרים את מצב המכשיר.

החזרות
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

עוזר לקבל את הפרש הזמנים בין המכשיר לבין ERROR(/Date) נתון. שימוש ב-Epoch Time באופן פנימי.

פרמטרים
date	Date

החזרות
long	ההבדל באלפיות השנייה

קליעות
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

מקבלים את הסטרימינג של האמולטור stdout ו-stderr

החזרות
InputStreamSource	הפלט של האמולטור

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

החזרות
long	כמות השטח הפנוי ב-KB

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getFastbootProductType

public abstract String getFastbootProductType ()

שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).

יש להשתמש בשיטה הזו רק אם המכשיר צריך להפעיל אתחול מהיר (fastboot). במקרה הזה, זו וריאציה קצת יותר בטוחה מהשיטה הכללית getProductType(), כי ITestDevice ילמדו לשחזר את המכשיר במסגרת אתחול מהיר אם המכשיר במצב שגוי או לא מגיב.

החזרות
String	השם של סוג המוצר String או null אם לא ניתן לקבוע

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).

יש להשתמש בשיטה הזו רק אם המכשיר צריך להפעיל אתחול מהיר (fastboot). במקרה הזה, זו וריאציה קצת יותר בטוחה מהשיטה הכללית getProductType(), כי ITestDevice ילמדו לשחזר את המכשיר במסגרת אתחול מהיר אם המכשיר במצב שגוי או לא מגיב.

החזרות
String	השם של סוג המוצר String או null אם לא ניתן לקבוע

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getFastbootSeriesNumber

public abstract String getFastbootSerialNumber ()

מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot).

החזרות
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר.

פרמטרים
variableName	String: שם המשתנה

החזרות
String	ערך הנכס או null אם הוא לא קיים

קליעות
	supportedOperationError
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

אחזור קובץ עזר לקובץ מרוחק במכשיר.

פרמטרים
path	String: נתיב הקובץ לאחזור. יכול להיות נתיב או נתיב מוחלטים ביחס ל-'/'. (כלומר, יש תמיכה בתחביר '/system' או 'system').

החזרות
IFileEntry	IFileEntry או null אם הקובץ path לא נמצא

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

הפונקציה מחזירה הפניה ל-ddmlib IDevice המשויך.

יכול להיות ש-DDMS יקצה ערך IDevice חדש בכל פעם שהמכשיר יתנתק ויתחבר מחדש מ-adb. לכן, המתקשרים לא צריכים לשמור הפניה אל IDevice, כי ההפניה הזו עלולה להפוך למיושנת.

החזרות
IDevice	IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר.

פרמטרים
name	String: שם הנכס
defaultValue	long: ערך ברירת המחדל שיוחזר אם הנכס ריק או לא קיים.

החזרות
long	ערך המאפיין או defaultValue אם המאפיין ריק, לא קיים או שאין לו ערך מסוג מספר שלם.

קליעות
DeviceNotAvailableException

getLastExpectedDefaultTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

הפונקציה מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה, מאז EPOCH כפי שהוחזר על ידי System.currentTimeMillis().

החזרות
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

מקבלים את רמת ה-API הראשונה שהושקה במכשיר. ברירת המחדל היא UNKNOWN_API_LEVEL.

החזרות
int	מספר שלם שמציין את רמת ה-API הראשונה של המכשיר שהושקה

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

תופסת רצף snapshot של נתוני ה-Logcat.

פועל בשני מצבים:

אם ה-Logcat מצולם כרגע ברקע, יחזיר עד TestDeviceOptions.getMaxLogcatDataSize() בייטים מהתוכן הנוכחי של לכידת ה-Logcat ברקע

אחרת, יחזיר תמונת מצב סטטית של נתוני ה-Logcat אם המכשיר מגיב כעת

החזרות
InputStreamSource

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

תופס זרם של תמונת מצב של maxBytes נתוני ה-Logcat שתועדו.

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

פרמטרים
maxBytes	int: כמות הנתונים המקסימלית שצריך להחזיר. הסכום צריך להיות מספיק מקום לזיכרון

החזרות
InputStreamSource

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר. בניגוד ל-getLogcat(), השיטה הזו תמיד תחזיר תמונת מצב סטטית של ה-Logcat.

החיסרון הוא ששום דבר לא יוחזר אם אי אפשר להשיג את המכשיר.

החזרות
InputStreamSource	InputStreamSource של נתוני ה-Logcat. אם הנתונים של Logcat לא ייקלטו, מוחזר זרם ריק.

getLogcatAfter

public abstract InputStreamSource getLogcatSince (long date)

יוצר זרם snapshot של נתוני Logcat שתועדו החל מהתאריך שצוין. השעה במכשיר צריכה להיות getDeviceDate().

פרמטרים
date	long: באלפיות השנייה מאז תחילת התקופה של זמן ההפעלה של קובץ ה-snapshot ועד היום. (אפשר לקבל את הערך הזה באמצעות 'date +%s')

החזרות
InputStreamSource

getMountPoint

public abstract String getMountPoint (String mountName)

מחזירה נקודת טעינה.

שליחת שאילתות ישירות למכשיר אם המידע שנשמר במטמון ב-IDevice לא זמין.

TODO: העברת ההתנהגות הזו אל IDevice#getMountPoint(String)

פרמטרים
mountName	String: השם של נקודת הטעינה

החזרות
String	נקודת הטעינה או null

למידע נוסף:

• IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

הפונקציה מחזירה ערך MountPointInfo שתואם לנתיב של נקודת הטעינה שצוין, או null אם לנתיב הזה לא נטען שום דבר או אם הוא לא מופיע ב- /proc/Loads כנקודת טעינה.

פרמטרים
mountpoint	String

החזרות
ITestDevice.MountPointInfo	ERROR(/List) מתוך MountPointInfo שמכילים את המידע ב-"/proc/המחירs"

קליעות
DeviceNotAvailableException

למידע נוסף:

• getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר

החזרות
	ERROR(/List) מתוך MountPointInfo שמכילים את המידע ב-"/proc/המחירs"

קליעות
DeviceNotAvailableException

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

פרמטרים
partition	String

החזרות
long	כמות השטח הפנוי ב-KB

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

שיטת ה-Assistant מריצה את הפקודות pidof ו-stat ומחזירה אובייקט ProcessInfo עם PID ושעת ההתחלה של התהליך של התהליך הנתון.

פרמטרים
processName	String: מחרוזת שם התהליך.

החזרות
ProcessInfo	ProcessInfo שלProcessName הנתון

קליעות
DeviceNotAvailableException

getProcessPid

public abstract String getProcessPid (String process)

מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש.

פרמטרים
process	String: מחרוזת שם הפרויקט (proces).

החזרות
String

קליעות
DeviceNotAvailableException

getProductType

public abstract String getProductType ()

שיטת נוחות לקבלת סוג המוצר של המכשיר הזה.

השיטה הזו תפעל אם המכשיר נמצא במצב adb או אתחול מהיר (fastboot).

החזרות
String	השם של סוג המוצר String. לא יהיה null

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו, או אם לא ניתן לקבוע את סוג המוצר

getProductVariant

public abstract String getProductVariant ()

שיטה נוחות לקבלת וריאציית המוצר של המכשיר הזה.

השיטה הזו תפעל אם המכשיר נמצא במצב adb או אתחול מהיר (fastboot).

החזרות
String	השם של וריאציית המוצר String או null אם לא ניתן לקבוע

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getProperty

public abstract String getProperty (String name)

מאחזרים את ערך המאפיין הנתון מהמכשיר.

פרמטרים
name	String: שם הנכס

החזרות
String	ערך הנכס או null אם הוא לא קיים

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getrecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

משתמשים במצב השחזור הנוכחי של המכשיר.

החזרות
ITestDevice.RecoveryMode	מצב השחזור הנוכחי שמשמש את המכשיר.

getSeriesNumber

public abstract String getSerialNumber ()

שיטת נוחות לקבלת המספר הסידורי של המכשיר הזה.

החזרות
String	המספר הסידורי String

getTombstones

public abstract  getTombstones ()

מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים. נדרש שורש.

היא הטובה ביותר. לכן, אם שליפה של מצבה אחת מסיבה כלשהי תיכשל, היא תיעלם ברשימה. רק DeviceNotAvailableException תסיים את השיטה מוקדם יותר.

החזרות
	רשימה של קובצי מצבות, ריקים אם אין מצבה.

קליעות
DeviceNotAvailableException

למידע נוסף:

• מסמכי תיעוד של אתר קבורה

getTotalMemory

public abstract long getTotalMemory ()

פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית

החזרות
long

getUseFastbootdelete

public abstract boolean getUseFastbootErase ()

בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.

החזרות
boolean	true אם תתבצע מחיקה של אתחול מהיר (fastboot), או false אם ייעשה שימוש בפורמט אתחול מהיר (fastboot).

למידע נוסף:

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

החזרות
boolean	true אם המכשיר נמצא כרגע ברמה הבסיסית (root) של adb, אחרת false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

isAdbTcp

public abstract boolean isAdbTcp ()

החזרות
boolean	true אם המכשיר מחובר ל-adb-over-tcp, אחרת false.

isAppEnumeration נתמך

public abstract boolean isAppEnumerationSupported ()

בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות

החזרות
boolean	True אם יש תמיכה בספירת אפליקציות, FALSE אם לא יש תמיכה בספירת אפליקציות

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

בדיקה אם הפלטפורמה במכשיר תומכת בעקיפת חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות

החזרות
boolean	הערך הוא True אם יש תמיכה בעקיפה של חסימת SDK עם יעדים נמוכים, אחרת הערך False

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

בודקים אם רכיבי ניפוי הבאגים טענו.

החזרות
boolean	true אם רכיבי ניפוי הבאגים נטענים

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isDeviceEncrypt

public abstract boolean isDeviceEncrypted ()

הפונקציה מחזירה אם המכשיר מוצפן.

החזרות
boolean	true אם המכשיר מוצפן.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הוא ספרייה

public abstract boolean isDirectory (String deviceFilePath)

פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false.

פרמטרים
deviceFilePath	String

החזרות
boolean

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isEncryptionsupported

public abstract boolean isEncryptionSupported ()

הפונקציה מחזירה אם המכשיר תומך בהצפנה.

החזרות
boolean	true אם המכשיר תומך בהצפנה.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

ניתן להפעלה

public abstract boolean isExecutable (String fullPath)

הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False.

פרמטרים
fullPath	String

החזרות
boolean

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

ללא GUI

public abstract boolean isHeadless ()

פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך false.

החזרות
boolean

קליעות
DeviceNotAvailableException

נתמך

public abstract boolean isRuntimePermissionSupported ()

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

החזרות
boolean	הערך הוא True אם יש תמיכה בהרשאה בתחילת ההפעלה, או FALSE אם יש תמיכה בהרשאה.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

הפונקציה מחזירה את הערך True אם המכשיר נמצא ב-TestDeviceState#FASTBOOT או ב-TestDeviceState.FASTBOOTD.

החזרות
boolean

LogAnrs

public abstract boolean logAnrs (ITestLogger logger)

איסוף ורישום של מקרי ANR מהמכשיר.

פרמטרים
logger	ITestLogger: ITestLogger לרישום מקרי ה-ANR.

החזרות
boolean	הערך הוא True אם הרישום ביומן בוצע בהצלחה, אחרת False.

קליעות
DeviceNotAvailableException

LogOnDevice

public abstract void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

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

פרמטרים
tag	String: התג שבו אנחנו מתעדים את ההודעה שלנו ב-Logcat.
level	Log.LogLevel: רמת ניפוי הבאגים של ההודעה ב-Logcat.
format	String: פורמט ההודעה.
args	Object: הארגומנטים שצריך להחליף דרך String.format().

טעינת ניפוי באגים

public abstract void mountDebugfs ()

טעינת ניפוי באגים.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

ללא חסימה מחדש

public abstract void nonBlockingReboot ()

יוצר פקודה להפעלה מחדש של המכשיר וחוזרת אחרי שהפקודה הושלמה וכשהמכשיר כבר לא גלוי ל-adb.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

הגדרת PostBoot

public abstract void postBootSetup ()

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

צריכה להתבצע קריאה אחרי שהמכשיר מופעל/זמין באופן מלא

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

המקרים שבהם צריך לקרוא לאפליקציה היא כשהמכשיר מופעל מחדש עקב אירועים אחרים (למשל, לאחר השלמת פקודת עדכון מהיר)

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

postInvocationTearDown

public void postInvocationTearDown ()

השיטה הזו הוצאה משימוש.
במקומו צריך להשתמש ב-postInvocationTearDown(Throwable).

שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה.

פרמטרים
invocationException	Throwable: אם יש כזה, החריג האחרון שגרם לכשל בהפעלה.

הגדרת הפעלה מראש

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

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

פרמטרים
info	IBuildInfo: ה-IBuildInfo של המכשיר.
attributes	MultiMap: המאפיינים שמאוחסנים בהקשר של ההפעלה

קליעות
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException
TargetSetupError

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.

פרמטרים
deviceFilePath	String: הנתיב המוחלט של הקובץ של המקור המרוחק
localDir	File: הספרייה המקומית שאליה מייצאים את הקבצים

החזרות
boolean	true אם הקובץ יישלף. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.

פרמטרים
deviceFilePath	String: הנתיב המוחלט של הקובץ של המקור המרוחק
localDir	File: הספרייה המקומית שאליה מייצאים את הקבצים
userId	int: מזהה המשתמש שממנו יש לשלוף

החזרות
boolean	true אם הקובץ יישלף. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File) מקומי זמני ומחזיר את File.

פרמטרים
remoteFilePath	String: הנתיב המוחלט לקובץ במכשיר.
userId	int: מזהה המשתמש שממנו יש לשלוף

החזרות
File	ERROR(/File) שמכיל את התוכן של קובץ המכשיר, או null אם ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח).

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pullFile

public abstract File pullFile (String remoteFilePath)

אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File) מקומי זמני ומחזיר את File.

פרמטרים
remoteFilePath	String: הנתיב המוחלט לקובץ במכשיר.

החזרות
File	ERROR(/File) שמכיל את התוכן של קובץ המכשיר, או null אם ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח).

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

אחזור קובץ מהמכשיר.

פרמטרים
remoteFilePath	String: הנתיב המוחלט לקובץ במכשיר.
localFile	File: הקובץ המקומי שבו שומרים את התוכן. אם השדה לא ריק, התוכן יוחלף.

החזרות
boolean	true אם הקובץ אוחזר בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

אחזור קובץ מהמכשיר.

פרמטרים
remoteFilePath	String: הנתיב המוחלט לקובץ במכשיר.
localFile	File: הקובץ המקומי שבו שומרים את התוכן. אם השדה לא ריק, התוכן יוחלף.
userId	int: מזהה המשתמש שממנו יש לשלוף

החזרות
boolean	true אם הקובץ אוחזר בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

אחזור קובץ מהמכשיר והחזרת התוכן שלו.

פרמטרים
remoteFilePath	String: הנתיב המוחלט לקובץ במכשיר.

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

קליעות
DeviceNotAvailableException

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

שיטת נוחות לאחזור קובץ מהאחסון החיצוני של המכשיר, לאחסון שלו ב-ERROR(/File) מקומי זמני ולהחזרת הפניה לאותו File.

פרמטרים
remoteFilePath	String: הנתיב לקובץ במכשיר, ביחס לנקודת הטעינה של האחסון החיצוני של המכשיר

החזרות
File	ERROR(/File) שמכיל את התוכן של קובץ המכשיר, או null אם ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח).

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.

פרמטרים
localDir	File: הספרייה המקומית שרוצים לדחוף
deviceFilePath	String: נתיב הקובץ המוחלט של היעד המרוחק
userId	int: מזהה המשתמש שאליו רוצים להעביר בדחיפה

החזרות
boolean	true אם הקובץ נדחף בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

דחיפת תוכן של ספריות באופן רקורסיבי למכשיר, ולא כולל ספריות מסוימות שמסוננות.

פרמטרים
localDir	File: הספרייה המקומית שרוצים לדחוף
deviceFilePath	String: נתיב הקובץ המוחלט של היעד המרוחק
excludedDirectories	: קבוצת שמות של ספריות מוחרגות שלא צריך לדחוף.

החזרות
boolean	true אם הקובץ נדחף בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.

פרמטרים
localDir	File: הספרייה המקומית שרוצים לדחוף
deviceFilePath	String: נתיב הקובץ המוחלט של היעד המרוחק

החזרות
boolean	true אם הקובץ נדחף בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

קובץ PushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

וריאנט של pushFile(File, String), עם אפשרות להעריך את הצורך בספק התוכן.

פרמטרים
localFile	File: הקובץ המקומי לדחיפה
deviceFilePath	String: הנתיב המוחלט לקובץ היעד המרוחק
evaluateContentProviderNeeded	boolean: האם לבדוק אם אנחנו צריכים את ספק התוכן

החזרות
boolean	true אם הקובץ נדחף בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

קובץ PushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

דחיפת קובץ למכשיר. שימוש בספק תוכן כברירת מחדל.

פרמטרים
localFile	File: הקובץ המקומי לדחיפה
deviceFilePath	String: הנתיב המוחלט לקובץ היעד המרוחק

החזרות
boolean	true אם הקובץ נדחף בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

קובץ PushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

דחיפת קובץ למכשיר. שימוש בספק תוכן כברירת מחדל.

פרמטרים
localFile	File: הקובץ המקומי לדחיפה
deviceFilePath	String: הנתיב המוחלט לקובץ היעד המרוחק
userId	int: מזהה המשתמש שאליו רוצים לדחוף

החזרות
boolean	true אם הקובץ נדחף בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

PushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

דחיפת קובץ שנוצר ממחרוזת למכשיר

פרמטרים
contents	String: תוכן הקובץ לדחיפה
deviceFilePath	String: הנתיב המוחלט לקובץ היעד המרוחק

החזרות
boolean	true אם המחרוזת נדחפה בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

להפעיל מחדש

public abstract void reboot ()

הפעלת המכשיר מחדש במצב adb.

החסימה תיחסם עד שהמכשיר יהיה זמין.

קליעות
DeviceNotAvailableException	אם המכשיר לא זמין לאחר ההפעלה מחדש

להפעיל מחדש

public abstract void reboot (String reason)

הפעלת המכשיר מחדש למצב adb עם reason שניתן כדי באופן רציף במהלך ההפעלה מחדש.

החסימה תיחסם עד שהמכשיר יהיה זמין.

אפשר לקבל את הסיבה להפעלה מחדש האחרונה על ידי שליחת שאילתה ברמת המערכת של sys.boot.reason.

פרמטרים
reason	String: הסיבה להפעלה מחדש, או null אם לא צוינה סיבה.

קליעות
DeviceNotAvailableException	אם המכשיר לא זמין לאחר ההפעלה מחדש

הפעלה מחדש של IntoBootloader

public abstract void rebootIntoBootloader ()

הפעלת המכשיר מחדש במצב תוכנת אתחול.

חסימה עד שהמכשיר יהיה במצב תוכנת אתחול.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הפעלה מחדש שלIntoFastbootd

public abstract void rebootIntoFastbootd ()

הפעלת המכשיר מחדש במצב אתחול מהיר (fastbootd).

חסימה עד שהמכשיר יופעל במצב אתחול מהיר (fastbootd).

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

הפעלה מחדש של התאוששות מאסון

public abstract void rebootIntoRecovery ()

הפעלת המכשיר מחדש במצב adbrecovery.

חסימה עד שהמכשיר יעבור לשחזור

קליעות
DeviceNotAvailableException	אם המכשיר לא זמין לאחר ההפעלה מחדש

הפעלה מחדש של IntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)

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

פרמטרים
autoReboot	boolean: האם להפעיל מחדש את המכשיר באופן אוטומטי לאחר טעינה ממקור לא ידוע

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

הפעלה מחדש של IntoSideload

public abstract void rebootIntoSideload ()

הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)

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

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

הפעלה מחדש עדאונליין

public abstract void rebootUntilOnline ()

חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

קליעות
DeviceNotAvailableException	אם המכשיר לא זמין לאחר ההפעלה מחדש

הפעלה מחדש עדאונליין

public abstract void rebootUntilOnline (String reason)

חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

פרמטרים
reason	String: הסיבה להפעלה מחדש, או null אם לא צוינה סיבה.

קליעות
DeviceNotAvailableException	אם המכשיר לא זמין לאחר ההפעלה מחדש

למידע נוסף:

• reboot(String)

substituteUserspace

public abstract void rebootUserspace ()

מופעלת מחדש רק חלק של מרחב המשתמשים במכשיר.

החסימה תיחסם עד שהמכשיר יהיה זמין.

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

קליעות
DeviceNotAvailableException	אם המכשיר לא זמין לאחר ההפעלה מחדש

מחדשים UserspaceBeforeOnline

public abstract void rebootUserspaceUntilOnline ()

חלופה ל-rebootUserspace() ()} שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

קליעות
DeviceNotAvailableException	אם המכשיר לא זמין לאחר ההפעלה מחדש

reloadSystemReadOnly

public abstract void remountSystemReadOnly ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

ל-reloadSystemWritable

public abstract void remountSystemWritable ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

טעינה מחדש של ספק קריאה בלבד

public abstract void remountVendorReadOnly ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

ספק טעינה מחדש

public abstract void remountVendorWritable ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

בדיקות runInstrumentationTest

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

שיטת נוחות לביצוע ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) עם אוזן אחד או יותר שמועבר כפרמטרים.

פרמטרים
runner	IRemoteAndroidTestRunner: ה-IRemoteAndroidTestRunner שמריץ את הבדיקות
listeners	ITestLifeCycleReceiver: המאזינים לתוצאת הבדיקה

החזרות
boolean	true אם פקודת הבדיקה הושלמה. false אם הסנכרון נכשל אבל השחזור בוצע בהצלחה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו. כלומר, פקודת הבדיקה נכשלה והשחזור נכשל.

בדיקות runInstrumentationTest

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר.

אם החיבור למכשיר יתנתק לפני שהרצת הבדיקה תסתיים והשחזור יצליח, כל המאזינים יקבלו הודעה על TestRunFailed והשגיאה "false" תוחזר. פקודת הבדיקה לא תרוץ מחדש. במקרה הצורך, המתקשרים יוכלו לנסות שוב.

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

פרמטרים
runner	IRemoteAndroidTestRunner: ה-IRemoteAndroidTestRunner שמריץ את הבדיקות
listeners	: המאזינים לתוצאת הבדיקה

החזרות
boolean	true אם פקודת הבדיקה הושלמה. false אם היא לא הושלמה עקב חריגת תקשורת במכשיר, אבל השחזור בוצע בהצלחה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ולא ניתן לשחזר אותו. כלומר, פקודת הבדיקה נכשלה והשחזור נכשל.

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

זהה ל-ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), אבל מריץ את הבדיקה עבור המשתמש הנתון.

פרמטרים
runner	IRemoteAndroidTestRunner
userId	int
listeners

החזרות
boolean

קליעות
DeviceNotAvailableException

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

דומה ל-ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), אבל מריץ את הבדיקה עבור משתמש נתון.

פרמטרים
runner	IRemoteAndroidTestRunner
userId	int
listeners	ITestLifeCycleReceiver

החזרות
boolean

קליעות
DeviceNotAvailableException

setDate (תאריך הגדרה)

public abstract void setDate (Date date)

מגדיר את התאריך במכשיר

הערה: הגדרת תאריך במכשיר מחייבת הרמה הבסיסית (root)

פרמטרים
date	Date: ציון תאריך מסוים. ייעשה שימוש בתאריך המארח אם null

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

setOptions

public abstract void setOptions (TestDeviceOptions options)

הגדרת TestDeviceOptions של המכשיר

פרמטרים
options	TestDeviceOptions

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

מגדיר את ערך המאפיין הנתון במכשיר. כדי להגדיר את הערך True, צריך להגדיר את השורש של adb.

פרמטרים
propKey	String: המפתח שרוצים להגדיר.
propValue	String: ערך המאפיין שרוצים להגדיר.

החזרות
boolean	מחזירה True אם הפקודה setpro בוצעה בהצלחה, אחרת False.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

הגדרה לשחזור

public abstract void setRecovery (IDeviceRecovery recovery)

הגדרת IDeviceRecovery לשימוש במכשיר הזה. צריך להגדיר אותן בזמן ההקצאה הראשונה של המכשיר.

פרמטרים
recovery	IDeviceRecovery: IDeviceRecovery

הגדרה לשחזור מצב

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

הגדרת מצב השחזור הנוכחי לשימוש במכשיר.

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

פרמטרים
mode	ITestDevice.RecoveryMode: האם מצב 'שחזור עד למצב אונליין בלבד' צריך להיות מופעל או לא.

setUseFastbootdelete

public abstract void setUseFastbootErase (boolean useFastbootErase)

הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר.

פרמטרים
useFastbootErase	boolean: true אם צריך להשתמש במחיקה של אתחול מהיר (fastboot), או false אם יש להשתמש בפורמט אתחול מהיר (fastboot).

למידע נוסף:

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

התחלת הצילום של פלט Logcat מהמכשיר ברקע.

לא תהיה לכך השפעה אם פלט ה-Logcat כבר תועד. אפשר לאחזר את הנתונים מאוחר יותר באמצעות getLogcat.

כשהמכשיר כבר לא בשימוש, צריך לבצע קריאה אל stopLogcat().

בדרך כלל אין צורך לקרוא ל-startLogcat() ול-stopLogcat() במסגרת הקשר הפעלה של TF, כי מסגרת TF תתחיל ותפסיק Logcat.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

סוגרים את הפלט של האמולטור ומוחקים אותו.

stopLogcat

public abstract void stopLogcat ()

הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו.

לא תהיה לכך השפעה אם לא יתועד פלט Logcat.

מעבר ל-AdbTcp

public abstract String switchToAdbTcp ()

העברת המכשיר למצב adb-over-tcp.

החזרות
String	את המספר הסידורי של ה-tcp או null אם לא ניתן להחליף את המכשיר

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

מעבר ל-AdbUsb

public abstract boolean switchToAdbUsb ()

העברת המכשיר למצב adb על גבי USB.

החזרות
boolean	true אם ההעברה בוצעה בהצלחה, false אחרת.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

SyncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר.

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

המערכת תתעלם מקבצים מוסתרים (עם שמות המתחילים ב-'.').

שימוש לדוגמה: SyncFiles("/tmp/files", "/sdcard") ייצור ספרייה מסוג /sdcard/files אם היא לא קיימת, וידחוף באופן רקורסיבי את התוכן /sdcard/files.

פרמטרים
localFileDir	File: ספריית הקבצים המקומית שמכילה את הקבצים שרוצים לדחוף באופן רקורסיבי.
deviceFilePath	String: הרמה הבסיסית (root) של נתיב הקובץ המוחלט של היעד המרוחק. כל הספריות בנתיב הקבצים הזה חייבות להיות קריאה. למשל, דחיפה אל /data/local/tmp כאשר adb אינו ברמה הבסיסית (root) תיכשל

החזרות
boolean	true אם הקבצים סונכרנו בהצלחה. אחרת, false.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

ביטול נעילת המכשיר

public abstract boolean unlockDevice ()

ביטול נעילת המכשיר אם המכשיר במצב מוצפן.

השיטה הזו עשויה להפעיל מחדש את ה-framework, אבל היא לא תפעיל postBootSetup(). לכן, יכול להיות שהמכשיר לא מוכן במלואו לבדיקה כשהשיטה הזו תוחזר.

החזרות
boolean	true אם הפעולה בוצעה ללא שגיאות או אם המכשיר לא מוצפן.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.
UnsupportedOperationException	אם המכשיר לא תומך בהצפנה.

ניתוק ניפוי באגים

public abstract void unmountDebugfs ()

ניתוק של ניפוי באגים.

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

pendingForBootcomplete

public abstract boolean waitForBootComplete (long timeOut)

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

פרמטרים
timeOut	long: הזמן באלפיות השנייה עד להגדרת הדגל

החזרות
boolean	true אם הדגל השלמת ההפעלה של המכשיר מוגדר במהלך הזמן הקצוב לתפוגה

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

pendingForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

החזרות
boolean	True אם המכשיר זמין, False אם השחזור מושבת ולא זמין.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pendingForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

פרמטרים
waitTime	long: משך הזמן באלפיות השנייה

החזרות
boolean	True אם המכשיר זמין, False אם השחזור מושבת ולא זמין.

קליעות
DeviceNotAvailableException	אם המכשיר עדיין לא מגיב לאחר תום זמן ההמתנה.

ListenForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור.

פרמטרים
waitTime	long

החזרות
boolean	הערך הוא True אם המכשיר זמין, או False אם לא זמין.

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

startForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

WaitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

חסימת המכשיר למצב 'שחזור adb' (שים לב לכך שהוא שונה מ- IDeviceRecovery).

פרמטרים
waitTime	long: משך הזמן באלפיות השנייה

החזרות
boolean	true אם המכשיר נכנס למצב שחזור לפני שהתוקף שלו פג. אחרת, false

ListenForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

חסימה כדי שהמכשיר יהיה במצב 'adb offload'

פרמטרים
waitTime	long: משך הזמן באלפיות השנייה

החזרות
boolean	true אם המכשיר נכנס למצב התקנה ממקור לא ידוע לפני שהתוקף שלו פג. אחרת, false

startForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

חסימות כדי שהמכשיר לא יהיה זמין, כלומר חסר ב-adb

פרמטרים
waitTime	long: משך הזמן באלפיות השנייה

החזרות
boolean	true אם המכשיר לא יהיה זמין לפני שהתוקף יפוג. אחרת, false

להמתיןForDeviceOnline

public abstract void waitForDeviceOnline ()

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

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

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

להמתיןForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

חסימה עד שהמכשיר גלוי דרך adb.

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

פרמטרים
waitTime	long: משך הזמן באלפיות השנייה

קליעות
DeviceNotAvailableException	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

startForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

בהמתנה עד שהמכשיר יגיב לפקודת מעטפת בסיסית של adb.

פרמטרים
waitTime	long: משך הזמן באלפיות השנייה

החזרות
boolean	true אם המכשיר מגיב לפני הזמן שחלף waitTime.