Update core library version.

Update README.md, remove outdated info and add template reference.
Add logging of ComboBox and checkbox values.
Add Polish and Ukrainian localization.

Author: mialeska

README.md

@@ -17,20 +17,18 @@ We use interfaces where is possible, so you can implement your own version of ta
 
 ### Quick start
 
-1. To start work with this package, simply add the dependency to your pom.xml:
+To start the project using Aquality.Selenium framework, you can [download our template BDD project by this link.](https://github.com/aquality-automation/aquality-appium-mobile-java-template)
+
+Alternatively, you can follow the steps below:
+
+1. Add the dependency to your pom.xml:
 ```
 <dependency>
     <groupId>com.github.aquality-automation</groupId>
     <artifactId>aquality-appium-mobile</artifactId>
-    <version>3.0.0-beta</version>
-</dependency>
-<dependency>
-    <groupId>org.seleniumhq.selenium</groupId>
-    <artifactId>selenium-java</artifactId>
-    <version>4.1.0</version>
+    <version>3.0.x</version>
 </dependency>
 ```
-Note: adding selenium dependency is a temporary solution to avoid version conflict caused by some appium dependencies; to be fixed on the release version.
 
 2. Configure the path to your application at settings.json:
  - Copy [settings.json](./src/main/resources/settings.json) into the resources directory of your project. 
@@ -203,8 +201,6 @@ public class DemoTest {
 }
 ```
 
-You can find an example in [aquality-appium-mobile-java-template](https://github.com/aquality-automation/aquality-appium-mobile-java-template) repository.
-
 ### Devices
 
 Our library allows you to run tests on different devices and store their settings (like udid, name, etc.) in JSON files.

pom.xml

@@ -172,13 +172,13 @@
         <dependency>
             <groupId>com.github.aquality-automation</groupId>
             <artifactId>aquality-selenium-core</artifactId>
-            <version>2.0.3</version>
+            <version>2.0.4</version>
         </dependency>
 
         <dependency>
             <groupId>io.appium</groupId>
             <artifactId>java-client</artifactId>
-            <version>8.1.1</version>
+            <version>8.2.0</version>
         </dependency>
 
         <dependency>

src/main/java/aquality/appium/mobile/elements/CheckBox.java

@@ -27,15 +27,9 @@ public void uncheck() {
         setState(false);
     }
 
-    @Override
-    public boolean isChecked() {
-        logElementAction("loc.checkbox.get.state");
-        return super.isChecked();
-    }
-
     @Override
     public void toggle() {
-        setState(!super.isChecked());
+        setState(!getState());
     }
 
     /**
@@ -45,7 +39,7 @@ public void toggle() {
      */
     private void setState(boolean state) {
         logElementAction("loc.setting.value", state);
-        if (state != super.isChecked()) {
+        if (state != getState()) {
             click();
         }
     }

src/main/java/aquality/appium/mobile/elements/CheckableElement.java

@@ -16,6 +16,14 @@ protected CheckableElement(By loc, String nameOf, ElementState stateOf) {
     }
 
     public boolean isChecked() {
+        logElementAction("loc.checkable.is.checked");
+        boolean state = getState();
+        logElementAction("loc.checkable.state", state);
+        return state;
+    }
+
+    protected boolean getState()
+    {
         return doWithRetry(() -> {
             String checked = getElement().getAttribute(Attributes.CHECKED.toString());
             if (checked == null || checked.equals("")) {

src/main/java/aquality/appium/mobile/elements/ComboBox.java

@@ -95,32 +95,44 @@ public void clickAndSelectByValue(String value) {
 
     @Override
     public String getSelectedValue() {
-        return doWithRetry(
+        logElementAction("loc.combobox.getting.selected.text");
+        String text = doWithRetry(
                 () -> new Select(getElement()).getFirstSelectedOption().getAttribute(Attributes.VALUE.toString()));
+        logElementAction("loc.combobox.selected.text", text);
+        return text;
     }
 
     @Override
     public String getSelectedText() {
-        return doWithRetry(() -> new Select(getElement()).getFirstSelectedOption().getText());
+        logElementAction("loc.combobox.getting.selected.value");
+        String value = doWithRetry(() -> new Select(getElement()).getFirstSelectedOption().getText());
+        logElementAction("loc.combobox.selected.value", value);
+        return value;
     }
 
     @Override
     public List<String> getValues() {
         logElementAction("loc.combobox.get.values");
-        return doWithRetry(() ->
+        List<String> values = doWithRetry(() ->
                 new Select(getElement()).getOptions()
                         .stream()
                         .map(option -> option.getAttribute(Attributes.VALUE.toString()))
                         .collect(Collectors.toList()));
+        logElementAction("loc.combobox.values",
+                values.stream().map(value -> String.format("'%s'", value)).collect(Collectors.joining(", ")));
+        return values;
     }
 
     @Override
     public List<String> getTexts() {
         logElementAction("loc.combobox.get.texts");
-        return doWithRetry(() ->
+        List<String> values = doWithRetry(() ->
                 new Select(getElement()).getOptions()
                         .stream()
                         .map(WebElement::getText)
                         .collect(Collectors.toList()));
+        logElementAction("loc.combobox.texts",
+                values.stream().map(value -> String.format("'%s'", value)).collect(Collectors.joining(", ")));
+        return values;
     }
 }

src/main/resources/localization/be.json

@@ -7,15 +7,21 @@
   "loc.application.android.activity.start": "Стартуем '%1$s' актыўнасць Android праграмы ў пакеце '%2$s'",
   "loc.button": "Кнопка",
   "loc.checkbox": "Чэкбокс",
-  "loc.checkbox.get.state": "Атрымліваем стан",
+  "loc.checkable.is.checked": "Атрымліваем стан",
+  "loc.checkable.state": "Стан: [%s]",
   "loc.combobox": "Камбабокс",
+  "loc.combobox.getting.selected.text": "Атрымліваем выбраны тэкст",
+  "loc.combobox.getting.selected.value": "Атрымліваем выбранае значэнне",
+  "loc.combobox.selected.text": "Выбраны тэкст: [%s]",
+  "loc.combobox.selected.value": "Выбранае значэнне: [%s]",
   "loc.combobox.select.by.text" : "Выбіраем значэнне з тэкстам '%s'",
   "loc.combobox.select.by.value" : "Выбіраем значэнне '%s'",
   "loc.combobox.get.texts": "Атрымліваем спіс тэкстаў опцыяў",
   "loc.combobox.get.values" : "Атрымліваем спіс значэнняў",
+  "loc.combobox.texts": "Спіс тэкстаў опцыяў: [%s]",
+  "loc.combobox.values": "Спіс значэнняў: [%s]",
   "loc.combobox.impossible.to.select.contain.value.or.text" : "Немагчыма выбраць опцыю, якая змяшчае значэнне/тэкст '%1$s' у камбабоксе '%2$s'",
   "loc.file.reading_exception" : "Памылка пры чытанні файла: '%s'",
-  "loc.focusing" : "Факусуемся",
   "loc.label" : "Надпіс",
   "loc.link" : "Спасылка",
   "loc.radio" : "Радыёкнопка",

src/main/resources/localization/en.json

@@ -7,15 +7,21 @@
   "loc.application.android.activity.start": "Starting the '%1$s' activity of the Android app at package '%2$s'",
   "loc.button": "Button",
   "loc.checkbox": "CheckBox",
-  "loc.checkbox.get.state": "Getting state",
+  "loc.checkable.is.checked": "Getting state",
+  "loc.checkable.state": "State: [%s]",
   "loc.combobox": "ComboBox",
+  "loc.combobox.getting.selected.text": "Getting selected text",
+  "loc.combobox.getting.selected.value": "Getting selected value",
+  "loc.combobox.selected.text": "Selected text: [%s]",
+  "loc.combobox.selected.value": "Selected value: [%s]",
   "loc.combobox.select.by.text": "Selecting value by text '%s'",
   "loc.combobox.select.by.value": "Selecting value '%s'",
   "loc.combobox.get.texts": "Getting option texts array",
   "loc.combobox.get.values": "Getting values array",
+  "loc.combobox.texts": "Option texts: [%s]",
+  "loc.combobox.values": "Option values: [%s]",
   "loc.combobox.impossible.to.select.contain.value.or.text": "It is impossible to select option that contains value/text '%1$s' from combobox '%2$s'",
   "loc.file.reading_exception": "Exception while reading file: '%s'",
-  "loc.focusing": "Focusing",
   "loc.label": "Label",
   "loc.link": "Link",
   "loc.radio": "Radiobutton",

src/main/resources/localization/pl.json

@@ -0,0 +1,40 @@
+{
+  "loc.application.quit": "Zamykanie aplikacji",
+  "loc.application.driver.remote": "Ustawianie sterownika aplikacji przy użyciu serwera na adresie '%s'",
+  "loc.platform.name.wrong": "Platforma '%s' nie jest obsługiwana.",
+  "loc.application.ready": "Aplikacja na platformie '%1$s' jest gotowa...",
+  "loc.application.implicit.timeout": "Ustawianie implicit(niejawnego) limitu czasu '%1$s' sek.",
+  "loc.application.android.activity.start": "Rozpoczęcie aktywności '%1$s' aplikacji Android w pakiecie '%2$s'",
+  "loc.button": "Przycisk",
+  "loc.checkbox": "Pole wyboru",
+  "loc.checkable.is.checked": "Uzyskiwanie stanu",
+  "loc.checkable.state": "Stan: [%s]",
+  "loc.combobox": "Pole kombi",
+  "loc.combobox.getting.selected.text": "Pobieranie zaznaczonego tekstu",
+  "loc.combobox.getting.selected.value": "Pobieranie wybranej wartości",
+  "loc.combobox.selected.text": "Wybrany tekst: [%s]",
+  "loc.combobox.selected.value": "Wybrana wartość: [%s]",
+  "loc.combobox.select.by.text": "Wybieranie wartości z tekstem '%s'",
+  "loc.combobox.select.by.value": "Wybieranie wartośc '%s'",
+  "loc.combobox.get.texts": "Pobieranie listy tekstów opcji",
+  "loc.combobox.get.values": "Pobieranie listy wartości",
+  "loc.combobox.texts": "Lista tekstów opcji: [%s]",
+  "loc.combobox.values": "Lista wartości: [%s]",
+  "loc.combobox.impossible.to.select.contain.value.or.text": "Wybieranie wartości ze znaczeniem/tekstem '%1$s' w polu kombi '%2$s' nie jest możliwe",
+  "loc.file.reading_exception": "Błąd podczas odczytu pliku: '%s'",
+  "loc.label": "Etykieta",
+  "loc.link": "Link",
+  "loc.radio": "Przycisk radiowy",
+  "loc.send.text": "Ustawianie tekstu - '%s'",
+  "loc.setting.value": "Ustawianie wartości '%s'",
+  "loc.text.clearing": "Czyszczenie",
+  "loc.text.field": "Pole tekstowe",
+  "loc.text.typing": "Wpisywanie '%s'",
+  "loc.text.focusing": "Skupienie się na polu",
+  "loc.text.unfocusing": "Usunięcie fokusu z pola",
+  "loc.text.masked_value": "********",
+  "loc.action.swipe": "Przesuwanie od współrzędnych (x:%1$s; y:%2$s) do (x:%3$s; y:%4$s)",
+  "loc.action.swipeLongPress": "Przesuwanie przy użyciu długiego naciśnięcia od współrzędnych (x:%1$s; y:%2$s) do (x:%3$s; y:%4$s)",
+  "loc.get.center": "Uzyskanie współrzędnych środka elementu",
+  "loc.center.value": "Współrzędne środka elementu: (x:%1$s; y:%2$s)"
+}

src/main/resources/localization/ru.json

@@ -7,15 +7,21 @@
   "loc.application.android.activity.start": "Стартуем '%1$s' активность Android приложения в пакете '%2$s'",
   "loc.button": "Кнопка",
   "loc.checkbox": "Чекбокс",
-  "loc.checkbox.get.state": "Получение состояния",
+  "loc.checkable.is.checked": "Получение состояния",
+  "loc.checkable.state": "Состояние: [%s]",
   "loc.combobox": "Комбобокс",
+  "loc.combobox.getting.selected.text": "Получаем выбранный текст",
+  "loc.combobox.getting.selected.value": "Получаем выбранное значение",
+  "loc.combobox.selected.text": "Выбранный текст: [%s]",
+  "loc.combobox.selected.value": "Выбранное значение: [%s]",
   "loc.combobox.select.by.text": "Выбор значения с текстом '%s'",
   "loc.combobox.select.by.value": "Выбор значения '%s'",
   "loc.combobox.get.texts": "Получение списка текстов опций",
   "loc.combobox.get.values": "Получение списка значений",
+  "loc.combobox.texts": "Список текстов опций: [%s]",
+  "loc.combobox.values": "Список значений: [%s]",
   "loc.combobox.impossible.to.select.contain.value.or.text": "Не удаётся выбрать значение которое содержит значение/текст '%1$s' в выпадающем списке '%2$s'",
   "loc.file.reading_exception": "Исключение при чтении файла: '%s'%n",
-  "loc.focusing": "Взятие элемента в фокус",
   "loc.label": "Надпись",
   "loc.link": "Ссылка",
   "loc.radio": "Радиокнопка",

src/main/resources/localization/uk.json

@@ -0,0 +1,40 @@
+{
+  "loc.application.quit": "Закриття програми",
+  "loc.application.driver.remote": "Налаштування драйвера програми за допомогою сервера за адресою '%s'",
+  "loc.platform.name.wrong": "Платформа '%s' не підтримується.",
+  "loc.application.ready": "Програма на платформі '%1$s' готова...",
+  "loc.application.implicit.timeout": "Встановлення implicit(неявного) часу очікування: '%1$s' сек.",
+  "loc.application.android.activity.start": "Запуск активності '%1$s' програми Android у пакеті '%2$s'",
+  "loc.button": "Кнопка",
+  "loc.checkbox": "Чекбокс",
+  "loc.checkable.is.checked": "Отримання стану",
+  "loc.checkable.state": "Стан: [%s]",
+  "loc.combobox": "Комбобокс",
+  "loc.combobox.getting.selected.text": "Отримання вибраного тексту",
+  "loc.combobox.getting.selected.value": "Отримання вибраного значення",
+  "loc.combobox.selected.text": "Вибраний текст: [%s]",
+  "loc.combobox.selected.value": "Вибране значення: [%s]",
+  "loc.combobox.select.by.text" : "Вибір значення за текстом '%s'",
+  "loc.combobox.select.by.value" : "Вибір значення '%s'",
+  "loc.combobox.get.texts": "Отримання масиву текстів опцій",
+  "loc.combobox.get.values" : "Отримання масиву значень",
+  "loc.combobox.texts": "Список текстів опцій: [%s]",
+  "loc.combobox.values": "Список значень: [%s]",
+  "loc.combobox.impossible.to.select.contain.value.or.text" : "Не вдалося вибрати опцію, що містіть значення/текст '%1$s' у комбобоксі '%2$s'",
+  "loc.file.reading_exception" : "Помилка підчас читання файлу: '%s'",
+  "loc.label" : "Напис",
+  "loc.link" : "Посилання",
+  "loc.radio" : "Радіокнопка",
+  "loc.send.text" : "Встановлення тексту - '%s'",
+  "loc.setting.value" : "Встановлення значення '%s'",
+  "loc.text.clearing" : "Очищення",
+  "loc.text.field" : "Текстове поле",
+  "loc.text.typing" : "Введення '%s'",
+  "loc.text.focusing": "Фокусування на полі",
+  "loc.text.unfocusing": "Зняття фокусування з поля",
+  "loc.text.masked_value": "********",
+  "loc.action.swipe": "Проводимо по екрану від координат (x:%1$s; y:%2$s) до (x:%3$s; y:%4$s)",
+  "loc.action.swipeLongPress": "Проводимо по екрану за допомогою тривалого натискання від координат (x:%1$s; y:%2$s) до (x:%3$s; y:%4$s)",
+  "loc.get.center": "Отримання координат центру елемента",
+  "loc.center.value": "Координати центру елемента: (x:%1$s; y:%2$s)"
+}