Skip to content

Latest commit

 

History

History
53 lines (42 loc) · 2.12 KB

index.md

File metadata and controls

53 lines (42 loc) · 2.12 KB
Raw
title description keywords author ms.author ms.date ms.topic ms.assetid ms.custom
Automate an iOS native app with Xamarin.UITest
A guide that shows you how-to automate your iOS Swift or Objective-C app with Xamarin.UITest.
Xamarin.UITest, iOS, Swift, Obc-c, Objective-C, automated, testing, ui testing.
lucen-ms
lucen
05/12/2020
article
842394DD-CFDA-4B2D-B4E6-3405ED036369
test

Automate iOS native apps with Xamarin.UITest

[!INCLUDE Retirement announcement for App Center] To follow the guide, you need access to the app source code.

Add an automation backend to your app

Part of the Xamarin.UITest toolchain is the backend that runs alongside the app. The Xamarin.UITest test script communicates with the backend, which executes the commands on the simulator or device.

Because Xamarin.UITest shares backend with Calabash, first step is to link the calabash.framework, using one of the three methods from the Calabash doc.

You should see that the server is running in Xcode, after following the Calabash guide.

You build the .app file from the terminal like below:

Note

.app files only work simulators

 xcrun xcodebuild \
  -project ProjectFile.xcodeproj \
  -configuration ConfiguratonWithCalabashLinked \
  -sdk iphonesimulator \
  ARCHS="x86_64" \
  VALID_ARCHS="x86_64" \
  ONLY_ACTIVE_ARCH=NO \
  -scheme SchemeWithCalabashLinked \
  -derivedDataPath DerivedData \
  build

The following switches must match your project:

  • -project
  • -configuration
  • -scheme

Run your Xamarin.UITest on a simulator

With the Calabash backend setup, the next step is to configure your Xamarin.UITest so that it opens your app on a simulator. See the Working with Simulators page on how identify simulators.

The .AppBundle() and .DeviceIdentifier() must be configured. You can find the AppBundle in the DerivedData if your app was built using the command from Add an automation backend to your app.

Run a test

Start your tests from Visual Studio for Mac by selecting Unit Tests in the right side.