Handlers

Handles launch environments passed by the UI test runner. Launch environments passed by the AutoMate are working.

LaunchEnvironmentManager should be initialized in the application delegate in method application(_:didFinishLaunchingWithOptions:).

Example:

let launchManager = aunchEnvironmentManager()
launchManager.add(handler: defaultEventKitHander, for: .events)
launchManager.add(handler: defaultEventKitHander, for: .reminders)
launchManager.add(handler: defaultContactsHander, for: .contacts)
launchManager.add(handler: defaultIsInUITestHandler, for: .isInUITest)
launchManager.add(handler: AnimationHandler(), for: .animation)
launchManager.setup()

See more

public final class LaunchEnvironmentManager

Handles enabling and disabling UIKit animations.

Handler should be added to LaunchEnvironmentManager.

Used key: AM_ANIMATION_KEY / AutoMateLaunchOptionKey.animation.

Supported values (case insensitive):

• true
• yes
• 1
• false
• no
• 0

Example:

let launchManager = LaunchEnvironmentManager()
launchManager.add(handler: AnimationHandler(), for: .animation)
launchManager.setup()

See more

Provides information whether the application is running under UI test environment.

Handler should be added to LaunchEnvironmentManager.

Used key: AM_IS_IN_UI_TEST / AutoMateLaunchOptionKey.isInUITest.

Supported values (case insensitive):

• true
• yes
• 1
• false
• no
• 0

Example:

let launchManager = LaunchEnvironmentManager()
let isInUITest = IsInUITestHandler()
launchManager.add(handler: isInUITest, for: .isInUITest)
launchManager.setup()

Later in the code, you can check whether the application is running in UI test environment, by using below example:

Example:

if isInUITest.inUITest {
    ...
}

See more

public class IsInUITestHandler : Handler

Handles contacts by using Contacts framework.

Handler should be added to LaunchEnvironmentManager.

Used key: AM_CONTACTS_KEY / AutoMateLaunchOptionKey.contacts.

Supported values: LaunchEnvironmentResource resources representation as a string.

Example:

let launchManager = LaunchEnvironmentManager()
let contactsHander = ContactsHandler(withParser: ContactDictionaryParser(with: CNContactStore()), contactsInterface: ContactsInterface())
launchManager.add(handler: contactsHander, for: .contacts)
launchManager.setup()

See more

public struct ContactsHandler<C, I> : Handler where C : ContactParser, I : ContactsInterface

Handles events and reminders by using EventKit framework.

Handler should be added to LaunchEnvironmentManager.

Used key: AM_EVENTS_KEY, AM_REMINDERS_KEY / AutoMateLaunchOptionKey.events, AutoMateLaunchOptionKey.reminders.

Supported values: LaunchEnvironmentResource resources representation as a string.

Example:

let launchManager = LaunchEnvironmentManager()
let eventsHander = EventKitHandler(withParsers: EventDictionaryParser(with: EKEventStore()), ReminderDictionaryParser(with: EKEventStore()),
                                   eventKitInterface: EventKitInterface())
launchManager.add(handler: eventsHander, for: .events)
launchManager.add(handler: eventsHander, for: .reminders)
launchManager.setup()

See more

public class EventKitHandler<E: EventParser, R: ReminderParser, I: EventKitInterfaceProtocol>: Handler
    where E.T == [String: Any],
        R.T == [String: Any]

Protocol defining necessary methods required by the LaunchEnvironmentManager to handle launch environments.

See more

public protocol Handler