Releases: appium/appium
@appium/[email protected]
1.16.3 (2021-09-14)
Note: Version bump only for package @appium/doctor
@appium/[email protected]
8.0.2 (2021-09-14)
Note: Version bump only for package @appium/base-driver
[email protected]
2.0.0-beta.15 (2021-09-14)
Note: Version bump only for package appium
v2.0.0-beta
This release will track changelog updates for Appium 2.0
v1.21.0
CHANGES IN VERSION 1.21.0 (FROM 1.20.2)
Appium 1.21.0 is a minor release
General
- Minimum NodeJS version moved to 12
- Support multiple image matches for Finding and Interacting with Image Elements appium-base-driver#449 (@khaong)
Android General
- Disable sending of Google analytics data by instruments appium-uiautomator2-driver#452, appium-espresso-driver#666
- Improve detection of screen lock status appium/appium-adb#564
- Add
speed
optional parameter to mock location appium-android-driver#681 (Thanks to @salabogdan) - Fix
autoLaunch
to install applications byapp
andotherApps
capabilities, but does not launch them as same as iOS appium-uiautomator2-driver#440, appium-espresso-driver#654, appium-android-driver#676 - Fix to handle special characters by
mobile:type
appium-adb#567 - Fix to switch to Web Views with same package name, but different process names appium-android-driver#687
- Fix to stop screen recording after a session is closed appium-android-driver#675 and each driver
Android(UIAutomator2)
- Add
mobile:
extensions:mobile:doubleClickGesture
for double click guesture appium-uiautomator2-driver#441, appium-uiautomator2-server#415mobile:installMultipleApks
to install multiple apks viaadb install-multiple
command. Please read mobile:installMultipleApks for more details
- Fix XPath lookup for queries which have
@*
attribute pattern appium-uiautomator2-server#417
Android(Espresso)
- Fix to raise an error in Reset App. It must quit the session and create a new one in Espresso driver. appium-espresso-driver#649
- Fix to reset instrumentation state before starting a new instance appium-espresso-driver#662
- Gradle wrapper has been rewritten using Kotlin DSL appium-espresso-driver#658, appium-espresso-driver#659 (Thanks to @misa)
iOS General
- Xcode 12.5 support
iOS(XCUITest)
- Add capabilities:
appium:includeDeviceCapsToSessionInfo
to skip adding the screen information in order to improve Get Session Capabilities API.mobile:viewportRect
andmobile:deviceScreenInfo
help to get these information when this capability isfalse
. appium-xcuitest-driver#1278appium:disableAutomaticScreenshots
to handle automatic screenshot by XCTest. Defaults totrue
appium-xcuitest-driver#1288 (@mrmacete)appium:shouldTerminateApp
to handle if Appium terminates the application under test process on the session end. Defaults totrue
appium-xcuitest-driver#1290, WebDriverAgent#486/ (Thanks to @mrmacete)
- Add
mobile:
extensions:mobile:viewportRect
returns the screen viewport information which is part of Get Session Capabilitiesmobile:deviceScreenInfo
returns the screen information which is part of Get Session Capabilities, WebDriverAgent#483mobile:pushNotification
to simulator push notification on simulator byxcrun simctl push
command. It requires Xcode 11.4+. Please read mobile:pushNotification for mroe details to trigger a push notification. appium-xcuitest-driver#1286mobile:expectNotification
to wait for a notification on the device under test. Please read mobile:expectNotification for more information on how to use it. appium-xcuitest-driver#1287 WebDriverAgent#480mobile:performIoHidEvent
to emulate low-level IO HID device events. Read mobile:performIoHidEvent for more details. appium-xcuitest-driver#1291, WebDriverAgent#494
- Add css selector support appium-xcuitest-driver#1274
css selector
selector will be converted to-ios class chain
selector
- Support Get Geolocation API appium-xcuitest-driver#1266
- Allow Location Access in Location Services for WebDriverAgent-Runner must be set to Always
- Add
accessible
attribute field into the XML page source WebDriverAgent#493 (Thanks to @TheDarkestDay) - Improve performance of the keyboard dismissal logic appium-xcuitest-driver#1267, WebDriverAgent#458
- Fix performance degradation of interaction in
nativeWebTap:true
appium-xcuitest-driver/pull/1265
Mac2
- Add capabilities:
appium:webDriverAgentMacUrl
to allow Appium to connect to a running WebDriverAgentMac instance at this URL appium-mac2-driver#41
- Add a possibility to provide key names for
macos:keys
extension appium-mac2-driver#60 - Add
hittable
attribute field into the XML page source appium-mac2-driver#65 - More fine-grained handling of orphaned xcodebuild processes appium-mac2-driver#73
You.i Engine Driver
The version is 1.2.8
Community based drivers
Flutter driver
The version is 0.0.28
New drivers
Add the ability to load appium-roku-driver
(appium#15227) and appium-webos-driver
(appium#15260) by @cbuelvasc
v1.20.2
fix: improve caching performance in Appium UiAutomator (appium/appium-uiautomator2-server#406)
v1.20.1
Appium 1.20.1 is a patch release
Android(UIAutomator2)
- Fix setting the session capabilities appium-uiautomator2-server#404
v1.20.0
Appium 1.20.0 is a minor release
General
- Does not destory sockets explicitly against a client appium-base-driver#437
- Connection timeout to each driver respects
--keep-alive-timeout
configuration appium-base-driver#443. Default to 10 minutes
Android General
InvalidContextError
error is thrown if running instrumentation process was dead- Fix Android emulator config paths on Windows appium-adb#558
Android(UIAutomator2)
- Appium adds
io.appium.settings
,io.appium.uiautomator2.server
andio.appium.uiautomator2.server.test
as the device's Doze whitelist to keep working appium-uiautomator2-driver#420 - Add settings:
useResourcesForOrientationDetection
to use application resource propertires to determine the current device orientation appium-uiautomator2-server#389
Android(Espresso)
- Appium adds
io.appium.settings
andio.appium.espressoserver.test
as the device's Doze whitelist to keep working appium-espresso-driver#627 - Add
mobile:
extensions:uiautomatorPageSource
returns the page source dump by UIAutomator appium-espresso-driver#628
- Improves XPath lookup performance appium-espresso-driver#637
iOS General
- Fix updating simulator preference method appium-ios-simulator#298
iOS(XCUITest)
- Support M1 chip based Mac, Xcode 12.3
- Snapshots caching logic has been rewritten to improve lookup performance e.g. WebDriverAgent#404, WebDriverAgent#407
- Breaking changes
- Support over Xcode 10.2, iOS 12.2 (Drop supporting Xcode 10.0 and 10.1)
accessibility id
,name
andid
lookup strategies now find elements byname
(wdName
) attributes in page source: WebDriverAgent#414- Previously, they found elements by
name
(wdName
) andvalue
(wdValue
) - Please use
predicate
strategy to findvalue
(wdValue
) attribute like this change
- Previously, they found elements by
- Add capabilities:
resultBundlePath
andresultBundleVersion
to allow to specify the path to the result bundle of WebDriverAgent xcodebuild WebDriverAgent#410safariIgnoreWebHostnames
to provide a list of hostnames that the Safari automation tools should ignore [appium-xcuitest-driver#1258](https://github.com/appium/appium-xcuitest-driver/pull/
waitForIdleTimeout
(Please read the below settings section)
- Add settings: (Please read Settings API for more details)
customSnapshotTimeout
which was renamed fromsnapshotTimeout
sets how much time is allowed to resolve a single accessibility snapshot with custom attributeswaitForIdleTimeout
to customize the time for waiting until the application under test is idling- The value
zero
(not recommended) is equal towaitForQuiescence
tofalse
- Important: this is still a workaround, so there is no guarantee it is going to always work. Please consider rather fixing your application source code, because XCTest uses idle intervals to send commands to the accessibility manager. You may get unexpected testing results or application crashes if such intervals don't exist or are too tiny.
- The value
animationCoolOffTimeout
customize the timeout to wait until the application under test has no animation
- Add a possibility to select elements by indexes WebDriverAgent#417
- Fix parsing SSL output from OpenSSL output appium-xcuitest-driver#1256
iOS(Safari)
This driver provides you to communicate with Apple's safaridriver
binary via Appium.
It only supports Safari browser automation on macOS and iOS (Simulator/Real Device).
Read https://github.com/appium/appium-safari-driver for more details.
Mac2
This driver provides you to handle macOS native applications with Apple's XCTest
framework.
Read https://github.com/appium/appium-mac2-driver for more details.
Gecko
This driver provides you to communicate with Firefox browsers on macOS, Windows, Linux and Android with geckodriver binary via Appium.
Read https://github.com/appium/appium-geckodriver for more details to set the environment up.
v1.19.2
Add safariIgnoreWebHostnames capabilities to provide a list of hostnames that the Safari automation tools should ignore appium-xcuitest-driver#1258
This is a workaround that makes iOS ignore search engines domains that cause Webkit automation problems. (example usage: safariIgnoreWebHostnames=www.google.com,www.bing.com,www.yahoo.com,yahoo.com,about:blank)