Share via

iOSApp Class

  • Reference

Definition

Namespace:
Xamarin.UITest.iOS
Assembly:
Xamarin.UITest.dll

Represents a running iOS application.

public class iOSApp : Xamarin.UITest.IApp
type iOSApp = class
    interface IApp
Public Class iOSApp
Implements IApp
Inheritance
Object
iOSApp
Implements
IApp

Constructors

iOSApp(IiOSAppConfiguration)

Main entry point for creating iOS applications. Should not be called directly but instead be invoked through the use of ConfigureApp.

Properties

Device

Runtime information and control of the currently running device.
Print

Contains helper methods for outputting the result of queries instead of resorting to Console.
TestServer

Allows HTTP access to the test server running on the device.

Methods

Back()

Navigate back on the device.
ClearText()

Clears text from the currently focused element.
ClearText(Func<AppQuery,AppQuery>)

Clears text from a matching element that supports it.
ClearText(Func<AppQuery,AppWebQuery>)

Clears text from a matching element that supports it.
ClearText(String)

Clears text from a matching element that supports it.
DismissKeyboard()

Dismisses the keyboard if present
DismissSpringboardAlerts()

Uses Device Agent to dismiss springboard alerts.
DoubleTap(Func<AppQuery,AppQuery>)

Performs two quick tap / touch gestures on the matched element. If multiple elements are matched, the first one will be used.
DoubleTap(String)

Performs two quick tap / touch gestures on the matched element. If multiple elements are matched, the first one will be used.
DoubleTapCoordinates(Single, Single)

Performs a quick double tap / touch gesture on the given coordinates.
DragAndDrop(Func<AppQuery,AppQuery>, Func<AppQuery,AppQuery>)

Drags the from element to the to element.
DragAndDrop(Func<AppQuery,AppQuery>, Func<AppQuery,AppQuery>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Drags the from element to the to element.
DragAndDrop(String, String)

Drags the from element to the to element.
DragCoordinates(Single, Single, Single, Single)

Performs a continuous drag gesture between 2 points.
DragCoordinates(Single, Single, Single, Single, Nullable<TimeSpan>, Nullable<TimeSpan>)

Performs a continuous drag gesture between 2 points.
EnterText(Func<AppQuery,AppQuery>, String)

Enters text into a matching element that supports it.
EnterText(Func<AppQuery,AppWebQuery>, String)

Enters text into a matching element that supports it.
EnterText(String)

Enters text into the currently focused element. Will fail if no keyboard is visible.
EnterText(String, String)

Enters text into a matching element that supports it.
Flash(Func<AppQuery,AppQuery>)

Highlights the results of the query by making them flash. Specify view elements using the fluent API. Defaults to all view objects that are visible.
Flash(String)

Highlights the results of the query by making them flash. Specify view elements using marked string.
FlickCoordinates(Single, Single, Single, Single)

Performs a quick continuous flick gesture between 2 points.
Invoke(String, Object)

Invokes a method on the app's app delegate. For Xamarin apps, methods must be exposed using attributes as shown below.

iOS example in app delegate:

[Export("myInvokeMethod:")]
public NSString MyInvokeMethod(NSString arg)
{
    return new NSString("uitest");
}
Invoke(String, Object[])

Invokes a method on the app's app delegate. For Xamarin apps, methods must be exposed using attributes as shown below.

iOS example in app delegate:

[Export("myInvokeMethod:")]
public NSString MyInvokeMethod(NSString arg, NSString arg2)
{
    return new NSString("uitest");
}
InvokeDeviceAgentGesture(String, Object, Object)

Invokes the Device Agent gesture.
InvokeDeviceAgentQuery(Object)

Invokes the Device Agent query.
InvokeUia(String)

Invokes raw UIA javascript.
PinchToZoomIn(Func<AppQuery,AppQuery>, Nullable<TimeSpan>)

Performs a pinch gestures on the matched element to zoom the view in. If multiple elements are matched, the first one will be used.
PinchToZoomIn(String, Nullable<TimeSpan>)

Performs a pinch gestures on the matched element to zoom the view in. If multiple elements are matched, the first one will be used.
PinchToZoomInCoordinates(Single, Single, Nullable<TimeSpan>)

Performs a pinch gestures to zoom the view in on the given coordinates.
PinchToZoomOut(Func<AppQuery,AppQuery>, Nullable<TimeSpan>)

Performs a pinch gestures on the matched element to zoom the view out. If multiple elements are matched, the first one will be used.
PinchToZoomOut(String, Nullable<TimeSpan>)

Performs a pinch gestures on the matched element to zoom the view out. If multiple elements are matched, the first one will be used.
PinchToZoomOutCoordinates(Single, Single, Nullable<TimeSpan>)

Performs a pinch gestures to zoom the view in on the given coordinates.
PressEnter()

Presses the enter key in the app.
PressVolumeDown()

Presses the volume down button on the device.
PressVolumeUp()

Presses the volume up button on the device.
Query(Func<AppQuery,AppQuery>)

Queries view objects using the fluent API. Defaults to only return view objects that are visible.
Query(Func<AppQuery,AppWebQuery>)

Queries web view objects using the fluent API. Defaults to only return view objects that are visible.
Query(Func<AppQuery,InvokeJSAppQuery>)

Queries view objects using the fluent API. Defaults to only return view objects that are visible.
Query(String)

Queries view objects using the fluent API. Defaults to only return view objects that are visible.
Query<T>(Func<AppQuery,AppTypedSelector<T>>)

Queries properties on view objects using the fluent API.
Repl()

Starts an interactive REPL (Read-Eval-Print-Loop) for app exploration and pauses test execution until it is closed.
Screenshot(String)

Takes a screenshot of the app in it's current state. This is used to denote test steps in the Xamarin Test Cloud.
ScrollDown(Func<AppQuery,AppQuery>, ScrollStrategy, Double, Int32, Boolean)

Scrolls down on the first element matching query.
ScrollDown(String, ScrollStrategy, Double, Int32, Boolean)

Scrolls down on the first element matching query.
ScrollDownTo(Func<AppQuery,AppQuery>, Func<AppQuery,AppQuery>, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll down until an element that matches the toQuery is shown on the screen.
ScrollDownTo(Func<AppQuery,AppWebQuery>, Func<AppQuery,AppQuery>, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll down until an element that matches the toQuery is shown on the screen.
ScrollDownTo(Func<AppQuery,AppWebQuery>, String, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll down until an element that matches the toMarked is shown on the screen.
ScrollDownTo(String, String, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll down until an element that matches the toMarked is shown on the screen.
ScrollTo(String, String, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll until an element that matches the toMarked is shown on the screen.
ScrollUp(Func<AppQuery,AppQuery>, ScrollStrategy, Double, Int32, Boolean)

Scrolls up on the first element matching query.
ScrollUp(String, ScrollStrategy, Double, Int32, Boolean)

Scrolls up on the first element matching query.
ScrollUpTo(Func<AppQuery,AppQuery>, Func<AppQuery,AppQuery>, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll up until an element that matches the toQuery is shown on the screen.
ScrollUpTo(Func<AppQuery,AppWebQuery>, Func<AppQuery,AppQuery>, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll up until an element that matches the toQuery is shown on the screen.
ScrollUpTo(Func<AppQuery,AppWebQuery>, String, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll up until an element that matches the toMarked is shown on the screen.
ScrollUpTo(String, String, ScrollStrategy, Double, Int32, Boolean, Nullable<TimeSpan>)

Scroll up until an element that matches the toMarked is shown on the screen.
SendAppToBackground(TimeSpan)

Sends the app to background for the specified time span.
SetOrientationLandscape()

Changes the device orientation to landscape mode.
SetOrientationPortrait()

Changes the device orientation to portrait mode.
SetSliderValue(Func<AppQuery,AppQuery>, Double)

Sets the value of a slider element that matches query.
SetSliderValue(String, Double)

Sets the value of a slider element that matches marked.
SwipeLeftToRight(Double, Int32, Boolean)

Performs a left to right swipe gesture.
SwipeLeftToRight(Func<AppQuery,AppQuery>, Double, Int32, Boolean)

Performs a left to right swipe gesture on the matching element. If multiple elements are matched, the first one will be used.
SwipeLeftToRight(Func<AppQuery,AppWebQuery>, Double, Int32, Boolean)

Performs a left to right swipe gesture on the matching element. If multiple elements are matched, the first one will be used.
SwipeLeftToRight(String, Double, Int32, Boolean)

Performs a left to right swipe gesture on the matching element. If multiple elements are matched, the first one will be used.
SwipeRightToLeft(Double, Int32, Boolean)

Performs a right to left swipe gesture.
SwipeRightToLeft(Func<AppQuery,AppQuery>, Double, Int32, Boolean)

Performs a right to left swipe gesture on the matching element. If multiple elements are matched, the first one will be used.
SwipeRightToLeft(Func<AppQuery,AppWebQuery>, Double, Int32, Boolean)

Performs a right to left swipe gesture on the matching element. If multiple elements are matched, the first one will be used.
SwipeRightToLeft(String, Double, Int32, Boolean)

Performs a right to left swipe gesture on the matching element. If multiple elements are matched, the first one will be used.
Tap(Func<AppQuery,AppQuery>)

Performs a tap / touch gesture on the matched element. If multiple elements are matched, the first one will be used.
Tap(Func<AppQuery,AppWebQuery>)

Performs a tap / touch gesture on the matched element. If multiple elements are matched, the first one will be used.
Tap(String)

Performs a tap / touch gesture on the matched element. If multiple elements are matched, the first one will be used.
TapCoordinates(Single, Single)

Performs a tap / touch gesture on the given coordinates.
TouchAndHold(Func<AppQuery,AppQuery>)

Performs a continuous touch gesture on the matched element. If multiple elements are matched, the first one will be used.
TouchAndHold(String)

Performs a continuous touch gesture on the matched element. If multiple elements are matched, the first one will be used.
TouchAndHoldCoordinates(Single, Single)

Performs a continuous touch gesture on the given coordinates.
TwoFingerTap(Func<AppQuery,AppQuery>)

Performs a tap / touch gestures with 2 fingers on the matched element. If multiple elements are matched, the first one will be used.
TwoFingerTap(String)

Performs a tap / touch gestures with 2 fingers on the matched element. If multiple elements are matched, the first one will be used.
TwoFingerTapCoordinates(Single, Single)

Performs a tap / touch gesture with 2 fingers on the given coordinates.
WaitFor(Func<Boolean>, String, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Generic wait function that will repeatly call the predicate function until it returns true. Throws a TimeoutException if the predicate is not fullfilled within the time limit.
WaitForElement(Func<AppQuery,AppQuery>, String, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Wait function that will repeatly query the app until a matching element is found. Throws a TimeoutException if no element is found within the time limit.
WaitForElement(Func<AppQuery,AppWebQuery>, String, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Wait function that will repeatly query the app until a matching element is found. Throws a TimeoutException if no element is found within the time limit.
WaitForElement(String, String, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Wait function that will repeatly query the app until a matching element is found. Throws a TimeoutException if no element is found within the time limit.
WaitForNoElement(Func<AppQuery,AppQuery>, String, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Wait function that will repeatly query the app until a matching element is no longer found. Throws a TimeoutException if the element is visible at the end of the time limit.
WaitForNoElement(Func<AppQuery,AppWebQuery>, String, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Wait function that will repeatly query the app until a matching element is no longer found. Throws a TimeoutException if the element is visible at the end of the time limit.
WaitForNoElement(String, String, Nullable<TimeSpan>, Nullable<TimeSpan>, Nullable<TimeSpan>)

Wait function that will repeatly query the app until a matching element is no longer found. Throws a TimeoutException if the element is visible at the end of the time limit.

Explicit Interface Implementations

IApp.Device

Runtime information and control of the currently running device.

Applies to