What's Changed

🔒 Security

• security: Fix path traversal vulnerability in SaveVisualizationAsFile (#1075) @Dor-bl

🐛 Fixes & Improvements

• refactor: DirectConnect.GetUri for improved readability and validation (#1081) @Dor-bl
• perf: Optimize ToDictionary() performance and clean up unused code (#1061) @Dor-bl

🧪 Tests

• test(ios): fix flaky CanBackgroundAppToDeactivation test (#1088) @Dor-bl
• test(android): increase adbExecTimeout in ClipboardTest (#1079) @Dor-bl
• Add integration and unit tests for GetProperty in AppiumElement (#1038) @Dor-bl
• Fix BrowserTests timeout: skip BrowserTests fixture on google_apis emulator (#1060) @copilot-swe-agent[bot]
• test: Fix IndexOutOfRange in ActionsChainsTest by adding explicit WebDriverWait (#1095) @Dor-bl
• test: stabilize CanActivateAppFromBackgroundTest (#1080) @Dor-bl

🧰 CI & Maintenance

• chore(ci): migrate release-drafter config to v7 and add validation workflow (#1087) @Dor-bl
• chore: improve android emulator stability in CI (#1086) @Dor-bl
• chore: remove prerelease identifier from release drafter (#1083) @Dor-bl
• chore: add Chore/Maintenance to PR template (#1084) @Dor-bl

📚 Documentation

• docs: remove obsolete CI badges (#1082) @Dor-bl

📦 Dependencies

• chore: Bump Selenium.WebDriver from 4.44.0 to 4.46.0 (#1063, #1085) @dependabot[bot], @Dor-bl
• chore: Bump Microsoft.SourceLink.GitHub from 10.0.300 to 10.0.301 (#1090) @dependabot[bot]
• chore: Bump System.Drawing.Common from 10.0.8 to 10.0.9 (#1062) @dependabot[bot]
• test: Bump NUnit from 4.5.1 to 4.6.1 and resolve compiler ambiguities (#1077) @Dor-bl
• test: Bump NUnit3TestAdapter from 6.1.0 to 6.2.0 (#1030) @dependabot[bot]
• test: Bump NUnit.Analyzers from 4.11.2 to 4.14.0 (#1072) @dependabot[bot]
• test: Bump Microsoft.NET.Test.Sdk from 18.0.1 to 18.7.0 (#1071) @dependabot[bot]
• test: Bump System.Text.Json from 10.0.7 to 10.0.10 (#1073, #1094) @dependabot[bot]
• ci(deps): Bump actions/setup-node from 6 to 7 (#1089) @dependabot[bot]
• ci(deps): Bump release-drafter/release-drafter from 6 to 7 (#1022) @dependabot[bot]
• ci(deps): Bump microsoft/setup-msbuild from 2 to 3 (#1027) @dependabot[bot]

🚀 Contributors

Thanks to the following contributors in this release:
@Dor-bl

What's Changed

🚀 Performance

• perf: Optimize WebSocket handler invocation in StringWebSocketClient (#1049) @Dor-bl

🐛 Bug Fixes

• fix: Use correct parameter for appium-xcuitest-driver "mobile: installApp" (#1068) @broetchenrackete36

📦 Dependencies

• ci(deps): Bump actions/cache from 5 to 6 (#1069) @dependabot[bot]
• ci(deps): Bump actions/checkout from 6 to 7 (#1070) @dependabot[bot]
• ci(deps): Bump NuGet/setup-nuget from 2 to 4 (#1044) @dependabot[bot]
• test: Bump System.Text.Json from 10.0.2 to 10.0.7 (#1047) @dependabot[bot]

📚 Documentation

• docs: Update compatibility matrix (#1067) @Dor-bl
• docs: Update README for v8.3.0 release (#1065) @Dor-bl

🙌 Contributors

Thanks to the following contributors in this release:
@Dor-bl, @broetchenrackete36

What's Changed

✨ Enhancements

• feat: support selenium 4.44.0, refactor tests, and modernize code (#1053) @kelmelzer
• test: add integration tests for AppiumElement.GetProperty (#1050) @Dor-bl
• feat: Optimize OptionCollector by reducing dictionary allocations (#1035) @Dor-bl

🚀 Contributors

Thanks to the following contributors in this release:
@Dor-bl and @kelmelzer

This release focuses on performance optimizations, adds iOS launch argument support, and updates several CI/test dependencies.

⚡ Performance

• Optimize ToDictionary() for improved performance in PointerInputDevice (#1026) @Dor-bl
• Optimize string concatenation in AppiumServiceBuilder (#1025) @Dor-bl
• Optimize busy wait in PingAsync with Task.Delay (#1017) @Dor-bl

✨ Enhancements

• Add launchAppWithArguments support for iOS (#1031) @Dor-bl — enables passing launch arguments directly to iOS apps at startup.

🧪 Tests

• Add iOS category attribute to multiple test classes (#1033) @Dor-bl
• Add app uninstall step to improve test stability (#1012) @KazuCocoa

📦 Dependencies

• Bump actions/upload-artifact from 6 to 7 (#1015) @dependabot
• Bump android-actions/setup-android from 3 to 4 (#1028) @dependabot
• Bump dorny/test-reporter from 2 to 3 (#1029) @dependabot
• Bump futureware-tech/simulator-action from 4 to 5 (#1016) @dependabot
• Bump NUnit from 4.4.0 to 4.5.1 (test dependency) (#1019) @dependabot

📚 Documentation

• Update README with test status badges (#1034) @Dor-bl

🚀 Contributors

Thanks to the following contributors in this release:
@Dor-bl, @KazuCocoa

What's Changed

✨ Enhancements

• feat: Implement StartActivity method for Android activities (#986) @Dor-bl
• feat: Add InstallApp method for Android and iOS (#974) @Dor-bl
• feat: Add WebSocket-based log broadcast support for Android (#969) @Dor-bl
• feat: Custom commands execution with ICustomDriverCommandExecutor (#965) @seriousQA

🐛 Bug Fixes

• fix: Stop local Appium process with SIGTERM (#1006) @Dor-bl
• fix: Remove iosWebviewApp from app sources and constants (#992) @Dor-bl
• fix: Fix ParseCapabilitiesIfUNIX for macOS/Linux and convert CI to GHA (#991) @KazuCocoa
• fix: Capability name behind LaunchTimeout for XCUITest (#989) @KazuCocoa

📦 Dependencies

NuGet Packages

• Bump System.Text.Json from 9.0.0 to 10.0.2 (#1003, #983)
• Bump NUnit3TestAdapter from 4.6.0 to 6.1.0 (#1002, #984)
• Bump NUnit from 4.3.2 to 4.4.0 (#975)
• Bump NUnit.Analyzers from 4.7.0 to 4.11.2 (#972)
• Bump Selenium.WebDriver from 4.35.0 to 4.36.0 (#964)
• Bump Microsoft.NET.Test.Sdk from 17.14.1 to 18.0.1 (#971)

GitHub Actions

• Bump actions/checkout, actions/setup-dotnet, and actions/upload-artifact to latest versions (#996, #999, #1000)
• Bump actions/cache to v5 and actions/setup-node to v6 (#998, #1001)
• Bump dorny/test-reporter to v2 (#997)

🛠️ Pipeline & 🧪 Tests

• ci: Add functional tests for Android and iOS (#993, #994)
• ci: Run custom commands as Android (#995)
• test: Add AppiumElementCacheTest (#985) @Dor-bl
• test: Optimize test app management and repository sources (#987) @KazuCocoa

📚 Documentation

• docs: Update compatibility matrix to include Appium .NET Client 8.0.1 and Selenium 4.36.0 (#973, #978)
• docs: Add usage notes regarding dependency versions (#1005)

🚀 Contributors

Thanks to the following contributors for their work on this release:
@Dor-bl, @KazuCocoa, @nvborisenko, @seriousQA

🧾 What’s Changed
🧰 Maintenance & Improvements

Fixed and refined XML documentation comments for improved code clarity. (#950, #951) — @seriousQA

Added a BiDi test using the latest Selenium WebDriver dependency. (#955) — @KazuCocoa

📦 Dependency Updates

Bump Microsoft.NET.Test.Sdk from 17.13.0 → 17.14.1. (#956) — @dependabot[bot]

Bump NUnit.Analyzers and Microsoft.NETFramework.ReferenceAssemblies in /test/integration. (#930) — @dependabot[bot]

Bump Selenium.WebDriver from 4.29.0 → 4.32.0 in /src/Appium.Net. (#940) — @dependabot[bot]

Bump actions/checkout from v4 → v5. (#954) — @dependabot[bot]

🚀 Contributors

A huge thanks to everyone who contributed to this release! ❤️
@KazuCocoa, @seriousQA, and @dependabot[bot]

✅ Summary

This release includes improved XML documentation, expanded test coverage, and updated dependencies for enhanced stability and compatibility.

What's Changed

• BREAKING CHANGE: use extension commands for deprecated endpoints (#939) @KazuCocoa

🧰 Maintenance

• chore: add todo comments in AppiumCommand.cs for future reference (#938) @KazuCocoa

🚀 Contributors

Thanks to the following contributors in this release:
@KazuCocoa

What's Changed

• github: Added a "🧪 Tests" section (#911) @Dor-bl

✨ Enhancements

• feat: Add support for Relax SSL validation (#922) @Dor-bl
• feat: add events endpoint calls (#913) @KazuCocoa

🐛 Bug Fixes

• fix: ToLower/ToUpper to ToLowerInvariant/ToUpperInvariant (#921) @KazuCocoa
• fix: use ToLowerInvariant in clipboard to follow invariant culture (#920) @KazuCocoa

📦 Dependencies

• build(deps): bump Microsoft.NET.Test.Sdk from 17.12.0 to 17.13.0 in /test/integration (#903) @dependabot[bot]
• build(deps): bump Selenium.WebDriver from 4.28.0 to 4.29.0 in /src/Appium.Net (#914) @dependabot[bot]

🛠️ Pipeline

• ci: Fix .NET Core run and add AppiumClientConfigTest to pipeline (#923) @Dor-bl

🧪 Tests

• test: add iOS keyboard tests for HideKeyboard functionality (#918) @Dor-bl
• test: Refactor DirectConnectTest for readability and consistency (#910) @Dor-bl

🚀 Contributors

Thanks to the following contributors in this release:
@Dor-bl, @KazuCocoa, @dependabot[bot] and dependabot[bot]

What's Changed

🧪 Tests

• test: Add FiltersTests class with NUnit tests for Filters.FirstWithName (#902) @Dor-bl
• test: NetworkTests Improvements (#892) @Dor-bl
• test: Add reset orientation in teardown to iOS OrientationTest (#890) @Dor-bl

✨ Enhancements

• refactor: Update the Integration project target frameworks to .NET 8.0 (#905) @Dor-bl

🐛 Bug Fixes

• fix: Init method in Env.cs for better initialization (#906) @Dor-bl
• fix: Refactor parameter names and update documentation (#901) @Dor-bl
• fix: correct formatting in env.json.sample for remoteAppiumServerUri (#893) @Dor-bl

🔄 Refactor

• refactor: Remove ByIosUIAutomation selector (#889) @Dor-bl

📦 Dependencies

• build(deps): bump Selenium.WebDriver from 4.27.0 to 4.28.0 in /src/Appium.Net (#896) @dependabot[bot]
• build(deps): bump Microsoft.NETFramework.ReferenceAssemblies and NUnit in /test/integration (#904) @dependabot[bot]
• build(deps): bump NUnit.Analyzers from 4.4.0 to 4.6.0 in /test/integration (#894) @dependabot[bot]

📚 Documentation

• docs: Update RELEASE_NOTES.md (#888) @Dor-bl
• docs: Update the compatibility matrix (#887) @Dor-bl

🚀 Contributors

Thanks to the following contributors in this release:
@Dor-bl

What's Changed

• test: Disable FullReset in IOS/ClipboardTest (#882) @Dor-bl
• test: update alert text assertion in IOS/AlertTests (#883) @Dor-bl
• test: Replace deprecated ByIosUIAutomation in ScrollingSearchingTest (#881) @Dor-bl
• test: fix assertion for logs entry (#878) @Dor-bl
• test: fix IOS/SearchingTest (#879) @Dor-bl
• BREAKING CHANGE: AndroidDriver to use modern mobile: commands for Lock, IsLocked and Unlock (#874) @Dor-bl
• github: Remove the selenium group (#865) @Dor-bl

✨ Enhancements

• feat: 'IOSDriver' to use modern mobile: commands for Lock, IsLocked and Unlock (#875) @Dor-bl

📦 Dependencies

• build(deps): bump Selenium.WebDriver from 4.26.1 to 4.27.0 in /src/Appium.Net (#871) @dependabot
• build(deps): bump NUnit from 4.2.2 to 4.3.0 in /test/integration (#880) @dependabot
• build(deps): bump Microsoft.NET.Test.Sdk from 17.11.1 to 17.12.0 in /test/integration (#869) @dependabot
• build(deps): bump NUnit.Analyzers from 4.3.0 to 4.4.0 in /test/integration (#868) @dependabot
• build(deps): bump System.Text.Json from 8.0.5 to 9.0.0 in /test/integration (#867) @dependabot

🛠️ Pipeline

• ci: Split tests into two separate tasks per framework (#877) @Dor-bl

• TouchAction + multiActions rewriting,
• Project structure overhaul.

• [Enhancement] Add screen recording mechanism (#277)
• [Enhancement] Add setting/getting clipboard mechanism (#278)
• [Enhancement] Update support for backgrounding (android) app (#292)
• [Enhancement] Add file push mechanism for ios and android driver (#301)
• [Enhancement] Add windows support for page Object pattern (#276)
• [Enhancement] Redirect local appium server log to Visual Studio output (#303)
• [BUG FIX] Override IFindsBy methods in appium driver (#302) fixes #265
• [BUG FIX] Refactor - removing the use of reflection (#297) fixes #291
• [BUG FIX] Allow log file to be parsed appium log file (#286)

• [BUG FIX] Fix for W3C locator strategies

• [BUG FIX] Fix for Displayed endpoint on AppiumWebElement

• [Enhancement] Added support for Tizen driver
• [BREAKING CHANGE] Move to Dotnet Standard with the exception of PageFactory.
• [BREAKING CHANGE] Replace DesiredCapabilities with AppiumOptions and AppiumCapablilities.
• [UPDATES]:
• Selenium.Support was updated 3.14.0
• Selenium.WebDriver was updated 3.14.0

• [Enhancement] The searching by ios class chain was implemented.
• [Enhancement] Details of a session. Interface IHasSessionDetails and its implementation.
• [BUG FIX] Fix of the LongPress action parameters.
• [BREAKING CHANGE] Unnecessary interface ITouchShortcuts was removed.
• [BREAKING CHANGE] Deprecated gesture methods were removed.
• [UPDATES]:
• Newtonsoft.Json was updated to 10.0.3
• Selenium.Support was updated 3.8.0
• Selenium.WebDriver was updated 3.8.0
• Castle.Core was updated to 4.2.1

• [Refactor] The obsolete interface OpenQA.Selenium.Appium.Android.Interfaces.ISendsKeyEvents was removed
• [Refactor] The obsolete interface OpenQA.Selenium.Appium.iOS.Interfaces.IIOSHidesKeyboard was removed
• [Enhancement] The new YouiEngine automation type was added to the OpenQA.Selenium.Appium.Enums.AutomationName
• [BUG FIX] The issue that was preventing the overriding of the Execute method was fixed.

• [Major update] Update to Selenium 3.0.1
• [Major enhancement] Windows automation:
• OpenQA.Selenium.Appium.Interfaces.IFindByWindowsUIAutomation was added.
• OpenQA.Selenium.Appium.Windows.WindowsDriver was added.
• OpenQA.Selenium.Appium.Windows.WindowsElement was added.
• OpenQA.Selenium.Appium.Windows.Enums.WindowsKeyCode was added.
• [Major enhancement] API redesign
• OpenQA.Selenium.Appium.Android.Interfaces.ISendsKeyEvents was marked obsolete.
• Appium.Interfaces.ISendsKeyEvents was added. It is implemented by AndroidDriver and WindowsDriver.
• OpenQA.Selenium.Appium.iOS.Interfaces.IIOSHidesKeyboard was marked obsolete.
• OpenQA.Selenium.Appium.Interfaces.IHidesKeyboardWithKeyName was added. It extends
• OpenQA.Selenium.Appium.Interfaces.IHidesKeyboard and it is implemented by IOSDriver and WindowsDriver.
• OpenQA.Selenium.Appium.Android.Interfaces.IHasSettings was added. It is implemented by AndroidDriver. Also
• The OpenQA.Selenium.Appium.Android.Enims.AutomatorSetting was provided.
• OpenQA.Selenium.Appium.iOS.Interfaces.IPerformsTouchID was added. It is implemented by IOSDriver.
• Updated almost all interfaces extend the OpenQA.Selenium.Appium.Interfaces.IExecuteMethod
• Command execution helpers:
• OpenQA.Selenium.Appium.AppiumCommandExecutionHelper was added.
• OpenQA.Selenium.Appium.Android.AndroidCommandExecutionHelper was added.
• OpenQA.Selenium.Appium.iOS.IOSCommandExecutionHelper was added. These classes consist of static methods which accept IExecuteMethod as one of parameters.
• [Major enhancement] Now the OpenQA.Selenium.Appium.AppiumDriver can use an instance of any OpenQA.Selenium.Appium.MobileBy subclass for the searching. It should work as expected when current session supports the given selector.
• [Major enhancement] The new interface OpenQA.Selenium.Appium.Interfaces.IFindsByFluentSelector was added. It is implemented by OpenQA.Selenium.Appium.AppiumDriver.
• [Major enhancement] The new interface OpenQA.Selenium.Appium.Interfaces.IFindsByIosNSPredicate was added.
• [Major enhancement] The new By-selector OpenQA.Selenium.Appium.ByWindowsAutomation was added.
• [Major enhancement] The new By-selector OpenQA.Selenium.Appium.ByIosNSPredicate was added.
• [Enhancement]. The method Response Execute(string) was added to
• OpenQA.Selenium.Appium.Interfaces.IExecuteMethod. It is implemented by OpenQA.Selenium.Appium.AppiumDriver.
• [Enhancement]. New automation types were added:
• OpenQA.Selenium.Appium.Enums.AutomationName.iOSXcuiTest
• OpenQA.Selenium.Appium.Enums.AutomationName.AndroidUIAutomator2

• All obsolete code was removed. Following capabilities were added:
• OpenQA.Selenium.Appium.Enums.AndroidMobileCapabilityType.AndroidInstallTimeout
• OpenQA.Selenium.Appium.Enums.AndroidMobileCapabilityType.NativeWebScreenshot
• OpenQA.Selenium.Appium.Enums.AndroidMobileCapabilityType.AndroidScreenshotPath
• OpenQA.Selenium.Appium.Enums.AndroidMobileCapabilityType.AppWaitDuration. -The new interface OpenQA.Selenium.Appium.Interfaces.IExecuteMethod was added.

• All obsolete code was removed. #C client won't support Appium server v lower than 1.5.0
• Source code migration to C# 6.0. Now this bundle requires .Net Framework > v4.5 or Mono Framework version which supports .Net Framework v4.5 with Lang Level 6.
• Update to Selenium.Webdriver v2.53.1 and Selenium.Support v2.53.1.
• Update to Newtonsoft.Json v9.0.1.
• Re-design of mobile searching strategies:
• The class OpenQA.Selenium.Appium.MobileBy was added.
• Classes ByAccessibilityId, ByAndroidUIAutomator, ByIosUIAutomation were grouped by the new class.
• Static methods that create instances of ByAccessibilityId, ByAndroidUIAutomator, ByIosUIAutomation were added.
• The method public W GetNamedTextField(String name) was marked obsolete. It is going to be removed.
• ScrollTo() and ScrollToExact() became deprecated. They are going to be removed in the next release. The swiping action and OpenQA.Selenium.Appium.ByAndroidUIAutomator or OpenQA.Selenium.Appium.ByIosUIAutomation are recommended to use instead.
• Server flags were added:
• GeneralOptionList.AsyncTrace
• IOSOptionList.WebkitDebugProxyPort
• The SessionDetails property was added. This property returns a dictionary of the current session data.
• FIX of the pinch/zoom issue. This change is supposed to be the temporary workaround. We are searching for a more convenient solution. It seems it requires some changes on the server side.
• FIX of the swiping issue (iOS, server version >= 1.5.0). Now the swiping is implemented differently by AndroidDriver and IOSDriver.
• Added the ability to start an activity using Android intent actions, intent categories, flags and arguments was added to OpenQA.Selenium.Appium.Android.AndroidDriver. The StartActivityWithIntent method. [Android] ability to push a common string as a file to the remote mobile device. The method was redesigned. [Android] ability to push base64 encoded bytes as a file to the remote mobile device. The method was added. [Android] ability to push a file as the file to the remote mobile device. The method was added. Constructors like AppiumDriver(ICommandExecutor commandExecutor, ICapabilities desiredCapabilities) were added to OpenQA.Selenium.Appium.Android.AndroidDriver and OpenQA.Selenium.Appium.iOS.IOSDriver. Also OpenQA.Selenium.Appium.AppiumCommand became public. The binding of these features may allow to use realated solutions of other vendors/modified Appium server builds which support JSONWP commands that default Appium/Selenium do not support. The SetImmediateValue method was moved to OpenQA.Selenium.Appium.AppiumWebElement. It works against text input elements on Android.

• Update to Selenium.Webdriver v2.53.0 and Selenium.Support v2.53.0
• Update to Newtonsoft.Json v8.0.2
• FIXED The issue of compatibility of AppiumServiceBuilder with Appium node server v >= 1.5.x.
• Page object tools were updated. By.Name locator strategy is deprecated for Android and iOS. It is still valid for the Selendroid mode.
• The DeviceTime property was added and it works with Appium node 1.5
• improvements of locking methods. The LockDevice(seconds) is obsolete and it is going to be removed in the next release. Since Appium node server v1.5.x it is recommended to use
• AndroidDriver.Lock()()...AndroidDriver.Unlock() or IOSDriver.Lock(int seconds) instead.
• AndroidDriver.KeyEvent() is obsolete and it is going to be removed soon. Please use
• AndroidDriver.PressKeyCode or AndroidDriver.LongPressKeyCode instead.
• The GetAppStrings(string language = null) method is obsolete now. It is going to be removed.
• The GetAppStringDictionary(string language = null, string stringFile = null) was added instead. It returns a
• dictionary with app strings (keys and values) instead of a string. Also it allows the searching app strings in the specified file.
• All capabilities were added according to https://github.com/appium/appium/blob/1.5/docs/en/writing-running-appium/caps.md. There are three classes:
• OpenQA.Selenium.Appium.Enums.MobileCapabilityType (just modified),
• OpenQA.Selenium.Appium.Enums.AndroidMobileCapabilityType (android-specific capabilities),
• OpenQA.Selenium.Appium.Enums.IOSMobileCapabilityType (iOS-specific capabilities).
• Some server flags were marked as obsolete because they are deprecated since server node v1.5.x. These options are going to be removed at the next .Net client release.
• The ability to start Appium node programmatically using desired capabilities. This feature is compatible with Appium node server v >= 1.5.x.

• Update to Selenium.Webdriver v2.48.2 and Selenium.Support v2.48.2
• The ability to start appium server programmatically was provided. The ICommandServer implementation (AppiumLocalService).
• The new boolean parameter of the AndroidDdriver.StartActivity method. It allows to start a new activity without closing of a target app.
• All possible key codes were added to AndroidKeyCode.
• The API refactoring.
• The "ReplaceValue" method was added to AndroidElement
• The "SetImmediateValue" was moved from the AppiumWebElement to IOSElement

1.4.1.1

• Update to Selenium.Webdriver v2.48.1 and Selenium.Support v2.48.1
• .Net client is completely following the Apache 2.0 license now.
• IMobileElement implementations are able to perform gestures such as Pinch, Tap and Zoom.
• Constructor set of MultiAction and TouchAction was improved. Redundant constructors were removed.

1.4.0.3

• the bug which prevented the using of TouchAction/MultiTouchActions with IWebElement was fixed. This problem is reproduced
• with IWebElement instances created via Selenium PageFactory.

• features ported from the Java-Appium-Driver. Integration with Selenium PageFactory.

• Generic AppiumDriver class/subclasses and fix for TryAddCommand.

• Fix/Test for hide keyboard.

• Separate android and ios drivers, improved namespaces, fixed tests, and redesigned methods and interfaces

• Update Selenium NuGet Package to get fix for locator strategy.

• Add GetSettings and IgnoreUnimportantViews methods.