החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

GceManager

public class GceManager
extends Object

java.lang.Object
↳	com.android.tradefed.device.cloud.GceManager

כלי עזר שמנהל את הקריאות ל-GCE כדי להפעיל או להפסיק את GCE ולאסוף ממנו יומנים.

סיכום

ערכים קבועים
`String`	`GCE_HOSTNAME_KEY`
`String`	`GCE_INSTANCE_CLEANED_KEY`
`String`	`GCE_INSTANCE_NAME_KEY`
`String`	`GCE_IP_PRECONFIGURED_KEY`

‫constructors ציבוריים
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` ‫Ctor, וריאציה שאפשר להשתמש בה כדי לספק ישירות את שם מופע GCE לשימוש.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, List<IBuildInfo> testResourceBuildInfos)` ה-constructor הזה הוצא משימוש. אפשר להשתמש בבוני אובייקטים אחרים. אנחנו שומרים את האפשרות הזו באופן זמני לצורך תאימות לדורות קודמים.

‫methods ציבוריים
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` הפעלה בפועל של Acloud כדי לכבות את המכשיר הווירטואלי.
`void`	`cleanUp()`
`static void`	`collectErrorSignatures(File remoteFile)`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` כדי להימנע מבעיות פוטנציאליות בחיבור adb, כדאי להשתמש ב-ssh כדי לקבל bugreportz מהמכשיר.
`HostOrchestratorUtil`	`getHostOrchestratorUtil()` הפונקציה מחזירה את המופע של `HostOrchestratorUtil`.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` קריאת התוכן הנוכחי של יומן סדרתי של מופע Gce Avd.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` קבלת דוח באגים באמצעות SSH עבור מופע מקונן.
`static void`	`logAndDeleteFile(File tempFile, String dataName, ITestLogger logger)`
`static void`	`logDirectory(File remoteDirectory, String baseName, ITestLogger logger, LogDataType type)`
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName, List<String> scpArgs)` שליפה של קובץ מרוחק ממופע מקונן ורישום שלו ביומן.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)` שליפה של קובץ מרוחק ממופע מקונן ורישום שלו ביומן.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` שליפה של קובץ מרוחק ממופע מקונן ורישום שלו ביומן.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` רישום הפלט הסידורי של מכשיר שמתואר על ידי `GceAvdInfo`.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` מריצים את הפקודה מרחוק באמצעות SSH במופע.
`boolean`	`shutdownGce()` מכבים את מופע GCE שמשויך אל `startGce()`.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)` מנסים להפעיל מופע של GCE באמצעות Acloud או Oxygen.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` מנסים להפעיל מכונת GCE.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)` מנסים להפעיל מופע של GCE באמצעות Acloud או Oxygen.
`List<GceAvdInfo>`	`startMultiDevicesGce(List<IBuildInfo> buildInfos, MultiMap<String, String> attributes)` ניסיון להפעיל מכונת GCE עם כמה מכשירים באמצעות Oxygen.
`List<GceAvdInfo>`	`startMultiDevicesGce(List<IBuildInfo> buildInfos)` השיטה הזו הוצאה משימוש. צריך להסיר את ההערה הזו אחרי שמעדכנים את ענף המאסטר.

שיטות מוגנות
`static List<String>`	`buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName(String bootupLogs)` אחזור שם המכונה מיומני האתחול של GCE.

ערכים קבועים

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

ערך קבוע: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

ערך קבוע: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

ערך קבוע: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

ערך קבוע: "gce-ip-pre-configured"

‫constructors ציבוריים

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo)

Ctor

פרמטרים
`deviceDesc`	‫`DeviceDescriptor`: ה-`DeviceDescriptor` שישויך למכשיר GCE.
`deviceOptions`	‫`TestDeviceOptions`: `TestDeviceOptions` שמשויך למכשיר.
`buildInfo`	‫`IBuildInfo`: `IBuildInfo` שמתאר את ה-build של GCE שרוצים להפעיל.

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                String gceInstanceName, 
                String gceHost)

‫Ctor, וריאציה שאפשר להשתמש בה כדי לספק ישירות את שם מופע GCE לשימוש.

פרמטרים
`deviceDesc`	‫`DeviceDescriptor`: ה-`DeviceDescriptor` שישויך למכשיר GCE.
`deviceOptions`	‫`TestDeviceOptions`: חשבון `TestDeviceOptions` שמשויך למכשיר
`buildInfo`	‫`IBuildInfo`: `IBuildInfo` שמתאר את ה-build של GCE שרוצים להפעיל.
`gceInstanceName`	‫`String`: שם המכונה שבה רוצים להשתמש.
`gceHost`	‫`String`: שם המארח או כתובת ה-IP של המכונה לשימוש.

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                List<IBuildInfo> testResourceBuildInfos)

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

פרמטרים
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`	`List`

‫methods ציבוריים

AcloudShutdown

public static boolean AcloudShutdown (TestDeviceOptions options, 
                IRunUtil runUtil, 
                String instanceName, 
                String hostname, 
                boolean isIpPreconfigured)

הפעלה בפועל של Acloud כדי לכבות את המכשיר הווירטואלי.

פרמטרים
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` לאפשרויות של Acloud
`runUtil`	‫`IRunUtil`: הפקודה `IRunUtil` להפעלת Acloud
`instanceName`	‫`String`: המכונה להשבתה.
`hostname`	‫`String`: שם המארח של המכונה, לשימוש רק ב-Oxygen cuttlefish.
`isIpPreconfigured`	‫`boolean`: האם ה-AVD נוצר במכשיר שמחובר לרשת אחרת עם כתובת IP שהוגדרה מראש

החזרות
`boolean`	‫True אם הפעולה הצליחה

cleanUp

public void cleanUp ()

collectErrorSignatures

public static void collectErrorSignatures (File remoteFile)

פרמטרים
`remoteFile`	`File`

getBugreportzWithSsh

public static File getBugreportzWithSsh (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

כדי להימנע מבעיות פוטנציאליות בחיבור adb, כדאי להשתמש ב-ssh כדי לקבל bugreportz מהמכשיר.

פרמטרים
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` שמתארות את המכשיר.
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` שמתאר את אפשרויות המכשיר שבהן יש להשתמש במכשיר GCE.
`runUtil`	‫`IRunUtil`: `IRunUtil` להרצת פקודות.

החזרות
`File`	קובץ שמפנה לדוח הבאגים בפורמט ZIP, או null אם אירעה בעיה.

הקפצת הודעות שגיאה (throw)
	java.io.IOException
`IOException`

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

הפונקציה מחזירה את המופע של HostOrchestratorUtil.

החזרות
`HostOrchestratorUtil`

getInstanceSerialLog

public static String getInstanceSerialLog (GceAvdInfo infos, 
                File avdConfigFile, 
                File jsonKeyFile, 
                IRunUtil runUtil)

קריאת התוכן הנוכחי של יומן סדרתי של מופע Gce Avd.

פרמטרים
`infos`	‫`GceAvdInfo`: ה-`GceAvdInfo` שמתאר את המכונה.
`avdConfigFile`	`File`: קובץ ההגדרות של ה-AVD
`jsonKeyFile`	‫`File`: קובץ מפתח JSON של חשבון השירות.
`runUtil`	‫`IRunUtil`: `IRunUtil` להרצת פקודות.

החזרות
`String`	פלט יומן סדרתי או null אם משהו השתבש.

getNestedDeviceSshBugreportz

public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

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

פרמטרים
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` שמתארות את המכשיר.
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` שמתאר את אפשרויות המכשיר שבהן יש להשתמש במכשיר GCE.
`runUtil`	‫`IRunUtil`: `IRunUtil` להרצת פקודות.

החזרות
`File`	קובץ שמפנה לדוח הבאגים בפורמט ZIP, או null אם אירעה בעיה.

הקפצת הודעות שגיאה (throw)
	java.io.IOException
`IOException`

logAndDeleteFile

public static void logAndDeleteFile (File tempFile, 
                String dataName, 
                ITestLogger logger)

פרמטרים
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

פרמטרים
`remoteDirectory`	`File`
`baseName`	`String`
`logger`	`ITestLogger`
`type`	`LogDataType`

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type, 
                String baseName, 
                List<String> scpArgs)

שליפה של קובץ מרוחק ממופע מקונן ורישום שלו ביומן.

פרמטרים
`logger`	‫`ITestLogger`: ה-`ITestLogger` שבו יתועד הקובץ.
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` שמתארות את המכשיר.
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` שמתאר את אפשרויות המכשיר שבהן יש להשתמש במכשיר GCE.
`runUtil`	‫`IRunUtil`: `IRunUtil` להרצת פקודות.
`remoteFilePath`	‫`String`: הנתיב המרוחק שבו נמצא הקובץ.
`type`	‫`LogDataType`: ה-`LogDataType` של הקובץ שנרשם ביומן.
`baseName`	‫`String`: שם הבסיס שמשמש לרישום הקובץ ביומן. אם הערך הוא null, המערכת תשתמש בשם הקובץ בפועל.
`scpArgs`	‫`List`: ארגומנטים נוספים שיועברו לפקודה scp

החזרות
`boolean`	האם הקובץ נרשם בהצלחה.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type)

שליפה של קובץ מרוחק ממופע מקונן ורישום שלו ביומן.

פרמטרים
`logger`	‫`ITestLogger`: ה-`ITestLogger` שבו יתועד הקובץ.
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` שמתארות את המכשיר.
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` שמתאר את אפשרויות המכשיר שבהן יש להשתמש במכשיר GCE.
`runUtil`	‫`IRunUtil`: `IRunUtil` להרצת פקודות.
`remoteFilePath`	‫`String`: הנתיב המרוחק שבו נמצא הקובץ.
`type`	‫`LogDataType`: ה-`LogDataType` של הקובץ שנרשם ביומן.

החזרות
`boolean`	האם הקובץ נרשם בהצלחה.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type, 
                String baseName)

שליפה של קובץ מרוחק ממופע מקונן ורישום שלו ביומן.

פרמטרים
`logger`	‫`ITestLogger`: ה-`ITestLogger` שבו יתועד הקובץ.
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` שמתארות את המכשיר.
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` שמתאר את אפשרויות המכשיר שבהן יש להשתמש במכשיר GCE.
`runUtil`	‫`IRunUtil`: `IRunUtil` להרצת פקודות.
`remoteFilePath`	‫`String`: הנתיב המרוחק שבו נמצא הקובץ.
`type`	‫`LogDataType`: ה-`LogDataType` של הקובץ שנרשם ביומן.
`baseName`	‫`String`: שם הבסיס שמשמש לרישום הקובץ ביומן. אם הערך הוא null, המערכת תשתמש בשם הקובץ בפועל.

החזרות
`boolean`	האם הקובץ נרשם בהצלחה.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

רישום הפלט הסידורי של מכשיר שמתואר על ידי GceAvdInfo.

פרמטרים
`infos`	‫`GceAvdInfo`: ה-`GceAvdInfo` שמתאר את המכונה.
`logger`	‫`ITestLogger`: `ITestLogger` המקום שבו יומן המספרים הסידוריים יתועד.

remoteSshCommandExecution

public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                long timeoutMs, 
                String... command)

מריצים את הפקודה מרחוק באמצעות SSH במופע.

פרמטרים
`gceAvd`	‫`GceAvdInfo`: `GceAvdInfo` שמתארות את המכשיר.
`options`	‫`TestDeviceOptions`: `TestDeviceOptions` שמתאר את אפשרויות המכשיר שבהן יש להשתמש במכשיר GCE.
`runUtil`	‫`IRunUtil`: `IRunUtil` להרצת פקודות.
`timeoutMs`	‫`long`: הזמן הקצוב לתפוגה באלפיות השנייה של הפקודה. הערך 0 מציין שאין זמן קצוב לתפוגה.
`command`	‫`String`: הפקודה להרצה מרחוק.

החזרות
`CommandResult`	‫`CommandResult` שמכיל את תוצאת ההרצה.

shutdownGce

public boolean shutdownGce ()

מכבים את מופע GCE שמשויך אל startGce().

החזרות
`boolean`	הפונקציה מחזירה true אם נשלחה בקשה להשבתת gce כבקשה לא חוסמת.

startGce

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes, 
                ITestLogger logger)

מנסים להפעיל מופע GCE באמצעות Acloud או Oxygen.

פרמטרים
`ipDevice`	‫`String`: כתובת ה-IP הראשונית של מופע GCE להרצת AVD, ‏ `null` אם לא רלוונטי
`user`	‫`String`: המשתמש שמריץ את המארח של AVD, ‏ `null` אם לא רלוונטי
`offset`	‫`Integer`: ההיסט של מספר המכשיר של ה-AVD במארח, `null` אם לא רלוונטי
`attributes`	‫`MultiMap`: מאפיינים שמשויכים להפעלה הנוכחית, שמשמשים להעברת מידע רלוונטי למכונת GCE כדי להוסיף אותו כמטא-נתונים של המכונה הווירטואלית
`logger`	‫`ITestLogger`: `ITestLogger` המקום שבו יתועדו יומני ההפעלה של המכשיר.

החזרות
`GceAvdInfo`	‫`GceAvdInfo` עם תיאור של מופע GCE. יכול להיות שזו דוגמה ל-BOOT_FAIL.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

החזרות
`GceAvdInfo`

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

startGce

public GceAvdInfo startGce (String ipDevice, 
                MultiMap<String, String> attributes)

מנסים להפעיל מכונת GCE.

פרמטרים
`ipDevice`	‫`String`: כתובת ה-IP הראשונית של מופע GCE להרצת AVD, ‏ `null` אם לא רלוונטי
`attributes`	‫`MultiMap`: מאפיינים שמשויכים להפעלה הנוכחית, שמשמשים להעברת מידע רלוונטי למכונת GCE כדי להוסיף אותו כמטא-נתונים של המכונה הווירטואלית

החזרות
`GceAvdInfo`	‫`GceAvdInfo` עם תיאור של מופע GCE. יכול להיות שזו דוגמה ל-BOOT_FAIL.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

מנסים להפעיל מופע GCE באמצעות Acloud או Oxygen.

פרמטרים
`ipDevice`	‫`String`: כתובת ה-IP הראשונית של מופע GCE להרצת AVD, ‏ `null` אם לא רלוונטי
`user`	‫`String`: המשתמש שמריץ את המארח של AVD, ‏ `null` אם לא רלוונטי
`offset`	‫`Integer`: ההיסט של מספר המכשיר של ה-AVD במארח, `null` אם לא רלוונטי
`attributes`	‫`MultiMap`: מאפיינים שמשויכים להפעלה הנוכחית, שמשמשים להעברת מידע רלוונטי למכונת GCE כדי להוסיף אותו כמטא-נתונים של המכונה הווירטואלית

החזרות
`GceAvdInfo`	‫`GceAvdInfo` עם תיאור של מופע GCE. יכול להיות שזו דוגמה ל-BOOT_FAIL.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos, 
                MultiMap<String, String> attributes)

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

פרמטרים
`buildInfos`	`List`: `ERROR(/List)`
`attributes`	‫`MultiMap`: מאפיינים שמשויכים להפעלה הנוכחית

החזרות
`List<GceAvdInfo>`	`ERROR(/List)` שמתאר את המידע על GCE Avd.

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

startMultiDevicesGce

public List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos)

השיטה הזו הוצאה משימוש.
Remove this after master branch is updated.

פרמטרים
`buildInfos`	`List`

החזרות
`List<GceAvdInfo>`

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

שיטות מוגנות

buildShutdownCommand

protected static List<String> buildShutdownCommand (File config, 
                TestDeviceOptions options, 
                String instanceName, 
                String hostname, 
                boolean isIpPreconfigured)

פרמטרים
`config`	`File`
`options`	`TestDeviceOptions`
`instanceName`	`String`
`hostname`	`String`
`isIpPreconfigured`	`boolean`

החזרות
`List<String>`

extractInstanceName

protected String extractInstanceName (String bootupLogs)

אחזור שם המכונה מיומני האתחול של GCE. מחפשים את התבנית 'name': 'gce-' כדי לחלץ את השם. אנחנו מחלצים מהיומנים במקום מקובץ התוצאות, כי אם האתחול של gce נכשל, שם המופע שניסו ליצור לא יופיע ב-json.

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

חזרה לרצף השגרה
`String`