1/* 2 * Copyright (C) 2010 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package vogar; 18 19import java.io.File; 20import java.util.Set; 21import vogar.commands.VmCommandBuilder; 22import vogar.tasks.Task; 23 24/** 25 * A Mode for running actions. Examples including running in a virtual machine 26 * either on the host or a device or within a specific context such as within an 27 * Activity. 28 */ 29public interface Mode { 30 /** 31 * Initializes the temporary directories and harness necessary to run 32 * actions. 33 */ 34 Set<Task> installTasks(); 35 36 Task executeActionTask(Action action, boolean useLargeTimeout); 37 38 /** 39 * Hook method called after action compilation. 40 */ 41 Set<Task> installActionTasks(Action action, File jar); 42 43 /** 44 * Deletes files and releases any resources required for the execution of 45 * the given action. 46 */ 47 Set<Task> cleanupTasks(Action action); 48 49 /** 50 * Returns a VM for action execution. 51 * 52 * @param workingDirectory the working directory of the target process. If 53 * the process runs on another device, this is the working directory of 54 * the device. 55 */ 56 VmCommandBuilder newVmCommandBuilder(Action action, File workingDirectory); 57 58 /** 59 * Returns the classpath containing JUnit and the dalvik annotations 60 * required for action execution. 61 */ 62 Classpath getRuntimeClasspath(Action action); 63} 64