Core version: 6.0.11

Enhancements

N/A

Fixes

• #652 web video quality property is missed

Known Issues

N/A

Dependencies Updates

• N/A

Core version: 6.0.10

Enhancements

• #566 Add new parameters for video recording to match appium 1.10 implementation
• Prepared MobileSampleTest for iOS/Android and internal application in carina-demo

Fixes

• ExtendedWebElement.scrollTo() refactored using up to date Locatable class

Known Issues

• #637 Abnormal behavior when swiping left or right
  More information requested
• #652 web video quality property is missed

Dependencies Updates

• N/A

Core version: 6.0.9

Enhancements

• #618 Update appium java client to the latest version (7.0.0)

• #622 Create Zoom in/out in MobileUtils/IMobileUtils

• #534, #563 Improved BrowserMob proxy coverage by unit tests including example for secure traffic sniffer.
  Take a look for example.
  Also disabled proxy_set_to_system=false property by default. It should be enabled only if you have to use your internal corporate proxy to have access to internet.

• #436, #326 Registering device information for unsuccessful driver start. Available only in scope of https://www.qps-infra.io and https://mobiletesting.farm
  Note: Appium should be patched to incorporate custom details into the exception (system-calls.js)

Fixes

• #625 AbstractTest doesn't implement ICustomTypePageFactory
• #629 Annoying INFO message: Value not resolved by key: PRODUCTION.url
• #636 operations with relative elements in AbstractUiObject are broken
• #634 do not restart proxy during driver restart on the same device

Known Issues

• #637 Abnormal behavior when swiping left or right

Dependencies Updates

• io.appium.java-client 6.1.0 -> 7.0.0

Core version: 6.0.8

Enhancements

• #614 refactor CustomTypePageFactory to interface
  Note: CustomTypePageFactory.initPage(….) should be replaced by initPage(…)
  also we again return initPage(…) method without driver as argument

CustomTypePageFactory.initPage(….); 
// it should be replaced in most cases by
initPage(…);

• #608 update copyright info using 2019

• #612 Test execution by filter rules.
  Annotations for future filtering can be set in tests in following way:

	@TestPriority(Priority.P1)
	@MethodOwner(owner = "owner")
	@TestTag(name = "feature", value = "reg")

And setup in config.properties

test_run_rules=PRIORITY=>P1&&P2;;OWNER=>owner;;TAGS=>tag1=temp&&feature=reg
rules logic: test_run_rules={RULE_NAME_ENUM}=>{RULE_VALUE1}&&{RULE_VALUE2};;...

Listener should be added in pom.xml or in required suite

<listener class-name="com.qaprosoft.carina.core.foundation.listeners.FilterTestsListener" /> 

Fixes

• #533 Default url parameter is not detected by envLoader
• #613 openURL functionality refactoring
• Improved hasDependencies logic using short and full qualified class/method names
• Improved negative use-case handlers avoiding loop in making screenshots and generating UiDump
• Added deprecation javadoc for DriverHelper.tapWithCoordinates(double x, double y)
• #623 LOGGER is not being recognized correctly in 6.0.7

Known Issues

• N/A

Dependencies Updates

• N/A

6.0.6

Enhancements

• #607 refactor DevicePool logic integrating it completely into DriverPool
  Note: Due to the removed DevicePool class some code refactoring on project level needed.
  Mostly for devicePool.getDevice() which is not available anymore:

DevicePool.getDevice(); 
// it should be replaced in most cases by
getDevice();

// for the use-case when you need it in static way use
IDriverPool.getDefaultDevice();

// Also we have new methods to get device by driver name!
getDevice("default"); // return device assigned to "default" driver
getDevice("custom"); //return device addigned to "custom" driver.
// if no driver discovered in the pool with provided name then nullDevice will be returned

• #610 Declared easy way to control drivers quit on project layer. You can disable core logic with no way to enable it back for current test run. Anyway, Carina will close drivers on suite finish.

// Execute as only you would like to disable automatic drivers quit
CarinaListener.disableDriversCleanup();

• #581 Agreed to avoid drivers keep for depenent groups. In case you need it please disable automatic drivers quit according to the step above and organize quit using your own logic.
• #599 Upgrade com.fasterxml.jackson.core:jackson-databind to version 2.8.11.3 or later

Fixes

• Fixed potential recursive loops in DriverListener during failures detection
• #605 review and complete IDriverPool TODO's
• #609 hide "Can't save file to Amazon S3!" error message stack-trace
• #604 device name for the test is not registered in Zafira
• #584 DevicePool.getDevice() returns different objects of the same device

Known Issues

• N/A

Dependencies Updates

• com.fasterxml.jackson.core: jackson-databind 2.8.11.1->2.8.11.3

6.0.5

Enhancements

• #565 carina-api: api.validateResponseAgainstJSONSchema should support schema draft 7
• Set of improvements into the IDriverPool to make its modification threads safety
• Start global migration of MobileUtils to IMobileUtils interface
• Register device information in global driversPool for each driver session
• Moved drivers quit and devices disconnect onto the java shutdown hook to kill sessions even for aborted tests/jobs
• Saved information about integrated with STF device in Device object with automatic disconnect on finish
• Do not show encrypted text in logs (aka user credentials etc)

Fixes

• #590 org.openqa.selenium.remote.RemoteWebDriver cannot be cast to io.appium.java_client.MobileDriver
• #590 Device type is defined incorrectly in several cases for iOS/Android tests
• #588 we still can generate ConcurrentModificationException during driver quit operation
• #574 annoying INFO message in log for specific use-cases
• #459 Enormous amount of logs appears in console on attempt to use element.clickIfPresent(3)
• Disabled screenshots capturing for two more driver failures:
  • was terminated due to CLIENT_STOPPED_SESSION
  • Session ID is null. Using WebDriver after calling quit()
  • was terminated due to BROWSER_TIMEOUT

Known Issues

• N/A

Dependencies Updates

• N/A

6.0.4

Fixes

• #553 6.0: Rebuild failures doesn't work
• #582 Hardcoded parameters in carina archetype (-Dname and -Durl)

Known Issues

N/A

Dependencies Updates

zafira-client 3.3.47->3.3.49

6.0.3

Enhancements

• #570 Updated iDriverPool returning back automatic driver quit onto AfterMethod phase as it was in 5.3.x core. New approach was rejected due to the discovered regressions

• #567 Added new browsermob_host parameter to override automatically detected IP address for embedded proxy. Updated manual accordingly http://qaprosoft.github.io/carina/proxy

• #568 Returned Chrome browser maximize to the default method removing old workaround with hardcoded dimension

• 576 Removed sensitive information from logs during onType and onAttachFile operations

• #574 Removed invalid log4j appender and hide noisy log messages on startup

• Adjust custom_capabilities usage allowing not only define it globally but generate for each driver session

  // start new driver with generated capabilities based on capabilities inside 
  // Samsung_Galaxy_S8.properties property file
   WebDriver drv = getDriver("name", new CapabilitiesLoader().getCapabilities("browserstack/android/Samsung_Galaxy_S8.properties"))

• Removed obsolete extra_capabilities configuration parameter

• Declared Spring Plugins repository in pom.xml to download from scratch monte-repack (javax.media.jai) dependency

Known Issues

• #553 In the integration with Zafira environment rerun failures is still broke

Dependencies Updates

• N/A

6.0.2

Enhancements

• Starting from 6.0.x carina-core became a listener with unified CarinaListener class:

  • most of the AbstractTest core methods moved to CarinaListener
  • incorporated HealthCheckListener as part of CarinaListener
  • splited initialization logic into static block and ISuiteListener->onStart(suite) method
  • incorporated DriverPool cleanup on shutdown hook
  • Note: some changes are incompatible in comparison with 5.x.x versions and need manual updates according to the Migration Steps

• Migrated to the latest 6.14.3 TestNG version with fully supported retry execution feature

• Updated build numbering structure according all qaprosoft projects:

  • 6.0.0 - core generation
  • 6.0.0 - service pack release
  • 6.0.0 - cross release build number which starts from 0 in 6th generation (in 5.x.x.x release latest build number is 5.3.3.129)

• Finalized integration rules for Zafira integration:

  • Add ZafiraListener in global pom.xml to inject it for all CI runs
  • Add ZafiraListener into each TestNG suite to be able to run locally with Zafira integration
  • Note: carina archetype updated accordingly

• Refactored DriverPool class and deliver it as functional IDriverPool interface

  • It allowed to remove driver_mode property and calculate driver lifecycle automatically based on rules below:
    • All drivers started during @BeforeSuite phase are saved across all suite run
    • All drivers started during @BeforeClass phase are saved across current test class run
    • All drivers started during @BeforeMethod phase or inside method are saved only for current method and closed automatically
    • To be able to keep "method mode" drivers just use dependsOnMethods property in @Test annotation.

Example:
    @Test()
    public void test1() {
        getDriver(); //start new driver
        ...
    }
    @Test(dependsOnMethods="test1")
    public void test2() {
        getDriver(); //get existing driver started in test1 as test2 depends on test1
        ...
    }
    @Test()
    public void test3() {
        getDriver(); //start new driver as no dependencies detected
        ...
    }

• Moved unit tests into the valid modules to be able to track coverage results in Sonar: https://ci.qaprosoft.com/sonarqube/dashboard/index?did=2

• Move some noisy log messages onto the DEBUG level

• added possibility to redefine log level for explicit sub-modules/classes

core_log_level=DEBUG
core_log_packages=IDriverPool,ZafiraConfigurator

• added support for Opera browser. For now both variants are ok:

  • browser=opera
  • browser=operablink

• Removed all TestRail updaters from Carina and all required dto classes. Integration with 3rd party testcase management tools will be allowed through the https://github.com/qaprosoft/zafira only!

• Removed SMTP integration settings from Carina. All notification methods will be concentrated in Zafira Reporting Tool. Carina could only run and generate local report in ./reports/qa folder.

• Removed completely JUnit libraries from classpath to avoid invalid asserts import inside the test classes on projects level

• Removed cucumber integration as not used feature

• Removed all deprecated methods in DriverHelper

• Removed deprecated constructors in ExtendedWebElement class

Fixes

• Improved driver restart logic fixing #364 and #552.
• removed soapui.log4j.config property
• reused new getConstructorOrMethod() function for getting methods instances
• #558, #546, #542, #532, #519, #512, #505, #484, #483, #480, #479, #375, #343

[DEPENDENCIES UPDATES]

TestNG 6.8.8->6.14.3
zafira-client 3.3.37->3.3.68-SNAPSHOT (due to the changed TestNG)
selenium-server 3.14.0->3.141.59
selenium-java 3.14.0->3.141.59
due to the security alerts bumped up:
jackson-databind.version 2.8.9->2.8.11.1
org.apache.pdfbox 1.8.7->1.8.16
org.testng 6.8.8->6.14.3
org.seleniumhq.selenium 3.12.0->3.14.0

Migration Steps

• Detailed migration procedure is described here: http://qaprosoft.github.io/carina/migration/
• Note: contact us via [email protected] to receive assistance with migration from 5.x to 6.0

5.3.3.129 (2018-11-21)

Enhancements

• Workaround Appium issue and enabled iOS Apps video recording
• Introduced new TestRail and QTest cases annotations
• Enabled secure (https) traffic sniffering via embedded proxy by default
• Removed dependencies conflicts to make browsermobproxy workable for secure content
• Published documentation about proxy usage

Fixes

• Removed workaround for https://github.com/SeleniumHQ/selenium/issues/5299 as not required anymore.
  • Note: tested on Chrome 69 and selenium-standalone 3.11.0-3.141.5
• #525 Incorrect video count in test info

[DEPENDENCIES UPDATES]

• exclude out-of-date 1.38 org.bouncycastle dependency

5.3.2.127 (2018-11-07)

Enhancements

• Added possibility to start localized Chrome and Firefox browsers using "browser_locale" property
• Updated carina archetype content
• Updated snapshots qaprosoft repositories to use https protocol.
• Switched to latest ZafiraClient (3.3.47) with improvements to the AWS S3 screenshots uploading. We can provide expiresIn in seconds for each uploaded image

Fixes

• Only "priority" tag name keep in reserved system names pool

[DEPENDENCIES UPDATES]

• com.qaprosoft.zafira-client updated to 3.3.47

6.0.207-SNAPSHOT

Enhancements

6.0-beta13

• Reorganized driver restart logic fixing #364 and #552. Also in scope of this fix resolved a root cause of the problem when used device is not marked as "busy" in STF app, i.e. no more calls with ENABLE_STF=false capabilities at all.
• Move some noisy log messages onto the DEBUG level

6.0-beta12

• finalized integration rules with Zafira (we support declaration of ZafiraListener in global pom.xml and inside each testng suite xml)
• adjusted default carina archetype based on new Zafira integration rules
• moved unit tests into the valid modules to be able to track coverage results in Sonar: https://ci.qaprosoft.com/sonarqube/overview?id=2
• hide several methods inside IDriverPool implementation
• added possibility to redefine log level for explicit sub-modules/classes

core_log_level=DEBUG
core_log_packages=IDriverPool,ZafiraConfigurator

6.0-beta11

• refactored onStart/onFinish actions using ISuiteListener and static initialization block
• Simplified integration with Zafira and successfully resolved registration issues in multi-threading mode
• temporary enabled debug logging for ZafiraConfigurator component only

[DEPENDENCIES UPDATES]

zafira-client 3.3.37->3.3.68-SNAPSHOT (based on TestNG 6.14.3)

6.0-beta10

• Removed Empty/Default/Custom testRail updater from Carina and all required dto classes. Integration with 3rd party testcase management tools will be allowed through the https://github.com/qaprosoft/zafira only!
• Ported changes from 5.3.3 (mostly browsermobproxy fixes)

6.0-beta9

• Wrapped onTestStart(previously @BeforeSuite) into synchronized action.
• Allowed single onTestStart execution only

6.0-beta8

• ported iOS video recording fixes from 5.3.x

6.0-beta7

• added ability to start localized browsers (Chrome and Firefox)
• keep static IDriverPool.getDefaultDriver() to keep all utils services classes.
• fixed browsermob proxy issues

6.0-beta6

• added support for Opera browser. For now both variants are ok:
  • browser=opera
  • browser=operablink

6.0-beta5

• removed driver_mode property. To keep drivers between methods you should use dependsOnMethods property in @Test annotation.
  Example:
  @Test()
  public void test1() {
  getDriver(); //start new driver
  ...
  }
  @Test(dependsOnMethods="test1")
  public void test2() {
  getDriver(); //get existing driver started in test1 as test2 depends on test1
  ...
  }
  @Test()
  public void test3() {
  getDriver(); //start new driver as no dependencies detected
  ...
  }

6.0-beta4

• return to default build numbering structure we use in all qaprosoft projects:
  • 6.0.0 - core generation
  • 6.0.0 - service pack release
  • 6.0.0 - cross release build number which starts from 0 in 6th generation (in 5.x.x.x release latest build number is 5.3.1.125 for today)
• refactored DriverPool class and make it as functional IDriverPool interface with default implementation

6.0-beta3

• Moved most of the AbstractTest functionality into CarinaListener class
• Incorporated all HealthCheckListener logic into the single CarinaListener
• Finally moved to the latest TestNG version with fully supported retry execution feature
• Migrated to the latest selenium version
• Removed smtp integration settings from Carina. All notification methods will be concentrated in Zafira Reporting Tool
• Removed completely junit libraries from classpath to avoid invalid asserts import inside the test classes on projects level
• Removed cucumber integration as not used feature
• Removed all deprecated methods in DriverHelper
• Removed deprecated constructors in ExtendedWebElement class

Fixes

• removed soapui.log4j.config property
• reused new getConstructorOrMethod() function for getting methods instances

[DEPENDENCIES UPDATES]

6.8.8->6.14.3
due to the security alerts bumped up:
jackson-databind.version 2.8.9->2.8.11.1
org.apache.pdfbox 1.8.7->1.8.16
org.testng 6.8.8->6.14.3
org.seleniumhq.selenium 3.12.0->3.14.0

5.3.1.125 (2018-10-16)

Enhancements

• Incorporated Carina pipeline build process into the common qps-pipeline library with such possibilities opened for everyone:
  • Automatic snapshot build deployment based on PullRequest sources when "build-snapshot" label is assigned to the PR or "build-snapshot" is present in PR title
  • Configured automatic PR checker static code analysis using Sonar PR checker
  • Configured full static code analysis and snapshot build generation after merge to master
• @TestTag and @TestPriority annotations developed to be able to assign P0-P6 priorities to any test method and any custom tag like "feature" etc
• Switched to latest ZafiraClient (3.3.46) with custom tags registration funcitonality

Fixes

N/A

[DEPENDENCIES UPDATES]

• maven-surefire-plugin 2.12.4->2.22.1
• maven-compiler-plugin 3.1->3.8.0
• maven-javadoc-plugin 2.3 -> 3.0.1
• maven-assembly-plugin 2.4.1 -> 3.1.0
• maven-source-plugin 2.4 -> 3.0.1
• com.qaprosoft.zafira-client updated to 3.3.46

5.3.0.124 (2018-10-08)

Enhancements

• Refactored List and AbstractUI objects to speedup objects manipulations
• Switched to latest ZafiraClient (3.3.44) with screenshots publishing into AWS S3
• Implemented async screenshot images publishing to AWS S3
• Added optimize_video_recording parameter. If true video will be captured only for the final retry and as result failed only.
• Handled application crash on iOS with proper exception as only it happens
• Improved logging messages and format to sync with new gallery and log viewer
• Removed obsolete Parameter(s)
  • ci_url
  • ci_build
  • keep_all_screenshots
• Removed obsolete com.qaprosoft.carina.core.foundation.webdriver.appium package
• Removed obsolete start/stop recording methods for Device
• Pushed to log WebDriver url when any exception is captured
• Be able to crypto aws access keys: http://qaprosoft.github.io/carina/security/

Fixes

• Found a root cause of the TestNG main thread crashes and delivered fixes (children DriverListener threads can't raise unchecked RuntimeException)
• Fixed huge regression defect with STF integration (added explicit adb disconnect to correctly stop device usage)
• Added explcit io.netty for carina-proxy module
• Fixed most of the serious Sonar complains
• Handled StaleElementReferenceException which appeared in 1.9.0 Appium
• Fix @CaseInsensitiveXPath annotation usage for more complicated xpath values

[DEPENDENCIES UPDATES]

• com.qaprosoft.zafira-client updated to 3.3.44

5.2.5.119 (2018-08-23)

Enhancements

• Disabled live screenshots appender into the Zafira Reporting Tool due to the performance degradation of elasticsearch
• Improved custom capabilities transfer between carina and custom mobile selenium-hub
• Added documentationabout CustomTypePageFactory usage to generate unified Desktop/Android/iOS test classes: http://qaprosoft.github.io/carina/automation/mobile/
• Added live VNC streaming support for drivers started in before suite/class/method actions
• Added new public static method DevicePool.isRegistered()
• Updated carina default archetype

Fixes

• Updated copyright info
• Workaround applied for appium issue: https://github.com/appium/appium/issues/10159
• Hide some stacktrace messages during browser maximize as warning (mostly for the executing web tests on mobile devices/browsers)
• Cleanup in DesktopFactory removing obsolete functionality

[DEPENDENCIES UPDATES]

• com.qaprosoft.zafira-client updated to 3.0.43

5.2.4.111 (2018-07-24)

Enhancements

• Published new article for API and Mobile automation approaches:
  http://qaprosoft.github.io/carina/automation/api/
  http://qaprosoft.github.io/carina/automation/mobile/

• Improved actual browser_version identification and it's registration in Zafira Reporting Tool

• Introduced new DisableCacheLookup annotation to ExtendedWebElement to disable automatic caching and use object as locator proxy only

• Introduced @CaseInsensitiveXPath annotation (mostly for Android where different frameworks can recognize locator in different way)

• Split click operation for separated Web and Mobile actions to minimize negative side-effects

• MobileUtils - migrated tap etc operations onto the TouchOptions etc
  Note: if in your code thera direct references onto the TouchActions->tap operations you should update them as well because in 6.0.0 java appium client deprecated methods were removed.
  Example: https://github.com/qaprosoft/carina/commit/859d1f0d284462733e2c2ddf005bad3f48b41711

• Introduced AndroidUtils.pressKeyboardKey(...) method

• Enabled logcat extractor for Android devices. Copying system device logs for each tests to capture crashes much easier

• Finalized with UI Dump generation utility (generating screenshot and metadata information on Android devices to be able to analyze xpath values in offline mode using uiautomator viewer)

• Improved integration with qps-pipeline to support demo screenshots publishing to CI for aborted testruns as well

Fixes

• minor adjustments in UI operations for invisible elements on browsers
• fixed integration with ZafiraClient to specify default expiration for test artifacts (30 days)
• Resolve issues with default Timer operations (error messages instead of RuntimeException)
• Handled annoying cast exception "java.lang.ClassCastException: com.google.common.collect.Maps$TransformedEntriesMap cannot be cast to java.lang.String" which is produced mistakenly by Appium instead of StaleElementException
• Fixed potential recursive callss in DriverListener->onException method
• Fixed vnc pattern usage for live video streaming (Web and Android mobile)
• Fixed UIX schema files generation for Android mobile pages
• Fixed IE/Edge capabilities generation for use-case with BrowserStack
• Added thread name and id into the thread log appender messaging

[DEPENDENCIES UPDATES]

• io.appium:java-client was updated to official 6.1.0 release
• org.seleniumhq.selenium:selenium-java updated to 3.12.0
• com.qaprosoft.zafira-client updated to 3.0.40

5.2.3.96 (2018-05-31)

Enhancements

• Detailed documentation prepared and published:
  http://qaprosoft.github.io/carina/

• Enabled elements caching for discovered elements by default.
  Minimized selenium/appium calls
  Details: https://github.com/qaprosoft/carina/pull/286

• Major Removed 16 unused dependencies from the core.
  It could affect test code if such dependencies were imported transitively. Please review below pull request and add explicit dependency on project layer in case of compilation failure or NoSuchMethod exception during runtime
  Details: https://github.com/qaprosoft/carina/pull/285/files

• Migrated to fluent waits for the operating with ExtendedWebElement(s):

  • removed several deprecated methods from DriverHelper
  • added public waitUntil to construct any conditions for page objects (DriverHelper)
    public boolean waitUntil(ExpectedCondition<?> condition, By by, long timeout)

• Example of the complicated wait until conditions combined into the single method which wait until element is present with exact text on page object layer:
  waitUntil(ExpectedConditions.and(ExpectedConditions.presenceOfAllElementsLocatedBy(element.getBy()), ExpectedConditions.textToBe(element.getBy(), myText)), timeout)

• Enabled default core performance metrics trackers (feature is available only in integration with Zafira Reporting Tool: https://github.com/qaprosoft/zafira):

  • wait
  • pause
  • click
  • screen shooting
  • etc

• ExtendedWebElement - added sendKeys method:
  public void sendKeys(Keys keys)

• AndroidUtils - added scroll till text using native functionality
  public static ExtendedWebElement scroll(String scrollToElement, ExtendedWebElement container)

• HockeyApp Tweaks to allow for pulling of ESPN based iOS and Android builds.

• Descriptive Test Names

  • New _config.property of "test_naming_pattern".
  • {method_name} - This is the default naming for all test cases.
  • {method_description} - This pulls in the description field of the @Test annotation, if it is blank for a particular test then it will default to {method_name} instead.
  • {method_priority} - Displays just the priority of a particular test in the test name.
  • {method_thread_pool_size} - Displays the size of the thread pool being used in the current test case.
  • One note about "test_naming_pattern" is you can use any type of pattern you want there..examples…
    • test_naming_pattern={method_name} - {method_description}
    • test_naming_pattern={method_description} - {method_priority}

Fixes

• Fixed multi-drivers manipulations inside the single test.
• Simplified ExtendedElementLocator logic using searchContext properly

5.2.2.45 (2018-01-18)

Enhancements

• Setup integration with maven central for releases distribution:
  https://repo.maven.apache.org/maven2/com/qaprosoft/carina-core/

• core engine refactored using multi-maven module structure. Below there are modules which are bundled with carina-core:
  |-- carina-commons
  |-- carina-api
  |-- carina-dataprovider
  |-- carina-proxy
  |-- carina-utils
  |-- carina-reporting
  |-- carina-crypto
  |-- carina-webdriver
  |-- carina-aws-s3
  |-- carina-hockeyapp
  |-- carina-core

• Extra modules
  |-- archetype
  |-- carina-grid
  |-- carina-jenkins

• Redesigned capabilities manipulation for web/mobile tests

• Migrated onto the cross independent mobile appium java-client 5.0.4 using Touch Actions

• Integrated loggers listener with rabbitmq for run-time logs analysis

• Introduced new screen shooting functionality based on driver listeners and extra rules.

• Delivered fixes to WebDriver factories to restore support with 3rd party clouds like BrowserStack, Sauce Labs etc.