Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

GceManager

public class GceManager
extends Object

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

Trình trợ giúp quản lý các lệnh gọi GCE để bắt đầu/dừng và thu thập nhật ký từ GCE.

Tóm tắt

Trường
`public static final String`	`GCE_HOSTNAME_KEY`
`public static final String`	`GCE_INSTANCE_CLEANED_KEY`
`public static final String`	`GCE_INSTANCE_NAME_KEY`
`public static final String`	`GCE_IP_PRECONFIGURED_KEY`

Hàm khởi tạo công khai
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Ctor
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)` Hàm khởi tạo này không còn được dùng nữa. Sử dụng các hàm khởi tạo khác, chúng tôi tạm thời giữ lại hàm khởi tạo này để có khả năng tương thích ngược.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Ctor, biến thể có thể được dùng để cung cấp tên thực thể GCE để sử dụng trực tiếp.

Phương thức công khai
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` Chạy Acloud thực tế để tắt thiết bị ảo.
`void`	`cleanUp()`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Nhận bugreportz từ thiết bị bằng cách sử dụng ssh để tránh mọi vấn đề tiềm ẩn về kết nối adb.
`HostOrchestratorUtil`	`getHostOrchestratorUtil()` Trả về thực thể của `HostOrchestratorUtil`.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Đọc nội dung hiện tại của nhật ký tuần tự của thực thể Gce Avd.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Nhận báo cáo lỗi qua ssh cho một thực thể lồng nhau.
`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)` Tìm nạp tệp từ xa từ một thực thể lồng nhau và ghi lại tệp đó.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` Tìm nạp tệp từ xa từ một thực thể lồng nhau và ghi lại tệp đó.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` Ghi lại đầu ra nối tiếp của một thiết bị do `GceAvdInfo` mô tả.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Thực thi lệnh từ xa qua ssh trên một thực thể.
`boolean`	`shutdownGce()` Tắt thực thể Gce được liên kết với `startGce()`.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)` Cố gắng khởi động một phiên bản gce bằng Acloud hoặc Oxygen.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Cố gắng khởi động một thực thể gce.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)` Cố gắng khởi động một phiên bản gce bằng Acloud hoặc Oxygen.
	`startMultiDevicesGce( buildInfos)` Phương thức này không còn được dùng nữa. Xoá phần này sau khi cập nhật nhánh chính.
	`startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)` Cố gắng khởi động thực thể gce trên nhiều thiết bị bằng Oxygen.

Phương thức được bảo vệ
`static`	`buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName(String bootupLogs)` Truy xuất tên thực thể từ nhật ký khởi động gce.

Trường

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Hàm khởi tạo công khai

GceManager

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

Ctor

Tham số
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor` sẽ được liên kết với thiết bị GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` liên kết với thiết bị.
`buildInfo`	`IBuildInfo`: `IBuildInfo` mô tả bản dựng gce để bắt đầu.

GceManager

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

Hàm khởi tạo này không còn được dùng nữa.
Hãy sử dụng các hàm khởi tạo khác, chúng tôi tạm thời giữ lại hàm khởi tạo này để có khả năng tương thích ngược.

Tham số
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`

GceManager

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

Ctor, biến thể có thể được dùng để cung cấp tên thực thể GCE để sử dụng trực tiếp.

Tham số
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor` sẽ được liên kết với thiết bị GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` liên kết với thiết bị
`buildInfo`	`IBuildInfo`: `IBuildInfo` mô tả bản dựng gce để bắt đầu.
`gceInstanceName`	`String`: Tên thực thể cần sử dụng.
`gceHost`	`String`: Tên máy chủ hoặc địa chỉ IP của thực thể cần sử dụng.

Phương thức công khai

AcloudShutdown

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

Chạy Acloud thực tế để tắt thiết bị ảo.

Tham số
`options`	`TestDeviceOptions`: `TestDeviceOptions` cho các tuỳ chọn Acloud
`runUtil`	`IRunUtil`: `IRunUtil` để chạy Acloud
`instanceName`	`String`: Thực thể cần tắt.
`hostname`	`String`: tên máy chủ của thực thể, chỉ dùng cho mực Oxygen.
`isIpPreconfigured`	`boolean`: liệu AVD có được tạo trên một thiết bị từ xa có IP được định cấu hình trước hay không

Giá trị trả về
`boolean`	Đúng nếu thành công

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Nhận bugreportz từ thiết bị bằng cách sử dụng ssh để tránh mọi vấn đề tiềm ẩn về kết nối adb.

Tham số
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` mô tả thiết bị.
`options`	`TestDeviceOptions`: `TestDeviceOptions` mô tả các tuỳ chọn thiết bị sẽ được sử dụng cho thiết bị GCE.
`runUtil`	`IRunUtil`: `IRunUtil` để thực thi các lệnh.

Giá trị trả về
`File`	Một tệp trỏ đến báo cáo lỗi zip hoặc rỗng nếu xảy ra vấn đề.

Gửi
	IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Trả về thực thể của HostOrchestratorUtil.

Giá trị trả về
`HostOrchestratorUtil`

getInstanceSerialLog

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

Đọc nội dung hiện tại của nhật ký tuần tự của thực thể Gce Avd.

Tham số
`infos`	`GceAvdInfo`: `GceAvdInfo` mô tả thực thể.
`avdConfigFile`	`File`: tệp cấu hình avd
`jsonKeyFile`	`File`: tệp khoá json của tài khoản dịch vụ.
`runUtil`	`IRunUtil`: `IRunUtil` để thực thi các lệnh.

Giá trị trả về
`String`	Kết quả nhật ký tuần tự hoặc rỗng nếu có sự cố.

getNestedDeviceSshBugreportz

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

Nhận báo cáo lỗi qua ssh cho một thực thể lồng nhau. Điều này đòi hỏi bạn phải yêu cầu adb trong thực thể ảo được lồng.

Tham số
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` mô tả thiết bị.
`options`	`TestDeviceOptions`: `TestDeviceOptions` mô tả các tuỳ chọn thiết bị sẽ được sử dụng cho thiết bị GCE.
`runUtil`	`IRunUtil`: `IRunUtil` để thực thi các lệnh.

Giá trị trả về
`File`	Một tệp trỏ đến báo cáo lỗi zip hoặc rỗng nếu xảy ra vấn đề.

Gửi
	IOException

logAndDeleteFile

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

Tham số
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

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

Tham số
`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)

Tìm nạp tệp từ xa từ một thực thể lồng nhau và ghi lại tệp đó.

Tham số
`logger`	`ITestLogger`: `ITestLogger` nơi ghi nhật ký tệp.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` mô tả thiết bị.
`options`	`TestDeviceOptions`: `TestDeviceOptions` mô tả các tuỳ chọn thiết bị sẽ được sử dụng cho thiết bị GCE.
`runUtil`	`IRunUtil`: `IRunUtil` để thực thi các lệnh.
`remoteFilePath`	`String`: Đường dẫn từ xa để tìm tệp.
`type`	`LogDataType`: `LogDataType` của tệp đã ghi.

Giá trị trả về
`boolean`	liệu tệp có được ghi nhật ký thành công hay không.

logNestedRemoteFile

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

Tìm nạp tệp từ xa từ một thực thể lồng nhau và ghi lại tệp đó.

Tham số
`logger`	`ITestLogger`: `ITestLogger` nơi ghi nhật ký tệp.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` mô tả thiết bị.
`options`	`TestDeviceOptions`: `TestDeviceOptions` mô tả các tuỳ chọn thiết bị sẽ được sử dụng cho thiết bị GCE.
`runUtil`	`IRunUtil`: `IRunUtil` để thực thi các lệnh.
`remoteFilePath`	`String`: Đường dẫn từ xa để tìm tệp.
`type`	`LogDataType`: `LogDataType` của tệp đã ghi.
`baseName`	`String`: Tên cơ sở để dùng ghi nhật ký tệp. Nếu giá trị này là rỗng, tên tệp thực tế sẽ được sử dụng.

Giá trị trả về
`boolean`	liệu tệp có được ghi nhật ký thành công hay không.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Ghi lại đầu ra nối tiếp của một thiết bị do GceAvdInfo mô tả.

Tham số
`infos`	`GceAvdInfo`: `GceAvdInfo` mô tả thực thể.
`logger`	`ITestLogger`: `ITestLogger` nơi ghi nhật ký tuần tự.

remoteSshCommandExecution

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

Thực thi lệnh từ xa qua ssh trên một thực thể.

Tham số
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` mô tả thiết bị.
`options`	`TestDeviceOptions`: `TestDeviceOptions` mô tả các tuỳ chọn thiết bị sẽ được sử dụng cho thiết bị GCE.
`runUtil`	`IRunUtil`: `IRunUtil` để thực thi các lệnh.
`timeoutMs`	`long`: Thời gian chờ tính bằng mili giây cho lệnh. 0 nghĩa là không có thời gian chờ.
`command`	`String`: Lệnh từ xa để thực thi.

Giá trị trả về
`CommandResult`	`CommandResult` chứa kết quả của quá trình thực thi.

shutdownGce

public boolean shutdownGce ()

Tắt thực thể Gce được liên kết với startGce().

Giá trị trả về
`boolean`	trả về true nếu bạn yêu cầu tắt gce ở chế độ không chặn.

startGce

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

Cố gắng khởi động một phiên bản gce bằng Acloud hoặc Oxygen.

Tham số
`ipDevice`	`String`: địa chỉ IP ban đầu của phiên bản máy ảo GCE để chạy AVD, `null` nếu không áp dụng
`user`	`String`: người dùng đang chạy máy chủ của AVD, `null` nếu không áp dụng
`offset`	`Integer`: độ lệch số thiết bị của AVD trong máy chủ, `null` nếu không áp dụng
`attributes`	`MultiMap`: các thuộc tính liên kết với lệnh gọi hiện tại, dùng để truyền thông tin có liên quan xuống thực thể GCE để thêm dưới dạng siêu dữ liệu máy ảo
`logger`	`ITestLogger`: `ITestLogger` nơi ghi nhật ký khởi chạy thiết bị.

Giá trị trả về
`GceAvdInfo`	`GceAvdInfo` mô tả thực thể GCE. Có thể là một thực thể BOOT_FAIL.

Gửi
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

Giá trị trả về
`GceAvdInfo`

Gửi
`TargetSetupError`

startGce

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

Cố gắng khởi động một thực thể gce.

Tham số
`ipDevice`	`String`: địa chỉ IP ban đầu của phiên bản máy ảo GCE để chạy AVD, `null` nếu không áp dụng
`attributes`	`MultiMap`: các thuộc tính liên kết với lệnh gọi hiện tại, dùng để truyền thông tin có liên quan xuống thực thể GCE để thêm dưới dạng siêu dữ liệu máy ảo

Giá trị trả về
`GceAvdInfo`	`GceAvdInfo` mô tả thực thể GCE. Có thể là một thực thể BOOT_FAIL.

Gửi
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

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

Cố gắng khởi động một phiên bản gce bằng Acloud hoặc Oxygen.

Tham số
`ipDevice`	`String`: địa chỉ IP ban đầu của phiên bản máy ảo GCE để chạy AVD, `null` nếu không áp dụng
`user`	`String`: người dùng đang chạy máy chủ của AVD, `null` nếu không áp dụng
`offset`	`Integer`: độ lệch số thiết bị của AVD trong máy chủ, `null` nếu không áp dụng
`attributes`	`MultiMap`: các thuộc tính liên kết với lệnh gọi hiện tại, dùng để truyền thông tin áp dụng xuống thực thể GCE để thêm dưới dạng siêu dữ liệu máy ảo

Giá trị trả về
`GceAvdInfo`	`GceAvdInfo` mô tả thực thể GCE. Có thể là một thực thể BOOT_FAIL.

Gửi
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Phương thức này không còn được dùng nữa.
Xoá phần này sau khi cập nhật nhánh chính.

Tham số
`buildInfos`

Giá trị trả về

Gửi
`TargetSetupError`

startMultiDevicesGce

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

Cố gắng khởi động thực thể gce trên nhiều thiết bị bằng Oxygen.

Tham số
`buildInfos`	: `ERROR(/List)`
`attributes`	`MultiMap`: các thuộc tính liên kết với lệnh gọi hiện tại

Giá trị trả về
	`ERROR(/List)` mô tả Thông tin về máy ảo GCE.

Gửi
`TargetSetupError`

Phương thức được bảo vệ

buildShutdownCommand

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

Tham số
`config`	`File`
`options`	`TestDeviceOptions`
`instanceName`	`String`
`hostname`	`String`
`isIpPreconfigured`	`boolean`

Giá trị trả về

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Truy xuất tên thực thể từ nhật ký khởi động gce. Tìm mẫu "name": "gce-" để trích xuất tên của mẫu đó. Chúng ta trích xuất từ nhật ký thay vì tệp kết quả vì khi khởi động gce không thành công, tên thực thể đã thử sẽ không xuất hiện trong json.

Tham số
`bootupLogs`	`String`

Trả về
`String`