Easily add a floating fingertip to your app demo.

Ever tried to record a demo video of your app, but the end result looks weird without a finger on the screen? Floater💩 is a tool that puts a floating fingertip on your screen. It uses Xcode UI tests, and it’s great. Your app needs it.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

1. Create UI test target

If you don’t already have one, create a UI test target for your app.

2. Add Floater💩 to your app & UI test targets

3. Use Floater💩Application as the application class

Swift

Remove @UIApplicationMain from your AppDelegate file, and create a main.swift file containing the following:

import Floater_

UIApplicationMain(Process.argc, Process.unsafeArgv, NSStringFromClass(Floater💩Application.self), NSStringFromClass(YOUR_APP_DELEGATE.self))

Objective-C

@import Floater_;

int main(int argc, char * argv[]) {
    @autoreleasepool {
        return UIApplicationMain(argc, argv, NSStringFromClass([FLTRApplication class]), NSStringFromClass([AppDelegate class]));
    }
}

Usage

1. Write UI tests!

   Write your UI tests as usual, with one difference: Use the float💩() method prior to each tap to move the floating fingertip between tap events.

   let awesomeButton = XCUIApplication().buttons["Awesome Button"]
   awesomeButton.float💩()
   awesomeButton.tap()

   You can call this method on both XCUIElement and XCUICoordinate.

   If you’ve never written Xcode UI tests, check out the WWDC 2015 session UI Testing in Xcode.

2. Run your tests in the simulator by hitting ⌘+U. You’ll be presented with the following prompt:

   

   Hit “Allow”. This is necessary for the test process to communicate with your app process.

3. Use Quicktime Player to record your screen. Boom.