Instance Method

activate()

Activates the application.

Declaration

func activate()

Discussion

This call is synchronous. The application will be in a state ready to handle events when this method returns.

If the application was not running prior to calling activate(), it will be launched automatically.

If the application is launched as a result of calling this method and has previously been launched via launch(), the launch arguments and environment variables from the original call to launch() will be supplied again.

Unlike launch(), a call to activate() will not terminate the existing instance if the application is already running.

Any failure in the activation or launch sequence will be reported as a test failure and the test will be halted at that point.