JCenter Update

• Falcon is currently published on JCenter - it will serve packages until February 1st 2022. Falcon packages will be migrated to Maven Central before that - see issue. Thanks for using Falcon! :)

Falcon

Take Android screenshots with Falcons bright eye!

Includes dialogs, toasts and all other extra windows in your screenshot.

Usage

// Saving screenshot to file
Falcon.takeScreenshot(activity, file);
// Take bitmap and do whatever you want
Bitmap bitmap = Falcon.takeScreenshotBitmap(activity);

Check falcon-sample and its android tests for more example usage.

Download

Grab via Gradle:

implementation 'com.jraska:falcon:2.1.1'

Spoon Compat

Spoon is really great library, but it also does not include dialogs and other extra windows in its screenshots. To keep using Spoon with advantage of Falcon you can use FalconSpoon class.

Usage of Spoon Compat

@Rule
public final FalconSpoonRule falconSpoonRule = new FalconSpoonRule();

@Test
public void awesomeTest() {
  ...
  File screenshot = FalconSpoonRule.screenshot(activity, tag);
  ...
}

Gradle

androidTestImplementation 'com.jraska:falcon:2.1.1'
androidTestImplementation 'com.jraska:falcon-spoon-compat:2.1.1'

Spoon 1.X Compatibility

Spoon version 2.0 is not released yet, so if you use version 1.X use Falcon 1.0.4.

androidTestImplementation 'com.jraska:falcon:1.0.4'
androidTestImplementation 'com.jraska:falcon-spoon-compat:1.0.4'

Q&A

Why is Falcon crashing on Android 9 Pie?

You are most likely not using the latest version of Falcon. Android 9 is supported from Falcon version 2.1.0. Some changes were needed since we use some reflection to make the screenshots possible.

Why another screenshot library?

There are plenty of great screenshot libraries, but all of them miss Dialogs, Toasts and other extra windows in Activity. Not this one!

License

Copyright 2015 Josef Raska

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.