/*
* Copyright (C) 2013 DroidDriver committers
*
* 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 io.appium.droiddriver.util;
import android.app.Activity;
import io.appium.droiddriver.exceptions.UnrecoverableException;
import io.appium.droiddriver.instrumentation.InstrumentationDriver;
/**
* Static helper methods for retrieving activities.
*/
public class ActivityUtils {
public interface Supplier<T> {
/**
* Retrieves an instance of the appropriate type. The returned object may or
* may not be a new instance, depending on the implementation.
*
* @return an instance of the appropriate type
*/
T get();
}
private static Supplier<Activity> runningActivitySupplier;
/**
* Sets the Supplier for the running (a.k.a. resumed or foreground) activity.
* Called from {@link io.appium.droiddriver.runner.TestRunner}. If a
* custom runner is used, this method must be called appropriately, otherwise
* {@link #getRunningActivity} won't work.
*/
public static synchronized void setRunningActivitySupplier(Supplier<Activity> activitySupplier) {
runningActivitySupplier = activitySupplier;
}
/**
* Gets the running (a.k.a. resumed or foreground) activity.
* {@link InstrumentationDriver} depends on this.
*
* @return the currently running activity, or null if no activity has focus.
*/
public static synchronized Activity getRunningActivity() {
if (runningActivitySupplier == null) {
throw new UnrecoverableException("If you don't use DroidDriver TestRunner, you need to call" +
" ActivityUtils.setRunningActivitySupplier appropriately");
}
return runningActivitySupplier.get();
}
}