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

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

‫methods ציבוריים
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` הפעלה בפועל של Acloud כדי לכבות את המכשיר הווירטואלי.
`void`	`cleanUp()`
`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)` שליפת קובץ מרוחק ממופע מקונן ורישום שלו ביומן.
`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.
	`startMultiDevicesGce( buildInfos)` השיטה הזו הוצאה משימוש. Remove this after master branch is updated.
	`startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)` ניסיון להפעיל כמה מכשירי gce עם Oxygen.

שיטות מוגנות
`static`	`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, 
                 testResourceBuildInfos)

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

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

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 של המופע לשימוש.

‫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 ()

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 אם אירעה בעיה.

זריקות
	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 אם אירעה בעיה.

זריקות
	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)

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

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

זריקות
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

החזרות
`GceAvdInfo`

זריקות
`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.

זריקות
	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.

זריקות
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

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

פרמטרים
`buildInfos`

החזרות

זריקות
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos, 
                MultiMap<String, String> attributes)

ניסיון להפעיל כמה מכשירי gce עם Oxygen.

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

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

זריקות
`TargetSetupError`

שיטות מוגנות

buildShutdownCommand

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

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

החזרות

extractInstanceName

protected String extractInstanceName (String bootupLogs)

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

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

החזרות
`String`