| /* |
| * Copyright (C) 2010 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package com.android.tradefed.device; |
| |
| import com.android.ddmlib.IDevice; |
| |
| /** |
| * A ITestDevice whose lifecycle is managed. |
| */ |
| interface IManagedTestDevice extends ITestDevice { |
| |
| /** |
| * Start capturing logcat output from device in the background. |
| * <p/> |
| * Will have no effect if logcat output is already being captured. |
| * Data can be later retrieved via getLogcat. |
| * <p/> |
| * When the device is no longer in use, {@link #stopLogcat()} must be called. |
| */ |
| public void startLogcat(); |
| |
| /** |
| * Stop capturing logcat output from device, and discard currently saved logcat data. |
| * <p/> |
| * Will have no effect if logcat output is not being captured. |
| */ |
| public void stopLogcat(); |
| |
| /** |
| * Update the IDevice associated with this ITestDevice. |
| * <p/> |
| * The new IDevice must refer the same physical device as the current reference. This method |
| * will be called if DDMS has allocated a new IDevice |
| * |
| * @param device the {@link IDevice} |
| */ |
| public void setIDevice(IDevice device); |
| |
| /** |
| * Update the device's state. |
| * |
| * @param deviceState the {@link TestDeviceState} |
| */ |
| public void setDeviceState(TestDeviceState deviceState); |
| |
| /** |
| * Set the fastboot option for the device. Should be set when device is first |
| * allocated. |
| * |
| * @param fastbootEnabled whether fastboot is available for the device or not |
| */ |
| public void setFastbootEnabled(boolean fastbootEnabled); |
| |
| /** |
| * Invoke recovery on the device. |
| * |
| * @throws DeviceNotAvailableException if recovery was not successful |
| */ |
| public void recoverDevice() throws DeviceNotAvailableException; |
| |
| /** |
| * Sets the {@link Process}, when this device is an emulator. |
| */ |
| public void setEmulatorProcess(Process p); |
| |
| /** |
| * Return the {@link Process} corresponding to this emulator. |
| * |
| * @return the {@link Process} or <code>null</code> |
| */ |
| public Process getEmulatorProcess(); |
| |
| } |