Appium.WebDriver 8.0.0

appium-dotnet-client

This driver is an extension of the Selenium C# client. It has all the functionalities of the regular driver, but add Appium-specific methods on top of this.

Compatibility Matrix

The Appium .NET Client depends on Selenium .NET binding, thus the Selenium .NET binding update might affect the Appium .NET Client behavior. For example, some changes in the Selenium binding could break the Appium client.

v8

To keep compatibility with Appium v3, most deprecated endpoint method calls have been replaced with compatible extension command with this PR. Old drivers which still haven't implemented extension commands might not have proper implementation. Then, you will need to update Appium driver versions first.

• Removed strategy argument in HideKeyboard because the argument was only for outdated old ios driver

v5

Appium server compatibility for v5.x

Additional Information

W3C Actions: https://www.selenium.dev/documentation/webdriver/actions_api <br/> App management: Please read issue #15807 for more details

Migration Guide to W3C actions

  using OpenQA.Selenium.Interactions;

  var touch = new PointerInputDevice(PointerKind.Touch, "finger");
  var sequence = new ActionSequence(touch);
  var move = touch.CreatePointerMove(elementToTouch, elementToTouch.Location.X, elementToTouch.Location.Y,TimeSpan.FromSeconds(1));
  var actionPress = touch.CreatePointerDown(MouseButton.Touch);
  var pause = touch.CreatePause(TimeSpan.FromMilliseconds(250));
  var actionRelease = touch.CreatePointerUp(MouseButton.Touch);

  sequence.AddAction(move);
  sequence.AddAction(actionPress);
  sequence.AddAction(pause);
  sequence.AddAction(actionRelease);

  var actions_seq = new List<ActionSequence>
  {
      sequence
  };

  _driver.PerformActions(actions_seq);

WinAppDriver Notice!

NuGet

NuGet Package

Dependencies:

• Selenium.WebDriver
• System.Drawing.Common

Note: we will NOT publish a signed version of this assembly since the dependencies we access through NuGet do not have a signed version - thus breaking the chain and causing us headaches. With that said, you are more than welcome to download the code and build a signed version yourself.

Usage

basics

• You need to add the following namespace line: using OpenQA.Selenium.Appium;.
• Use the AppiumDriver class/subclass to construct the driver. It works the same as the Selenium Webdriver, except that the ports default to Appium values, and the driver does not know how to start the Appium independently.
• To use the Appium methods on Element, specify the parameter of AppiumDriver or its subclasses.

Read Wiki

See samples here

Dev Build+Test

Xamarin/Mono

• Open with Xamarin
• Rebuild all
• Run tests in test/specs

JetBrains Rider

• Open with Rider
• From the menu Build -> Rebuild Solution
• Run tests in Appium.Net.Integration.Tests

Visual Studio

• Open with Visual Studio
• build solution

Nuget Deployment (for maintainers)

To Setup Nuget

• Download Nuget exe.
• Setup the Api Key (see here).
• alias NuGet='mono <Nuget Path>/NuGet.exe'

To Release a New Version

• update assemblyInfo.cs, RELEASE_NOTES.md, and appium-dotnet-driver.nuspec with the new version number and release details, then check it in
• pull new code
• Rebuild All with Release target.
• NuGet pack appium-dotnet-driver.nuspec
• NuGet push Appium.WebDriver.<version>.nupkg