diff options
Diffstat (limited to 'src/io/appium/droiddriver/util/ActivityUtils.java')
-rw-r--r-- | src/io/appium/droiddriver/util/ActivityUtils.java | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/src/io/appium/droiddriver/util/ActivityUtils.java b/src/io/appium/droiddriver/util/ActivityUtils.java new file mode 100644 index 0000000..1e35de8 --- /dev/null +++ b/src/io/appium/droiddriver/util/ActivityUtils.java @@ -0,0 +1,63 @@ +/* + * 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(); + } +} |